Services API

Creating a Service (deprecated)

POST /v2/services

Request

Route

POST /v2/services

Body

Name	Description	Default	Valid Values	Example Values
guid	The guid of the service
label	The name of the service			SomeMysqlService
description	A short blurb describing the service			Mysql stores things for you
long_description	A longer description of the service			Mysql is a database. It stores things. Use it in your apps...
info_url	A url that points to an info page for the service			http://info.somemysqlservice.com
documentation_url	A url that points to a documentation page for the service			http://docs.somemysqlservice.com
timeout	A timeout used by the v1 service gateway client
active	A boolean describing that the service can be provisioned by users	false
bindable	A boolean describing that the service can be bound to applications	true
extra	A JSON field with extra data pertaining to the service			{"providerDisplayName": "MyServiceProvider"}
unique_id	A guid that identifies the service with the broker (not the same as the guid above)
tags	A list of tags for the service	[]		database mysql
requires	A list of dependencies for services	[]		syslog_drain
provider	The name of the service provider (used only by v1 service gateways)			MySql Provider
version	The version of the service (used only by v1 service gateways)			2.0
url	The url of ther service provider (used only by v1 service gateways)			http://myql.provider.com
service_broker_guid	The guid of the v2 service broker associated with the service
plan_updateable	A boolean describing that an instance of this service can be updated to a different plan	false

{
  "label": "SomeMysqlService",
  "description": "Mysql stores things for you",
  "provider": "MySql Provider",
  "version": "2.0",
  "url": "http://myql.provider.com"
}

Headers

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTQyNCIsImVtYWlsIjoiZW1haWwtMzE0QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0Mzg2NDE4MTV9.9aPL8pxBfJuz3ycqh_omsuFyXpSUGPqxYRJkdnCpBIk
Host: example.org
Content-Type: application/x-www-form-urlencoded
Cookie: 

cURL

curl "https://api.[your-domain.com]/v2/services" -d '{
  "label": "SomeMysqlService",
  "description": "Mysql stores things for you",
  "provider": "MySql Provider",
  "version": "2.0",
  "url": "http://myql.provider.com"
}' -X POST \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTQyNCIsImVtYWlsIjoiZW1haWwtMzE0QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0Mzg2NDE4MTV9.9aPL8pxBfJuz3ycqh_omsuFyXpSUGPqxYRJkdnCpBIk" \
	-H "Host: example.org" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-H "Cookie: "

Response

Status

201 Created

Body

{
  "metadata": {
    "guid": "e9c877d4-6a22-40cf-92f4-27166ba9d178",
    "url": "/v2/services/e9c877d4-6a22-40cf-92f4-27166ba9d178",
    "created_at": "2015-07-27T22:43:35Z",
    "updated_at": null
  },
  "entity": {
    "label": "SomeMysqlService",
    "provider": "MySql Provider",
    "url": "http://myql.provider.com",
    "description": "Mysql stores things for you",
    "long_description": null,
    "version": "2.0",
    "info_url": null,
    "active": false,
    "bindable": true,
    "unique_id": null,
    "extra": null,
    "tags": [

    ],
    "requires": [

    ],
    "documentation_url": null,
    "service_broker_guid": null,
    "plan_updateable": false,
    "service_plans_url": "/v2/services/e9c877d4-6a22-40cf-92f4-27166ba9d178/service_plans"
  }
}

Headers

Content-Type: application/json;charset=utf-8
Location: /v2/services/e9c877d4-6a22-40cf-92f4-27166ba9d178
X-VCAP-Request-ID: 18b124aa-c0cb-4429-8a9f-a4980325c003
Content-Length: 771
X-Content-Type-Options: nosniff