List free IP addresses of a private cloud
GET/api/v3/servers/:server_id/private-cloud/available-ip-addresses
Required scopes: server:read
Free and available IP addresses of the pool of the private cloud, the ones to use as ip_address_id to create a VM of the private cloud or a public network interface of one of its VMs. The server can be the private cloud or one of its VMs.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 429
- 500
OK
The request is not valid: error 1000 with the errors for each field in meta.errors, error 1001 (or 1) for other invalid input
The access token is missing, invalid, expired or revoked (error 1100): request a new token and retry once
The access token is valid but not enough: missing scope (error 1101), token for the other API (error 1102), missing permission, feature not included in the plan, operation not available to sub-accounts, internal API without administrator privileges or IP address not allowed (error 1601). A new token does not change the result
The resource does not exist or does not belong to the account (error 1200)
Too many requests (error 1300): retry after the seconds in the Retry-After header
Response Headers
Seconds to wait before retrying
Unexpected server error (error 1500)