Skip to content

nexus: update documenation for EphemeralIpCreate #8030

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Apr 23, 2025

Conversation

sudomateo
Copy link
Contributor

Passing an empty request body (i.e., {}) to the instance_ephemeral_ip_attach API results in the API allocating an ephemeral IP from the silo's default IP pool. However, the documentation did not describe that behavior and now it does.

Here's an example request showing the behavior.

> echo "{}" | oxide api /v1/instances/$INSTANCE_ID/external-ips/ephemeral --method POST --input -
{
  "ip": "192.168.0.99",
  "kind": "ephemeral"
}

@sudomateo sudomateo force-pushed the ephemeral-ip-create-docs branch from a1cc828 to b135c83 Compare April 23, 2025 19:17
Copy link
Contributor

@david-crespo david-crespo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, take the suggestions as you will.

Passing an empty request body (i.e., `{}`) to the
[instance_ephemeral_ip_attach](https://docs.oxide.computer/api/instance_ephemeral_ip_attach)
API results in the API allocating an ephemeral IP from the silo's
default IP pool. However, the documentation did not describe that
behavior and now it does.

Here's an example request showing the behavior.

```sh
> echo "{}" | oxide api /v1/instances/$INSTANCE_ID/external-ips/ephemeral --method POST --input -
{
  "ip": "192.168.0.99",
  "kind": "ephemeral"
}
```

Co-authored-by: Jordan Raub <jraub@switch.com>
@sudomateo sudomateo force-pushed the ephemeral-ip-create-docs branch from b135c83 to 129cd9e Compare April 23, 2025 19:24
@sudomateo sudomateo enabled auto-merge (squash) April 23, 2025 19:47
@sudomateo sudomateo merged commit 4235bfb into main Apr 23, 2025
17 checks passed
@sudomateo sudomateo deleted the ephemeral-ip-create-docs branch April 23, 2025 21:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants