Home
Version 3
Space Quota Definitions API

Space Quota Definitions API

Updating a Space Quota Definition

PUT /v2/space_quota_definitions/:guid

Request

Route

PUT /v2/space_quota_definitions/b1c385f6-3318-426d-a9ae-f5c099a94d8e

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 non basic services
  • 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) 0
  • -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-e7aa0cf1-ac2c-428f-af2d-98e6afc02bf6
app_task_limit The number of tasks that can be run per app. (-1 represents an unlimited amount) 5
  • -1
  • 5
  • 10
{
  "name": "new_name"
}

Headers

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTEyMCIsImVtYWlsIjoiZW1haWwtODhAc29tZWRvbWFpbi5jb20iLCJzY29wZSI6WyJjbG91ZF9jb250cm9sbGVyLmFkbWluIl0sImF1ZCI6WyJjbG91ZF9jb250cm9sbGVyIl0sImV4cCI6MTQ2MTk1ODM5Nn0.rB6C_RVzI_lumeMZLaLMtPtUzMQkSUI48S-O6TPX5Io
Host: example.org
Content-Type: application/x-www-form-urlencoded
Cookie: 

cURL

curl "https://api.[your-domain.com]/v2/space_quota_definitions/b1c385f6-3318-426d-a9ae-f5c099a94d8e" -d '{
  "name": "new_name"
}' -X PUT \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTEyMCIsImVtYWlsIjoiZW1haWwtODhAc29tZWRvbWFpbi5jb20iLCJzY29wZSI6WyJjbG91ZF9jb250cm9sbGVyLmFkbWluIl0sImF1ZCI6WyJjbG91ZF9jb250cm9sbGVyIl0sImV4cCI6MTQ2MTk1ODM5Nn0.rB6C_RVzI_lumeMZLaLMtPtUzMQkSUI48S-O6TPX5Io" \
	-H "Host: example.org" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-H "Cookie: "

Response

Status

201 Created

Body

{
  "metadata": {
    "guid": "b1c385f6-3318-426d-a9ae-f5c099a94d8e",
    "url": "/v2/space_quota_definitions/b1c385f6-3318-426d-a9ae-f5c099a94d8e",
    "created_at": "2016-04-22T19:33:16Z",
    "updated_at": "2016-04-22T19:33:16Z"
  },
  "entity": {
    "name": "new_name",
    "organization_guid": "e573f0b5-b28f-40a7-a21e-85ed2afedaf0",
    "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/e573f0b5-b28f-40a7-a21e-85ed2afedaf0",
    "spaces_url": "/v2/space_quota_definitions/b1c385f6-3318-426d-a9ae-f5c099a94d8e/spaces"
  }
}

Headers

Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: 0cab437e-3cc6-4982-a7dc-41f412f667b0
Content-Length: 795
X-Content-Type-Options: nosniff