Space Quota Definitions API

Updating a Space Quota Definition

PUT /v2/space_quota_definitions/:guid

Request

Route

PUT /v2/space_quota_definitions/bbd837ac-309d-4f53-9d49-67cb75364904

Parameters

Name Description Valid Values Example Values
guid The guid of the Space Quota Definition

Body

Name Description Default Valid Values Example Values
name The name for the Space Quota Definition.
  • gold_quota
non_basic_services_allowed If a space can have services that are not free
  • true
  • false
total_services How many services a space can have. (-1 represents an unlimited amount)
  • -1
  • 5
  • 201
total_routes How many routes a space can have. (-1 represents an unlimited amount)
  • -1
  • 10
  • 23
total_reserved_route_ports How many routes a space can have that use a reserved port. These routes count toward total_routes. (-1 represents an unlimited amount; subject to org quota) -1
  • -1
  • 10
  • 20
memory_limit How much memory in megabytes a space can have.
  • 5120
  • 10024
total_service_keys How many service keys an organization can have. (-1 represents an unlimited amount) -1
  • -1
  • 5
  • 201
instance_memory_limit The maximum amount of memory in megabytes an application instance can have. (-1 represents an unlimited amount) -1
  • -1
  • 10024
app_instance_limit How many app instances a space can create. (-1 represents an unlimited amount) -1
  • -1
  • 10
  • 23
organization_guid The owning organization of the space quota
  • guid-76569616-94e2-45c0-a32b-aedab94ecf4d
app_task_limit Maximum number of running tasks in a space. (-1 represents an unlimited amount) 5
  • -1
  • 5
  • 10
 
{
  "name": "new_name"
}

Headers

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTE0MCIsImVtYWlsIjoiZW1haWwtOTVAc29tZWRvbWFpbi5jb20iLCJzY29wZSI6WyJjbG91ZF9jb250cm9sbGVyLmFkbWluIl0sImF1ZCI6WyJjbG91ZF9jb250cm9sbGVyIl0sImV4cCI6MTQ2NjAwODg4OX0._R3GzJIE9JnhsViYuXjg3o1LCQCPGCgquOo2iBlOQaw
Host: example.org
Content-Type: application/json
Cookie:

cURL

curl "https://api.[your-domain.com]/v2/space_quota_definitions/bbd837ac-309d-4f53-9d49-67cb75364904" -d '{
  "name": "new_name"
}' -X PUT \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTE0MCIsImVtYWlsIjoiZW1haWwtOTVAc29tZWRvbWFpbi5jb20iLCJzY29wZSI6WyJjbG91ZF9jb250cm9sbGVyLmFkbWluIl0sImF1ZCI6WyJjbG91ZF9jb250cm9sbGVyIl0sImV4cCI6MTQ2NjAwODg4OX0._R3GzJIE9JnhsViYuXjg3o1LCQCPGCgquOo2iBlOQaw" \
	-H "Host: example.org" \
	-H "Content-Type: application/json" \
	-H "Cookie: "

Response

Status

201 Created

Body

{
  "metadata": {
    "guid": "bbd837ac-309d-4f53-9d49-67cb75364904",
    "url": "/v2/space_quota_definitions/bbd837ac-309d-4f53-9d49-67cb75364904",
    "created_at": "2016-06-08T16:41:29Z",
    "updated_at": "2016-06-08T16:41:29Z"
  },
  "entity": {
    "name": "new_name",
    "organization_guid": "dbd76462-6fec-4add-aaca-35b2ca7493bb",
    "non_basic_services_allowed": true,
    "total_services": 60,
    "total_routes": 1000,
    "memory_limit": 20480,
    "instance_memory_limit": -1,
    "app_instance_limit": -1,
    "app_task_limit": 5,
    "total_service_keys": 600,
    "total_reserved_route_ports": -1,
    "organization_url": "/v2/organizations/dbd76462-6fec-4add-aaca-35b2ca7493bb",
    "spaces_url": "/v2/space_quota_definitions/bbd837ac-309d-4f53-9d49-67cb75364904/spaces"
  }
}

Headers

Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: 6488fbd0-0f3d-40a9-b647-203ba64bdcc2
Content-Length: 795
X-Content-Type-Options: nosniff