Apps API

Creating a Docker App (experimental)

POST /v2/apps/

Request

Route

POST /v2/apps

Body

Name	Description	Default	Valid Values	Example Values
name	The name of the app.			my_super_app
memory	The amount of memory each instance should have. In megabytes.			1024 512
instances	The number of instances of the app to run. To ensure optimal availability, ensure there are at least 2 instances.			2 6 10
disk_quota	The maximum amount of disk available to an instance of an app. In megabytes.			1204 2048
space_guid	The guid of the associated space.			guid-5b2d71f2-e68b-4e62-92ab-e9d79f9410a6
stack_guid	The guid of the associated stack.	Uses the default system stack.		guid-91ec9be0-c1dc-4054-97a4-e5f0f16c07e3
state	The current desired state of the app. One of STOPPED or STARTED.	STOPPED	STOPPED STARTED
detected_start_command	The command detected by the buildpack during staging.
command	The command to start an app after it is staged, maximum length: 4096 (e.g. 'rails s -p $PORT' or 'java com.org.Server $PORT').
buildpack	Buildpack to build the app. 3 options: a) Blank means autodetection; b) A Git Url pointing to a buildpack; c) Name of an installed buildpack.			https://github.com/virtualstaticvoid/heroku-buildpack-r.git an_example_installed_buildpack
health_check_type	Type of health check to perform.	port	port none
health_check_timeout	Timeout for health checking of an staged app when starting up
diego	Use diego to stage and to run when available	false	true false
docker_image	Name of the Docker image containing the app			cloudfoundry/helloworld registry.example.com:5000/user/repository/tag
docker_credentials_json	Docker credentials for pulling docker image.	{}		#<RspecApiDocumentation::Views::HtmlExample:0x0000000b7c7f58>
environment_json	Key/value pairs of all the environment variables to run in your app. Does not include any system or service variables.
production	Deprecated.	true	true false
console	Open the console port for the app (at $CONSOLE_PORT).	false	true false
debug	Open the debug port for the app (at $DEBUG_PORT).	false	true false
staging_failed_reason	Reason for application staging failures
staging_failed_description	Detailed description for the staging_failed_reason
name	The name of the app.			my_super_app
memory	The amount of memory each instance should have. In megabytes.			1024 512
instances	The number of instances of the app to run. To ensure optimal availability, ensure there are at least 2 instances.			2 6 10
disk_quota	The maximum amount of disk available to an instance of an app. In megabytes.			1204 2048
space_guid	The guid of the associated space.			guid-1b3d3f25-3372-4f90-8c15-e70df23fa288
stack_guid	The guid of the associated stack.	Uses the default system stack.		guid-ea26e286-ed64-492f-b5f9-2fece8de03c2
state	The current desired state of the app. One of STOPPED or STARTED.	STOPPED	STOPPED STARTED
detected_start_command	The command detected by the buildpack during staging.
command	The command to start an app after it is staged, maximum length: 4096 (e.g. 'rails s -p $PORT' or 'java com.org.Server $PORT').
buildpack	Buildpack to build the app. 3 options: a) Blank means autodetection; b) A Git Url pointing to a buildpack; c) Name of an installed buildpack.			https://github.com/virtualstaticvoid/heroku-buildpack-r.git an_example_installed_buildpack
health_check_type	Type of health check to perform.	port	port none
health_check_timeout	Timeout for health checking of an staged app when starting up
diego	Use diego to stage and to run when available	false	true false
docker_image	Name of the Docker image containing the app			cloudfoundry/helloworld registry.example.com:5000/user/repository/tag
docker_credentials_json	Docker credentials for pulling docker image.	{}		#<RspecApiDocumentation::Views::HtmlExample:0x0000000b7c7f58>
environment_json	Key/value pairs of all the environment variables to run in your app. Does not include any system or service variables.
production	Deprecated.	true	true false
console	Open the console port for the app (at $CONSOLE_PORT).	false	true false
debug	Open the debug port for the app (at $DEBUG_PORT).	false	true false
staging_failed_reason	Reason for application staging failures
staging_failed_description	Detailed description for the staging_failed_reason

{
  "name": "docker_app",
  "space_guid": "18d7fa29-3912-4eb3-b2fd-41660777c6e4",
  "docker_image": "cloudfoundry/hello",
  "diego": true
}

Headers

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTM5OSIsImVtYWlsIjoiZW1haWwtMjY3QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0NDQyNjA2NTd9._G3FKPHm1x7Rv8Ray7d2MX3pUNMquN7EGhD90o_1g94
Host: example.org
Content-Type: application/x-www-form-urlencoded
Cookie:

cURL

curl "https://api.[your-domain.com]/v2/apps" -d '{
  "name": "docker_app",
  "space_guid": "18d7fa29-3912-4eb3-b2fd-41660777c6e4",
  "docker_image": "cloudfoundry/hello",
  "diego": true
}' -X POST \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTM5OSIsImVtYWlsIjoiZW1haWwtMjY3QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0NDQyNjA2NTd9._G3FKPHm1x7Rv8Ray7d2MX3pUNMquN7EGhD90o_1g94" \
	-H "Host: example.org" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-H "Cookie: "

Response

Status

201 Created

Body

{
  "metadata": {
    "guid": "493eab9a-94f8-4e04-8ac8-4863324f9f17",
    "url": "/v2/apps/493eab9a-94f8-4e04-8ac8-4863324f9f17",
    "created_at": "2015-09-30T23:30:57Z",
    "updated_at": null
  },
  "entity": {
    "name": "docker_app",
    "production": false,
    "space_guid": "18d7fa29-3912-4eb3-b2fd-41660777c6e4",
    "stack_guid": "f437c627-cc39-4e9b-8848-e2d26478850c",
    "buildpack": null,
    "detected_buildpack": null,
    "environment_json": {

    },
    "memory": 1024,
    "instances": 1,
    "disk_quota": 1024,
    "state": "STOPPED",
    "version": "0e0d10f0-079b-4b46-9c2d-86f6c5a5128b",
    "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": true,
    "docker_image": "cloudfoundry/hello:latest",
    "package_updated_at": "2015-09-30T23:30:57Z",
    "detected_start_command": "",
    "enable_ssh": true,
    "docker_credentials_json": {
      "redacted_message": "[PRIVATE DATA HIDDEN]"
    },
    "space_url": "/v2/spaces/18d7fa29-3912-4eb3-b2fd-41660777c6e4",
    "stack_url": "/v2/stacks/f437c627-cc39-4e9b-8848-e2d26478850c",
    "events_url": "/v2/apps/493eab9a-94f8-4e04-8ac8-4863324f9f17/events",
    "service_bindings_url": "/v2/apps/493eab9a-94f8-4e04-8ac8-4863324f9f17/service_bindings",
    "routes_url": "/v2/apps/493eab9a-94f8-4e04-8ac8-4863324f9f17/routes"
  }
}

Headers

Content-Type: application/json;charset=utf-8
Location: /v2/apps/493eab9a-94f8-4e04-8ac8-4863324f9f17
X-VCAP-Request-ID: 75295ca7-6348-441a-8c64-fa4a76615535
Content-Length: 1526
X-Content-Type-Options: nosniff

Audit Records Created By The Request

Audit Record: audit.app.create

Attribute Name	Value
id	10
guid	154bd9b5-8456-4516-9675-5a8e90a3c71f
created_at	2015-09-30 23:30:57 UTC
updated_at
timestamp	2015-09-30 23:30:57 UTC
type	audit.app.create
actor	uaa-id-399
actor_type	user
actee	493eab9a-94f8-4e04-8ac8-4863324f9f17
actee_type	app
metadata	{ "request": { "name": "docker_app", "space_guid": "18d7fa29-3912-4eb3-b2fd-41660777c6e4", "docker_image": "cloudfoundry/hello", "diego": true, "console": false, "docker_credentials_json": "PRIVATE DATA HIDDEN", "environment_json": "PRIVATE DATA HIDDEN", "health_check_type": "port", "instances": 1, "production": false, "state": "STOPPED" } }
space_id
organization_guid	4c765e0f-fd0c-4be4-8f13-f5608a5a3f5b
space_guid	18d7fa29-3912-4eb3-b2fd-41660777c6e4
actor_name	email-267@somedomain.com
actee_name	docker_app