AnkraDocs
Console

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

200 response fields
FieldTypeDescription
limitsrequiredQuotaAmounts
serversrequiredinteger
coresrequiredinteger
memory_mebibytesrequiredintegerMemory of the servers the account holds or may hold, in MiB.
storage_gibibytesrequiredinteger
floating_ipsrequiredintegerFloating 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.
routersrequiredinteger
private_networksrequiredinteger
public_ipv4_addressesrequiredintegerGlobally 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.
usagerequiredQuotaAmounts
serversrequiredinteger
coresrequiredinteger
memory_mebibytesrequiredintegerMemory of the servers the account holds or may hold, in MiB.
storage_gibibytesrequiredinteger
floating_ipsrequiredintegerFloating 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.
routersrequiredinteger
private_networksrequiredinteger
public_ipv4_addressesrequiredintegerGlobally 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_credentials on 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

bash
curl 'https://cloud.ankra.app/v1/quotas' \
  -H "Authorization: Bearer $ANKRA_CLOUD_TOKEN"