API reference · Account and billing
Quotas
1 operation of the Ankra Cloud API: Account quotas.
The account's limits and what it holds#
GET
/v1/quotas- Operation
get_quotas- Credentials
- API token, Portal session
- Requires
- Permission
read
Responses
200Limits and usage.application/json · Quota
| Field | Type | Description |
|---|---|---|
limitsrequired | QuotaAmounts | |
serversrequired | integer | |
coresrequired | integer | |
memory_mebibytesrequired | integer | Memory of the servers the account holds or may hold, in MiB. |
storage_gibibytesrequired | integer | |
floating_ipsrequired | integer | Floating IPs the zone's gateways forward to a server (requires_restart false), 1 by default. A floating IP that becomes the server's own public IPv4 (requires_restart true) counts under public_ipv4_addresses instead. |
routersrequired | integer | |
private_networksrequired | integer | |
public_ipv4_addressesrequired | integer | Globally routable public IPv4 addresses the account holds or may hold (3 by default): those of its servers and its floating IPs that become a server's own public IPv4 (requires_restart true), each counted once, assigned or not. Floating IPs the gateways forward keep the floating_ips limit; router NAT addresses, addresses of a pool in a private or other special-purpose range, and IPv6 do not count. IPv6 has no limit. |
usagerequired | QuotaAmounts | |
serversrequired | integer | |
coresrequired | integer | |
memory_mebibytesrequired | integer | Memory of the servers the account holds or may hold, in MiB. |
storage_gibibytesrequired | integer | |
floating_ipsrequired | integer | Floating IPs the zone's gateways forward to a server (requires_restart false), 1 by default. A floating IP that becomes the server's own public IPv4 (requires_restart true) counts under public_ipv4_addresses instead. |
routersrequired | integer | |
private_networksrequired | integer | |
public_ipv4_addressesrequired | integer | Globally routable public IPv4 addresses the account holds or may hold (3 by default): those of its servers and its floating IPs that become a server's own public IPv4 (requires_restart true), each counted once, assigned or not. Floating IPs the gateways forward keep the floating_ips limit; router NAT addresses, addresses of a pool in a private or other special-purpose range, and IPv6 do not count. IPv6 has no limit. |
- 401Not signed in, or the credential is invalid or expired.
- 403The role lacks the permission, the token is read-only (a read-only token also gets
reason: read_only_token_cannot_read_credentialson every credential read), the CSRF header is missing, a support session may not do this, or the route needs a verified email address and the caller's is not (reason: email_unverified). - 429Rate limited. On a customer operation the credential (the API token, or the signed-in user for a session) is over its requests per minute and the
X-RateLimit-*headers say when the window ends; on a sign-in route the client network is over its attempts or the email is locked out. - defaultAny other error, usually 500.
Example
curl 'https://cloud.ankra.app/v1/quotas' \
-H "Authorization: Bearer $ANKRA_CLOUD_TOKEN"