logo
Expand description

AWS OpsWorks

Welcome to the AWS OpsWorks Stacks API Reference. This guide provides descriptions, syntax, and usage examples for AWS OpsWorks Stacks actions and data types, including common parameters and error codes.

AWS OpsWorks Stacks is an application management service that provides an integrated experience for overseeing the complete application lifecycle. For information about this product, go to the AWS OpsWorks details page.

SDKs and CLI

The most common way to use the AWS OpsWorks Stacks API is by using the AWS Command Line Interface (CLI) or by using one of the AWS SDKs to implement applications in your preferred language. For more information, see:

Endpoints

AWS OpsWorks Stacks supports the following endpoints, all HTTPS. You must connect to one of the following endpoints. Stacks can only be accessed or managed within the endpoint in which they are created.

  • opsworks.us-east-1.amazonaws.com

  • opsworks.us-east-2.amazonaws.com

  • opsworks.us-west-1.amazonaws.com

  • opsworks.us-west-2.amazonaws.com

  • opsworks.ca-central-1.amazonaws.com (API only; not available in the AWS console)

  • opsworks.eu-west-1.amazonaws.com

  • opsworks.eu-west-2.amazonaws.com

  • opsworks.eu-west-3.amazonaws.com

  • opsworks.eu-central-1.amazonaws.com

  • opsworks.ap-northeast-1.amazonaws.com

  • opsworks.ap-northeast-2.amazonaws.com

  • opsworks.ap-south-1.amazonaws.com

  • opsworks.ap-southeast-1.amazonaws.com

  • opsworks.ap-southeast-2.amazonaws.com

  • opsworks.sa-east-1.amazonaws.com

Chef Versions

When you call CreateStack, CloneStack, or UpdateStack we recommend you use the ConfigurationManager parameter to specify the Chef version. The recommended and default value for Linux stacks is currently 12. Windows stacks use Chef 12.2. For more information, see Chef Versions.

You can specify Chef 12, 11.10, or 11.4 for your Linux stack. We recommend migrating your existing Linux stacks to Chef 12 as soon as possible.

If you’re using the service, you’re probably looking for OpsWorksClient and OpsWorks.

Structs

Describes an agent version.

A description of the app.

Describes a load-based auto scaling upscaling or downscaling threshold configuration, which specifies when AWS OpsWorks Stacks starts or stops load-based instances.

Describes a block device mapping. This data type maps directly to the Amazon EC2 BlockDeviceMapping data type.

Describes the Chef configuration.

Contains the response to a CloneStack request.

Describes the Amazon CloudWatch logs configuration for a layer.

Describes the Amazon CloudWatch logs configuration for a layer. For detailed information about members of this data type, see the CloudWatch Logs Agent Reference.

Describes a command.

Contains the response to a CreateApp request.

Contains the response to a CreateDeployment request.

Contains the response to a CreateInstance request.

Contains the response to a CreateLayer request.

Contains the response to a CreateStack request.

Contains the response to a CreateUserProfile request.

Describes an app's data source.

Describes a deployment of a stack or app.

Used to specify a stack or deployment command.

Contains the response to a DescribeAgentVersions request.

Contains the response to a DescribeApps request.

Contains the response to a DescribeCommands request.

Contains the response to a DescribeDeployments request.

Contains the response to a DescribeEcsClusters request.

Contains the response to a DescribeElasticIps request.

Contains the response to a DescribeElasticLoadBalancers request.

Contains the response to a DescribeInstances request.

Contains the response to a DescribeLayers request.

Contains the response to a DescribeLoadBasedAutoScaling request.

Contains the response to a DescribeMyUserProfile request.

The response to a DescribeOperatingSystems request.

Contains the response to a DescribePermissions request.

Contains the response to a DescribeRaidArrays request.

Contains the response to a DescribeRdsDbInstances request.

Contains the response to a DescribeServiceErrors request.

Contains the response to a DescribeStackProvisioningParameters request.

Contains the response to a DescribeStackSummary request.

Contains the response to a DescribeStacks request.

Contains the response to a DescribeTimeBasedAutoScaling request.

Contains the response to a DescribeUserProfiles request.

Contains the response to a DescribeVolumes request.

Describes an Amazon EBS volume. This data type maps directly to the Amazon EC2 EbsBlockDevice data type.

Describes a registered Amazon ECS cluster.

Describes an Elastic IP address.

Describes an Elastic Load Balancing instance.

Represents an app's environment variable.

Contains the response to a GetHostnameSuggestion request.

Contains the response to a GrantAccess request.

Describes an instance.

Contains a description of an Amazon EC2 instance from the Amazon EC2 metadata service. For more information, see Instance Metadata and User Data.

Describes how many instances a stack has for each status.

Describes a layer.

Specifies the lifecycle event configuration

Contains the response to a ListTags request.

Describes a layer's load-based auto scaling configuration.

Describes supported operating systems in AWS OpsWorks Stacks.

A block that contains information about the configuration manager (Chef) and the versions of the configuration manager that are supported for an operating system.

A client for the AWS OpsWorks API.

Describes stack or user permissions.

Describes an instance's RAID array.

Describes an Amazon RDS instance.

AWS OpsWorks Stacks supports five lifecycle events: setup, configuration, deploy, undeploy, and shutdown. For each layer, AWS OpsWorks Stacks runs a set of standard recipes for each event. In addition, you can provide custom recipes for any or all layers and events. AWS OpsWorks Stacks runs custom event recipes after the standard recipes. LayerCustomRecipes specifies the custom recipes for a particular layer to be run in response to each of the five events.

To specify a recipe, use the cookbook's directory name in the repository followed by two colons and the recipe name, which is the recipe's file name without the .rb extension. For example: phpapp2::dbsetup specifies the dbsetup.rb recipe in the repository's phpapp2 folder.

Contains the response to a RegisterEcsCluster request.

Contains the response to a RegisterElasticIp request.

Contains the response to a RegisterInstanceResult request.

Contains the response to a RegisterVolume request.

A registered instance's reported operating system.

Describes a user's SSH information.

Describes an AWS OpsWorks Stacks service error.

The Shutdown event configuration.

Contains the information required to retrieve an app or cookbook from a repository. For more information, see Creating Apps or Custom Recipes and Cookbooks.

Describes an app's SSL configuration.

Describes a stack.

Describes the configuration manager.

Summarizes the number of layers, instances, and apps in a stack.

Contains the data needed by RDP clients such as the Microsoft Remote Desktop Connection to log in to the instance.

Describes an instance's time-based auto scaling configuration.

Describes a user's SSH information.

Describes an instance's Amazon EBS volume.

Describes an Amazon EBS volume configuration.

Describes a time-based instance's auto scaling schedule. The schedule consists of a set of key-value pairs.

  • The key is the time period (a UTC hour) and must be an integer from 0 - 23.

  • The value indicates whether the instance should be online or offline for the specified period, and must be set to "on" or "off"

The default setting for all time periods is off, so you use the following parameters primarily to specify the online periods. You don't have to explicitly specify offline periods unless you want to change an online period to an offline period.

The following example specifies that the instance should be online for four hours, from UTC 1200 - 1600. It will be off for the remainder of the day.

{ "12":"on", "13":"on", "14":"on", "15":"on" }

Enums

Errors returned by AssignInstance

Errors returned by AssignVolume

Errors returned by AssociateElasticIp

Errors returned by AttachElasticLoadBalancer

Errors returned by CloneStack

Errors returned by CreateApp

Errors returned by CreateDeployment

Errors returned by CreateInstance

Errors returned by CreateLayer

Errors returned by CreateStack

Errors returned by CreateUserProfile

Errors returned by DeleteApp

Errors returned by DeleteInstance

Errors returned by DeleteLayer

Errors returned by DeleteStack

Errors returned by DeleteUserProfile

Errors returned by DeregisterEcsCluster

Errors returned by DeregisterElasticIp

Errors returned by DeregisterInstance

Errors returned by DeregisterRdsDbInstance

Errors returned by DeregisterVolume

Errors returned by DescribeAgentVersions

Errors returned by DescribeApps

Errors returned by DescribeCommands

Errors returned by DescribeDeployments

Errors returned by DescribeEcsClusters

Errors returned by DescribeElasticIps

Errors returned by DescribeElasticLoadBalancers

Errors returned by DescribeInstances

Errors returned by DescribeLayers

Errors returned by DescribeLoadBasedAutoScaling

Errors returned by DescribeMyUserProfile

Errors returned by DescribeOperatingSystems

Errors returned by DescribePermissions

Errors returned by DescribeRaidArrays

Errors returned by DescribeRdsDbInstances

Errors returned by DescribeServiceErrors

Errors returned by DescribeStackProvisioningParameters

Errors returned by DescribeStackSummary

Errors returned by DescribeStacks

Errors returned by DescribeTimeBasedAutoScaling

Errors returned by DescribeUserProfiles

Errors returned by DescribeVolumes

Errors returned by DetachElasticLoadBalancer

Errors returned by DisassociateElasticIp

Errors returned by GetHostnameSuggestion

Errors returned by GrantAccess

Errors returned by ListTags

Errors returned by RebootInstance

Errors returned by RegisterEcsCluster

Errors returned by RegisterElasticIp

Errors returned by RegisterInstance

Errors returned by RegisterRdsDbInstance

Errors returned by RegisterVolume

Errors returned by SetLoadBasedAutoScaling

Errors returned by SetPermission

Errors returned by SetTimeBasedAutoScaling

Errors returned by StartInstance

Errors returned by StartStack

Errors returned by StopInstance

Errors returned by StopStack

Errors returned by TagResource

Errors returned by UnassignInstance

Errors returned by UnassignVolume

Errors returned by UntagResource

Errors returned by UpdateApp

Errors returned by UpdateElasticIp

Errors returned by UpdateInstance

Errors returned by UpdateLayer

Errors returned by UpdateMyUserProfile

Errors returned by UpdateRdsDbInstance

Errors returned by UpdateStack

Errors returned by UpdateUserProfile

Errors returned by UpdateVolume

Traits

Trait representing the capabilities of the AWS OpsWorks API. AWS OpsWorks clients implement this trait.