Environments API


Boot an environment from a blueprint

POST /environments/:environment/boot

Parameters

cluster_configuration
required: true
Hash of cluster configuration options.
configuration
required: true
Hash of specific configuration options.
type
required: true
scope: cluster_configuration
Type of configuration to boot. Valid values are solo, cluster, production, custom.
apps
required: false
scope: cluster_configuration
Hash containing information about the app instances
count
required: false
scope: apps
Number of app instances to provision
flavor
required: false
scope: apps
default: m3.medium
Flavor of the app instances
volume_size
required: false
scope: apps
Size of the app instance /data volumes
mnt_volume_size
required: false
scope: apps
Size of the app instance /mnt volume
dedicated
required: false
scope: apps
Should the app instances have dedicated tenancy
db_master
required: false
scope: cluster_configuration
Configuration for the db_master
flavor
required: false
scope: db_master
default: m3.medium
Flavor for the database master
volume_size
required: false
scope: db_master
Size of the databases /db volume
mnt_volume_size
required: false
scope: db_master
Size of the databases /mnt volume
iops
required: false
scope: db_master
Provisioned IOPS for the database servers
dedicated
required: false
scope: db_master
Should the master have dedicated tenancy
db_slaves
required: false
scope: cluster_configuration
Array containing configuration information for the database slaves
name
required: false
scope: db_slaves
Name of the replica
flavor
required: false
scope: db_slaves
default: m3.medium
Flavor for the replica
dedicated
required: false
scope: db_slaves
Should the replica have dedicated tenancy
utils
required: false
scope: cluster_configuration
Array containing configuration information for util instances
name
required: false
scope: utils
Name of the utility instance
flavor
required: false
scope: utils
Flavor of the utility instance
volume_size
required: false
scope: utils
Size of the /data volume of the utility instance
mnt_volume_size
required: false
scope: utils
Size of the /mnt volume of the utility instance
iops
required: false
scope: utils
Provisioned IOPS for the utility instance
dedicated
required: false
scope: utils
Should the util instance have dedicated tenancy

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
            "cluster_configuration": {
              "blueprint_id": "6f6b0a33-c2f6-40f6-94e7-81dbb322722c"
            }
          }
            
          

Response

          Status: 200 OK
          Content-Type: 
          
            
          {
          }
            
          








Boot an environment from a blueprint with an IP specified

POST /environments/:environment/boot

This example uses a specific 'ip_id' (an actual ID), but 'host' is also a valid option is you want to use public hostname (no IP)

Parameters

cluster_configuration
required: true
Hash of cluster configuration options.
configuration
required: true
Hash of specific configuration options.
type
required: true
scope: cluster_configuration
Type of configuration to boot. Valid values are solo, cluster, production, custom.
apps
required: false
scope: cluster_configuration
Hash containing information about the app instances
count
required: false
scope: apps
Number of app instances to provision
flavor
required: false
scope: apps
default: m3.medium
Flavor of the app instances
volume_size
required: false
scope: apps
Size of the app instance /data volumes
mnt_volume_size
required: false
scope: apps
Size of the app instance /mnt volume
dedicated
required: false
scope: apps
Should the app instances have dedicated tenancy
db_master
required: false
scope: cluster_configuration
Configuration for the db_master
flavor
required: false
scope: db_master
default: m3.medium
Flavor for the database master
volume_size
required: false
scope: db_master
Size of the databases /db volume
mnt_volume_size
required: false
scope: db_master
Size of the databases /mnt volume
iops
required: false
scope: db_master
Provisioned IOPS for the database servers
dedicated
required: false
scope: db_master
Should the master have dedicated tenancy
db_slaves
required: false
scope: cluster_configuration
Array containing configuration information for the database slaves
name
required: false
scope: db_slaves
Name of the replica
flavor
required: false
scope: db_slaves
default: m3.medium
Flavor for the replica
dedicated
required: false
scope: db_slaves
Should the replica have dedicated tenancy
utils
required: false
scope: cluster_configuration
Array containing configuration information for util instances
name
required: false
scope: utils
Name of the utility instance
flavor
required: false
scope: utils
Flavor of the utility instance
volume_size
required: false
scope: utils
Size of the /data volume of the utility instance
mnt_volume_size
required: false
scope: utils
Size of the /mnt volume of the utility instance
iops
required: false
scope: utils
Provisioned IOPS for the utility instance
dedicated
required: false
scope: utils
Should the util instance have dedicated tenancy

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
            "cluster_configuration": {
              "blueprint_id": "e16fc3e9-26c2-40c2-9876-2b1a9df5d5d0",
              "ip_id": 1
            }
          }
            
          

Response

          Status: 200 OK
          Content-Type: 
          
            
          {
          }
            
          








Boot an environment with a custom configuration

POST /environments/:environment/boot

This is the equivalent of selecting the 'Custom Configuration' option in the UI when booting an environment

Parameters

cluster_configuration
required: true
Hash of cluster configuration options.
configuration
required: true
Hash of specific configuration options.
type
required: true
scope: cluster_configuration
Type of configuration to boot. Valid values are solo, cluster, production, custom.
apps
required: false
scope: cluster_configuration
Hash containing information about the app instances
count
required: false
scope: apps
Number of app instances to provision
flavor
required: false
scope: apps
default: m3.medium
Flavor of the app instances
volume_size
required: false
scope: apps
Size of the app instance /data volumes
mnt_volume_size
required: false
scope: apps
Size of the app instance /mnt volume
dedicated
required: false
scope: apps
Should the app instances have dedicated tenancy
db_master
required: false
scope: cluster_configuration
Configuration for the db_master
flavor
required: false
scope: db_master
default: m3.medium
Flavor for the database master
volume_size
required: false
scope: db_master
Size of the databases /db volume
mnt_volume_size
required: false
scope: db_master
Size of the databases /mnt volume
iops
required: false
scope: db_master
Provisioned IOPS for the database servers
dedicated
required: false
scope: db_master
Should the master have dedicated tenancy
db_slaves
required: false
scope: cluster_configuration
Array containing configuration information for the database slaves
name
required: false
scope: db_slaves
Name of the replica
flavor
required: false
scope: db_slaves
default: m3.medium
Flavor for the replica
dedicated
required: false
scope: db_slaves
Should the replica have dedicated tenancy
utils
required: false
scope: cluster_configuration
Array containing configuration information for util instances
name
required: false
scope: utils
Name of the utility instance
flavor
required: false
scope: utils
Flavor of the utility instance
volume_size
required: false
scope: utils
Size of the /data volume of the utility instance
mnt_volume_size
required: false
scope: utils
Size of the /mnt volume of the utility instance
iops
required: false
scope: utils
Provisioned IOPS for the utility instance
dedicated
required: false
scope: utils
Should the util instance have dedicated tenancy

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
            "cluster_configuration": {
              "configuration": {
                "type": "custom",
                "apps": {
                  "count": 4,
                  "flavor": "m4.large",
                  "volume_size": "100",
                  "mnt_volume_size": "150"
                },
                "db_master": {
                  "flavor": "c4.large",
                  "volume_size": "200",
                  "iops": "2000"
                },
                "db_slaves": [
                  {
                    "name": "test",
                    "flavor": "c4.xlarge"
                  }
                ],
                "utils": [
                  {
                    "name": "redis",
                    "flavor": "r3.large",
                    "volume_size": "300",
                    "mnt_volume_size": "300",
                    "iops": "3000"
                  }
                ]
              }
            }
          }
            
          

Response

          Status: 200 OK
          Content-Type: application/json; charset=utf-8
          
            
          {
            "request": {
              "type": "start_environment",
              "id": "2f5521f8-dfa0-483f-a2bf-acd041101c45",
              "created_at": "2018-04-12T17:56:42+00:00",
              "started_at": "2018-04-12T17:56:42+00:00",
              "finished_at": "2018-04-12T17:57:11+00:00",
              "message": "provision_server:bb560e72-2b06-4aae-8487-909238d8d81e 'VolumeIOPSLimit => Volume iops of 3000 is too high; maximum is 4000. (smithy/provision_volume) [72d4d215-1a40-4e3a-8a4d-1c96dd66deca]'",
              "request_status": "Failed: Start environment (2f5521f8-dfa0-483f-a2bf-acd041101c45). Error: provision_server:bb560e72-2b06-4aae-8487-909238d8d81e 'VolumeIOPSLimit => Volume iops of 3000 is too high; maximum is 4000. (smithy/provision_volume) [72d4d215-1a40-4e3a-8a4d-1c96dd66deca]'",
              "successful": false,
              "updated_at": "2018-04-12T17:57:11+00:00",
              "read_channel": null,
              "stage": "start",
              "dependencies": "https://api.engineyard.com/requests/2f5521f8-dfa0-483f-a2bf-acd041101c45/dependencies",
              "stages": "https://api.engineyard.com/requests/2f5521f8-dfa0-483f-a2bf-acd041101c45/stages",
              "account": "https://api.engineyard.com/accounts/49eefbbc-34b0-4bae-8c8d-014af2f3190e",
              "requester": "https://api.engineyard.com/requests/2f5521f8-dfa0-483f-a2bf-acd041101c45/requester",
              "messages": "https://api.engineyard.com/requests/2f5521f8-dfa0-483f-a2bf-acd041101c45/messages",
              "callback_url": "https://api.engineyard.com/requests/2f5521f8-dfa0-483f-a2bf-acd041101c45/callback",
              "progress": false,
              "resource": "https://api.engineyard.com/environments/18"
            }
          }
            
          








Boot an environment with a production configuration

POST /environments/:environment/boot

This is the equivalent of selecting the 'Production' option in the UI when booting an environment

Parameters

cluster_configuration
required: true
Hash of cluster configuration options.
configuration
required: true
Hash of specific configuration options.
type
required: true
scope: cluster_configuration
Type of configuration to boot. Valid values are solo, cluster, production, custom.
apps
required: false
scope: cluster_configuration
Hash containing information about the app instances
count
required: false
scope: apps
Number of app instances to provision
flavor
required: false
scope: apps
default: m3.medium
Flavor of the app instances
volume_size
required: false
scope: apps
Size of the app instance /data volumes
mnt_volume_size
required: false
scope: apps
Size of the app instance /mnt volume
dedicated
required: false
scope: apps
Should the app instances have dedicated tenancy
db_master
required: false
scope: cluster_configuration
Configuration for the db_master
flavor
required: false
scope: db_master
default: m3.medium
Flavor for the database master
volume_size
required: false
scope: db_master
Size of the databases /db volume
mnt_volume_size
required: false
scope: db_master
Size of the databases /mnt volume
iops
required: false
scope: db_master
Provisioned IOPS for the database servers
dedicated
required: false
scope: db_master
Should the master have dedicated tenancy
db_slaves
required: false
scope: cluster_configuration
Array containing configuration information for the database slaves
name
required: false
scope: db_slaves
Name of the replica
flavor
required: false
scope: db_slaves
default: m3.medium
Flavor for the replica
dedicated
required: false
scope: db_slaves
Should the replica have dedicated tenancy
utils
required: false
scope: cluster_configuration
Array containing configuration information for util instances
name
required: false
scope: utils
Name of the utility instance
flavor
required: false
scope: utils
Flavor of the utility instance
volume_size
required: false
scope: utils
Size of the /data volume of the utility instance
mnt_volume_size
required: false
scope: utils
Size of the /mnt volume of the utility instance
iops
required: false
scope: utils
Provisioned IOPS for the utility instance
dedicated
required: false
scope: utils
Should the util instance have dedicated tenancy

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
            "cluster_configuration": {
              "configuration": {
                "type": "production"
              }
            }
          }
            
          

Response

          Status: 200 OK
          Content-Type: application/json; charset=utf-8
          
            
          {
            "request": {
              "type": "start_environment",
              "id": "7795bed0-c2bd-4cac-adbb-b0f4703108f1",
              "created_at": "2018-04-12T17:56:28+00:00",
              "started_at": "2018-04-12T17:56:28+00:00",
              "finished_at": "2018-04-12T17:56:37+00:00",
              "message": null,
              "request_status": "Finished: Start environment (7795bed0-c2bd-4cac-adbb-b0f4703108f1) (less than a minute ago)",
              "successful": true,
              "updated_at": "2018-04-12T17:56:37+00:00",
              "read_channel": null,
              "stage": "wait-for-instance-updates",
              "dependencies": "https://api.engineyard.com/requests/7795bed0-c2bd-4cac-adbb-b0f4703108f1/dependencies",
              "stages": "https://api.engineyard.com/requests/7795bed0-c2bd-4cac-adbb-b0f4703108f1/stages",
              "account": "https://api.engineyard.com/accounts/21b1b06e-785c-4d0f-813c-bc8f014c9427",
              "requester": "https://api.engineyard.com/requests/7795bed0-c2bd-4cac-adbb-b0f4703108f1/requester",
              "messages": "https://api.engineyard.com/requests/7795bed0-c2bd-4cac-adbb-b0f4703108f1/messages",
              "callback_url": "https://api.engineyard.com/requests/7795bed0-c2bd-4cac-adbb-b0f4703108f1/callback",
              "progress": false,
              "resource": "https://api.engineyard.com/environments/17"
            }
          }
            
          








Boot an environment with a solo configuration

POST /environments/:environment/boot

This is the equivalent of selecting the 'Single Instance' option in the UI when booting an environment

Parameters

cluster_configuration
required: true
Hash of cluster configuration options.
configuration
required: true
Hash of specific configuration options.
type
required: true
scope: cluster_configuration
Type of configuration to boot. Valid values are solo, cluster, production, custom.
apps
required: false
scope: cluster_configuration
Hash containing information about the app instances
count
required: false
scope: apps
Number of app instances to provision
flavor
required: false
scope: apps
default: m3.medium
Flavor of the app instances
volume_size
required: false
scope: apps
Size of the app instance /data volumes
mnt_volume_size
required: false
scope: apps
Size of the app instance /mnt volume
dedicated
required: false
scope: apps
Should the app instances have dedicated tenancy
db_master
required: false
scope: cluster_configuration
Configuration for the db_master
flavor
required: false
scope: db_master
default: m3.medium
Flavor for the database master
volume_size
required: false
scope: db_master
Size of the databases /db volume
mnt_volume_size
required: false
scope: db_master
Size of the databases /mnt volume
iops
required: false
scope: db_master
Provisioned IOPS for the database servers
dedicated
required: false
scope: db_master
Should the master have dedicated tenancy
db_slaves
required: false
scope: cluster_configuration
Array containing configuration information for the database slaves
name
required: false
scope: db_slaves
Name of the replica
flavor
required: false
scope: db_slaves
default: m3.medium
Flavor for the replica
dedicated
required: false
scope: db_slaves
Should the replica have dedicated tenancy
utils
required: false
scope: cluster_configuration
Array containing configuration information for util instances
name
required: false
scope: utils
Name of the utility instance
flavor
required: false
scope: utils
Flavor of the utility instance
volume_size
required: false
scope: utils
Size of the /data volume of the utility instance
mnt_volume_size
required: false
scope: utils
Size of the /mnt volume of the utility instance
iops
required: false
scope: utils
Provisioned IOPS for the utility instance
dedicated
required: false
scope: utils
Should the util instance have dedicated tenancy

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
            "cluster_configuration": {
              "configuration": {
                "type": "solo"
              }
            }
          }
            
          

Response

          Status: 200 OK
          Content-Type: application/json; charset=utf-8
          
            
          {
            "request": {
              "type": "start_environment",
              "id": "55f39e9a-e57c-4556-b5cd-d1bcde647735",
              "created_at": "2018-04-12T17:55:51+00:00",
              "started_at": "2018-04-12T17:55:51+00:00",
              "finished_at": "2018-04-12T17:56:01+00:00",
              "message": null,
              "request_status": "Finished: Start environment (55f39e9a-e57c-4556-b5cd-d1bcde647735) (less than a minute ago)",
              "successful": true,
              "updated_at": "2018-04-12T17:56:01+00:00",
              "read_channel": null,
              "stage": "wait-for-instance-updates",
              "dependencies": "https://api.engineyard.com/requests/55f39e9a-e57c-4556-b5cd-d1bcde647735/dependencies",
              "stages": "https://api.engineyard.com/requests/55f39e9a-e57c-4556-b5cd-d1bcde647735/stages",
              "account": "https://api.engineyard.com/accounts/84a3644b-2c65-4d2f-b268-0fe537817766",
              "requester": "https://api.engineyard.com/requests/55f39e9a-e57c-4556-b5cd-d1bcde647735/requester",
              "messages": "https://api.engineyard.com/requests/55f39e9a-e57c-4556-b5cd-d1bcde647735/messages",
              "callback_url": "https://api.engineyard.com/requests/55f39e9a-e57c-4556-b5cd-d1bcde647735/callback",
              "progress": false,
              "resource": "https://api.engineyard.com/environments/15"
            }
          }
            
          








Boot an environment with a staging configuration

POST /environments/:environment/boot

This is the equivalent of selecting the 'Staging Configuration' option in the UI when booting an environment

Parameters

cluster_configuration
required: true
Hash of cluster configuration options.
configuration
required: true
Hash of specific configuration options.
type
required: true
scope: cluster_configuration
Type of configuration to boot. Valid values are solo, cluster, production, custom.
apps
required: false
scope: cluster_configuration
Hash containing information about the app instances
count
required: false
scope: apps
Number of app instances to provision
flavor
required: false
scope: apps
default: m3.medium
Flavor of the app instances
volume_size
required: false
scope: apps
Size of the app instance /data volumes
mnt_volume_size
required: false
scope: apps
Size of the app instance /mnt volume
dedicated
required: false
scope: apps
Should the app instances have dedicated tenancy
db_master
required: false
scope: cluster_configuration
Configuration for the db_master
flavor
required: false
scope: db_master
default: m3.medium
Flavor for the database master
volume_size
required: false
scope: db_master
Size of the databases /db volume
mnt_volume_size
required: false
scope: db_master
Size of the databases /mnt volume
iops
required: false
scope: db_master
Provisioned IOPS for the database servers
dedicated
required: false
scope: db_master
Should the master have dedicated tenancy
db_slaves
required: false
scope: cluster_configuration
Array containing configuration information for the database slaves
name
required: false
scope: db_slaves
Name of the replica
flavor
required: false
scope: db_slaves
default: m3.medium
Flavor for the replica
dedicated
required: false
scope: db_slaves
Should the replica have dedicated tenancy
utils
required: false
scope: cluster_configuration
Array containing configuration information for util instances
name
required: false
scope: utils
Name of the utility instance
flavor
required: false
scope: utils
Flavor of the utility instance
volume_size
required: false
scope: utils
Size of the /data volume of the utility instance
mnt_volume_size
required: false
scope: utils
Size of the /mnt volume of the utility instance
iops
required: false
scope: utils
Provisioned IOPS for the utility instance
dedicated
required: false
scope: utils
Should the util instance have dedicated tenancy

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
            "cluster_configuration": {
              "configuration": {
                "type": "cluster"
              }
            }
          }
            
          

Response

          Status: 200 OK
          Content-Type: application/json; charset=utf-8
          
            
          {
            "request": {
              "type": "start_environment",
              "id": "a6af0f4f-762a-41fc-be85-942f91f9354d",
              "created_at": "2018-04-12T17:56:05+00:00",
              "started_at": "2018-04-12T17:56:05+00:00",
              "finished_at": "2018-04-12T17:56:24+00:00",
              "message": null,
              "request_status": "Finished: Start environment (a6af0f4f-762a-41fc-be85-942f91f9354d) (less than a minute ago)",
              "successful": true,
              "updated_at": "2018-04-12T17:56:24+00:00",
              "read_channel": null,
              "stage": "wait-for-instance-updates",
              "dependencies": "https://api.engineyard.com/requests/a6af0f4f-762a-41fc-be85-942f91f9354d/dependencies",
              "stages": "https://api.engineyard.com/requests/a6af0f4f-762a-41fc-be85-942f91f9354d/stages",
              "account": "https://api.engineyard.com/accounts/264e9ee9-3d7d-43e5-923f-3be15e17181e",
              "requester": "https://api.engineyard.com/requests/a6af0f4f-762a-41fc-be85-942f91f9354d/requester",
              "messages": "https://api.engineyard.com/requests/a6af0f4f-762a-41fc-be85-942f91f9354d/messages",
              "callback_url": "https://api.engineyard.com/requests/a6af0f4f-762a-41fc-be85-942f91f9354d/callback",
              "progress": false,
              "resource": "https://api.engineyard.com/environments/16"
            }
          }
            
          








Boot an environment with one app server and a separate database server

POST /environments/:environment/boot

Parameters

cluster_configuration
required: true
Hash of cluster configuration options.
configuration
required: true
Hash of specific configuration options.
type
required: true
scope: cluster_configuration
Type of configuration to boot. Valid values are solo, cluster, production, custom.
apps
required: false
scope: cluster_configuration
Hash containing information about the app instances
count
required: false
scope: apps
Number of app instances to provision
flavor
required: false
scope: apps
default: m3.medium
Flavor of the app instances
volume_size
required: false
scope: apps
Size of the app instance /data volumes
mnt_volume_size
required: false
scope: apps
Size of the app instance /mnt volume
dedicated
required: false
scope: apps
Should the app instances have dedicated tenancy
db_master
required: false
scope: cluster_configuration
Configuration for the db_master
flavor
required: false
scope: db_master
default: m3.medium
Flavor for the database master
volume_size
required: false
scope: db_master
Size of the databases /db volume
mnt_volume_size
required: false
scope: db_master
Size of the databases /mnt volume
iops
required: false
scope: db_master
Provisioned IOPS for the database servers
dedicated
required: false
scope: db_master
Should the master have dedicated tenancy
db_slaves
required: false
scope: cluster_configuration
Array containing configuration information for the database slaves
name
required: false
scope: db_slaves
Name of the replica
flavor
required: false
scope: db_slaves
default: m3.medium
Flavor for the replica
dedicated
required: false
scope: db_slaves
Should the replica have dedicated tenancy
utils
required: false
scope: cluster_configuration
Array containing configuration information for util instances
name
required: false
scope: utils
Name of the utility instance
flavor
required: false
scope: utils
Flavor of the utility instance
volume_size
required: false
scope: utils
Size of the /data volume of the utility instance
mnt_volume_size
required: false
scope: utils
Size of the /mnt volume of the utility instance
iops
required: false
scope: utils
Provisioned IOPS for the utility instance
dedicated
required: false
scope: utils
Should the util instance have dedicated tenancy

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
            "cluster_configuration": {
              "configuration": {
                "type": "custom",
                "apps": {
                  "count": 1,
                  "flavor": "m4.large",
                  "volume_size": "100",
                  "mnt_volume_size": "150"
                },
                "db_master": {
                  "flavor": "c4.large",
                  "volume_size": "200",
                  "iops": "2000"
                },
                "db_slaves": [
          
                ],
                "utils": [
          
                ]
              }
            }
          }
            
          

Response

          Status: 200 OK
          Content-Type: application/json; charset=utf-8
          
            
          {
            "request": {
              "type": "start_environment",
              "id": "5f6beeff-f735-462b-a68b-15a741da9500",
              "created_at": "2018-04-12T17:57:15+00:00",
              "started_at": "2018-04-12T17:57:15+00:00",
              "finished_at": "2018-04-12T17:57:30+00:00",
              "message": null,
              "request_status": "Finished: Start environment (5f6beeff-f735-462b-a68b-15a741da9500) (less than a minute ago)",
              "successful": true,
              "updated_at": "2018-04-12T17:57:30+00:00",
              "read_channel": null,
              "stage": "wait-for-instance-updates",
              "dependencies": "https://api.engineyard.com/requests/5f6beeff-f735-462b-a68b-15a741da9500/dependencies",
              "stages": "https://api.engineyard.com/requests/5f6beeff-f735-462b-a68b-15a741da9500/stages",
              "account": "https://api.engineyard.com/accounts/e45e4c47-e7bf-42d0-920e-6687f5ede8c7",
              "requester": "https://api.engineyard.com/requests/5f6beeff-f735-462b-a68b-15a741da9500/requester",
              "messages": "https://api.engineyard.com/requests/5f6beeff-f735-462b-a68b-15a741da9500/messages",
              "callback_url": "https://api.engineyard.com/requests/5f6beeff-f735-462b-a68b-15a741da9500/callback",
              "progress": false,
              "resource": "https://api.engineyard.com/environments/19"
            }
          }
            
          








Create an environment

POST /accounts/:account/environments

Parameters

account
required: false
Account to assign the environment to
application_id
required: true
scope: environment
Id of the application to associate with this environment
database_backup_interval
required: false
How often to run backups (in hours)
database_backup_limit
required: false
Number of logical database backups to keep
database_stack
required: false
scope: environment
default: postgres9_4
Database stack name. Valid values are: ["mysql", "mysql5_1", "mysql5_5", "mysql5_6", "mysql5_7", "aurora5_6", "mariadb10_0", "postgres", "postgres9", "postgres9_1", "postgres9_2", "postgres9_3", "postgres9_4", "postgres9_5", "postgres9_6", "no_db"]
deploy_method
required: false
scope: environment
default: serverside
Default deployment method for the environment. Valid values are chef, serverside, none
encrypted_database_ebs
required: false
scope: environment
Should the database volumes be encrypted
encrypted_ebs_for_everything
required: false
scope: environment
Should the volumes for all servers be encrypted. This setting will take precedence over encrypted_database_ebs
framework_env
required: false
scope: environment
default: production
Framework for the environment. Production, staging, development, etc
language
required: false
scope: environment
default: Ruby 2.2
Language and version to support. Valid values are: Ruby 1.9.3, Ruby 2.0.0, Ruby 2.1.2, Ruby 2.1.5, Ruby 2.2, Ruby 2.3, Ruby 2.4, PHP, Node.js
lock_db_version
required: false
scope: environment
Prevent database version changes
name
required: true
scope: environment
Name of the environment
network_id
required: false
scope: environment
Network ID to associate with this environment
region
required: false
scope: environment
Region for the environment
snapshot_limit
required: false
scope: environment
Number of snapshots to keep
snapshot_retention
required: false
scope: environment
Number of days to keep the snapshots
takeover_preference
required: false
scope: environment
default: snapshot
How to handle takeovers. Valid values: [snapshot, new_volume, no_slave, disable]

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
            "environment": {
              "name": "newenvironment",
              "application_id": 22
            }
          }
            
          

Response

          Status: 201 Created
          Content-Type: application/json; charset=utf-8
          
            
          {
            "environment": {
              "id": 6,
              "account": "https://api.engineyard.com/accounts/1ab98af8-ba64-40d2-9818-c886d2a45e1b",
              "alerts": "https://api.engineyard.com/environments/6/server-alerts",
              "applications": "https://api.engineyard.com/environments/6/applications",
              "classic": true,
              "created_at": "2018-04-12T17:55:24+00:00",
              "database_services": "https://api.engineyard.com/environments/6/database-services",
              "deleted_at": null,
              "firewall": null,
              "internal_private_key": "-----BEGIN RSA PRIVATE KEY-----\nMIIEoAIBAAKCAQEAwP3xABDWtk9+5k2LKV/pm6igfLd+NyM+vbnJpy5+PmCv1FGw\nL99I5EmNsOlbmooUFxtbn8cg595yy+kvB0ENLAYqBp3vaC/M/Vj4KTGd0xm/RIq0\nmAp5Jw8ZW+AmXxMOOoAxocaJ6m/kquF5W1kVUfq2IfMmCZEc86Bb/Wy9z6ntA4KK\nP0HTenzkTSVVRnuwR+DMSac9c3LMoUgULLCJ4+orFSifmin8wbO/cwOoo8T/UDWV\neLPkPR+h9c5ne9cq0Lpx0MneqctU8tr/UwBGTStUVesC+h6A+iDZVHcIB5zlpc93\nKFXqEQSbauXnQE/mpZaJLCMJmV2NR2sv1VCewwIBIwKCAQB+0sLxaiayUX9G4oAF\nPwc6Z39n5kugk4EAVYSDzhhyIkeox/dv6oBbgMrTV4VW7QXjTH4J6UGCbZvlFZPu\n0voG/LyIAWLPb956mY0iYm8HEOtnjllrOhUZqtYmbrohOGhvlhH8mGlCSYejfjnO\nUHu5h38AXfRsr9EyYhCQl+pyhHeDZwM0MQm5459XTmoSjW7AcFaE4qn0CD0VGeQ9\nDlbH2zCcQU3+Ljpvla+ME5yN3qeppKd/bQQp3FT7MpxdDcEGDHtnkAEhggbRcXJ+\nrBw5F8GN2j8f5jZdflnb8FHVI+iAiTLfBc74V1+z5n+XnkwbtagjQpU1MpyeKp5R\nPGPTAoGBAORa/BsN7zYqw0wsCSQv3kpkGjZNnVO8PUxThVddpLJiDZI1xyWOPCrW\nlwdk8cPC2uNwc83HY/u3qMARLwfcOQdNWtvjZWwYjWjulh2b884FFVgMopPGKPpc\nNzNxdsXRajEWbw8eK8Sv6j/qF9wpMMwCFB8h0pMBorJo8V65zPktAoGBANha/+/h\n5pmkJ49kmbwyCPUBt3Z/vB6+SlsBIOcN9gWJYoaNbWeJIehMcJaoNtVArYwKIEM9\nUPhySPxmXXzPO0ux0igNA77CbOzFjR05EbGB5rRbKNd92fw8KV/tWucTPthRV/k8\nWPWOJhfIFj3MOVjopaHUqFvimlvXhuAwlw2vAoGAVNFWUzEPtQiRrpQDZTZZ4R3d\n2afMuLOhvUOX7UAJ+R0a+8rU8LEsSmz2RJM1OhUsuuCgCpqEOOxx4PBwjeQVLpkT\nHnkIafp9qqHCuoph3s6wKASxahZm/ee8u1YHi03IW2AanzcXkjK2F71ZUcYoEUKZ\nwmul/BaM4y5LBe09gR8CgYA3ol8RzF/eXWlCIS7Ynybf6n+iINiaMO6MbgEleJ5Z\nMfTDg3PnbGfOBQcCK0FMx30VYbCGUZh6ZofL387llF+0YOzlujQpvPdwFYqvvje/\n7jQCfddNWuBILLounB6wcqnCmJL28kLCzMf3fJgBQySwdlZ6Ehyp6c/ruxQNw1oK\n1QKBgDDNm9MBRY8OTKCQKj9HJx7Gh3zFKHIIBAjZlEdcwgzjsNi8+HsQuDiTkroe\nxhXjGNCek0vwr81HAa0wbEFPF1ohxkICUavo10SAMeLZQGRGhYV6oxCpD415oZI2\n0sZlQjRBG6S4zkBIk9R7+RMz3YGpey/SnNFWhhrBKBMPU0VW\n-----END RSA PRIVATE KEY-----",
              "internal_public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAwP3xABDWtk9+5k2LKV/pm6igfLd+NyM+vbnJpy5+PmCv1FGwL99I5EmNsOlbmooUFxtbn8cg595yy+kvB0ENLAYqBp3vaC/M/Vj4KTGd0xm/RIq0mAp5Jw8ZW+AmXxMOOoAxocaJ6m/kquF5W1kVUfq2IfMmCZEc86Bb/Wy9z6ntA4KKP0HTenzkTSVVRnuwR+DMSac9c3LMoUgULLCJ4+orFSifmin8wbO/cwOoo8T/UDWVeLPkPR+h9c5ne9cq0Lpx0MneqctU8tr/UwBGTStUVesC+h6A+iDZVHcIB5zlpc93KFXqEQSbauXnQE/mpZaJLCMJmV2NR2sv1VCeww==",
              "keypairs": "https://api.engineyard.com/environments/6/keypairs",
              "logical_databases": "https://api.engineyard.com/environments/6/logical-databases",
              "monitor_url": null,
              "name": "newenvironment",
              "server_alerts": "https://api.engineyard.com/environments/6/server-alerts",
              "servers": "https://api.engineyard.com/environments/6/servers",
              "service_level": "default",
              "service_plan": null,
              "snapshots": "https://api.engineyard.com/environments/6/snapshots",
              "updated_at": "2018-04-12T17:55:24+00:00",
              "auto_scaling_group": null,
              "available_upgrade_web_uri": null,
              "custom_recipes": null,
              "database_backup_interval": 24,
              "database_backup_limit": 10,
              "database_stack": "postgres9_4",
              "deploy_method": "serverside",
              "deployments": "https://api.engineyard.com/environments/6/deployments",
              "encrypted_database_ebs": false,
              "encrypted_ebs_for_everything": false,
              "environment_variables": "https://api.engineyard.com/environments/6/environment_variables",
              "framework_env": "production",
              "kubey_cluster": "https://api.engineyard.com/environments/6/kubey_cluster",
              "kubey_logical_database_count": null,
              "kubey_master_count": 0,
              "kubey_node_count": 0,
              "language": "Ruby 2.2",
              "lock_db_version": true,
              "network": null,
              "region": "us-east-1",
              "release_label": "stable-v4-2.0.126",
              "requests": "https://api.engineyard.com/environments/6/requests",
              "snapshot_limit": 10,
              "snapshot_retention": 90,
              "stack_name": "nginx_passenger4",
              "takeover_preference": "snapshot",
              "upgrade_available": false,
              "username": "deploy",
              "vpc_name": null,
              "vpc_provisioned_id": null
            }
          }
            
          








Create an environment with a custom database stack

POST /accounts/:account/environments

Parameters

account
required: false
Account to assign the environment to
application_id
required: true
scope: environment
Id of the application to associate with this environment
database_backup_interval
required: false
How often to run backups (in hours)
database_backup_limit
required: false
Number of logical database backups to keep
database_stack
required: false
scope: environment
default: postgres9_4
Database stack name. Valid values are: ["mysql", "mysql5_1", "mysql5_5", "mysql5_6", "mysql5_7", "aurora5_6", "mariadb10_0", "postgres", "postgres9", "postgres9_1", "postgres9_2", "postgres9_3", "postgres9_4", "postgres9_5", "postgres9_6", "no_db"]
deploy_method
required: false
scope: environment
default: serverside
Default deployment method for the environment. Valid values are chef, serverside, none
encrypted_database_ebs
required: false
scope: environment
Should the database volumes be encrypted
encrypted_ebs_for_everything
required: false
scope: environment
Should the volumes for all servers be encrypted. This setting will take precedence over encrypted_database_ebs
framework_env
required: false
scope: environment
default: production
Framework for the environment. Production, staging, development, etc
language
required: false
scope: environment
default: Ruby 2.2
Language and version to support. Valid values are: Ruby 1.9.3, Ruby 2.0.0, Ruby 2.1.2, Ruby 2.1.5, Ruby 2.2, Ruby 2.3, Ruby 2.4, PHP, Node.js
lock_db_version
required: false
scope: environment
Prevent database version changes
name
required: true
scope: environment
Name of the environment
network_id
required: false
scope: environment
Network ID to associate with this environment
region
required: false
scope: environment
Region for the environment
snapshot_limit
required: false
scope: environment
Number of snapshots to keep
snapshot_retention
required: false
scope: environment
Number of days to keep the snapshots
takeover_preference
required: false
scope: environment
default: snapshot
How to handle takeovers. Valid values: [snapshot, new_volume, no_slave, disable]

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
            "environment": {
              "name": "c8189918",
              "application_id": 26,
              "database_stack": "postgres9_3"
            }
          }
            
          

Response

          Status: 201 Created
          Content-Type: application/json; charset=utf-8
          
            
          {
            "environment": {
              "id": 10,
              "account": "https://api.engineyard.com/accounts/b794c5ea-3ea1-4273-9c7e-f7f6780a7813",
              "alerts": "https://api.engineyard.com/environments/10/server-alerts",
              "applications": "https://api.engineyard.com/environments/10/applications",
              "classic": true,
              "created_at": "2018-04-12T17:55:33+00:00",
              "database_services": "https://api.engineyard.com/environments/10/database-services",
              "deleted_at": null,
              "firewall": null,
              "internal_private_key": "-----BEGIN RSA PRIVATE KEY-----\nMIIEoAIBAAKCAQEAwP3xABDWtk9+5k2LKV/pm6igfLd+NyM+vbnJpy5+PmCv1FGw\nL99I5EmNsOlbmooUFxtbn8cg595yy+kvB0ENLAYqBp3vaC/M/Vj4KTGd0xm/RIq0\nmAp5Jw8ZW+AmXxMOOoAxocaJ6m/kquF5W1kVUfq2IfMmCZEc86Bb/Wy9z6ntA4KK\nP0HTenzkTSVVRnuwR+DMSac9c3LMoUgULLCJ4+orFSifmin8wbO/cwOoo8T/UDWV\neLPkPR+h9c5ne9cq0Lpx0MneqctU8tr/UwBGTStUVesC+h6A+iDZVHcIB5zlpc93\nKFXqEQSbauXnQE/mpZaJLCMJmV2NR2sv1VCewwIBIwKCAQB+0sLxaiayUX9G4oAF\nPwc6Z39n5kugk4EAVYSDzhhyIkeox/dv6oBbgMrTV4VW7QXjTH4J6UGCbZvlFZPu\n0voG/LyIAWLPb956mY0iYm8HEOtnjllrOhUZqtYmbrohOGhvlhH8mGlCSYejfjnO\nUHu5h38AXfRsr9EyYhCQl+pyhHeDZwM0MQm5459XTmoSjW7AcFaE4qn0CD0VGeQ9\nDlbH2zCcQU3+Ljpvla+ME5yN3qeppKd/bQQp3FT7MpxdDcEGDHtnkAEhggbRcXJ+\nrBw5F8GN2j8f5jZdflnb8FHVI+iAiTLfBc74V1+z5n+XnkwbtagjQpU1MpyeKp5R\nPGPTAoGBAORa/BsN7zYqw0wsCSQv3kpkGjZNnVO8PUxThVddpLJiDZI1xyWOPCrW\nlwdk8cPC2uNwc83HY/u3qMARLwfcOQdNWtvjZWwYjWjulh2b884FFVgMopPGKPpc\nNzNxdsXRajEWbw8eK8Sv6j/qF9wpMMwCFB8h0pMBorJo8V65zPktAoGBANha/+/h\n5pmkJ49kmbwyCPUBt3Z/vB6+SlsBIOcN9gWJYoaNbWeJIehMcJaoNtVArYwKIEM9\nUPhySPxmXXzPO0ux0igNA77CbOzFjR05EbGB5rRbKNd92fw8KV/tWucTPthRV/k8\nWPWOJhfIFj3MOVjopaHUqFvimlvXhuAwlw2vAoGAVNFWUzEPtQiRrpQDZTZZ4R3d\n2afMuLOhvUOX7UAJ+R0a+8rU8LEsSmz2RJM1OhUsuuCgCpqEOOxx4PBwjeQVLpkT\nHnkIafp9qqHCuoph3s6wKASxahZm/ee8u1YHi03IW2AanzcXkjK2F71ZUcYoEUKZ\nwmul/BaM4y5LBe09gR8CgYA3ol8RzF/eXWlCIS7Ynybf6n+iINiaMO6MbgEleJ5Z\nMfTDg3PnbGfOBQcCK0FMx30VYbCGUZh6ZofL387llF+0YOzlujQpvPdwFYqvvje/\n7jQCfddNWuBILLounB6wcqnCmJL28kLCzMf3fJgBQySwdlZ6Ehyp6c/ruxQNw1oK\n1QKBgDDNm9MBRY8OTKCQKj9HJx7Gh3zFKHIIBAjZlEdcwgzjsNi8+HsQuDiTkroe\nxhXjGNCek0vwr81HAa0wbEFPF1ohxkICUavo10SAMeLZQGRGhYV6oxCpD415oZI2\n0sZlQjRBG6S4zkBIk9R7+RMz3YGpey/SnNFWhhrBKBMPU0VW\n-----END RSA PRIVATE KEY-----",
              "internal_public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAwP3xABDWtk9+5k2LKV/pm6igfLd+NyM+vbnJpy5+PmCv1FGwL99I5EmNsOlbmooUFxtbn8cg595yy+kvB0ENLAYqBp3vaC/M/Vj4KTGd0xm/RIq0mAp5Jw8ZW+AmXxMOOoAxocaJ6m/kquF5W1kVUfq2IfMmCZEc86Bb/Wy9z6ntA4KKP0HTenzkTSVVRnuwR+DMSac9c3LMoUgULLCJ4+orFSifmin8wbO/cwOoo8T/UDWVeLPkPR+h9c5ne9cq0Lpx0MneqctU8tr/UwBGTStUVesC+h6A+iDZVHcIB5zlpc93KFXqEQSbauXnQE/mpZaJLCMJmV2NR2sv1VCeww==",
              "keypairs": "https://api.engineyard.com/environments/10/keypairs",
              "logical_databases": "https://api.engineyard.com/environments/10/logical-databases",
              "monitor_url": null,
              "name": "c8189918",
              "server_alerts": "https://api.engineyard.com/environments/10/server-alerts",
              "servers": "https://api.engineyard.com/environments/10/servers",
              "service_level": "default",
              "service_plan": null,
              "snapshots": "https://api.engineyard.com/environments/10/snapshots",
              "updated_at": "2018-04-12T17:55:33+00:00",
              "auto_scaling_group": null,
              "available_upgrade_web_uri": null,
              "custom_recipes": null,
              "database_backup_interval": 24,
              "database_backup_limit": 10,
              "database_stack": "postgres9_3",
              "deploy_method": "serverside",
              "deployments": "https://api.engineyard.com/environments/10/deployments",
              "encrypted_database_ebs": false,
              "encrypted_ebs_for_everything": false,
              "environment_variables": "https://api.engineyard.com/environments/10/environment_variables",
              "framework_env": "production",
              "kubey_cluster": "https://api.engineyard.com/environments/10/kubey_cluster",
              "kubey_logical_database_count": null,
              "kubey_master_count": 0,
              "kubey_node_count": 0,
              "language": "Ruby 2.2",
              "lock_db_version": true,
              "network": null,
              "region": "us-east-1",
              "release_label": "stable-v4-2.0.126",
              "requests": "https://api.engineyard.com/environments/10/requests",
              "snapshot_limit": 10,
              "snapshot_retention": 90,
              "stack_name": "nginx_passenger4",
              "takeover_preference": "snapshot",
              "upgrade_available": false,
              "username": "deploy",
              "vpc_name": null,
              "vpc_provisioned_id": null
            }
          }
            
          








Create an environment with a custom framework environment

POST /accounts/:account/environments

Parameters

account
required: false
Account to assign the environment to
application_id
required: true
scope: environment
Id of the application to associate with this environment
database_backup_interval
required: false
How often to run backups (in hours)
database_backup_limit
required: false
Number of logical database backups to keep
database_stack
required: false
scope: environment
default: postgres9_4
Database stack name. Valid values are: ["mysql", "mysql5_1", "mysql5_5", "mysql5_6", "mysql5_7", "aurora5_6", "mariadb10_0", "postgres", "postgres9", "postgres9_1", "postgres9_2", "postgres9_3", "postgres9_4", "postgres9_5", "postgres9_6", "no_db"]
deploy_method
required: false
scope: environment
default: serverside
Default deployment method for the environment. Valid values are chef, serverside, none
encrypted_database_ebs
required: false
scope: environment
Should the database volumes be encrypted
encrypted_ebs_for_everything
required: false
scope: environment
Should the volumes for all servers be encrypted. This setting will take precedence over encrypted_database_ebs
framework_env
required: false
scope: environment
default: production
Framework for the environment. Production, staging, development, etc
language
required: false
scope: environment
default: Ruby 2.2
Language and version to support. Valid values are: Ruby 1.9.3, Ruby 2.0.0, Ruby 2.1.2, Ruby 2.1.5, Ruby 2.2, Ruby 2.3, Ruby 2.4, PHP, Node.js
lock_db_version
required: false
scope: environment
Prevent database version changes
name
required: true
scope: environment
Name of the environment
network_id
required: false
scope: environment
Network ID to associate with this environment
region
required: false
scope: environment
Region for the environment
snapshot_limit
required: false
scope: environment
Number of snapshots to keep
snapshot_retention
required: false
scope: environment
Number of days to keep the snapshots
takeover_preference
required: false
scope: environment
default: snapshot
How to handle takeovers. Valid values: [snapshot, new_volume, no_slave, disable]

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
            "environment": {
              "name": "dd026e7b",
              "application_id": 23,
              "framework_env": "testing"
            }
          }
            
          

Response

          Status: 201 Created
          Content-Type: application/json; charset=utf-8
          
            
          {
            "environment": {
              "id": 7,
              "account": "https://api.engineyard.com/accounts/437ade8e-86ac-4ad2-b08d-1ef160a6ea2d",
              "alerts": "https://api.engineyard.com/environments/7/server-alerts",
              "applications": "https://api.engineyard.com/environments/7/applications",
              "classic": true,
              "created_at": "2018-04-12T17:55:26+00:00",
              "database_services": "https://api.engineyard.com/environments/7/database-services",
              "deleted_at": null,
              "firewall": null,
              "internal_private_key": "-----BEGIN RSA PRIVATE KEY-----\nMIIEoAIBAAKCAQEAwP3xABDWtk9+5k2LKV/pm6igfLd+NyM+vbnJpy5+PmCv1FGw\nL99I5EmNsOlbmooUFxtbn8cg595yy+kvB0ENLAYqBp3vaC/M/Vj4KTGd0xm/RIq0\nmAp5Jw8ZW+AmXxMOOoAxocaJ6m/kquF5W1kVUfq2IfMmCZEc86Bb/Wy9z6ntA4KK\nP0HTenzkTSVVRnuwR+DMSac9c3LMoUgULLCJ4+orFSifmin8wbO/cwOoo8T/UDWV\neLPkPR+h9c5ne9cq0Lpx0MneqctU8tr/UwBGTStUVesC+h6A+iDZVHcIB5zlpc93\nKFXqEQSbauXnQE/mpZaJLCMJmV2NR2sv1VCewwIBIwKCAQB+0sLxaiayUX9G4oAF\nPwc6Z39n5kugk4EAVYSDzhhyIkeox/dv6oBbgMrTV4VW7QXjTH4J6UGCbZvlFZPu\n0voG/LyIAWLPb956mY0iYm8HEOtnjllrOhUZqtYmbrohOGhvlhH8mGlCSYejfjnO\nUHu5h38AXfRsr9EyYhCQl+pyhHeDZwM0MQm5459XTmoSjW7AcFaE4qn0CD0VGeQ9\nDlbH2zCcQU3+Ljpvla+ME5yN3qeppKd/bQQp3FT7MpxdDcEGDHtnkAEhggbRcXJ+\nrBw5F8GN2j8f5jZdflnb8FHVI+iAiTLfBc74V1+z5n+XnkwbtagjQpU1MpyeKp5R\nPGPTAoGBAORa/BsN7zYqw0wsCSQv3kpkGjZNnVO8PUxThVddpLJiDZI1xyWOPCrW\nlwdk8cPC2uNwc83HY/u3qMARLwfcOQdNWtvjZWwYjWjulh2b884FFVgMopPGKPpc\nNzNxdsXRajEWbw8eK8Sv6j/qF9wpMMwCFB8h0pMBorJo8V65zPktAoGBANha/+/h\n5pmkJ49kmbwyCPUBt3Z/vB6+SlsBIOcN9gWJYoaNbWeJIehMcJaoNtVArYwKIEM9\nUPhySPxmXXzPO0ux0igNA77CbOzFjR05EbGB5rRbKNd92fw8KV/tWucTPthRV/k8\nWPWOJhfIFj3MOVjopaHUqFvimlvXhuAwlw2vAoGAVNFWUzEPtQiRrpQDZTZZ4R3d\n2afMuLOhvUOX7UAJ+R0a+8rU8LEsSmz2RJM1OhUsuuCgCpqEOOxx4PBwjeQVLpkT\nHnkIafp9qqHCuoph3s6wKASxahZm/ee8u1YHi03IW2AanzcXkjK2F71ZUcYoEUKZ\nwmul/BaM4y5LBe09gR8CgYA3ol8RzF/eXWlCIS7Ynybf6n+iINiaMO6MbgEleJ5Z\nMfTDg3PnbGfOBQcCK0FMx30VYbCGUZh6ZofL387llF+0YOzlujQpvPdwFYqvvje/\n7jQCfddNWuBILLounB6wcqnCmJL28kLCzMf3fJgBQySwdlZ6Ehyp6c/ruxQNw1oK\n1QKBgDDNm9MBRY8OTKCQKj9HJx7Gh3zFKHIIBAjZlEdcwgzjsNi8+HsQuDiTkroe\nxhXjGNCek0vwr81HAa0wbEFPF1ohxkICUavo10SAMeLZQGRGhYV6oxCpD415oZI2\n0sZlQjRBG6S4zkBIk9R7+RMz3YGpey/SnNFWhhrBKBMPU0VW\n-----END RSA PRIVATE KEY-----",
              "internal_public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAwP3xABDWtk9+5k2LKV/pm6igfLd+NyM+vbnJpy5+PmCv1FGwL99I5EmNsOlbmooUFxtbn8cg595yy+kvB0ENLAYqBp3vaC/M/Vj4KTGd0xm/RIq0mAp5Jw8ZW+AmXxMOOoAxocaJ6m/kquF5W1kVUfq2IfMmCZEc86Bb/Wy9z6ntA4KKP0HTenzkTSVVRnuwR+DMSac9c3LMoUgULLCJ4+orFSifmin8wbO/cwOoo8T/UDWVeLPkPR+h9c5ne9cq0Lpx0MneqctU8tr/UwBGTStUVesC+h6A+iDZVHcIB5zlpc93KFXqEQSbauXnQE/mpZaJLCMJmV2NR2sv1VCeww==",
              "keypairs": "https://api.engineyard.com/environments/7/keypairs",
              "logical_databases": "https://api.engineyard.com/environments/7/logical-databases",
              "monitor_url": null,
              "name": "dd026e7b",
              "server_alerts": "https://api.engineyard.com/environments/7/server-alerts",
              "servers": "https://api.engineyard.com/environments/7/servers",
              "service_level": "default",
              "service_plan": null,
              "snapshots": "https://api.engineyard.com/environments/7/snapshots",
              "updated_at": "2018-04-12T17:55:26+00:00",
              "auto_scaling_group": null,
              "available_upgrade_web_uri": null,
              "custom_recipes": null,
              "database_backup_interval": 24,
              "database_backup_limit": 10,
              "database_stack": "postgres9_4",
              "deploy_method": "serverside",
              "deployments": "https://api.engineyard.com/environments/7/deployments",
              "encrypted_database_ebs": false,
              "encrypted_ebs_for_everything": false,
              "environment_variables": "https://api.engineyard.com/environments/7/environment_variables",
              "framework_env": "testing",
              "kubey_cluster": "https://api.engineyard.com/environments/7/kubey_cluster",
              "kubey_logical_database_count": null,
              "kubey_master_count": 0,
              "kubey_node_count": 0,
              "language": "Ruby 2.2",
              "lock_db_version": true,
              "network": null,
              "region": "us-east-1",
              "release_label": "stable-v4-2.0.126",
              "requests": "https://api.engineyard.com/environments/7/requests",
              "snapshot_limit": 10,
              "snapshot_retention": 90,
              "stack_name": "nginx_passenger4",
              "takeover_preference": "snapshot",
              "upgrade_available": false,
              "username": "deploy",
              "vpc_name": null,
              "vpc_provisioned_id": null
            }
          }
            
          








Create an environment with a custom language

POST /accounts/:account/environments

Parameters

account
required: false
Account to assign the environment to
application_id
required: true
scope: environment
Id of the application to associate with this environment
database_backup_interval
required: false
How often to run backups (in hours)
database_backup_limit
required: false
Number of logical database backups to keep
database_stack
required: false
scope: environment
default: postgres9_4
Database stack name. Valid values are: ["mysql", "mysql5_1", "mysql5_5", "mysql5_6", "mysql5_7", "aurora5_6", "mariadb10_0", "postgres", "postgres9", "postgres9_1", "postgres9_2", "postgres9_3", "postgres9_4", "postgres9_5", "postgres9_6", "no_db"]
deploy_method
required: false
scope: environment
default: serverside
Default deployment method for the environment. Valid values are chef, serverside, none
encrypted_database_ebs
required: false
scope: environment
Should the database volumes be encrypted
encrypted_ebs_for_everything
required: false
scope: environment
Should the volumes for all servers be encrypted. This setting will take precedence over encrypted_database_ebs
framework_env
required: false
scope: environment
default: production
Framework for the environment. Production, staging, development, etc
language
required: false
scope: environment
default: Ruby 2.2
Language and version to support. Valid values are: Ruby 1.9.3, Ruby 2.0.0, Ruby 2.1.2, Ruby 2.1.5, Ruby 2.2, Ruby 2.3, Ruby 2.4, PHP, Node.js
lock_db_version
required: false
scope: environment
Prevent database version changes
name
required: true
scope: environment
Name of the environment
network_id
required: false
scope: environment
Network ID to associate with this environment
region
required: false
scope: environment
Region for the environment
snapshot_limit
required: false
scope: environment
Number of snapshots to keep
snapshot_retention
required: false
scope: environment
Number of days to keep the snapshots
takeover_preference
required: false
scope: environment
default: snapshot
How to handle takeovers. Valid values: [snapshot, new_volume, no_slave, disable]

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
            "environment": {
              "name": "d84987cb",
              "application_id": 25,
              "language": "Ruby 2.1.5"
            }
          }
            
          

Response

          Status: 201 Created
          Content-Type: application/json; charset=utf-8
          
            
          {
            "environment": {
              "id": 9,
              "account": "https://api.engineyard.com/accounts/24e3f3ee-52a3-4247-8acc-12a59de0ad88",
              "alerts": "https://api.engineyard.com/environments/9/server-alerts",
              "applications": "https://api.engineyard.com/environments/9/applications",
              "classic": true,
              "created_at": "2018-04-12T17:55:31+00:00",
              "database_services": "https://api.engineyard.com/environments/9/database-services",
              "deleted_at": null,
              "firewall": null,
              "internal_private_key": "-----BEGIN RSA PRIVATE KEY-----\nMIIEoAIBAAKCAQEAwP3xABDWtk9+5k2LKV/pm6igfLd+NyM+vbnJpy5+PmCv1FGw\nL99I5EmNsOlbmooUFxtbn8cg595yy+kvB0ENLAYqBp3vaC/M/Vj4KTGd0xm/RIq0\nmAp5Jw8ZW+AmXxMOOoAxocaJ6m/kquF5W1kVUfq2IfMmCZEc86Bb/Wy9z6ntA4KK\nP0HTenzkTSVVRnuwR+DMSac9c3LMoUgULLCJ4+orFSifmin8wbO/cwOoo8T/UDWV\neLPkPR+h9c5ne9cq0Lpx0MneqctU8tr/UwBGTStUVesC+h6A+iDZVHcIB5zlpc93\nKFXqEQSbauXnQE/mpZaJLCMJmV2NR2sv1VCewwIBIwKCAQB+0sLxaiayUX9G4oAF\nPwc6Z39n5kugk4EAVYSDzhhyIkeox/dv6oBbgMrTV4VW7QXjTH4J6UGCbZvlFZPu\n0voG/LyIAWLPb956mY0iYm8HEOtnjllrOhUZqtYmbrohOGhvlhH8mGlCSYejfjnO\nUHu5h38AXfRsr9EyYhCQl+pyhHeDZwM0MQm5459XTmoSjW7AcFaE4qn0CD0VGeQ9\nDlbH2zCcQU3+Ljpvla+ME5yN3qeppKd/bQQp3FT7MpxdDcEGDHtnkAEhggbRcXJ+\nrBw5F8GN2j8f5jZdflnb8FHVI+iAiTLfBc74V1+z5n+XnkwbtagjQpU1MpyeKp5R\nPGPTAoGBAORa/BsN7zYqw0wsCSQv3kpkGjZNnVO8PUxThVddpLJiDZI1xyWOPCrW\nlwdk8cPC2uNwc83HY/u3qMARLwfcOQdNWtvjZWwYjWjulh2b884FFVgMopPGKPpc\nNzNxdsXRajEWbw8eK8Sv6j/qF9wpMMwCFB8h0pMBorJo8V65zPktAoGBANha/+/h\n5pmkJ49kmbwyCPUBt3Z/vB6+SlsBIOcN9gWJYoaNbWeJIehMcJaoNtVArYwKIEM9\nUPhySPxmXXzPO0ux0igNA77CbOzFjR05EbGB5rRbKNd92fw8KV/tWucTPthRV/k8\nWPWOJhfIFj3MOVjopaHUqFvimlvXhuAwlw2vAoGAVNFWUzEPtQiRrpQDZTZZ4R3d\n2afMuLOhvUOX7UAJ+R0a+8rU8LEsSmz2RJM1OhUsuuCgCpqEOOxx4PBwjeQVLpkT\nHnkIafp9qqHCuoph3s6wKASxahZm/ee8u1YHi03IW2AanzcXkjK2F71ZUcYoEUKZ\nwmul/BaM4y5LBe09gR8CgYA3ol8RzF/eXWlCIS7Ynybf6n+iINiaMO6MbgEleJ5Z\nMfTDg3PnbGfOBQcCK0FMx30VYbCGUZh6ZofL387llF+0YOzlujQpvPdwFYqvvje/\n7jQCfddNWuBILLounB6wcqnCmJL28kLCzMf3fJgBQySwdlZ6Ehyp6c/ruxQNw1oK\n1QKBgDDNm9MBRY8OTKCQKj9HJx7Gh3zFKHIIBAjZlEdcwgzjsNi8+HsQuDiTkroe\nxhXjGNCek0vwr81HAa0wbEFPF1ohxkICUavo10SAMeLZQGRGhYV6oxCpD415oZI2\n0sZlQjRBG6S4zkBIk9R7+RMz3YGpey/SnNFWhhrBKBMPU0VW\n-----END RSA PRIVATE KEY-----",
              "internal_public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAwP3xABDWtk9+5k2LKV/pm6igfLd+NyM+vbnJpy5+PmCv1FGwL99I5EmNsOlbmooUFxtbn8cg595yy+kvB0ENLAYqBp3vaC/M/Vj4KTGd0xm/RIq0mAp5Jw8ZW+AmXxMOOoAxocaJ6m/kquF5W1kVUfq2IfMmCZEc86Bb/Wy9z6ntA4KKP0HTenzkTSVVRnuwR+DMSac9c3LMoUgULLCJ4+orFSifmin8wbO/cwOoo8T/UDWVeLPkPR+h9c5ne9cq0Lpx0MneqctU8tr/UwBGTStUVesC+h6A+iDZVHcIB5zlpc93KFXqEQSbauXnQE/mpZaJLCMJmV2NR2sv1VCeww==",
              "keypairs": "https://api.engineyard.com/environments/9/keypairs",
              "logical_databases": "https://api.engineyard.com/environments/9/logical-databases",
              "monitor_url": null,
              "name": "d84987cb",
              "server_alerts": "https://api.engineyard.com/environments/9/server-alerts",
              "servers": "https://api.engineyard.com/environments/9/servers",
              "service_level": "default",
              "service_plan": null,
              "snapshots": "https://api.engineyard.com/environments/9/snapshots",
              "updated_at": "2018-04-12T17:55:31+00:00",
              "auto_scaling_group": null,
              "available_upgrade_web_uri": null,
              "custom_recipes": null,
              "database_backup_interval": 24,
              "database_backup_limit": 10,
              "database_stack": "postgres9_4",
              "deploy_method": "serverside",
              "deployments": "https://api.engineyard.com/environments/9/deployments",
              "encrypted_database_ebs": false,
              "encrypted_ebs_for_everything": false,
              "environment_variables": "https://api.engineyard.com/environments/9/environment_variables",
              "framework_env": "production",
              "kubey_cluster": "https://api.engineyard.com/environments/9/kubey_cluster",
              "kubey_logical_database_count": null,
              "kubey_master_count": 0,
              "kubey_node_count": 0,
              "language": "Ruby 2.1.5",
              "lock_db_version": true,
              "network": null,
              "region": "us-east-1",
              "release_label": "stable-v4-2.0.126",
              "requests": "https://api.engineyard.com/environments/9/requests",
              "snapshot_limit": 10,
              "snapshot_retention": 90,
              "stack_name": "nginx_passenger4",
              "takeover_preference": "snapshot",
              "upgrade_available": false,
              "username": "deploy",
              "vpc_name": null,
              "vpc_provisioned_id": null
            }
          }
            
          








Create an environment with an associated network

POST /accounts/:account/environments

Parameters

account
required: false
Account to assign the environment to
application_id
required: true
scope: environment
Id of the application to associate with this environment
database_backup_interval
required: false
How often to run backups (in hours)
database_backup_limit
required: false
Number of logical database backups to keep
database_stack
required: false
scope: environment
default: postgres9_4
Database stack name. Valid values are: ["mysql", "mysql5_1", "mysql5_5", "mysql5_6", "mysql5_7", "aurora5_6", "mariadb10_0", "postgres", "postgres9", "postgres9_1", "postgres9_2", "postgres9_3", "postgres9_4", "postgres9_5", "postgres9_6", "no_db"]
deploy_method
required: false
scope: environment
default: serverside
Default deployment method for the environment. Valid values are chef, serverside, none
encrypted_database_ebs
required: false
scope: environment
Should the database volumes be encrypted
encrypted_ebs_for_everything
required: false
scope: environment
Should the volumes for all servers be encrypted. This setting will take precedence over encrypted_database_ebs
framework_env
required: false
scope: environment
default: production
Framework for the environment. Production, staging, development, etc
language
required: false
scope: environment
default: Ruby 2.2
Language and version to support. Valid values are: Ruby 1.9.3, Ruby 2.0.0, Ruby 2.1.2, Ruby 2.1.5, Ruby 2.2, Ruby 2.3, Ruby 2.4, PHP, Node.js
lock_db_version
required: false
scope: environment
Prevent database version changes
name
required: true
scope: environment
Name of the environment
network_id
required: false
scope: environment
Network ID to associate with this environment
region
required: false
scope: environment
Region for the environment
snapshot_limit
required: false
scope: environment
Number of snapshots to keep
snapshot_retention
required: false
scope: environment
Number of days to keep the snapshots
takeover_preference
required: false
scope: environment
default: snapshot
How to handle takeovers. Valid values: [snapshot, new_volume, no_slave, disable]

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
            "network": "a34d4013-aaf5-4e51-afa4-8c824cca64d3",
            "environment": {
              "name": "f82904f7",
              "application_id": 27
            }
          }
            
          

Response

          Status: 201 Created
          Content-Type: application/json; charset=utf-8
          
            
          {
            "environment": {
              "id": 11,
              "account": "https://api.engineyard.com/accounts/aa303e25-2771-40ce-9b9a-da4828554b82",
              "alerts": "https://api.engineyard.com/environments/11/server-alerts",
              "applications": "https://api.engineyard.com/environments/11/applications",
              "classic": true,
              "created_at": "2018-04-12T17:55:38+00:00",
              "database_services": "https://api.engineyard.com/environments/11/database-services",
              "deleted_at": null,
              "firewall": null,
              "internal_private_key": "-----BEGIN RSA PRIVATE KEY-----\nMIIEoAIBAAKCAQEAwP3xABDWtk9+5k2LKV/pm6igfLd+NyM+vbnJpy5+PmCv1FGw\nL99I5EmNsOlbmooUFxtbn8cg595yy+kvB0ENLAYqBp3vaC/M/Vj4KTGd0xm/RIq0\nmAp5Jw8ZW+AmXxMOOoAxocaJ6m/kquF5W1kVUfq2IfMmCZEc86Bb/Wy9z6ntA4KK\nP0HTenzkTSVVRnuwR+DMSac9c3LMoUgULLCJ4+orFSifmin8wbO/cwOoo8T/UDWV\neLPkPR+h9c5ne9cq0Lpx0MneqctU8tr/UwBGTStUVesC+h6A+iDZVHcIB5zlpc93\nKFXqEQSbauXnQE/mpZaJLCMJmV2NR2sv1VCewwIBIwKCAQB+0sLxaiayUX9G4oAF\nPwc6Z39n5kugk4EAVYSDzhhyIkeox/dv6oBbgMrTV4VW7QXjTH4J6UGCbZvlFZPu\n0voG/LyIAWLPb956mY0iYm8HEOtnjllrOhUZqtYmbrohOGhvlhH8mGlCSYejfjnO\nUHu5h38AXfRsr9EyYhCQl+pyhHeDZwM0MQm5459XTmoSjW7AcFaE4qn0CD0VGeQ9\nDlbH2zCcQU3+Ljpvla+ME5yN3qeppKd/bQQp3FT7MpxdDcEGDHtnkAEhggbRcXJ+\nrBw5F8GN2j8f5jZdflnb8FHVI+iAiTLfBc74V1+z5n+XnkwbtagjQpU1MpyeKp5R\nPGPTAoGBAORa/BsN7zYqw0wsCSQv3kpkGjZNnVO8PUxThVddpLJiDZI1xyWOPCrW\nlwdk8cPC2uNwc83HY/u3qMARLwfcOQdNWtvjZWwYjWjulh2b884FFVgMopPGKPpc\nNzNxdsXRajEWbw8eK8Sv6j/qF9wpMMwCFB8h0pMBorJo8V65zPktAoGBANha/+/h\n5pmkJ49kmbwyCPUBt3Z/vB6+SlsBIOcN9gWJYoaNbWeJIehMcJaoNtVArYwKIEM9\nUPhySPxmXXzPO0ux0igNA77CbOzFjR05EbGB5rRbKNd92fw8KV/tWucTPthRV/k8\nWPWOJhfIFj3MOVjopaHUqFvimlvXhuAwlw2vAoGAVNFWUzEPtQiRrpQDZTZZ4R3d\n2afMuLOhvUOX7UAJ+R0a+8rU8LEsSmz2RJM1OhUsuuCgCpqEOOxx4PBwjeQVLpkT\nHnkIafp9qqHCuoph3s6wKASxahZm/ee8u1YHi03IW2AanzcXkjK2F71ZUcYoEUKZ\nwmul/BaM4y5LBe09gR8CgYA3ol8RzF/eXWlCIS7Ynybf6n+iINiaMO6MbgEleJ5Z\nMfTDg3PnbGfOBQcCK0FMx30VYbCGUZh6ZofL387llF+0YOzlujQpvPdwFYqvvje/\n7jQCfddNWuBILLounB6wcqnCmJL28kLCzMf3fJgBQySwdlZ6Ehyp6c/ruxQNw1oK\n1QKBgDDNm9MBRY8OTKCQKj9HJx7Gh3zFKHIIBAjZlEdcwgzjsNi8+HsQuDiTkroe\nxhXjGNCek0vwr81HAa0wbEFPF1ohxkICUavo10SAMeLZQGRGhYV6oxCpD415oZI2\n0sZlQjRBG6S4zkBIk9R7+RMz3YGpey/SnNFWhhrBKBMPU0VW\n-----END RSA PRIVATE KEY-----",
              "internal_public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAwP3xABDWtk9+5k2LKV/pm6igfLd+NyM+vbnJpy5+PmCv1FGwL99I5EmNsOlbmooUFxtbn8cg595yy+kvB0ENLAYqBp3vaC/M/Vj4KTGd0xm/RIq0mAp5Jw8ZW+AmXxMOOoAxocaJ6m/kquF5W1kVUfq2IfMmCZEc86Bb/Wy9z6ntA4KKP0HTenzkTSVVRnuwR+DMSac9c3LMoUgULLCJ4+orFSifmin8wbO/cwOoo8T/UDWVeLPkPR+h9c5ne9cq0Lpx0MneqctU8tr/UwBGTStUVesC+h6A+iDZVHcIB5zlpc93KFXqEQSbauXnQE/mpZaJLCMJmV2NR2sv1VCeww==",
              "keypairs": "https://api.engineyard.com/environments/11/keypairs",
              "logical_databases": "https://api.engineyard.com/environments/11/logical-databases",
              "monitor_url": null,
              "name": "f82904f7",
              "server_alerts": "https://api.engineyard.com/environments/11/server-alerts",
              "servers": "https://api.engineyard.com/environments/11/servers",
              "service_level": "default",
              "service_plan": null,
              "snapshots": "https://api.engineyard.com/environments/11/snapshots",
              "updated_at": "2018-04-12T17:55:38+00:00",
              "auto_scaling_group": null,
              "available_upgrade_web_uri": null,
              "custom_recipes": null,
              "database_backup_interval": 24,
              "database_backup_limit": 10,
              "database_stack": "postgres9_4",
              "deploy_method": "serverside",
              "deployments": "https://api.engineyard.com/environments/11/deployments",
              "encrypted_database_ebs": false,
              "encrypted_ebs_for_everything": false,
              "environment_variables": "https://api.engineyard.com/environments/11/environment_variables",
              "framework_env": "production",
              "kubey_cluster": "https://api.engineyard.com/environments/11/kubey_cluster",
              "kubey_logical_database_count": null,
              "kubey_master_count": 0,
              "kubey_node_count": 0,
              "language": "Ruby 2.2",
              "lock_db_version": true,
              "network": "https://api.engineyard.com/networks/a34d4013-aaf5-4e51-afa4-8c824cca64d3",
              "region": "us-east-1",
              "release_label": "stable-v4-2.0.126",
              "requests": "https://api.engineyard.com/environments/11/requests",
              "snapshot_limit": 10,
              "snapshot_retention": 90,
              "stack_name": "nginx_passenger4",
              "takeover_preference": "snapshot",
              "upgrade_available": false,
              "username": "deploy",
              "vpc_name": null,
              "vpc_provisioned_id": "vpc-409d2b86"
            }
          }
            
          








Create an environment with encrypted EBS volumes

POST /accounts/:account/environments

Parameters

account
required: false
Account to assign the environment to
application_id
required: true
scope: environment
Id of the application to associate with this environment
database_backup_interval
required: false
How often to run backups (in hours)
database_backup_limit
required: false
Number of logical database backups to keep
database_stack
required: false
scope: environment
default: postgres9_4
Database stack name. Valid values are: ["mysql", "mysql5_1", "mysql5_5", "mysql5_6", "mysql5_7", "aurora5_6", "mariadb10_0", "postgres", "postgres9", "postgres9_1", "postgres9_2", "postgres9_3", "postgres9_4", "postgres9_5", "postgres9_6", "no_db"]
deploy_method
required: false
scope: environment
default: serverside
Default deployment method for the environment. Valid values are chef, serverside, none
encrypted_database_ebs
required: false
scope: environment
Should the database volumes be encrypted
encrypted_ebs_for_everything
required: false
scope: environment
Should the volumes for all servers be encrypted. This setting will take precedence over encrypted_database_ebs
framework_env
required: false
scope: environment
default: production
Framework for the environment. Production, staging, development, etc
language
required: false
scope: environment
default: Ruby 2.2
Language and version to support. Valid values are: Ruby 1.9.3, Ruby 2.0.0, Ruby 2.1.2, Ruby 2.1.5, Ruby 2.2, Ruby 2.3, Ruby 2.4, PHP, Node.js
lock_db_version
required: false
scope: environment
Prevent database version changes
name
required: true
scope: environment
Name of the environment
network_id
required: false
scope: environment
Network ID to associate with this environment
region
required: false
scope: environment
Region for the environment
snapshot_limit
required: false
scope: environment
Number of snapshots to keep
snapshot_retention
required: false
scope: environment
Number of days to keep the snapshots
takeover_preference
required: false
scope: environment
default: snapshot
How to handle takeovers. Valid values: [snapshot, new_volume, no_slave, disable]

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
            "environment": {
              "name": "d2605dd8",
              "application_id": 24,
              "encrypted_ebs_for_everything": true
            }
          }
            
          

Response

          Status: 201 Created
          Content-Type: application/json; charset=utf-8
          
            
          {
            "environment": {
              "id": 8,
              "account": "https://api.engineyard.com/accounts/507fa502-9942-4287-b35d-630c7688df27",
              "alerts": "https://api.engineyard.com/environments/8/server-alerts",
              "applications": "https://api.engineyard.com/environments/8/applications",
              "classic": true,
              "created_at": "2018-04-12T17:55:29+00:00",
              "database_services": "https://api.engineyard.com/environments/8/database-services",
              "deleted_at": null,
              "firewall": null,
              "internal_private_key": "-----BEGIN RSA PRIVATE KEY-----\nMIIEoAIBAAKCAQEAwP3xABDWtk9+5k2LKV/pm6igfLd+NyM+vbnJpy5+PmCv1FGw\nL99I5EmNsOlbmooUFxtbn8cg595yy+kvB0ENLAYqBp3vaC/M/Vj4KTGd0xm/RIq0\nmAp5Jw8ZW+AmXxMOOoAxocaJ6m/kquF5W1kVUfq2IfMmCZEc86Bb/Wy9z6ntA4KK\nP0HTenzkTSVVRnuwR+DMSac9c3LMoUgULLCJ4+orFSifmin8wbO/cwOoo8T/UDWV\neLPkPR+h9c5ne9cq0Lpx0MneqctU8tr/UwBGTStUVesC+h6A+iDZVHcIB5zlpc93\nKFXqEQSbauXnQE/mpZaJLCMJmV2NR2sv1VCewwIBIwKCAQB+0sLxaiayUX9G4oAF\nPwc6Z39n5kugk4EAVYSDzhhyIkeox/dv6oBbgMrTV4VW7QXjTH4J6UGCbZvlFZPu\n0voG/LyIAWLPb956mY0iYm8HEOtnjllrOhUZqtYmbrohOGhvlhH8mGlCSYejfjnO\nUHu5h38AXfRsr9EyYhCQl+pyhHeDZwM0MQm5459XTmoSjW7AcFaE4qn0CD0VGeQ9\nDlbH2zCcQU3+Ljpvla+ME5yN3qeppKd/bQQp3FT7MpxdDcEGDHtnkAEhggbRcXJ+\nrBw5F8GN2j8f5jZdflnb8FHVI+iAiTLfBc74V1+z5n+XnkwbtagjQpU1MpyeKp5R\nPGPTAoGBAORa/BsN7zYqw0wsCSQv3kpkGjZNnVO8PUxThVddpLJiDZI1xyWOPCrW\nlwdk8cPC2uNwc83HY/u3qMARLwfcOQdNWtvjZWwYjWjulh2b884FFVgMopPGKPpc\nNzNxdsXRajEWbw8eK8Sv6j/qF9wpMMwCFB8h0pMBorJo8V65zPktAoGBANha/+/h\n5pmkJ49kmbwyCPUBt3Z/vB6+SlsBIOcN9gWJYoaNbWeJIehMcJaoNtVArYwKIEM9\nUPhySPxmXXzPO0ux0igNA77CbOzFjR05EbGB5rRbKNd92fw8KV/tWucTPthRV/k8\nWPWOJhfIFj3MOVjopaHUqFvimlvXhuAwlw2vAoGAVNFWUzEPtQiRrpQDZTZZ4R3d\n2afMuLOhvUOX7UAJ+R0a+8rU8LEsSmz2RJM1OhUsuuCgCpqEOOxx4PBwjeQVLpkT\nHnkIafp9qqHCuoph3s6wKASxahZm/ee8u1YHi03IW2AanzcXkjK2F71ZUcYoEUKZ\nwmul/BaM4y5LBe09gR8CgYA3ol8RzF/eXWlCIS7Ynybf6n+iINiaMO6MbgEleJ5Z\nMfTDg3PnbGfOBQcCK0FMx30VYbCGUZh6ZofL387llF+0YOzlujQpvPdwFYqvvje/\n7jQCfddNWuBILLounB6wcqnCmJL28kLCzMf3fJgBQySwdlZ6Ehyp6c/ruxQNw1oK\n1QKBgDDNm9MBRY8OTKCQKj9HJx7Gh3zFKHIIBAjZlEdcwgzjsNi8+HsQuDiTkroe\nxhXjGNCek0vwr81HAa0wbEFPF1ohxkICUavo10SAMeLZQGRGhYV6oxCpD415oZI2\n0sZlQjRBG6S4zkBIk9R7+RMz3YGpey/SnNFWhhrBKBMPU0VW\n-----END RSA PRIVATE KEY-----",
              "internal_public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAwP3xABDWtk9+5k2LKV/pm6igfLd+NyM+vbnJpy5+PmCv1FGwL99I5EmNsOlbmooUFxtbn8cg595yy+kvB0ENLAYqBp3vaC/M/Vj4KTGd0xm/RIq0mAp5Jw8ZW+AmXxMOOoAxocaJ6m/kquF5W1kVUfq2IfMmCZEc86Bb/Wy9z6ntA4KKP0HTenzkTSVVRnuwR+DMSac9c3LMoUgULLCJ4+orFSifmin8wbO/cwOoo8T/UDWVeLPkPR+h9c5ne9cq0Lpx0MneqctU8tr/UwBGTStUVesC+h6A+iDZVHcIB5zlpc93KFXqEQSbauXnQE/mpZaJLCMJmV2NR2sv1VCeww==",
              "keypairs": "https://api.engineyard.com/environments/8/keypairs",
              "logical_databases": "https://api.engineyard.com/environments/8/logical-databases",
              "monitor_url": null,
              "name": "d2605dd8",
              "server_alerts": "https://api.engineyard.com/environments/8/server-alerts",
              "servers": "https://api.engineyard.com/environments/8/servers",
              "service_level": "default",
              "service_plan": null,
              "snapshots": "https://api.engineyard.com/environments/8/snapshots",
              "updated_at": "2018-04-12T17:55:29+00:00",
              "auto_scaling_group": null,
              "available_upgrade_web_uri": null,
              "custom_recipes": null,
              "database_backup_interval": 24,
              "database_backup_limit": 10,
              "database_stack": "postgres9_4",
              "deploy_method": "serverside",
              "deployments": "https://api.engineyard.com/environments/8/deployments",
              "encrypted_database_ebs": false,
              "encrypted_ebs_for_everything": true,
              "environment_variables": "https://api.engineyard.com/environments/8/environment_variables",
              "framework_env": "production",
              "kubey_cluster": "https://api.engineyard.com/environments/8/kubey_cluster",
              "kubey_logical_database_count": null,
              "kubey_master_count": 0,
              "kubey_node_count": 0,
              "language": "Ruby 2.2",
              "lock_db_version": true,
              "network": null,
              "region": "us-east-1",
              "release_label": "stable-v4-2.0.126",
              "requests": "https://api.engineyard.com/environments/8/requests",
              "snapshot_limit": 10,
              "snapshot_retention": 90,
              "stack_name": "nginx_passenger4",
              "takeover_preference": "snapshot",
              "upgrade_available": false,
              "username": "deploy",
              "vpc_name": null,
              "vpc_provisioned_id": null
            }
          }
            
          








Delete an environment

DELETE /environments/:environment

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
          }
            
          

Response

          Status: 200 OK
          Content-Type: application/json; charset=utf-8
          
            
          {
            "request": {
              "type": "destroy_environment",
              "id": "81b16032-85f2-4308-ba28-f4d2ef87ff72",
              "created_at": "2018-04-12T17:58:19+00:00",
              "started_at": "2018-04-12T17:58:19+00:00",
              "finished_at": "2018-04-12T17:58:26+00:00",
              "message": null,
              "request_status": "Finished: Destroy environment (81b16032-85f2-4308-ba28-f4d2ef87ff72) (less than a minute ago)",
              "successful": true,
              "updated_at": "2018-04-12T17:58:26+00:00",
              "read_channel": null,
              "stage": "cleanup",
              "dependencies": "https://api.engineyard.com/requests/81b16032-85f2-4308-ba28-f4d2ef87ff72/dependencies",
              "stages": "https://api.engineyard.com/requests/81b16032-85f2-4308-ba28-f4d2ef87ff72/stages",
              "account": "https://api.engineyard.com/accounts/902a6a9b-ec56-46bc-8461-7c62a88f430c",
              "requester": "https://api.engineyard.com/requests/81b16032-85f2-4308-ba28-f4d2ef87ff72/requester",
              "messages": "https://api.engineyard.com/requests/81b16032-85f2-4308-ba28-f4d2ef87ff72/messages",
              "callback_url": "https://api.engineyard.com/requests/81b16032-85f2-4308-ba28-f4d2ef87ff72/callback",
              "progress": false,
              "resource": "https://api.engineyard.com/environments/22"
            }
          }
            
          








Deploy an application to an environment

POST /environments/:environment/deploy

Parameters

application_id
required: true
Id of the application to deploy
deploy
required: true
Hash of deployment options
ref
required: true
scope: deploy
Ref to deploy (HEAD, master, branch, etc)
migrate
required: false
scope: deploy
Boolean whether or not to migrate the database
migrate_command
required: false
scope: deploy
Command to run during the migration

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
            "application_id": 39,
            "deploy": {
              "ref": "HEAD",
              "migrate": true,
              "migration_command": "bundle exec rake db:migrate"
            }
          }
            
          

Response

          Status: 200 OK
          Content-Type: application/json; charset=utf-8
          
            
          {
            "request": {
              "type": "app_deployment",
              "id": "663cb3f0-7ea4-4ba0-a214-c19635e41aa3",
              "created_at": "2018-04-12T17:58:40+00:00",
              "started_at": "2018-04-12T17:58:40+00:00",
              "finished_at": "2018-04-12T17:58:40+00:00",
              "message": null,
              "request_status": "Finished: App deployment (663cb3f0-7ea4-4ba0-a214-c19635e41aa3) (less than a minute ago)",
              "successful": true,
              "updated_at": "2018-04-12T17:58:40+00:00",
              "read_channel": "https://messages.engineyard.com/stream?subscription=%2Frequests%2F663cb3f0&token=35053803e4bcdec320f403d2a2303ea5",
              "stage": "deploy",
              "dependencies": "https://api.engineyard.com/requests/663cb3f0-7ea4-4ba0-a214-c19635e41aa3/dependencies",
              "stages": "https://api.engineyard.com/requests/663cb3f0-7ea4-4ba0-a214-c19635e41aa3/stages",
              "account": "https://api.engineyard.com/accounts/9b63ecf9-c421-4faf-a10b-853ec402a044",
              "requester": "https://api.engineyard.com/requests/663cb3f0-7ea4-4ba0-a214-c19635e41aa3/requester",
              "messages": "https://api.engineyard.com/requests/663cb3f0-7ea4-4ba0-a214-c19635e41aa3/messages",
              "callback_url": "https://api.engineyard.com/requests/663cb3f0-7ea4-4ba0-a214-c19635e41aa3/callback",
              "progress": false,
              "resource": "https://api.engineyard.com/deployments/9"
            }
          }
            
          








Disable maintenance on an application in an environment

PUT /environments/:environment/maintenance

Parameters

application_id
required: true
Id of the application to deploy
maintenance
required: true
Hash of maintenance options
action
required: true
scope: maintenance
Enable/Disable maintenance

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
            "application_id": 42,
            "maintenance": {
              "action": "disable"
            }
          }
            
          

Response

          Status: 200 OK
          Content-Type: application/json; charset=utf-8
          
            
          {
            "request": {
              "type": "app_deployment_maintenance",
              "id": "8e68b2dc-85f2-4bb1-9fba-0e4dd73ae720",
              "created_at": "2018-04-12T17:59:23+00:00",
              "started_at": "2018-04-12T17:59:23+00:00",
              "finished_at": "2018-04-12T17:59:23+00:00",
              "message": null,
              "request_status": "Finished: App deployment maintenance (8e68b2dc-85f2-4bb1-9fba-0e4dd73ae720) (less than a minute ago)",
              "successful": true,
              "updated_at": "2018-04-12T17:59:23+00:00",
              "read_channel": null,
              "stage": "set_maintenance",
              "dependencies": "https://api.engineyard.com/requests/8e68b2dc-85f2-4bb1-9fba-0e4dd73ae720/dependencies",
              "stages": "https://api.engineyard.com/requests/8e68b2dc-85f2-4bb1-9fba-0e4dd73ae720/stages",
              "account": "https://api.engineyard.com/accounts/98ab773d-89f6-43b6-98ba-8925b87725e4",
              "requester": "https://api.engineyard.com/requests/8e68b2dc-85f2-4bb1-9fba-0e4dd73ae720/requester",
              "messages": "https://api.engineyard.com/requests/8e68b2dc-85f2-4bb1-9fba-0e4dd73ae720/messages",
              "callback_url": "https://api.engineyard.com/requests/8e68b2dc-85f2-4bb1-9fba-0e4dd73ae720/callback",
              "progress": false,
              "resource": false
            }
          }
            
          








Enable maintenance on an application in an environment

PUT /environments/:environment/maintenance

Parameters

application_id
required: true
Id of the application to deploy
maintenance
required: true
Hash of maintenance options
action
required: true
scope: maintenance
Enable/Disable maintenance

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
            "application_id": 41,
            "maintenance": {
              "action": "enable"
            }
          }
            
          

Response

          Status: 200 OK
          Content-Type: application/json; charset=utf-8
          
            
          {
            "request": {
              "type": "app_deployment_maintenance",
              "id": "6d712c3d-b07b-41c1-9fcb-bac03d21241c",
              "created_at": "2018-04-12T17:59:09+00:00",
              "started_at": "2018-04-12T17:59:09+00:00",
              "finished_at": "2018-04-12T17:59:10+00:00",
              "message": null,
              "request_status": "Finished: App deployment maintenance (6d712c3d-b07b-41c1-9fcb-bac03d21241c) (less than a minute ago)",
              "successful": true,
              "updated_at": "2018-04-12T17:59:10+00:00",
              "read_channel": null,
              "stage": "set_maintenance",
              "dependencies": "https://api.engineyard.com/requests/6d712c3d-b07b-41c1-9fcb-bac03d21241c/dependencies",
              "stages": "https://api.engineyard.com/requests/6d712c3d-b07b-41c1-9fcb-bac03d21241c/stages",
              "account": "https://api.engineyard.com/accounts/5fa9df2b-108e-4089-8af8-950aa837c991",
              "requester": "https://api.engineyard.com/requests/6d712c3d-b07b-41c1-9fcb-bac03d21241c/requester",
              "messages": "https://api.engineyard.com/requests/6d712c3d-b07b-41c1-9fcb-bac03d21241c/messages",
              "callback_url": "https://api.engineyard.com/requests/6d712c3d-b07b-41c1-9fcb-bac03d21241c/callback",
              "progress": false,
              "resource": false
            }
          }
            
          








List environments

GET /environments

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
          }
            
          

Response

          Status: 200 OK
          Content-Type: application/json; charset=utf-8
          
            
          {
            "environments": [
              {
                "id": 12,
                "account": "https://api.engineyard.com/accounts/74864529-4607-4794-9c21-3bb18c1b9344",
                "alerts": "https://api.engineyard.com/environments/12/server-alerts",
                "applications": "https://api.engineyard.com/environments/12/applications",
                "classic": true,
                "created_at": "2018-04-12T17:55:41+00:00",
                "database_services": "https://api.engineyard.com/environments/12/database-services",
                "deleted_at": null,
                "firewall": null,
                "internal_private_key": "-----BEGIN RSA PRIVATE KEY-----\nMIIEoAIBAAKCAQEAwP3xABDWtk9+5k2LKV/pm6igfLd+NyM+vbnJpy5+PmCv1FGw\nL99I5EmNsOlbmooUFxtbn8cg595yy+kvB0ENLAYqBp3vaC/M/Vj4KTGd0xm/RIq0\nmAp5Jw8ZW+AmXxMOOoAxocaJ6m/kquF5W1kVUfq2IfMmCZEc86Bb/Wy9z6ntA4KK\nP0HTenzkTSVVRnuwR+DMSac9c3LMoUgULLCJ4+orFSifmin8wbO/cwOoo8T/UDWV\neLPkPR+h9c5ne9cq0Lpx0MneqctU8tr/UwBGTStUVesC+h6A+iDZVHcIB5zlpc93\nKFXqEQSbauXnQE/mpZaJLCMJmV2NR2sv1VCewwIBIwKCAQB+0sLxaiayUX9G4oAF\nPwc6Z39n5kugk4EAVYSDzhhyIkeox/dv6oBbgMrTV4VW7QXjTH4J6UGCbZvlFZPu\n0voG/LyIAWLPb956mY0iYm8HEOtnjllrOhUZqtYmbrohOGhvlhH8mGlCSYejfjnO\nUHu5h38AXfRsr9EyYhCQl+pyhHeDZwM0MQm5459XTmoSjW7AcFaE4qn0CD0VGeQ9\nDlbH2zCcQU3+Ljpvla+ME5yN3qeppKd/bQQp3FT7MpxdDcEGDHtnkAEhggbRcXJ+\nrBw5F8GN2j8f5jZdflnb8FHVI+iAiTLfBc74V1+z5n+XnkwbtagjQpU1MpyeKp5R\nPGPTAoGBAORa/BsN7zYqw0wsCSQv3kpkGjZNnVO8PUxThVddpLJiDZI1xyWOPCrW\nlwdk8cPC2uNwc83HY/u3qMARLwfcOQdNWtvjZWwYjWjulh2b884FFVgMopPGKPpc\nNzNxdsXRajEWbw8eK8Sv6j/qF9wpMMwCFB8h0pMBorJo8V65zPktAoGBANha/+/h\n5pmkJ49kmbwyCPUBt3Z/vB6+SlsBIOcN9gWJYoaNbWeJIehMcJaoNtVArYwKIEM9\nUPhySPxmXXzPO0ux0igNA77CbOzFjR05EbGB5rRbKNd92fw8KV/tWucTPthRV/k8\nWPWOJhfIFj3MOVjopaHUqFvimlvXhuAwlw2vAoGAVNFWUzEPtQiRrpQDZTZZ4R3d\n2afMuLOhvUOX7UAJ+R0a+8rU8LEsSmz2RJM1OhUsuuCgCpqEOOxx4PBwjeQVLpkT\nHnkIafp9qqHCuoph3s6wKASxahZm/ee8u1YHi03IW2AanzcXkjK2F71ZUcYoEUKZ\nwmul/BaM4y5LBe09gR8CgYA3ol8RzF/eXWlCIS7Ynybf6n+iINiaMO6MbgEleJ5Z\nMfTDg3PnbGfOBQcCK0FMx30VYbCGUZh6ZofL387llF+0YOzlujQpvPdwFYqvvje/\n7jQCfddNWuBILLounB6wcqnCmJL28kLCzMf3fJgBQySwdlZ6Ehyp6c/ruxQNw1oK\n1QKBgDDNm9MBRY8OTKCQKj9HJx7Gh3zFKHIIBAjZlEdcwgzjsNi8+HsQuDiTkroe\nxhXjGNCek0vwr81HAa0wbEFPF1ohxkICUavo10SAMeLZQGRGhYV6oxCpD415oZI2\n0sZlQjRBG6S4zkBIk9R7+RMz3YGpey/SnNFWhhrBKBMPU0VW\n-----END RSA PRIVATE KEY-----",
                "internal_public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAwP3xABDWtk9+5k2LKV/pm6igfLd+NyM+vbnJpy5+PmCv1FGwL99I5EmNsOlbmooUFxtbn8cg595yy+kvB0ENLAYqBp3vaC/M/Vj4KTGd0xm/RIq0mAp5Jw8ZW+AmXxMOOoAxocaJ6m/kquF5W1kVUfq2IfMmCZEc86Bb/Wy9z6ntA4KKP0HTenzkTSVVRnuwR+DMSac9c3LMoUgULLCJ4+orFSifmin8wbO/cwOoo8T/UDWVeLPkPR+h9c5ne9cq0Lpx0MneqctU8tr/UwBGTStUVesC+h6A+iDZVHcIB5zlpc93KFXqEQSbauXnQE/mpZaJLCMJmV2NR2sv1VCeww==",
                "keypairs": "https://api.engineyard.com/environments/12/keypairs",
                "logical_databases": "https://api.engineyard.com/environments/12/logical-databases",
                "monitor_url": null,
                "name": "279147",
                "server_alerts": "https://api.engineyard.com/environments/12/server-alerts",
                "servers": "https://api.engineyard.com/environments/12/servers",
                "service_level": "default",
                "service_plan": null,
                "snapshots": "https://api.engineyard.com/environments/12/snapshots",
                "updated_at": "2018-04-12T17:55:41+00:00",
                "auto_scaling_group": null,
                "available_upgrade_web_uri": null,
                "custom_recipes": null,
                "database_backup_interval": 24,
                "database_backup_limit": 10,
                "database_stack": "postgres9_4",
                "deploy_method": "serverside",
                "deployments": "https://api.engineyard.com/environments/12/deployments",
                "encrypted_database_ebs": false,
                "encrypted_ebs_for_everything": false,
                "environment_variables": "https://api.engineyard.com/environments/12/environment_variables",
                "framework_env": "production",
                "kubey_cluster": "https://api.engineyard.com/environments/12/kubey_cluster",
                "kubey_logical_database_count": null,
                "kubey_master_count": 0,
                "kubey_node_count": 0,
                "language": "Ruby 2.2",
                "lock_db_version": true,
                "network": null,
                "region": "us-east-2",
                "release_label": "stable-v4-2.0.126",
                "requests": "https://api.engineyard.com/environments/12/requests",
                "snapshot_limit": 10,
                "snapshot_retention": 90,
                "stack_name": "nginx_passenger4",
                "takeover_preference": "snapshot",
                "upgrade_available": false,
                "username": "deploy",
                "vpc_name": null,
                "vpc_provisioned_id": null
              }
            ]
          }
            
          








Restart app servers (unicorn, puma, etc)

PUT /environments/:environment/app_restart

Parameters

application_id
required: true
Id of the application to deploy

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
            "application_id": 43
          }
            
          

Response

          Status: 200 OK
          Content-Type: application/json; charset=utf-8
          
            
          {
            "request": {
              "type": "app_server_restart",
              "id": "6c8be45c-a55d-43c0-a741-5fe59d7eae0d",
              "created_at": "2018-04-12T17:59:36+00:00",
              "started_at": "2018-04-12T17:59:36+00:00",
              "finished_at": "2018-04-12T17:59:36+00:00",
              "message": null,
              "request_status": "Finished: App server restart (6c8be45c-a55d-43c0-a741-5fe59d7eae0d) (less than a minute ago)",
              "successful": true,
              "updated_at": "2018-04-12T17:59:36+00:00",
              "read_channel": null,
              "stage": "restart-app-servers",
              "dependencies": "https://api.engineyard.com/requests/6c8be45c-a55d-43c0-a741-5fe59d7eae0d/dependencies",
              "stages": "https://api.engineyard.com/requests/6c8be45c-a55d-43c0-a741-5fe59d7eae0d/stages",
              "account": "https://api.engineyard.com/accounts/75eca1d6-7171-4349-a401-cad5b9e365a2",
              "requester": "https://api.engineyard.com/requests/6c8be45c-a55d-43c0-a741-5fe59d7eae0d/requester",
              "messages": "https://api.engineyard.com/requests/6c8be45c-a55d-43c0-a741-5fe59d7eae0d/messages",
              "callback_url": "https://api.engineyard.com/requests/6c8be45c-a55d-43c0-a741-5fe59d7eae0d/callback",
              "progress": false,
              "resource": false
            }
          }
            
          








Run chef on an environment

POST /environments/:environment/apply

Parameters

type
required: false
Type of chef run (main, custom, quick)

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
          }
            
          

Response

          Status: 200 OK
          Content-Type: application/json; charset=utf-8
          
            
          {
            "request": {
              "type": "configure_environment",
              "id": "bdbf8885-7066-4f87-b0ad-920c8e76a0e5",
              "created_at": "2018-04-12T17:58:55+00:00",
              "started_at": "2018-04-12T17:58:55+00:00",
              "finished_at": "2018-04-12T17:58:56+00:00",
              "message": null,
              "request_status": "Finished: Configure environment (bdbf8885-7066-4f87-b0ad-920c8e76a0e5) (less than a minute ago)",
              "successful": true,
              "updated_at": "2018-04-12T17:58:56+00:00",
              "read_channel": null,
              "stage": "environment.update-instances",
              "dependencies": "https://api.engineyard.com/requests/bdbf8885-7066-4f87-b0ad-920c8e76a0e5/dependencies",
              "stages": "https://api.engineyard.com/requests/bdbf8885-7066-4f87-b0ad-920c8e76a0e5/stages",
              "account": "https://api.engineyard.com/accounts/58f17176-8f39-4fe3-b580-13f1684de00c",
              "requester": "https://api.engineyard.com/requests/bdbf8885-7066-4f87-b0ad-920c8e76a0e5/requester",
              "messages": "https://api.engineyard.com/requests/bdbf8885-7066-4f87-b0ad-920c8e76a0e5/messages",
              "callback_url": "https://api.engineyard.com/requests/bdbf8885-7066-4f87-b0ad-920c8e76a0e5/callback",
              "progress": false,
              "resource": false
            }
          }
            
          








Save a blueprint of an environment

POST /environments/:environment/blueprint

Parameters

name
required: true
Name of the blueprint

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
            "name": "de6731"
          }
            
          

Response

          Status: 200 OK
          Content-Type: application/json; charset=utf-8
          
            
          {
            "blueprint": {
              "id": "15f922d6-a2ca-4320-865b-8720dc99dbda",
              "account": "https://api.engineyard.com/accounts/7a8fca54-8222-4d85-a5c5-2daf4694e3cd",
              "environment": "https://api.engineyard.com/environments/20",
              "created_at": "2018-04-12T17:57:44+00:00",
              "updated_at": "2018-04-12T17:57:44+00:00",
              "data": {
                "app_instances": [
                  {
                    "encrypted": false,
                    "flavor": "m4_large",
                    "mnt_volume_size": 25,
                    "name": null,
                    "volume_iops": null,
                    "volume_size": 15
                  }
                ],
                "db_master": [
          
                ],
                "db_slaves": [
          
                ],
                "utils": [
          
                ]
              },
              "name": "de6731"
            }
          }
            
          








Stop an environment

PUT /environments/:environment/deprovision

Request

          Accept: application/vnd.engineyard.v3+json
          Content-Type: application/json
          
            
          {
          }
            
          

Response

          Status: 200 OK
          Content-Type: application/json; charset=utf-8
          
            
          {
            "request": {
              "type": "deprovision_environment",
              "id": "04fd632b-2f99-4ab9-a9e9-31fc83b052e7",
              "created_at": "2018-04-12T17:57:59+00:00",
              "started_at": "2018-04-12T17:57:59+00:00",
              "finished_at": "2018-04-12T17:58:05+00:00",
              "message": null,
              "request_status": "Finished: Deprovision environment (04fd632b-2f99-4ab9-a9e9-31fc83b052e7) (less than a minute ago)",
              "successful": true,
              "updated_at": "2018-04-12T17:58:05+00:00",
              "read_channel": null,
              "stage": "notify",
              "dependencies": "https://api.engineyard.com/requests/04fd632b-2f99-4ab9-a9e9-31fc83b052e7/dependencies",
              "stages": "https://api.engineyard.com/requests/04fd632b-2f99-4ab9-a9e9-31fc83b052e7/stages",
              "account": "https://api.engineyard.com/accounts/87d589d9-ada8-4912-9248-18e23e07938f",
              "requester": "https://api.engineyard.com/requests/04fd632b-2f99-4ab9-a9e9-31fc83b052e7/requester",
              "messages": "https://api.engineyard.com/requests/04fd632b-2f99-4ab9-a9e9-31fc83b052e7/messages",
              "callback_url": "https://api.engineyard.com/requests/04fd632b-2f99-4ab9-a9e9-31fc83b052e7/callback",
              "progress": false,
              "resource": "https://api.engineyard.com/environments/21"
            }
          }