Apps API

Creating a Docker App (experimental)

POST /v2/apps/

Fields

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-cd414b0a-ff08-4ac5-b059-484913da74d2
stack_guid	The guid of the associated stack.	Uses the default system stack.
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 (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_timeout	Timeout for health checking of an staged app when starting up
docker_image	Name of the Docker image containing the app			cloudfoundry/helloworld registry.example.com:5000/user/repository/tag
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
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-a03d7e13-ccf2-4bd0-b3a8-a4c9b036b77a
stack_guid	The guid of the associated stack.	Uses the default system stack.
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 (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_timeout	Timeout for health checking of an staged app when starting up
docker_image	Name of the Docker image containing the app			cloudfoundry/helloworld registry.example.com:5000/user/repository/tag
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

Request

Headers

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

Route

POST /v2/apps

Body

{
  "name": "docker_app",
  "memory": 1024,
  "instances": 2,
  "disk_quota": 1204,
  "space_guid": "88fba81d-f4ca-4ad8-807d-54449f651f59",
  "docker_image": "cloudfoundry/hello",
  "environment_json": {
    "DIEGO_STAGE_BETA": "true",
    "DIEGO_RUN_BETA": "true"
  }
}

cURL

curl "https://api.[your-domain.com]/v2/apps" -d '{
  "name": "docker_app",
  "memory": 1024,
  "instances": 2,
  "disk_quota": 1204,
  "space_guid": "88fba81d-f4ca-4ad8-807d-54449f651f59",
  "docker_image": "cloudfoundry/hello",
  "environment_json": {
    "DIEGO_STAGE_BETA": "true",
    "DIEGO_RUN_BETA": "true"
  }
}' -X POST \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTI3MiIsImVtYWlsIjoiZW1haWwtMTk3QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0MTY1MjY3MTB9.ARxsnz2Ah5f3b5E1dRgRWn32PuywbMSbp68DP6RLS0w" \
	-H "Host: example.org" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-H "Cookie: "

Response

Headers

Content-Type: application/json;charset=utf-8
Location: /v2/apps/5212bf57-7c10-43ea-81c9-b52e89c0da9e
X-VCAP-Request-ID: 24739acb-ca2f-4c90-8147-1a4fd58b56b7
Content-Length: 1394
X-Content-Type-Options: nosniff

Status

201 Created

Body

{
  "metadata": {
    "guid": "5212bf57-7c10-43ea-81c9-b52e89c0da9e",
    "url": "/v2/apps/5212bf57-7c10-43ea-81c9-b52e89c0da9e",
    "created_at": "2014-11-13T23:38:30+00:00",
    "updated_at": null
  },
  "entity": {
    "name": "docker_app",
    "production": false,
    "space_guid": "88fba81d-f4ca-4ad8-807d-54449f651f59",
    "stack_guid": "8d050664-9576-4e4a-954c-c33e059f234b",
    "buildpack": null,
    "detected_buildpack": null,
    "environment_json": {
      "DIEGO_STAGE_BETA": "true",
      "DIEGO_RUN_BETA": "true"
    },
    "memory": 1024,
    "instances": 2,
    "disk_quota": 1204,
    "state": "STOPPED",
    "version": "e23accb2-ab63-4d9c-ba70-d9c8aa2afe4c",
    "command": null,
    "console": false,
    "debug": null,
    "staging_task_id": null,
    "package_state": "PENDING",
    "health_check_timeout": null,
    "staging_failed_reason": null,
    "docker_image": "cloudfoundry/hello:latest",
    "package_updated_at": "2014-11-13T23:38:30+00:00",
    "detected_start_command": "",
    "space_url": "/v2/spaces/88fba81d-f4ca-4ad8-807d-54449f651f59",
    "stack_url": "/v2/stacks/8d050664-9576-4e4a-954c-c33e059f234b",
    "events_url": "/v2/apps/5212bf57-7c10-43ea-81c9-b52e89c0da9e/events",
    "service_bindings_url": "/v2/apps/5212bf57-7c10-43ea-81c9-b52e89c0da9e/service_bindings",
    "routes_url": "/v2/apps/5212bf57-7c10-43ea-81c9-b52e89c0da9e/routes"
  }
}

Audit Records Created By The Request

Audit Record: audit.app.create

Attribute Name	Value
id	16
guid	0ba06805-02c8-47ec-a235-46273ad67dd4
created_at	2014-11-13 23:38:30 +0000
updated_at
timestamp	2014-11-13 23:38:30 +0000
type	audit.app.create
actor	uaa-id-272
actor_type	user
actee	5212bf57-7c10-43ea-81c9-b52e89c0da9e
actee_type	app
metadata	{ "request": { "name": "docker_app", "memory": 1024, "instances": 2, "disk_quota": 1204, "space_guid": "88fba81d-f4ca-4ad8-807d-54449f651f59", "docker_image": "cloudfoundry/hello", "environment_json": "PRIVATE DATA HIDDEN", "console": false, "production": false, "state": "STOPPED" } }
space_id	100
organization_guid	2ee24413-4066-441f-9751-e5a91cd3be0c
space_guid	88fba81d-f4ca-4ad8-807d-54449f651f59
actor_name	email-197@somedomain.com
actee_name	docker_app