Spaces API

Get Space summary

GET /v2/spaces/:guid/summary

Request

Route

GET /v2/spaces/50ae42f6-346d-4eca-9e97-f8c9e04d5fbe/summary

Body

Name Description Default Valid Values Example Values
guid The guid of the space for which summary is requested
name The name of the space.
apps List of apps that are running in the space
services List of services that are associated with the space

Headers

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTEyOCIsImVtYWlsIjoiZW1haWwtODNAc29tZWRvbWFpbi5jb20iLCJzY29wZSI6WyJjbG91ZF9jb250cm9sbGVyLmFkbWluIl0sImF1ZCI6WyJjbG91ZF9jb250cm9sbGVyIl0sImV4cCI6MTQ2NjAwODg4OH0.lUdlvxq8sZh6ctfGKKGZ75WBX-YptFgd2D4ln9LIte8
Host: example.org
Cookie: 

cURL

curl "https://api.[your-domain.com]/v2/spaces/50ae42f6-346d-4eca-9e97-f8c9e04d5fbe/summary" -X GET \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTEyOCIsImVtYWlsIjoiZW1haWwtODNAc29tZWRvbWFpbi5jb20iLCJzY29wZSI6WyJjbG91ZF9jb250cm9sbGVyLmFkbWluIl0sImF1ZCI6WyJjbG91ZF9jb250cm9sbGVyIl0sImV4cCI6MTQ2NjAwODg4OH0.lUdlvxq8sZh6ctfGKKGZ75WBX-YptFgd2D4ln9LIte8" \
	-H "Host: example.org" \
	-H "Cookie: "

Response

Status

200 OK

Body

{
  "guid": "50ae42f6-346d-4eca-9e97-f8c9e04d5fbe",
  "name": "name-1382",
  "apps": [
    {
      "guid": "c49aac23-e26c-4564-ba1a-0b0bdcff1387",
      "urls": [
        "host-7.domain-7.example.com"
      ],
      "routes": [
        {
          "guid": "9b593acf-f617-4713-b9cf-c959aa2e3276",
          "host": "host-7",
          "port": null,
          "path": "",
          "domain": {
            "guid": "97b03bcb-db5d-4923-8b02-662c490fc2ac",
            "name": "domain-7.example.com"
          }
        }
      ],
      "service_count": 1,
      "service_names": [
        "name-1385"
      ],
      "running_instances": 0,
      "name": "name-1388",
      "production": false,
      "space_guid": "50ae42f6-346d-4eca-9e97-f8c9e04d5fbe",
      "stack_guid": "8d4152c3-d2bb-44ac-9036-b2a8c95f24ef",
      "buildpack": null,
      "detected_buildpack": null,
      "detected_buildpack_guid": null,
      "environment_json": null,
      "memory": 1024,
      "instances": 1,
      "disk_quota": 1024,
      "state": "STOPPED",
      "version": "a93316d0-dcd0-43c2-9569-624af35a61bd",
      "command": null,
      "console": false,
      "debug": null,
      "staging_task_id": null,
      "package_state": "PENDING",
      "health_check_type": "port",
      "health_check_timeout": null,
      "staging_failed_reason": null,
      "staging_failed_description": null,
      "diego": false,
      "docker_image": null,
      "docker_credentials": {
        "username": null,
        "password": null
      },
      "package_updated_at": "2016-06-08T16:41:28Z",
      "detected_start_command": "",
      "enable_ssh": true,
      "ports": null
    }
  ],
  "services": [
    {
      "guid": "5cf08d8b-848c-4f27-bd92-8080fa021783",
      "name": "name-1385",
      "bound_app_count": 1,
      "shared_from": {
        "space_guid": "c4861ea6-fc27-4a20-ad21-461743ce8921",
        "space_name": "source-space",
        "organization_name": "source-org"
      },
      "shared_to": [],
      "last_operation": {
        "type": "create",
        "state": "succeeded",
        "description": "description goes here",
        "updated_at": "2016-06-08T16:41:28Z",
        "created_at": "2016-06-08T16:41:28Z"
      },
      "dashboard_url": null,
      "service_broker_name": "broker-name",
      "maintenance_info": {
        "version": "1.0.0",
        "description": "OS image update.\nExpect downtime."
      },
      "service_plan": {
        "guid": "0f8ad3ee-ca65-4849-ae52-d6539392fae2",
        "name": "name-1386",
        "maintenance_info": {
          "version": "2.0.0",
          "description": "Stemcell update.\nExpect downtime."
        },
        "service": {
          "guid": "17752c54-ac25-46fb-9989-3f69017d0dbe",
          "label": "label-27",
          "provider": null,
          "version": null
        }
      }
    }
  ]
}

Headers

Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: 7c9f5169-fbc5-458d-92cc-6d1b2be486b1
Content-Length: 2320
X-Content-Type-Options: nosniff