Quota
All operations require authentication.
2 operationsv2/publicCloud/project
Get the project quotaProduction
GET
/v2/
Returns the project quota. When the region query parameter is set, the response narrows targetSpec.regions and currentState.regions to that single region. Omit it to get all regions.
Path parameters
project
required
string
Project ID
Query parameters
region
string
Optional region filter
Response
200Quotasuccessful operation
checksum
read-only
string
Computed hash representing the current target specification value
created
read-only
stringdate-time
Creation date of the quota
current
read-only
Quota
Current state of the quota
current
read-only
Current
Ongoing asynchronous tasks related to the quota
id
read-only
string
Project ID this quota belongs to
resource
read-only
Resource
Quota readiness in the system
Values
CREATINGCREATION_PLANNEDDELETINGERROROUT_OF_SYNCREADYSUSPENDEDUNKNOWNUPDATINGtarget
read-only
Quota
Last target specification of the quota
updated
read-only
stringdate-time
Last update date of the quota
400objectError 400 response
409objectError 409 response
Example uses projectId = string
$ curl https:/{ "checksum": "string", "createdAt": "2024-01-01T12:00:00Z", "currentState": { "availableProfiles": [ { "compute": { "cores": 0, "instances": 0, "memory": 0 }, "keyManager": { "containers": 0, "secrets": 0 }, "keypair": { "keypairs": 0 }, "loadbalancer": { "healthMonitors": 0, "l7Policies": 0, "l7Rules": 0, "listeners": 0, "loadbalancers": 0, "members": 0, "pools": 0 }, "name": "string", "network": { "floatingIps": 0, "gateways": 0, "networks": 0, "securityGroupRules": 0, "securityGroups": 0, "subnets": 0 }, "share": { "backupSizeTotal": 0, "backups": 0, "shares": 0, "sizeTotal": 0, "snapshots": 0 }, "volume": { "backupSizeTotal": 0, "backups": 0, "sizeTotal": 0, "snapshots": 0, "volumes": 0 } } ], "preventAutomaticQuotaUpgrade": true, "regions": [ { "location": { "availabilityZone": "string", "region": "string" }, "profile": "string", "usage": { "compute": { "cores": { "limit": null, "unit": null, "used": null }, "instances": { "limit": null, "unit": null, "used": null }, "memory": { "limit": null, "unit": null, "used": null } }, "keyManager": { "containers": { "limit": null, "unit": null, "used": null }, "secrets": { "limit": null, "unit": null, "used": null } }, "keypair": { "keypairs": { "limit": null, "unit": null, "used": null } }, "loadbalancer": { "healthMonitors": { "limit": null, "unit": null, "used": null }, "l7Policies": { "limit": null, "unit": null, "used": null }, "l7Rules": { "limit": null, "unit": null, "used": null }, "listeners": { "limit": null, "unit": null, "used": null }, "loadbalancers": { "limit": null, "unit": null, "used": null }, "members": { "limit": null, "unit": null, "used": null }, "pools": { "limit": null, "unit": null, "used": null } }, "network": { "floatingIps": { "limit": null, "unit": null, "used": null }, "gateways": { "limit": null, "unit": null, "used": null }, "networks": { "limit": null, "unit": null, "used": null }, "securityGroupRules": { "limit": null, "unit": null, "used": null }, "securityGroups": { "limit": null, "unit": null, "used": null }, "subnets": { "limit": null, "unit": null, "used": null } }, "share": { "backupSizeTotal": { "limit": null, "unit": null, "used": null }, "backups": { "limit": null, "unit": null, "used": null }, "perShareSize": { "limit": null, "unit": null }, "shareNetworks": { "limit": null, "unit": null, "used": null }, "shares": { "limit": null, "unit": null, "used": null }, "sizeTotal": { "limit": null, "unit": null, "used": null }, "snapshotSizeTotal": { "limit": null, "unit": null, "used": null }, "snapshots": { "limit": null, "unit": null, "used": null } }, "volume": { "backupSizeTotal": { "limit": null, "unit": null, "used": null }, "backups": { "limit": null, "unit": null, "used": null }, "perVolumeSize": { "limit": null, "unit": null }, "sizeTotal": { "limit": null, "unit": null, "used": null }, "snapshots": { "limit": null, "unit": null, "used": null }, "volumes": { "limit": null, "unit": null, "used": null } } } } ] }, "currentTasks": [ { "errors": [ { "message": "string" } ], "id": "00000000-0000-0000-0000-000000000000", "link": "string", "status": "ERROR", "type": "string" } ], "id": "string", "resourceStatus": "CREATING", "targetSpec": { "preventAutomaticQuotaUpgrade": true, "regions": [ { "location": { "availabilityZone": "string", "region": "string" }, "profile": "string" } ] }, "updatedAt": "2024-01-01T12:00:00Z"}
Update the project quotaProduction
PUT
/v2/
Updates the project quota region by region. Each region listed in targetSpec.regions is added or updated, and the regions you omit are left unchanged, so raising the quota of one region does not require restating the others. Unlike the other update routes of this API, this list is merged, not replaced. preventAutomaticQuotaUpgrade is required.
Path parameters
project
required
string
Project ID
Request body (required)
checksum
string
Optional concurrency-control checksum. When supplied, it must match the resource's current checksum or the request is rejected with a 409 checksum-mismatch conflict. When omitted or empty, the concurrency check is skipped and the write is forced (last-write-wins).
target
required
Quota
Update specification
Response
200Quotasuccessful operation
checksum
read-only
string
Computed hash representing the current target specification value
created
read-only
stringdate-time
Creation date of the quota
current
read-only
Quota
Current state of the quota
current
read-only
Current
Ongoing asynchronous tasks related to the quota
id
read-only
string
Project ID this quota belongs to
resource
read-only
Resource
Quota readiness in the system
Values
CREATINGCREATION_PLANNEDDELETINGERROROUT_OF_SYNCREADYSUSPENDEDUNKNOWNUPDATINGtarget
read-only
Quota
Last target specification of the quota
updated
read-only
stringdate-time
Last update date of the quota
400objectError 400 response
409objectError 409 response
Example uses projectId = string
$ curl https:/{ "checksum": "string", "createdAt": "2024-01-01T12:00:00Z", "currentState": { "availableProfiles": [ { "compute": { "cores": 0, "instances": 0, "memory": 0 }, "keyManager": { "containers": 0, "secrets": 0 }, "keypair": { "keypairs": 0 }, "loadbalancer": { "healthMonitors": 0, "l7Policies": 0, "l7Rules": 0, "listeners": 0, "loadbalancers": 0, "members": 0, "pools": 0 }, "name": "string", "network": { "floatingIps": 0, "gateways": 0, "networks": 0, "securityGroupRules": 0, "securityGroups": 0, "subnets": 0 }, "share": { "backupSizeTotal": 0, "backups": 0, "shares": 0, "sizeTotal": 0, "snapshots": 0 }, "volume": { "backupSizeTotal": 0, "backups": 0, "sizeTotal": 0, "snapshots": 0, "volumes": 0 } } ], "preventAutomaticQuotaUpgrade": true, "regions": [ { "location": { "availabilityZone": "string", "region": "string" }, "profile": "string", "usage": { "compute": { "cores": { "limit": null, "unit": null, "used": null }, "instances": { "limit": null, "unit": null, "used": null }, "memory": { "limit": null, "unit": null, "used": null } }, "keyManager": { "containers": { "limit": null, "unit": null, "used": null }, "secrets": { "limit": null, "unit": null, "used": null } }, "keypair": { "keypairs": { "limit": null, "unit": null, "used": null } }, "loadbalancer": { "healthMonitors": { "limit": null, "unit": null, "used": null }, "l7Policies": { "limit": null, "unit": null, "used": null }, "l7Rules": { "limit": null, "unit": null, "used": null }, "listeners": { "limit": null, "unit": null, "used": null }, "loadbalancers": { "limit": null, "unit": null, "used": null }, "members": { "limit": null, "unit": null, "used": null }, "pools": { "limit": null, "unit": null, "used": null } }, "network": { "floatingIps": { "limit": null, "unit": null, "used": null }, "gateways": { "limit": null, "unit": null, "used": null }, "networks": { "limit": null, "unit": null, "used": null }, "securityGroupRules": { "limit": null, "unit": null, "used": null }, "securityGroups": { "limit": null, "unit": null, "used": null }, "subnets": { "limit": null, "unit": null, "used": null } }, "share": { "backupSizeTotal": { "limit": null, "unit": null, "used": null }, "backups": { "limit": null, "unit": null, "used": null }, "perShareSize": { "limit": null, "unit": null }, "shareNetworks": { "limit": null, "unit": null, "used": null }, "shares": { "limit": null, "unit": null, "used": null }, "sizeTotal": { "limit": null, "unit": null, "used": null }, "snapshotSizeTotal": { "limit": null, "unit": null, "used": null }, "snapshots": { "limit": null, "unit": null, "used": null } }, "volume": { "backupSizeTotal": { "limit": null, "unit": null, "used": null }, "backups": { "limit": null, "unit": null, "used": null }, "perVolumeSize": { "limit": null, "unit": null }, "sizeTotal": { "limit": null, "unit": null, "used": null }, "snapshots": { "limit": null, "unit": null, "used": null }, "volumes": { "limit": null, "unit": null, "used": null } } } } ] }, "currentTasks": [ { "errors": [ { "message": "string" } ], "id": "00000000-0000-0000-0000-000000000000", "link": "string", "status": "ERROR", "type": "string" } ], "id": "string", "resourceStatus": "CREATING", "targetSpec": { "preventAutomaticQuotaUpgrade": true, "regions": [ { "location": { "availabilityZone": "string", "region": "string" }, "profile": "string" } ] }, "updatedAt": "2024-01-01T12:00:00Z"}