Create a network interface
Allocates its routed IPv6 /64 (and, with ipv4, a public IPv4 address) and attaches its initial firewalls: the project's default firewall when firewalls is omitted, none for [].
https://network-api.ezghcloud.com/v1/organizations/{orgId}/projects/{projectId}/network-interfacesAuthorization
Path parameters
Header parameters
Request bodyJSONrequired
- ipv4optionalobjectorobjectorobject
A public interface: {allocate: true} or {address: "pip_…"}. A private interface (subnet set): {allocate: true|false}, a public IPv4 mapped onto its primary private address (the guest sees only the private one); omitted, the subnet's autoAssignPublicIpv4 decides. Allocating needs an attached network gateway on the VPC (409 vpc_has_no_gateway).
- ipv6optionalobject
With subnet only (a public interface always has its /64; 400 invalid_request otherwise): a public IPv6 /64 the guest configures beside its ULA; omitted, the subnet's autoAssignPublicIpv6 decides. Allocating needs an attached network gateway (409 vpc_has_no_gateway); 409 ipv6_pool_exhausted as a public create.
Returns
201
The interface, available.
400
invalid_request (with issues), invalid_cursor, or the endpoint's own 400 codes.
403
access_denied: the caller's policies don't allow the action; forbidden_origin: a cookie-authenticated write from an origin that isn't allowed; spend_limit_reached.
404
not_found: unknown, malformed, or in an organization the caller isn't in.
409
quota_exceeded (an allocation quota, with quota), idempotency_conflict, idempotency_in_progress (with Retry-After), organization_deletion_pending, operation_in_progress, or the endpoint's own 409 codes.
413
payload_too_large: the body is over the endpoint's limit (1 MiB unless it says otherwise).
429
too_many_requests, with Retry-After; or quota_exceeded (a rate, usage or concurrency quota, with quota), never with Retry-After.
500
internal_error: a bug; the details are in the logs, under the request ID.