Stage a package
POST /v3/packages/:guid/droplets
Request
Route
POST /v3/packages/guid-4f87b655-db44-44e3-a920-aa4d9a99eda5/droplets
Parameters
| Name |
Description |
Valid Values |
Example Values |
|
buildpack_guid
|
Admin buildpack used to stage the package (cannot be used with buildpack_git_url)
|
|
|
|
buildpack_git_url
|
Git url of a buildpack used to stage the package (cannot be used with buildpack_guid)
|
|
|
|
staging_environment_variables
|
Environment variables to use during staging
|
|
|
|
stack
|
Stack used to stage package
|
|
|
|
memory_limit
|
Memory limit used to stage package
|
|
|
|
disk_limit
|
Disk limit used to stage package
|
|
|
Body
| Name |
Description |
Default |
Valid Values |
Example Values |
{
"buildpack_git_url": "http://github.com/myorg/awesome-buildpack",
"stack": "trusty64"
}
Headers
cURL
curl "https://api.[your-domain.com]/v3/packages/guid-4f87b655-db44-44e3-a920-aa4d9a99eda5/droplets" -d '{
"buildpack_git_url": "http://github.com/myorg/awesome-buildpack",
"stack": "trusty64"
}' -X POST \
-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTIxNSIsImVtYWlsIjoiZW1haWwtMTY0QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5yZWFkIiwiY2xvdWRfY29udHJvbGxlci53cml0ZSJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0MzUxMDI4NTR9.Q28gYUi7vfrWAs2-OpWAcAIFcQYr7Civmo_MgEcjcuo" \
-H "Host: example.org" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Cookie: "
Response
Status
201 Created
Body
{
"guid": "whatuuid",
"state": "PENDING",
"hash": null,
"buildpack_git_url": "http://github.com/myorg/awesome-buildpack",
"failure_reason": null,
"detected_start_command": null,
"procfile": null,
"environment_variables": {
"VCAP_APPLICATION": {
"limits": {
"mem": 1024,
"disk": 4096,
"fds": 16384
},
"application_version": "whatuuid",
"application_name": "name-815",
"application_uris": [
],
"version": "whatuuid",
"name": "name-815",
"space_name": "name-812",
"space_id": "42c84b02-07ce-47a9-adf2-afef6f26a113",
"uris": [
],
"users": null
},
"CF_STACK": "trusty64"
},
"created_at": "2015-06-16T23:40:54Z",
"updated_at": null,
"_links": {
"self": {
"href": "/v3/droplets/whatuuid"
},
"package": {
"href": "/v3/packages/guid-4f87b655-db44-44e3-a920-aa4d9a99eda5"
},
"app": {
"href": "/v3/apps/guid-3844c320-d8af-4019-ac27-5d0c6037516f"
}
}
}
Headers