opsworks

package module
v0.26.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 30, 2020 License: Apache-2.0 Imports: 25 Imported by: 0

Documentation

Index

Constants

View Source
const ServiceAPIVersion = "2013-02-18"
View Source
const ServiceID = "OpsWorks"

Variables

This section is empty.

Functions

func AddResolveEndpointMiddleware

func AddResolveEndpointMiddleware(stack *middleware.Stack, options ResolveEndpointMiddlewareOptions)

func NewDefaultEndpointResolver

func NewDefaultEndpointResolver() *internalendpoints.Resolver

NewDefaultEndpointResolver constructs a new service endpoint resolver

func RemoveResolveEndpointMiddleware

func RemoveResolveEndpointMiddleware(stack *middleware.Stack) error

Types

type AssignInstanceInput

type AssignInstanceInput struct {
	// The instance ID.
	InstanceId *string
	// The layer ID, which must correspond to a custom layer. You cannot assign a
	// registered instance to a built-in layer.
	LayerIds []*string
}

type AssignInstanceOutput

type AssignInstanceOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type AssignVolumeInput

type AssignVolumeInput struct {
	// The volume ID.
	VolumeId *string
	// The instance ID.
	InstanceId *string
}

type AssignVolumeOutput

type AssignVolumeOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type AssociateElasticIpInput

type AssociateElasticIpInput struct {
	// The Elastic IP address.
	ElasticIp *string
	// The instance ID.
	InstanceId *string
}

type AssociateElasticIpOutput

type AssociateElasticIpOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type AttachElasticLoadBalancerInput

type AttachElasticLoadBalancerInput struct {
	// The ID of the layer to which the Elastic Load Balancing instance is to be
	// attached.
	LayerId *string
	// The Elastic Load Balancing instance's name.
	ElasticLoadBalancerName *string
}

type AttachElasticLoadBalancerOutput

type AttachElasticLoadBalancerOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type Client

type Client struct {
	// contains filtered or unexported fields
}

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 (http://aws.amazon.com/opsworks/) details page. <p> <b>SDKs and CLI</b> </p> <p>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:</p> <ul> <li> <p> <a href="https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html">AWS CLI</a> </p> </li> <li> <p> <a href="https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/opsworks/AWSOpsWorksClient.html">AWS SDK for Java</a> </p> </li> <li> <p> <a href="https://docs.aws.amazon.com/sdkfornet/latest/apidocs/html/N_Amazon_OpsWorks.htm">AWS SDK for .NET</a> </p> </li> <li> <p> <a href="https://docs.aws.amazon.com/aws-sdk-php-2/latest/class-Aws.OpsWorks.OpsWorksClient.html">AWS SDK for PHP 2</a> </p> </li> <li> <p> <a href="http://docs.aws.amazon.com/sdkforruby/api/">AWS SDK for Ruby</a> </p> </li> <li> <p> <a href="http://aws.amazon.com/documentation/sdkforjavascript/">AWS SDK for Node.js</a> </p> </li> <li> <p> <a href="http://docs.pythonboto.org/en/latest/ref/opsworks.html">AWS SDK for Python(Boto)</a> </p> </li> </ul> <p> <b>Endpoints</b> </p> <p>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.</p> <ul> <li> <p>opsworks.us-east-1.amazonaws.com</p> </li> <li> <p>opsworks.us-east-2.amazonaws.com</p> </li> <li> <p>opsworks.us-west-1.amazonaws.com</p> </li> <li> <p>opsworks.us-west-2.amazonaws.com</p> </li> <li> <p>opsworks.ca-central-1.amazonaws.com (API only; not available in the AWS console)</p> </li> <li> <p>opsworks.eu-west-1.amazonaws.com</p> </li> <li> <p>opsworks.eu-west-2.amazonaws.com</p> </li> <li> <p>opsworks.eu-west-3.amazonaws.com</p> </li> <li> <p>opsworks.eu-central-1.amazonaws.com</p> </li> <li> <p>opsworks.ap-northeast-1.amazonaws.com</p> </li> <li> <p>opsworks.ap-northeast-2.amazonaws.com</p> </li> <li> <p>opsworks.ap-south-1.amazonaws.com</p> </li> <li> <p>opsworks.ap-southeast-1.amazonaws.com</p> </li> <li> <p>opsworks.ap-southeast-2.amazonaws.com</p> </li> <li> <p>opsworks.sa-east-1.amazonaws.com</p> </li> </ul> <p> <b>Chef Versions</b> </p> <p>When you call <a>CreateStack</a>, <a>CloneStack</a>, or <a>UpdateStack</a> we recommend you use the <code>ConfigurationManager</code> 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 <a href="https://docs.aws.amazon.com/opsworks/latest/userguide/workingcookbook-chef11.html">Chef Versions</a>.</p> <note> <p>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.</p> </note>

func New

func New(options Options, optFns ...func(*Options)) *Client

New returns an initialized Client based on the functional options. Provide additional functional options to further configure the behavior of the client, such as changing the client's endpoint or adding custom middleware behavior.

func NewFromConfig

func NewFromConfig(cfg aws.Config, optFns ...func(*Options)) *Client

NewFromConfig returns a new client from the provided config.

func (*Client) AssignInstance

func (c *Client) AssignInstance(ctx context.Context, params *AssignInstanceInput, optFns ...func(*Options)) (*AssignInstanceOutput, error)

Assign a registered instance to a layer.

  • You can assign registered

on-premises instances to any layer type.

  • You can assign registered Amazon

EC2 instances only to custom layers.

  • You cannot use this action with

instances that were created with AWS OpsWorks Stacks.

Required Permissions: To use this action, an AWS Identity and Access Management (IAM) user must have a Manage permissions level for the stack or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) AssignVolume

func (c *Client) AssignVolume(ctx context.Context, params *AssignVolumeInput, optFns ...func(*Options)) (*AssignVolumeOutput, error)

Assigns one of the stack's registered Amazon EBS volumes to a specified instance. The volume must first be registered with the stack by calling RegisterVolume (). After you register the volume, you must call UpdateVolume () to specify a mount point before calling AssignVolume. For more information, see Resource Management (https://docs.aws.amazon.com/opsworks/latest/userguide/resources.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) AssociateElasticIp

func (c *Client) AssociateElasticIp(ctx context.Context, params *AssociateElasticIpInput, optFns ...func(*Options)) (*AssociateElasticIpOutput, error)

Associates one of the stack's registered Elastic IP addresses with a specified instance. The address must first be registered with the stack by calling RegisterElasticIp (). For more information, see Resource Management (https://docs.aws.amazon.com/opsworks/latest/userguide/resources.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) AttachElasticLoadBalancer

func (c *Client) AttachElasticLoadBalancer(ctx context.Context, params *AttachElasticLoadBalancerInput, optFns ...func(*Options)) (*AttachElasticLoadBalancerOutput, error)

Attaches an Elastic Load Balancing load balancer to a specified layer. AWS OpsWorks Stacks does not support Application Load Balancer. You can only use Classic Load Balancer with AWS OpsWorks Stacks. For more information, see Elastic Load Balancing (https://docs.aws.amazon.com/opsworks/latest/userguide/layers-elb.html). You must create the Elastic Load Balancing instance separately, by using the Elastic Load Balancing console, API, or CLI. For more information, see Elastic Load Balancing Developer Guide (https://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/Welcome.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) CloneStack

func (c *Client) CloneStack(ctx context.Context, params *CloneStackInput, optFns ...func(*Options)) (*CloneStackOutput, error)

Creates a clone of a specified stack. For more information, see Clone a Stack (https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-cloning.html). By default, all parameters are set to the values used by the parent stack. Required Permissions: To use this action, an IAM user must have an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) CreateApp

func (c *Client) CreateApp(ctx context.Context, params *CreateAppInput, optFns ...func(*Options)) (*CreateAppOutput, error)

Creates an app for a specified stack. For more information, see Creating Apps (https://docs.aws.amazon.com/opsworks/latest/userguide/workingapps-creating.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) CreateDeployment

func (c *Client) CreateDeployment(ctx context.Context, params *CreateDeploymentInput, optFns ...func(*Options)) (*CreateDeploymentOutput, error)

Runs deployment or stack commands. For more information, see Deploying Apps (https://docs.aws.amazon.com/opsworks/latest/userguide/workingapps-deploying.html) and Run Stack Commands (https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-commands.html). Required Permissions: To use this action, an IAM user must have a Deploy or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) CreateInstance

func (c *Client) CreateInstance(ctx context.Context, params *CreateInstanceInput, optFns ...func(*Options)) (*CreateInstanceOutput, error)

Creates an instance in a specified stack. For more information, see Adding an Instance to a Layer (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-add.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) CreateLayer

func (c *Client) CreateLayer(ctx context.Context, params *CreateLayerInput, optFns ...func(*Options)) (*CreateLayerOutput, error)

Creates a layer. For more information, see How to Create a Layer (https://docs.aws.amazon.com/opsworks/latest/userguide/workinglayers-basics-create.html). You should use CreateLayer for noncustom layer types such as PHP App Server only if the stack does not have an existing layer of that type. A stack can have at most one instance of each noncustom layer; if you attempt to create a second instance, CreateLayer fails. A stack can have an arbitrary number of custom layers, so you can call CreateLayer as many times as you like for that layer type. Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) CreateStack

func (c *Client) CreateStack(ctx context.Context, params *CreateStackInput, optFns ...func(*Options)) (*CreateStackOutput, error)

Creates a new stack. For more information, see Create a New Stack (https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-edit.html). Required Permissions: To use this action, an IAM user must have an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) CreateUserProfile

func (c *Client) CreateUserProfile(ctx context.Context, params *CreateUserProfileInput, optFns ...func(*Options)) (*CreateUserProfileOutput, error)

Creates a new user profile. Required Permissions: To use this action, an IAM user must have an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DeleteApp

func (c *Client) DeleteApp(ctx context.Context, params *DeleteAppInput, optFns ...func(*Options)) (*DeleteAppOutput, error)

Deletes a specified app. Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DeleteInstance

func (c *Client) DeleteInstance(ctx context.Context, params *DeleteInstanceInput, optFns ...func(*Options)) (*DeleteInstanceOutput, error)

Deletes a specified instance, which terminates the associated Amazon EC2 instance. You must stop an instance before you can delete it. For more information, see Deleting Instances (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-delete.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DeleteLayer

func (c *Client) DeleteLayer(ctx context.Context, params *DeleteLayerInput, optFns ...func(*Options)) (*DeleteLayerOutput, error)

Deletes a specified layer. You must first stop and then delete all associated instances or unassign registered instances. For more information, see How to Delete a Layer (https://docs.aws.amazon.com/opsworks/latest/userguide/workinglayers-basics-delete.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DeleteStack

func (c *Client) DeleteStack(ctx context.Context, params *DeleteStackInput, optFns ...func(*Options)) (*DeleteStackOutput, error)

Deletes a specified stack. You must first delete all instances, layers, and apps or deregister registered instances. For more information, see Shut Down a Stack (https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-shutting.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DeleteUserProfile

func (c *Client) DeleteUserProfile(ctx context.Context, params *DeleteUserProfileInput, optFns ...func(*Options)) (*DeleteUserProfileOutput, error)

Deletes a user profile. Required Permissions: To use this action, an IAM user must have an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DeregisterEcsCluster

func (c *Client) DeregisterEcsCluster(ctx context.Context, params *DeregisterEcsClusterInput, optFns ...func(*Options)) (*DeregisterEcsClusterOutput, error)

Deregisters a specified Amazon ECS cluster from a stack. For more information, see Resource Management (https://docs.aws.amazon.com/opsworks/latest/userguide/workinglayers-ecscluster.html#workinglayers-ecscluster-delete). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack or an attached policy that explicitly grants permissions. For more information on user permissions, see https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DeregisterElasticIp

func (c *Client) DeregisterElasticIp(ctx context.Context, params *DeregisterElasticIpInput, optFns ...func(*Options)) (*DeregisterElasticIpOutput, error)

Deregisters a specified Elastic IP address. The address can then be registered by another stack. For more information, see Resource Management (https://docs.aws.amazon.com/opsworks/latest/userguide/resources.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DeregisterInstance

func (c *Client) DeregisterInstance(ctx context.Context, params *DeregisterInstanceInput, optFns ...func(*Options)) (*DeregisterInstanceOutput, error)

Deregister a registered Amazon EC2 or on-premises instance. This action removes the instance from the stack and returns it to your control. This action cannot be used with instances that were created with AWS OpsWorks Stacks. Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DeregisterRdsDbInstance

func (c *Client) DeregisterRdsDbInstance(ctx context.Context, params *DeregisterRdsDbInstanceInput, optFns ...func(*Options)) (*DeregisterRdsDbInstanceOutput, error)

Deregisters an Amazon RDS instance. Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DeregisterVolume

func (c *Client) DeregisterVolume(ctx context.Context, params *DeregisterVolumeInput, optFns ...func(*Options)) (*DeregisterVolumeOutput, error)

Deregisters an Amazon EBS volume. The volume can then be registered by another stack. For more information, see Resource Management (https://docs.aws.amazon.com/opsworks/latest/userguide/resources.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DescribeAgentVersions

func (c *Client) DescribeAgentVersions(ctx context.Context, params *DescribeAgentVersionsInput, optFns ...func(*Options)) (*DescribeAgentVersionsOutput, error)

Describes the available AWS OpsWorks Stacks agent versions. You must specify a stack ID or a configuration manager. DescribeAgentVersions returns a list of available agent versions for the specified stack or configuration manager.

func (*Client) DescribeApps

func (c *Client) DescribeApps(ctx context.Context, params *DescribeAppsInput, optFns ...func(*Options)) (*DescribeAppsOutput, error)

Requests a description of a specified set of apps. This call accepts only one resource-identifying parameter. Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DescribeCommands

func (c *Client) DescribeCommands(ctx context.Context, params *DescribeCommandsInput, optFns ...func(*Options)) (*DescribeCommandsOutput, error)

Describes the results of specified commands. This call accepts only one resource-identifying parameter. Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DescribeDeployments

func (c *Client) DescribeDeployments(ctx context.Context, params *DescribeDeploymentsInput, optFns ...func(*Options)) (*DescribeDeploymentsOutput, error)

Requests a description of a specified set of deployments. This call accepts only one resource-identifying parameter. Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DescribeEcsClusters

func (c *Client) DescribeEcsClusters(ctx context.Context, params *DescribeEcsClustersInput, optFns ...func(*Options)) (*DescribeEcsClustersOutput, error)

Describes Amazon ECS clusters that are registered with a stack. If you specify only a stack ID, you can use the MaxResults and NextToken parameters to paginate the response. However, AWS OpsWorks Stacks currently supports only one cluster per layer, so the result set has a maximum of one element. Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack or an attached policy that explicitly grants permission. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html). This call accepts only one resource-identifying parameter.

func (*Client) DescribeElasticIps

func (c *Client) DescribeElasticIps(ctx context.Context, params *DescribeElasticIpsInput, optFns ...func(*Options)) (*DescribeElasticIpsOutput, error)

Describes Elastic IP addresses (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html). This call accepts only one resource-identifying parameter. Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DescribeElasticLoadBalancers

func (c *Client) DescribeElasticLoadBalancers(ctx context.Context, params *DescribeElasticLoadBalancersInput, optFns ...func(*Options)) (*DescribeElasticLoadBalancersOutput, error)

Describes a stack's Elastic Load Balancing instances. This call accepts only one resource-identifying parameter. Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DescribeInstances

func (c *Client) DescribeInstances(ctx context.Context, params *DescribeInstancesInput, optFns ...func(*Options)) (*DescribeInstancesOutput, error)

Requests a description of a set of instances. This call accepts only one resource-identifying parameter. Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DescribeLayers

func (c *Client) DescribeLayers(ctx context.Context, params *DescribeLayersInput, optFns ...func(*Options)) (*DescribeLayersOutput, error)

Requests a description of one or more layers in a specified stack. This call accepts only one resource-identifying parameter. Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DescribeLoadBasedAutoScaling

func (c *Client) DescribeLoadBasedAutoScaling(ctx context.Context, params *DescribeLoadBasedAutoScalingInput, optFns ...func(*Options)) (*DescribeLoadBasedAutoScalingOutput, error)

Describes load-based auto scaling configurations for specified layers. You must specify at least one of the parameters. Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DescribeMyUserProfile

func (c *Client) DescribeMyUserProfile(ctx context.Context, params *DescribeMyUserProfileInput, optFns ...func(*Options)) (*DescribeMyUserProfileOutput, error)

Describes a user's SSH information. Required Permissions: To use this action, an IAM user must have self-management enabled or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DescribeOperatingSystems

func (c *Client) DescribeOperatingSystems(ctx context.Context, params *DescribeOperatingSystemsInput, optFns ...func(*Options)) (*DescribeOperatingSystemsOutput, error)

Describes the operating systems that are supported by AWS OpsWorks Stacks.

func (*Client) DescribePermissions

func (c *Client) DescribePermissions(ctx context.Context, params *DescribePermissionsInput, optFns ...func(*Options)) (*DescribePermissionsOutput, error)

Describes the permissions for a specified stack. Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DescribeRaidArrays

func (c *Client) DescribeRaidArrays(ctx context.Context, params *DescribeRaidArraysInput, optFns ...func(*Options)) (*DescribeRaidArraysOutput, error)

Describe an instance's RAID arrays. This call accepts only one resource-identifying parameter. Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DescribeRdsDbInstances

func (c *Client) DescribeRdsDbInstances(ctx context.Context, params *DescribeRdsDbInstancesInput, optFns ...func(*Options)) (*DescribeRdsDbInstancesOutput, error)

Describes Amazon RDS instances. Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html). This call accepts only one resource-identifying parameter.

func (*Client) DescribeServiceErrors

func (c *Client) DescribeServiceErrors(ctx context.Context, params *DescribeServiceErrorsInput, optFns ...func(*Options)) (*DescribeServiceErrorsOutput, error)

Describes AWS OpsWorks Stacks service errors. Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html). This call accepts only one resource-identifying parameter.

func (*Client) DescribeStackProvisioningParameters

func (c *Client) DescribeStackProvisioningParameters(ctx context.Context, params *DescribeStackProvisioningParametersInput, optFns ...func(*Options)) (*DescribeStackProvisioningParametersOutput, error)

Requests a description of a stack's provisioning parameters. Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DescribeStackSummary

func (c *Client) DescribeStackSummary(ctx context.Context, params *DescribeStackSummaryInput, optFns ...func(*Options)) (*DescribeStackSummaryOutput, error)

Describes the number of layers and apps in a specified stack, and the number of instances in each state, such as running_setup or online. Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DescribeStacks

func (c *Client) DescribeStacks(ctx context.Context, params *DescribeStacksInput, optFns ...func(*Options)) (*DescribeStacksOutput, error)

Requests a description of one or more stacks. Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DescribeTimeBasedAutoScaling

func (c *Client) DescribeTimeBasedAutoScaling(ctx context.Context, params *DescribeTimeBasedAutoScalingInput, optFns ...func(*Options)) (*DescribeTimeBasedAutoScalingOutput, error)

Describes time-based auto scaling configurations for specified instances. You must specify at least one of the parameters. Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DescribeUserProfiles

func (c *Client) DescribeUserProfiles(ctx context.Context, params *DescribeUserProfilesInput, optFns ...func(*Options)) (*DescribeUserProfilesOutput, error)

Describe specified users. Required Permissions: To use this action, an IAM user must have an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DescribeVolumes

func (c *Client) DescribeVolumes(ctx context.Context, params *DescribeVolumesInput, optFns ...func(*Options)) (*DescribeVolumesOutput, error)

Describes an instance's Amazon EBS volumes. This call accepts only one resource-identifying parameter. Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DetachElasticLoadBalancer

func (c *Client) DetachElasticLoadBalancer(ctx context.Context, params *DetachElasticLoadBalancerInput, optFns ...func(*Options)) (*DetachElasticLoadBalancerOutput, error)

Detaches a specified Elastic Load Balancing instance from its layer. Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) DisassociateElasticIp

func (c *Client) DisassociateElasticIp(ctx context.Context, params *DisassociateElasticIpInput, optFns ...func(*Options)) (*DisassociateElasticIpOutput, error)

Disassociates an Elastic IP address from its instance. The address remains registered with the stack. For more information, see Resource Management (https://docs.aws.amazon.com/opsworks/latest/userguide/resources.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) GetHostnameSuggestion

func (c *Client) GetHostnameSuggestion(ctx context.Context, params *GetHostnameSuggestionInput, optFns ...func(*Options)) (*GetHostnameSuggestionOutput, error)

Gets a generated host name for the specified layer, based on the current host name theme. Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) GrantAccess

func (c *Client) GrantAccess(ctx context.Context, params *GrantAccessInput, optFns ...func(*Options)) (*GrantAccessOutput, error)

This action can be used only with Windows stacks. Grants RDP access to a Windows instance for a specified time period.

func (*Client) ListTags

func (c *Client) ListTags(ctx context.Context, params *ListTagsInput, optFns ...func(*Options)) (*ListTagsOutput, error)

Returns a list of tags that are applied to the specified stack or layer.

func (*Client) RebootInstance

func (c *Client) RebootInstance(ctx context.Context, params *RebootInstanceInput, optFns ...func(*Options)) (*RebootInstanceOutput, error)

Reboots a specified instance. For more information, see Starting, Stopping, and Rebooting Instances (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-starting.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) RegisterEcsCluster

func (c *Client) RegisterEcsCluster(ctx context.Context, params *RegisterEcsClusterInput, optFns ...func(*Options)) (*RegisterEcsClusterOutput, error)

Registers a specified Amazon ECS cluster with a stack. You can register only one cluster with a stack. A cluster can be registered with only one stack. For more information, see Resource Management (https://docs.aws.amazon.com/opsworks/latest/userguide/workinglayers-ecscluster.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) RegisterElasticIp

func (c *Client) RegisterElasticIp(ctx context.Context, params *RegisterElasticIpInput, optFns ...func(*Options)) (*RegisterElasticIpOutput, error)

Registers an Elastic IP address with a specified stack. An address can be registered with only one stack at a time. If the address is already registered, you must first deregister it by calling DeregisterElasticIp (). For more information, see Resource Management (https://docs.aws.amazon.com/opsworks/latest/userguide/resources.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) RegisterInstance

func (c *Client) RegisterInstance(ctx context.Context, params *RegisterInstanceInput, optFns ...func(*Options)) (*RegisterInstanceOutput, error)

Registers instances that were created outside of AWS OpsWorks Stacks with a specified stack. We do not recommend using this action to register instances. The complete registration operation includes two tasks: installing the AWS OpsWorks Stacks agent on the instance, and registering the instance with the stack. RegisterInstance handles only the second step. You should instead use the AWS CLI register command, which performs the entire registration operation. For more information, see Registering an Instance with an AWS OpsWorks Stacks Stack (https://docs.aws.amazon.com/opsworks/latest/userguide/registered-instances-register.html). Registered instances have the same requirements as instances that are created by using the CreateInstance () API. For example, registered instances must be running a supported Linux-based operating system, and they must have a supported instance type. For more information about requirements for instances that you want to register, see Preparing the Instance (https://docs.aws.amazon.com/opsworks/latest/userguide/registered-instances-register-registering-preparer.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) RegisterRdsDbInstance

func (c *Client) RegisterRdsDbInstance(ctx context.Context, params *RegisterRdsDbInstanceInput, optFns ...func(*Options)) (*RegisterRdsDbInstanceOutput, error)

Registers an Amazon RDS instance with a stack. Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) RegisterVolume

func (c *Client) RegisterVolume(ctx context.Context, params *RegisterVolumeInput, optFns ...func(*Options)) (*RegisterVolumeOutput, error)

Registers an Amazon EBS volume with a specified stack. A volume can be registered with only one stack at a time. If the volume is already registered, you must first deregister it by calling DeregisterVolume (). For more information, see Resource Management (https://docs.aws.amazon.com/opsworks/latest/userguide/resources.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) SetLoadBasedAutoScaling

func (c *Client) SetLoadBasedAutoScaling(ctx context.Context, params *SetLoadBasedAutoScalingInput, optFns ...func(*Options)) (*SetLoadBasedAutoScalingOutput, error)

Specify the load-based auto scaling configuration for a specified layer. For more information, see Managing Load with Time-based and Load-based Instances (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-autoscaling.html). To use load-based auto scaling, you must create a set of load-based auto scaling instances. Load-based auto scaling operates only on the instances from that set, so you must ensure that you have created enough instances to handle the maximum anticipated load. Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) SetPermission

func (c *Client) SetPermission(ctx context.Context, params *SetPermissionInput, optFns ...func(*Options)) (*SetPermissionOutput, error)

Specifies a user's permissions. For more information, see Security and Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/workingsecurity.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) SetTimeBasedAutoScaling

func (c *Client) SetTimeBasedAutoScaling(ctx context.Context, params *SetTimeBasedAutoScalingInput, optFns ...func(*Options)) (*SetTimeBasedAutoScalingOutput, error)

Specify the time-based auto scaling configuration for a specified instance. For more information, see Managing Load with Time-based and Load-based Instances (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-autoscaling.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) StartInstance

func (c *Client) StartInstance(ctx context.Context, params *StartInstanceInput, optFns ...func(*Options)) (*StartInstanceOutput, error)

Starts a specified instance. For more information, see Starting, Stopping, and Rebooting Instances (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-starting.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) StartStack

func (c *Client) StartStack(ctx context.Context, params *StartStackInput, optFns ...func(*Options)) (*StartStackOutput, error)

Starts a stack's instances. Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) StopInstance

func (c *Client) StopInstance(ctx context.Context, params *StopInstanceInput, optFns ...func(*Options)) (*StopInstanceOutput, error)

Stops a specified instance. When you stop a standard instance, the data disappears and must be reinstalled when you restart the instance. You can stop an Amazon EBS-backed instance without losing data. For more information, see Starting, Stopping, and Rebooting Instances (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-starting.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) StopStack

func (c *Client) StopStack(ctx context.Context, params *StopStackInput, optFns ...func(*Options)) (*StopStackOutput, error)

Stops a specified stack. Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) TagResource

func (c *Client) TagResource(ctx context.Context, params *TagResourceInput, optFns ...func(*Options)) (*TagResourceOutput, error)

Apply cost-allocation tags to a specified stack or layer in AWS OpsWorks Stacks. For more information about how tagging works, see Tags (https://docs.aws.amazon.com/opsworks/latest/userguide/tagging.html) in the AWS OpsWorks User Guide.

func (*Client) UnassignInstance

func (c *Client) UnassignInstance(ctx context.Context, params *UnassignInstanceInput, optFns ...func(*Options)) (*UnassignInstanceOutput, error)

Unassigns a registered instance from all layers that are using the instance. The instance remains in the stack as an unassigned instance, and can be assigned to another layer as needed. You cannot use this action with instances that were created with AWS OpsWorks Stacks. Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) UnassignVolume

func (c *Client) UnassignVolume(ctx context.Context, params *UnassignVolumeInput, optFns ...func(*Options)) (*UnassignVolumeOutput, error)

Unassigns an assigned Amazon EBS volume. The volume remains registered with the stack. For more information, see Resource Management (https://docs.aws.amazon.com/opsworks/latest/userguide/resources.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) UntagResource

func (c *Client) UntagResource(ctx context.Context, params *UntagResourceInput, optFns ...func(*Options)) (*UntagResourceOutput, error)

Removes tags from a specified stack or layer.

func (*Client) UpdateApp

func (c *Client) UpdateApp(ctx context.Context, params *UpdateAppInput, optFns ...func(*Options)) (*UpdateAppOutput, error)

Updates a specified app. Required Permissions: To use this action, an IAM user must have a Deploy or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) UpdateElasticIp

func (c *Client) UpdateElasticIp(ctx context.Context, params *UpdateElasticIpInput, optFns ...func(*Options)) (*UpdateElasticIpOutput, error)

Updates a registered Elastic IP address's name. For more information, see Resource Management (https://docs.aws.amazon.com/opsworks/latest/userguide/resources.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) UpdateInstance

func (c *Client) UpdateInstance(ctx context.Context, params *UpdateInstanceInput, optFns ...func(*Options)) (*UpdateInstanceOutput, error)

Updates a specified instance. Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) UpdateLayer

func (c *Client) UpdateLayer(ctx context.Context, params *UpdateLayerInput, optFns ...func(*Options)) (*UpdateLayerOutput, error)

Updates a specified layer. Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) UpdateMyUserProfile

func (c *Client) UpdateMyUserProfile(ctx context.Context, params *UpdateMyUserProfileInput, optFns ...func(*Options)) (*UpdateMyUserProfileOutput, error)

Updates a user's SSH public key. Required Permissions: To use this action, an IAM user must have self-management enabled or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) UpdateRdsDbInstance

func (c *Client) UpdateRdsDbInstance(ctx context.Context, params *UpdateRdsDbInstanceInput, optFns ...func(*Options)) (*UpdateRdsDbInstanceOutput, error)

Updates an Amazon RDS instance. Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) UpdateStack

func (c *Client) UpdateStack(ctx context.Context, params *UpdateStackInput, optFns ...func(*Options)) (*UpdateStackOutput, error)

Updates a specified stack. Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) UpdateUserProfile

func (c *Client) UpdateUserProfile(ctx context.Context, params *UpdateUserProfileInput, optFns ...func(*Options)) (*UpdateUserProfileOutput, error)

Updates a specified user profile. Required Permissions: To use this action, an IAM user must have an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

func (*Client) UpdateVolume

func (c *Client) UpdateVolume(ctx context.Context, params *UpdateVolumeInput, optFns ...func(*Options)) (*UpdateVolumeOutput, error)

Updates an Amazon EBS volume's name or mount point. For more information, see Resource Management (https://docs.aws.amazon.com/opsworks/latest/userguide/resources.html). Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).

type CloneStackInput

type CloneStackInput struct {
	// The default AWS OpsWorks Stacks agent version. You have the following options:
	//
	//
	// * Auto-update - Set this parameter to LATEST. AWS OpsWorks Stacks automatically
	// installs new agent versions on the stack's instances as soon as they are
	// available.
	//
	//     * Fixed version - Set this parameter to your preferred agent
	// version. To update the agent version, you must edit the stack configuration and
	// specify a new version. AWS OpsWorks Stacks then automatically installs that
	// version on the stack's instances.
	//
	// The default setting is LATEST. To specify an
	// agent version, you must use the complete version number, not the abbreviated
	// number shown on the console. For a list of available agent version numbers, call
	// DescribeAgentVersions (). AgentVersion cannot be set to Chef 12.2. You can also
	// specify an agent version when you create or update an instance, which overrides
	// the stack's default setting.
	AgentVersion *string
	// Whether to use custom cookbooks.
	UseCustomCookbooks *bool
	// The stack's operating system, which must be set to one of the following.
	//
	//     *
	// A supported Linux operating system: An Amazon Linux version, such as Amazon
	// Linux 2018.03, Amazon Linux 2017.09, Amazon Linux 2017.03, Amazon Linux 2016.09,
	// Amazon Linux 2016.03, Amazon Linux 2015.09, or Amazon Linux 2015.03.
	//
	//     * A
	// supported Ubuntu operating system, such as Ubuntu 16.04 LTS, Ubuntu 14.04 LTS,
	// or Ubuntu 12.04 LTS.
	//
	//     * CentOS Linux 7
	//
	//     * Red Hat Enterprise Linux 7
	//
	//
	// * Microsoft Windows Server 2012 R2 Base, Microsoft Windows Server 2012 R2 with
	// SQL Server Express, Microsoft Windows Server 2012 R2 with SQL Server Standard,
	// or Microsoft Windows Server 2012 R2 with SQL Server Web.
	//
	//     * A custom AMI:
	// Custom. You specify the custom AMI you want to use when you create instances.
	// For more information about how to use custom AMIs with OpsWorks, see Using
	// Custom AMIs
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-custom-ami.html).
	//
	// The
	// default option is the parent stack's operating system. For more information
	// about supported operating systems, see AWS OpsWorks Stacks Operating Systems
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-os.html).
	// You can specify a different Linux operating system for the cloned stack, but you
	// cannot change from Linux to Windows or Windows to Linux.
	DefaultOs *string
	// The stack AWS Identity and Access Management (IAM) role, which allows AWS
	// OpsWorks Stacks to work with AWS resources on your behalf. You must set this
	// parameter to the Amazon Resource Name (ARN) for an existing IAM role. If you
	// create a stack by using the AWS OpsWorks Stacks console, it creates the role for
	// you. You can obtain an existing stack's IAM ARN programmatically by calling
	// DescribePermissions (). For more information about IAM ARNs, see Using
	// Identifiers
	// (https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html). You
	// must set this parameter to a valid service role ARN or the action will fail;
	// there is no default value. You can specify the source stack's service role ARN,
	// if you prefer, but you must do so explicitly.
	ServiceRoleArn *string
	// The Amazon Resource Name (ARN) of an IAM profile that is the default profile for
	// all of the stack's EC2 instances. For more information about IAM ARNs, see Using
	// Identifiers
	// (https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html).
	DefaultInstanceProfileArn *string
	// A list of stack attributes and values as key/value pairs to be added to the
	// cloned stack.
	Attributes map[string]*string
	// Whether to associate the AWS OpsWorks Stacks built-in security groups with the
	// stack's layers. AWS OpsWorks Stacks provides a standard set of built-in security
	// groups, one for each layer, which are associated with layers by default. With
	// UseOpsworksSecurityGroups you can instead provide your own custom security
	// groups. UseOpsworksSecurityGroups has the following settings:
	//
	//     * True - AWS
	// OpsWorks Stacks automatically associates the appropriate built-in security group
	// with each layer (default setting). You can associate additional security groups
	// with a layer after you create it but you cannot delete the built-in security
	// group.
	//
	//     * False - AWS OpsWorks Stacks does not associate built-in security
	// groups with layers. You must create appropriate Amazon Elastic Compute Cloud
	// (Amazon EC2) security groups and associate a security group with each layer that
	// you create. However, you can still manually associate a built-in security group
	// with a layer on creation; custom security groups are required only for those
	// layers that need custom settings.
	//
	// For more information, see Create a New Stack
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-creating.html).
	UseOpsworksSecurityGroups *bool
	// A string that contains user-defined, custom JSON. It is used to override the
	// corresponding default stack configuration JSON values. The string should be in
	// the following format: "{\"key1\": \"value1\", \"key2\": \"value2\",...}" For
	// more information about custom JSON, see Use Custom JSON to Modify the Stack
	// Configuration Attributes
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-json.html)
	CustomJson *string
	// The cloned stack AWS region, such as "ap-northeast-2". For more information
	// about AWS regions, see Regions and Endpoints
	// (https://docs.aws.amazon.com/general/latest/gr/rande.html).
	Region *string
	// A default Amazon EC2 key pair name. The default value is none. If you specify a
	// key pair name, AWS OpsWorks installs the public key on the instance and you can
	// use the private key with an SSH client to log in to the instance. For more
	// information, see  Using SSH to Communicate with an Instance
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-ssh.html)
	// and  Managing SSH Access
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/security-ssh-access.html).
	// You can override this setting by specifying a different key pair, or no key
	// pair, when you  create an instance
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-add.html).
	DefaultSshKeyName *string
	// The stack's default VPC subnet ID. This parameter is required if you specify a
	// value for the VpcId parameter. All instances are launched into this subnet
	// unless you specify otherwise when you create the instance. If you also specify a
	// value for DefaultAvailabilityZone, the subnet must be in that zone. For
	// information on default values and when this parameter is required, see the VpcId
	// parameter description.
	DefaultSubnetId *string
	// Contains the information required to retrieve an app or cookbook from a
	// repository. For more information, see Adding Apps
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingapps-creating.html)
	// or Cookbooks and Recipes
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingcookbook.html).
	CustomCookbooksSource *types.Source
	// The configuration manager. When you clone a stack we recommend that you use the
	// configuration manager to specify the Chef version: 12, 11.10, or 11.4 for Linux
	// stacks, or 12.2 for Windows stacks. The default value for Linux stacks is
	// currently 12.
	ConfigurationManager *types.StackConfigurationManager
	// A list of source stack app IDs to be included in the cloned stack.
	CloneAppIds []*string
	// The default root device type. This value is used by default for all instances in
	// the cloned stack, but you can override it when you create an instance. For more
	// information, see Storage for the Root Device
	// (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ComponentsAMIs.html#storage-for-the-root-device).
	DefaultRootDeviceType types.RootDeviceType
	// The ID of the VPC that the cloned stack is to be launched into. It must be in
	// the specified region. All instances are launched into this VPC, and you cannot
	// change the ID later.
	//
	//     * If your account supports EC2 Classic, the default
	// value is no VPC.
	//
	//     * If your account does not support EC2 Classic, the
	// default value is the default VPC for the specified region.
	//
	// If the VPC ID
	// corresponds to a default VPC and you have specified either the
	// DefaultAvailabilityZone or the DefaultSubnetId parameter only, AWS OpsWorks
	// Stacks infers the value of the other parameter. If you specify neither
	// parameter, AWS OpsWorks Stacks sets these parameters to the first valid
	// Availability Zone for the specified region and the corresponding default VPC
	// subnet ID, respectively. If you specify a nondefault VPC ID, note the
	// following:
	//
	//     * It must belong to a VPC in your account that is in the
	// specified region.
	//
	//     * You must specify a value for DefaultSubnetId.
	//
	// For more
	// information about how to use AWS OpsWorks Stacks with a VPC, see Running a Stack
	// in a VPC
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-vpc.html).
	// For more information about default VPC and EC2 Classic, see Supported Platforms
	// (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-supported-platforms.html).
	VpcId *string
	// The stack's host name theme, with spaces are replaced by underscores. The theme
	// is used to generate host names for the stack's instances. By default,
	// HostnameTheme is set to Layer_Dependent, which creates host names by appending
	// integers to the layer's short name. The other themes are:
	//
	//     * Baked_Goods
	//
	//
	// * Clouds
	//
	//     * Europe_Cities
	//
	//     * Fruits
	//
	//     * Greek_Deities_and_Titans
	//
	//
	// * Legendary_creatures_from_Japan
	//
	//     * Planets_and_Moons
	//
	//     * Roman_Deities
	//
	//
	// * Scottish_Islands
	//
	//     * US_Cities
	//
	//     * Wild_Cats
	//
	// To obtain a generated host
	// name, call GetHostNameSuggestion, which returns a host name based on the current
	// theme.
	HostnameTheme *string
	// A ChefConfiguration object that specifies whether to enable Berkshelf and the
	// Berkshelf version on Chef 11.10 stacks. For more information, see Create a New
	// Stack
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-creating.html).
	ChefConfiguration *types.ChefConfiguration
	// The cloned stack name.
	Name *string
	// Whether to clone the source stack's permissions.
	ClonePermissions *bool
	// The source stack ID.
	SourceStackId *string
	// The cloned stack's default Availability Zone, which must be in the specified
	// region. For more information, see Regions and Endpoints
	// (https://docs.aws.amazon.com/general/latest/gr/rande.html). If you also specify
	// a value for DefaultSubnetId, the subnet must be in the same zone. For more
	// information, see the VpcId parameter description.
	DefaultAvailabilityZone *string
}

type CloneStackOutput

type CloneStackOutput struct {
	// The cloned stack ID.
	StackId *string

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a CloneStack request.

type CreateAppInput

type CreateAppInput struct {
	// An SslConfiguration object with the SSL configuration.
	SslConfiguration *types.SslConfiguration
	// The app's short name.
	Shortname *string
	// An array of EnvironmentVariable objects that specify environment variables to be
	// associated with the app. After you deploy the app, these variables are defined
	// on the associated app server instance. For more information, see  Environment
	// Variables
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingapps-creating.html#workingapps-creating-environment).
	// There is no specific limit on the number of environment variables. However, the
	// size of the associated data structure - which includes the variables' names,
	// values, and protected flag values - cannot exceed 20 KB. This limit should
	// accommodate most if not all use cases. Exceeding it will cause an exception with
	// the message, "Environment: is too large (maximum is 20KB)." If you have
	// specified one or more environment variables, you cannot modify the stack's Chef
	// version.
	Environment []*types.EnvironmentVariable
	// One or more user-defined key/value pairs to be added to the stack attributes.
	Attributes map[string]*string
	// A Source object that specifies the app repository.
	AppSource *types.Source
	// A description of the app.
	Description *string
	// The app's data source.
	DataSources []*types.DataSource
	// The app type. Each supported type is associated with a particular layer. For
	// example, PHP applications are associated with a PHP layer. AWS OpsWorks Stacks
	// deploys an application to those instances that are members of the corresponding
	// layer. If your app isn't one of the standard types, or you prefer to implement
	// your own Deploy recipes, specify other.
	Type types.AppType
	// The app virtual host settings, with multiple domains separated by commas. For
	// example: 'www.example.com, example.com'
	Domains []*string
	// The stack ID.
	StackId *string
	// The app name.
	Name *string
	// Whether to enable SSL for the app.
	EnableSsl *bool
}

type CreateAppOutput

type CreateAppOutput struct {
	// The app ID.
	AppId *string

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a CreateApp request.

type CreateDeploymentInput

type CreateDeploymentInput struct {
	// The stack ID.
	StackId *string
	// The instance IDs for the deployment targets.
	InstanceIds []*string
	// The app ID. This parameter is required for app deployments, but not for other
	// deployment commands.
	AppId *string
	// A user-defined comment.
	Comment *string
	// A string that contains user-defined, custom JSON. You can use this parameter to
	// override some corresponding default stack configuration JSON values. The string
	// should be in the following format: "{\"key1\": \"value1\", \"key2\":
	// \"value2\",...}" For more information about custom JSON, see Use Custom JSON to
	// Modify the Stack Configuration Attributes
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-json.html)
	// and Overriding Attributes With Custom JSON
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingcookbook-json-override.html).
	CustomJson *string
	// A DeploymentCommand object that specifies the deployment command and any
	// associated arguments.
	Command *types.DeploymentCommand
	// The layer IDs for the deployment targets.
	LayerIds []*string
}

type CreateDeploymentOutput

type CreateDeploymentOutput struct {
	// The deployment ID, which can be used with other requests to identify the
	// deployment.
	DeploymentId *string

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a CreateDeployment request.

type CreateInstanceInput

type CreateInstanceInput struct {
	// The stack ID.
	StackId *string
	// An array of BlockDeviceMapping objects that specify the instance's block
	// devices. For more information, see Block Device Mapping
	// (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html).
	// Note that block device mappings are not supported for custom AMIs.
	BlockDeviceMappings []*types.BlockDeviceMapping
	// The ID of the instance's subnet. If the stack is running in a VPC, you can use
	// this parameter to override the stack's default subnet ID value and direct AWS
	// OpsWorks Stacks to launch the instance in a different subnet.
	SubnetId *string
	// For load-based or time-based instances, the type. Windows stacks can use only
	// time-based instances.
	AutoScalingType types.AutoScalingType
	// The instance's operating system, which must be set to one of the following.
	//
	//
	// * A supported Linux operating system: An Amazon Linux version, such as Amazon
	// Linux 2018.03, Amazon Linux 2017.09, Amazon Linux 2017.03, Amazon Linux 2016.09,
	// Amazon Linux 2016.03, Amazon Linux 2015.09, or Amazon Linux 2015.03.
	//
	//     * A
	// supported Ubuntu operating system, such as Ubuntu 16.04 LTS, Ubuntu 14.04 LTS,
	// or Ubuntu 12.04 LTS.
	//
	//     * CentOS Linux 7
	//
	//     * Red Hat Enterprise Linux 7
	//
	//
	// * A supported Windows operating system, such as Microsoft Windows Server 2012 R2
	// Base, Microsoft Windows Server 2012 R2 with SQL Server Express, Microsoft
	// Windows Server 2012 R2 with SQL Server Standard, or Microsoft Windows Server
	// 2012 R2 with SQL Server Web.
	//
	//     * A custom AMI: Custom.
	//
	// For more information
	// about the supported operating systems, see AWS OpsWorks Stacks Operating Systems
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-os.html).
	// The default option is the current Amazon Linux version. If you set this
	// parameter to Custom, you must use the CreateInstance () action's AmiId parameter
	// to specify the custom AMI that you want to use. Block device mappings are not
	// supported if the value is Custom. For more information about supported operating
	// systems, see Operating Systems
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-os.html)For
	// more information about how to use custom AMIs with AWS OpsWorks Stacks, see
	// Using Custom AMIs
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-custom-ami.html).
	Os *string
	// The instance root device type. For more information, see Storage for the Root
	// Device
	// (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ComponentsAMIs.html#storage-for-the-root-device).
	RootDeviceType types.RootDeviceType
	// The instance's Amazon EC2 key-pair name.
	SshKeyName *string
	// The instance's tenancy option. The default option is no tenancy, or if the
	// instance is running in a VPC, inherit tenancy settings from the VPC. The
	// following are valid values for this parameter: dedicated, default, or host.
	// Because there are costs associated with changes in tenancy options, we recommend
	// that you research tenancy options before choosing them for your instances. For
	// more information about dedicated hosts, see Dedicated Hosts Overview
	// (http://aws.amazon.com/ec2/dedicated-hosts/) and Amazon EC2 Dedicated Hosts
	// (http://aws.amazon.com/ec2/dedicated-hosts/). For more information about
	// dedicated instances, see Dedicated Instances
	// (https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/dedicated-instance.html)
	// and Amazon EC2 Dedicated Instances
	// (http://aws.amazon.com/ec2/purchasing-options/dedicated-instances/).
	Tenancy *string
	// The instance type, such as t2.micro. For a list of supported instance types,
	// open the stack in the console, choose Instances, and choose + Instance. The Size
	// list contains the currently supported types. For more information, see Instance
	// Families and Types
	// (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html). The
	// parameter values that you use to specify the various types are in the API Name
	// column of the Available Instance Types table.
	InstanceType *string
	// An array that contains the instance's layer IDs.
	LayerIds []*string
	// A custom AMI ID to be used to create the instance. The AMI should be based on
	// one of the supported operating systems. For more information, see Using Custom
	// AMIs
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-custom-ami.html).
	// If you specify a custom AMI, you must set Os to Custom.
	AmiId *string
	// Whether to install operating system and package updates when the instance boots.
	// The default value is true. To control when updates are installed, set this value
	// to false. You must then update your instances manually by using CreateDeployment
	// () to run the update_dependencies stack command or by manually running yum
	// (Amazon Linux) or apt-get (Ubuntu) on the instances. We strongly recommend using
	// the default value of true to ensure that your instances have the latest security
	// updates.
	InstallUpdatesOnBoot *bool
	// The instance Availability Zone. For more information, see Regions and Endpoints
	// (https://docs.aws.amazon.com/general/latest/gr/rande.html).
	AvailabilityZone *string
	// The instance's virtualization type, paravirtual or hvm.
	VirtualizationType *string
	// The default AWS OpsWorks Stacks agent version. You have the following options:
	//
	//
	// * INHERIT - Use the stack's default agent version setting.
	//
	//     * version_number
	// - Use the specified agent version. This value overrides the stack's default
	// setting. To update the agent version, edit the instance configuration and
	// specify a new version. AWS OpsWorks Stacks then automatically installs that
	// version on the instance.
	//
	// The default setting is INHERIT. To specify an agent
	// version, you must use the complete version number, not the abbreviated number
	// shown on the console. For a list of available agent version numbers, call
	// DescribeAgentVersions (). AgentVersion cannot be set to Chef 12.2.
	AgentVersion *string
	// The instance architecture. The default option is x86_64. Instance types do not
	// necessarily support both architectures. For a list of the architectures that are
	// supported by the different instance types, see Instance Families and Types
	// (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html).
	Architecture types.Architecture
	// Whether to create an Amazon EBS-optimized instance.
	EbsOptimized *bool
	// The instance host name.
	Hostname *string
}

type CreateInstanceOutput

type CreateInstanceOutput struct {
	// The instance ID.
	InstanceId *string

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a CreateInstance request.

type CreateLayerInput

type CreateLayerInput struct {
	// Whether to use Amazon EBS-optimized instances.
	UseEbsOptimizedInstances *bool
	// The ARN of an IAM profile to be used for the layer's EC2 instances. For more
	// information about IAM ARNs, see Using Identifiers
	// (https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html).
	CustomInstanceProfileArn *string
	// Whether to disable auto healing for the layer.
	EnableAutoHealing *bool
	// A LifeCycleEventConfiguration object that you can use to configure the Shutdown
	// event to specify an execution timeout and enable or disable Elastic Load
	// Balancer connection draining.
	LifecycleEventConfiguration *types.LifecycleEventConfiguration
	// The layer stack ID.
	StackId *string
	// The layer name, which is used by the console.
	Name *string
	// For custom layers only, use this parameter to specify the layer's short name,
	// which is used internally by AWS OpsWorks Stacks and by Chef recipes. The short
	// name is also used as the name for the directory where your app files are
	// installed. It can have a maximum of 200 characters, which are limited to the
	// alphanumeric characters, '-', '_', and '.'. The built-in layers' short names are
	// defined by AWS OpsWorks Stacks. For more information, see the Layer Reference
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/layers.html).
	Shortname *string
	// Whether to install operating system and package updates when the instance boots.
	// The default value is true. To control when updates are installed, set this value
	// to false. You must then update your instances manually by using CreateDeployment
	// () to run the update_dependencies stack command or by manually running yum
	// (Amazon Linux) or apt-get (Ubuntu) on the instances. To ensure that your
	// instances have the latest security updates, we strongly recommend using the
	// default value of true.
	InstallUpdatesOnBoot *bool
	// Specifies CloudWatch Logs configuration options for the layer. For more
	// information, see CloudWatchLogsLogStream ().
	CloudWatchLogsConfiguration *types.CloudWatchLogsConfiguration
	// An array of Package objects that describes the layer packages.
	Packages []*string
	// Whether to automatically assign an Elastic IP address
	// (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html)
	// to the layer's instances. For more information, see How to Edit a Layer
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinglayers-basics-edit.html).
	AutoAssignElasticIps *bool
	// An array containing the layer custom security group IDs.
	CustomSecurityGroupIds []*string
	// The layer type. A stack cannot have more than one built-in layer of the same
	// type. It can have any number of custom layers. Built-in layers are not available
	// in Chef 12 stacks.
	Type types.LayerType
	// A JSON-formatted string containing custom stack configuration and deployment
	// attributes to be installed on the layer's instances. For more information, see
	// Using Custom JSON
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingcookbook-json-override.html).
	// This feature is supported as of version 1.7.42 of the AWS CLI.
	CustomJson *string
	// A LayerCustomRecipes object that specifies the layer custom recipes.
	CustomRecipes *types.Recipes
	// A VolumeConfigurations object that describes the layer's Amazon EBS volumes.
	VolumeConfigurations []*types.VolumeConfiguration
	// For stacks that are running in a VPC, whether to automatically assign a public
	// IP address to the layer's instances. For more information, see How to Edit a
	// Layer
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinglayers-basics-edit.html).
	AutoAssignPublicIps *bool
	// One or more user-defined key-value pairs to be added to the stack attributes. To
	// create a cluster layer, set the EcsClusterArn attribute to the cluster's ARN.
	Attributes map[string]*string
}

type CreateLayerOutput

type CreateLayerOutput struct {
	// The layer ID.
	LayerId *string

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a CreateLayer request.

type CreateStackInput

type CreateStackInput struct {
	// Whether the stack uses custom cookbooks.
	UseCustomCookbooks *bool
	// The stack's AWS Identity and Access Management (IAM) role, which allows AWS
	// OpsWorks Stacks to work with AWS resources on your behalf. You must set this
	// parameter to the Amazon Resource Name (ARN) for an existing IAM role. For more
	// information about IAM ARNs, see Using Identifiers
	// (https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html).
	ServiceRoleArn *string
	// The default AWS OpsWorks Stacks agent version. You have the following options:
	//
	//
	// * Auto-update - Set this parameter to LATEST. AWS OpsWorks Stacks automatically
	// installs new agent versions on the stack's instances as soon as they are
	// available.
	//
	//     * Fixed version - Set this parameter to your preferred agent
	// version. To update the agent version, you must edit the stack configuration and
	// specify a new version. AWS OpsWorks Stacks then automatically installs that
	// version on the stack's instances.
	//
	// The default setting is the most recent
	// release of the agent. To specify an agent version, you must use the complete
	// version number, not the abbreviated number shown on the console. For a list of
	// available agent version numbers, call DescribeAgentVersions (). AgentVersion
	// cannot be set to Chef 12.2. You can also specify an agent version when you
	// create or update an instance, which overrides the stack's default setting.
	AgentVersion *string
	// Whether to associate the AWS OpsWorks Stacks built-in security groups with the
	// stack's layers. AWS OpsWorks Stacks provides a standard set of built-in security
	// groups, one for each layer, which are associated with layers by default. With
	// UseOpsworksSecurityGroups you can instead provide your own custom security
	// groups. UseOpsworksSecurityGroups has the following settings:
	//
	//     * True - AWS
	// OpsWorks Stacks automatically associates the appropriate built-in security group
	// with each layer (default setting). You can associate additional security groups
	// with a layer after you create it, but you cannot delete the built-in security
	// group.
	//
	//     * False - AWS OpsWorks Stacks does not associate built-in security
	// groups with layers. You must create appropriate EC2 security groups and
	// associate a security group with each layer that you create. However, you can
	// still manually associate a built-in security group with a layer on creation;
	// custom security groups are required only for those layers that need custom
	// settings.
	//
	// For more information, see Create a New Stack
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-creating.html).
	UseOpsworksSecurityGroups *bool
	// The Amazon Resource Name (ARN) of an IAM profile that is the default profile for
	// all of the stack's EC2 instances. For more information about IAM ARNs, see Using
	// Identifiers
	// (https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html).
	DefaultInstanceProfileArn *string
	// One or more user-defined key-value pairs to be added to the stack attributes.
	Attributes map[string]*string
	// The stack's AWS region, such as ap-south-1. For more information about Amazon
	// regions, see Regions and Endpoints
	// (https://docs.aws.amazon.com/general/latest/gr/rande.html). In the AWS CLI, this
	// API maps to the --stack-region parameter. If the --stack-region parameter and
	// the AWS CLI common parameter --region are set to the same value, the stack uses
	// a regional endpoint. If the --stack-region parameter is not set, but the AWS CLI
	// --region parameter is, this also results in a stack with a regional endpoint.
	// However, if the --region parameter is set to us-east-1, and the --stack-region
	// parameter is set to one of the following, then the stack uses a legacy or
	// classic region: us-west-1, us-west-2, sa-east-1, eu-central-1, eu-west-1,
	// ap-northeast-1, ap-southeast-1, ap-southeast-2. In this case, the actual API
	// endpoint of the stack is in us-east-1. Only the preceding regions are supported
	// as classic regions in the us-east-1 API endpoint. Because it is a best practice
	// to choose the regional endpoint that is closest to where you manage AWS, we
	// recommend that you use regional endpoints for new stacks. The AWS CLI common
	// --region parameter always specifies a regional API endpoint; it cannot be used
	// to specify a classic AWS OpsWorks Stacks region.
	Region *string
	// A string that contains user-defined, custom JSON. It can be used to override the
	// corresponding default stack configuration attribute values or to pass data to
	// recipes. The string should be in the following format: "{\"key1\": \"value1\",
	// \"key2\": \"value2\",...}" For more information about custom JSON, see Use
	// Custom JSON to Modify the Stack Configuration Attributes
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-json.html).
	CustomJson *string
	// A default Amazon EC2 key pair name. The default value is none. If you specify a
	// key pair name, AWS OpsWorks installs the public key on the instance and you can
	// use the private key with an SSH client to log in to the instance. For more
	// information, see  Using SSH to Communicate with an Instance
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-ssh.html)
	// and  Managing SSH Access
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/security-ssh-access.html).
	// You can override this setting by specifying a different key pair, or no key
	// pair, when you  create an instance
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-add.html).
	DefaultSshKeyName *string
	// The stack's default VPC subnet ID. This parameter is required if you specify a
	// value for the VpcId parameter. All instances are launched into this subnet
	// unless you specify otherwise when you create the instance. If you also specify a
	// value for DefaultAvailabilityZone, the subnet must be in that zone. For
	// information on default values and when this parameter is required, see the VpcId
	// parameter description.
	DefaultSubnetId *string
	// Contains the information required to retrieve an app or cookbook from a
	// repository. For more information, see Adding Apps
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingapps-creating.html)
	// or Cookbooks and Recipes
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingcookbook.html).
	CustomCookbooksSource *types.Source
	// The configuration manager. When you create a stack we recommend that you use the
	// configuration manager to specify the Chef version: 12, 11.10, or 11.4 for Linux
	// stacks, or 12.2 for Windows stacks. The default value for Linux stacks is
	// currently 12.
	ConfigurationManager *types.StackConfigurationManager
	// The default root device type. This value is the default for all instances in the
	// stack, but you can override it when you create an instance. The default option
	// is instance-store. For more information, see Storage for the Root Device
	// (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ComponentsAMIs.html#storage-for-the-root-device).
	DefaultRootDeviceType types.RootDeviceType
	// The ID of the VPC that the stack is to be launched into. The VPC must be in the
	// stack's region. All instances are launched into this VPC. You cannot change the
	// ID later.
	//
	//     * If your account supports EC2-Classic, the default value is no
	// VPC.
	//
	//     * If your account does not support EC2-Classic, the default value is
	// the default VPC for the specified region.
	//
	// If the VPC ID corresponds to a
	// default VPC and you have specified either the DefaultAvailabilityZone or the
	// DefaultSubnetId parameter only, AWS OpsWorks Stacks infers the value of the
	// other parameter. If you specify neither parameter, AWS OpsWorks Stacks sets
	// these parameters to the first valid Availability Zone for the specified region
	// and the corresponding default VPC subnet ID, respectively. If you specify a
	// nondefault VPC ID, note the following:
	//
	//     * It must belong to a VPC in your
	// account that is in the specified region.
	//
	//     * You must specify a value for
	// DefaultSubnetId.
	//
	// For more information about how to use AWS OpsWorks Stacks with
	// a VPC, see Running a Stack in a VPC
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-vpc.html).
	// For more information about default VPC and EC2-Classic, see Supported Platforms
	// (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-supported-platforms.html).
	VpcId *string
	// The stack's host name theme, with spaces replaced by underscores. The theme is
	// used to generate host names for the stack's instances. By default, HostnameTheme
	// is set to Layer_Dependent, which creates host names by appending integers to the
	// layer's short name. The other themes are:
	//
	//     * Baked_Goods
	//
	//     * Clouds
	//
	//
	// * Europe_Cities
	//
	//     * Fruits
	//
	//     * Greek_Deities_and_Titans
	//
	//     *
	// Legendary_creatures_from_Japan
	//
	//     * Planets_and_Moons
	//
	//     * Roman_Deities
	//
	//
	// * Scottish_Islands
	//
	//     * US_Cities
	//
	//     * Wild_Cats
	//
	// To obtain a generated host
	// name, call GetHostNameSuggestion, which returns a host name based on the current
	// theme.
	HostnameTheme *string
	// The stack name.
	Name *string
	// A ChefConfiguration object that specifies whether to enable Berkshelf and the
	// Berkshelf version on Chef 11.10 stacks. For more information, see Create a New
	// Stack
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-creating.html).
	ChefConfiguration *types.ChefConfiguration
	// The stack's default operating system, which is installed on every instance
	// unless you specify a different operating system when you create the instance.
	// You can specify one of the following.
	//
	//     * A supported Linux operating system:
	// An Amazon Linux version, such as Amazon Linux 2018.03, Amazon Linux 2017.09,
	// Amazon Linux 2017.03, Amazon Linux 2016.09, Amazon Linux 2016.03, Amazon Linux
	// 2015.09, or Amazon Linux 2015.03.
	//
	//     * A supported Ubuntu operating system,
	// such as Ubuntu 16.04 LTS, Ubuntu 14.04 LTS, or Ubuntu 12.04 LTS.
	//
	//     * CentOS
	// Linux 7
	//
	//     * Red Hat Enterprise Linux 7
	//
	//     * A supported Windows operating
	// system, such as Microsoft Windows Server 2012 R2 Base, Microsoft Windows Server
	// 2012 R2 with SQL Server Express, Microsoft Windows Server 2012 R2 with SQL
	// Server Standard, or Microsoft Windows Server 2012 R2 with SQL Server Web.
	//
	//     *
	// A custom AMI: Custom. You specify the custom AMI you want to use when you create
	// instances. For more information, see  Using Custom AMIs
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-custom-ami.html).
	//
	// The
	// default option is the current Amazon Linux version. For more information about
	// supported operating systems, see AWS OpsWorks Stacks Operating Systems
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-os.html).
	DefaultOs *string
	// The stack's default Availability Zone, which must be in the specified region.
	// For more information, see Regions and Endpoints
	// (https://docs.aws.amazon.com/general/latest/gr/rande.html). If you also specify
	// a value for DefaultSubnetId, the subnet must be in the same zone. For more
	// information, see the VpcId parameter description.
	DefaultAvailabilityZone *string
}

type CreateStackOutput

type CreateStackOutput struct {
	// The stack ID, which is an opaque string that you use to identify the stack when
	// performing actions such as DescribeStacks.
	StackId *string

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a CreateStack request.

type CreateUserProfileInput

type CreateUserProfileInput struct {
	// The user's SSH user name. The allowable characters are [a-z], [A-Z], [0-9], '-',
	// and '_'. If the specified name includes other punctuation marks, AWS OpsWorks
	// Stacks removes them. For example, my.name will be changed to myname. If you do
	// not specify an SSH user name, AWS OpsWorks Stacks generates one from the IAM
	// user name.
	SshUsername *string
	// The user's IAM ARN; this can also be a federated user's ARN.
	IamUserArn *string
	// Whether users can specify their own SSH public key through the My Settings page.
	// For more information, see Setting an IAM User's Public SSH Key
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/security-settingsshkey.html).
	AllowSelfManagement *bool
	// The user's public SSH key.
	SshPublicKey *string
}

type CreateUserProfileOutput

type CreateUserProfileOutput struct {
	// The user's IAM ARN.
	IamUserArn *string

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a CreateUserProfile request.

type DeleteAppInput

type DeleteAppInput struct {
	// The app ID.
	AppId *string
}

type DeleteAppOutput

type DeleteAppOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type DeleteInstanceInput

type DeleteInstanceInput struct {
	// The instance ID.
	InstanceId *string
	// Whether to delete the instance Elastic IP address.
	DeleteElasticIp *bool
	// Whether to delete the instance's Amazon EBS volumes.
	DeleteVolumes *bool
}

type DeleteInstanceOutput

type DeleteInstanceOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type DeleteLayerInput

type DeleteLayerInput struct {
	// The layer ID.
	LayerId *string
}

type DeleteLayerOutput

type DeleteLayerOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type DeleteStackInput

type DeleteStackInput struct {
	// The stack ID.
	StackId *string
}

type DeleteStackOutput

type DeleteStackOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type DeleteUserProfileInput

type DeleteUserProfileInput struct {
	// The user's IAM ARN. This can also be a federated user's ARN.
	IamUserArn *string
}

type DeleteUserProfileOutput

type DeleteUserProfileOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type DeregisterEcsClusterInput

type DeregisterEcsClusterInput struct {
	// The cluster's Amazon Resource Number (ARN).
	EcsClusterArn *string
}

type DeregisterEcsClusterOutput

type DeregisterEcsClusterOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type DeregisterElasticIpInput

type DeregisterElasticIpInput struct {
	// The Elastic IP address.
	ElasticIp *string
}

type DeregisterElasticIpOutput

type DeregisterElasticIpOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type DeregisterInstanceInput

type DeregisterInstanceInput struct {
	// The instance ID.
	InstanceId *string
}

type DeregisterInstanceOutput

type DeregisterInstanceOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type DeregisterRdsDbInstanceInput

type DeregisterRdsDbInstanceInput struct {
	// The Amazon RDS instance's ARN.
	RdsDbInstanceArn *string
}

type DeregisterRdsDbInstanceOutput

type DeregisterRdsDbInstanceOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type DeregisterVolumeInput

type DeregisterVolumeInput struct {
	// The AWS OpsWorks Stacks volume ID, which is the GUID that AWS OpsWorks Stacks
	// assigned to the instance when you registered the volume with the stack, not the
	// Amazon EC2 volume ID.
	VolumeId *string
}

type DeregisterVolumeOutput

type DeregisterVolumeOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type DescribeAgentVersionsInput

type DescribeAgentVersionsInput struct {
	// The configuration manager.
	ConfigurationManager *types.StackConfigurationManager
	// The stack ID.
	StackId *string
}

type DescribeAgentVersionsOutput

type DescribeAgentVersionsOutput struct {
	// The agent versions for the specified stack or configuration manager. Note that
	// this value is the complete version number, not the abbreviated number used by
	// the console.
	AgentVersions []*types.AgentVersion

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeAgentVersions request.

type DescribeAppsInput

type DescribeAppsInput struct {
	// The app stack ID. If you use this parameter, DescribeApps returns a description
	// of the apps in the specified stack.
	StackId *string
	// An array of app IDs for the apps to be described. If you use this parameter,
	// DescribeApps returns a description of the specified apps. Otherwise, it returns
	// a description of every app.
	AppIds []*string
}

type DescribeAppsOutput

type DescribeAppsOutput struct {
	// An array of App objects that describe the specified apps.
	Apps []*types.App

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeApps request.

type DescribeCommandsInput

type DescribeCommandsInput struct {
	// The deployment ID. If you include this parameter, DescribeCommands returns a
	// description of the commands associated with the specified deployment.
	DeploymentId *string
	// The instance ID. If you include this parameter, DescribeCommands returns a
	// description of the commands associated with the specified instance.
	InstanceId *string
	// An array of command IDs. If you include this parameter, DescribeCommands returns
	// a description of the specified commands. Otherwise, it returns a description of
	// every command.
	CommandIds []*string
}

type DescribeCommandsOutput

type DescribeCommandsOutput struct {
	// An array of Command objects that describe each of the specified commands.
	Commands []*types.Command

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeCommands request.

type DescribeDeploymentsInput

type DescribeDeploymentsInput struct {
	// The app ID. If you include this parameter, the command returns a description of
	// the commands associated with the specified app.
	AppId *string
	// The stack ID. If you include this parameter, the command returns a description
	// of the commands associated with the specified stack.
	StackId *string
	// An array of deployment IDs to be described. If you include this parameter, the
	// command returns a description of the specified deployments. Otherwise, it
	// returns a description of every deployment.
	DeploymentIds []*string
}

type DescribeDeploymentsOutput

type DescribeDeploymentsOutput struct {
	// An array of Deployment objects that describe the deployments.
	Deployments []*types.Deployment

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeDeployments request.

type DescribeEcsClustersInput

type DescribeEcsClustersInput struct {
	// A list of ARNs, one for each cluster to be described.
	EcsClusterArns []*string
	// If the previous paginated request did not return all of the remaining results,
	// the response object'sNextToken parameter value is set to a token. To retrieve
	// the next set of results, call DescribeEcsClusters again and assign that token to
	// the request object's NextToken parameter. If there are no remaining results, the
	// previous response object's NextToken parameter is set to null.
	NextToken *string
	// A stack ID. DescribeEcsClusters returns a description of the cluster that is
	// registered with the stack.
	StackId *string
	// To receive a paginated response, use this parameter to specify the maximum
	// number of results to be returned with a single call. If the number of available
	// results exceeds this maximum, the response includes a NextToken value that you
	// can assign to the NextToken request parameter to get the next set of results.
	MaxResults *int32
}

type DescribeEcsClustersOutput

type DescribeEcsClustersOutput struct {
	// A list of EcsCluster objects containing the cluster descriptions.
	EcsClusters []*types.EcsCluster
	// If a paginated request does not return all of the remaining results, this
	// parameter is set to a token that you can assign to the request object's
	// NextToken parameter to retrieve the next set of results. If the previous
	// paginated request returned all of the remaining results, this parameter is set
	// to null.
	NextToken *string

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeEcsClusters request.

type DescribeElasticIpsInput

type DescribeElasticIpsInput struct {
	// A stack ID. If you include this parameter, DescribeElasticIps returns a
	// description of the Elastic IP addresses that are registered with the specified
	// stack.
	StackId *string
	// An array of Elastic IP addresses to be described. If you include this parameter,
	// DescribeElasticIps returns a description of the specified Elastic IP addresses.
	// Otherwise, it returns a description of every Elastic IP address.
	Ips []*string
	// The instance ID. If you include this parameter, DescribeElasticIps returns a
	// description of the Elastic IP addresses associated with the specified instance.
	InstanceId *string
}

type DescribeElasticIpsOutput

type DescribeElasticIpsOutput struct {
	// An ElasticIps object that describes the specified Elastic IP addresses.
	ElasticIps []*types.ElasticIp

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeElasticIps request.

type DescribeElasticLoadBalancersInput

type DescribeElasticLoadBalancersInput struct {
	// A stack ID. The action describes the stack's Elastic Load Balancing instances.
	StackId *string
	// A list of layer IDs. The action describes the Elastic Load Balancing instances
	// for the specified layers.
	LayerIds []*string
}

type DescribeElasticLoadBalancersOutput

type DescribeElasticLoadBalancersOutput struct {
	// A list of ElasticLoadBalancer objects that describe the specified Elastic Load
	// Balancing instances.
	ElasticLoadBalancers []*types.ElasticLoadBalancer

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeElasticLoadBalancers request.

type DescribeInstancesInput

type DescribeInstancesInput struct {
	// A layer ID. If you use this parameter, DescribeInstances returns descriptions of
	// the instances associated with the specified layer.
	LayerId *string
	// An array of instance IDs to be described. If you use this parameter,
	// DescribeInstances returns a description of the specified instances. Otherwise,
	// it returns a description of every instance.
	InstanceIds []*string
	// A stack ID. If you use this parameter, DescribeInstances returns descriptions of
	// the instances associated with the specified stack.
	StackId *string
}

type DescribeInstancesOutput

type DescribeInstancesOutput struct {
	// An array of Instance objects that describe the instances.
	Instances []*types.Instance

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeInstances request.

type DescribeLayersInput

type DescribeLayersInput struct {
	// The stack ID.
	StackId *string
	// An array of layer IDs that specify the layers to be described. If you omit this
	// parameter, DescribeLayers returns a description of every layer in the specified
	// stack.
	LayerIds []*string
}

type DescribeLayersOutput

type DescribeLayersOutput struct {
	// An array of Layer objects that describe the layers.
	Layers []*types.Layer

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeLayers request.

type DescribeLoadBasedAutoScalingInput

type DescribeLoadBasedAutoScalingInput struct {
	// An array of layer IDs.
	LayerIds []*string
}

type DescribeLoadBasedAutoScalingOutput

type DescribeLoadBasedAutoScalingOutput struct {
	// An array of LoadBasedAutoScalingConfiguration objects that describe each layer's
	// configuration.
	LoadBasedAutoScalingConfigurations []*types.LoadBasedAutoScalingConfiguration

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeLoadBasedAutoScaling request.

type DescribeMyUserProfileInput

type DescribeMyUserProfileInput struct {
}

type DescribeMyUserProfileOutput

type DescribeMyUserProfileOutput struct {
	// A UserProfile object that describes the user's SSH information.
	UserProfile *types.SelfUserProfile

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeMyUserProfile request.

type DescribeOperatingSystemsInput

type DescribeOperatingSystemsInput struct {
}

type DescribeOperatingSystemsOutput

type DescribeOperatingSystemsOutput struct {
	// Contains information in response to a DescribeOperatingSystems request.
	OperatingSystems []*types.OperatingSystem

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

The response to a DescribeOperatingSystems request.

type DescribePermissionsInput

type DescribePermissionsInput struct {
	// The user's IAM ARN. This can also be a federated user's ARN. For more
	// information about IAM ARNs, see Using Identifiers
	// (https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html).
	IamUserArn *string
	// The stack ID.
	StackId *string
}

type DescribePermissionsOutput

type DescribePermissionsOutput struct {
	// An array of Permission objects that describe the stack permissions.
	//
	//     * If
	// the request object contains only a stack ID, the array contains a Permission
	// object with permissions for each of the stack IAM ARNs.
	//
	//     * If the request
	// object contains only an IAM ARN, the array contains a Permission object with
	// permissions for each of the user's stack IDs.
	//
	//     * If the request contains a
	// stack ID and an IAM ARN, the array contains a single Permission object with
	// permissions for the specified stack and IAM ARN.
	Permissions []*types.Permission

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribePermissions request.

type DescribeRaidArraysInput

type DescribeRaidArraysInput struct {
	// An array of RAID array IDs. If you use this parameter, DescribeRaidArrays
	// returns descriptions of the specified arrays. Otherwise, it returns a
	// description of every array.
	RaidArrayIds []*string
	// The instance ID. If you use this parameter, DescribeRaidArrays returns
	// descriptions of the RAID arrays associated with the specified instance.
	InstanceId *string
	// The stack ID.
	StackId *string
}

type DescribeRaidArraysOutput

type DescribeRaidArraysOutput struct {
	// A RaidArrays object that describes the specified RAID arrays.
	RaidArrays []*types.RaidArray

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeRaidArrays request.

type DescribeRdsDbInstancesInput

type DescribeRdsDbInstancesInput struct {
	// The ID of the stack with which the instances are registered. The operation
	// returns descriptions of all registered Amazon RDS instances.
	StackId *string
	// An array containing the ARNs of the instances to be described.
	RdsDbInstanceArns []*string
}

type DescribeRdsDbInstancesOutput

type DescribeRdsDbInstancesOutput struct {
	// An a array of RdsDbInstance objects that describe the instances.
	RdsDbInstances []*types.RdsDbInstance

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeRdsDbInstances request.

type DescribeServiceErrorsInput

type DescribeServiceErrorsInput struct {
	// An array of service error IDs. If you use this parameter, DescribeServiceErrors
	// returns descriptions of the specified errors. Otherwise, it returns a
	// description of every error.
	ServiceErrorIds []*string
	// The stack ID. If you use this parameter, DescribeServiceErrors returns
	// descriptions of the errors associated with the specified stack.
	StackId *string
	// The instance ID. If you use this parameter, DescribeServiceErrors returns
	// descriptions of the errors associated with the specified instance.
	InstanceId *string
}

type DescribeServiceErrorsOutput

type DescribeServiceErrorsOutput struct {
	// An array of ServiceError objects that describe the specified service errors.
	ServiceErrors []*types.ServiceError

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeServiceErrors request.

type DescribeStackProvisioningParametersInput

type DescribeStackProvisioningParametersInput struct {
	// The stack ID.
	StackId *string
}

type DescribeStackProvisioningParametersOutput

type DescribeStackProvisioningParametersOutput struct {
	// The AWS OpsWorks Stacks agent installer's URL.
	AgentInstallerUrl *string
	// An embedded object that contains the provisioning parameters.
	Parameters map[string]*string

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeStackProvisioningParameters request.

type DescribeStackSummaryInput

type DescribeStackSummaryInput struct {
	// The stack ID.
	StackId *string
}

type DescribeStackSummaryOutput

type DescribeStackSummaryOutput struct {
	// A StackSummary object that contains the results.
	StackSummary *types.StackSummary

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeStackSummary request.

type DescribeStacksInput

type DescribeStacksInput struct {
	// An array of stack IDs that specify the stacks to be described. If you omit this
	// parameter, DescribeStacks returns a description of every stack.
	StackIds []*string
}

type DescribeStacksOutput

type DescribeStacksOutput struct {
	// An array of Stack objects that describe the stacks.
	Stacks []*types.Stack

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeStacks request.

type DescribeTimeBasedAutoScalingInput

type DescribeTimeBasedAutoScalingInput struct {
	// An array of instance IDs.
	InstanceIds []*string
}

type DescribeTimeBasedAutoScalingOutput

type DescribeTimeBasedAutoScalingOutput struct {
	// An array of TimeBasedAutoScalingConfiguration objects that describe the
	// configuration for the specified instances.
	TimeBasedAutoScalingConfigurations []*types.TimeBasedAutoScalingConfiguration

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeTimeBasedAutoScaling request.

type DescribeUserProfilesInput

type DescribeUserProfilesInput struct {
	// An array of IAM or federated user ARNs that identify the users to be described.
	IamUserArns []*string
}

type DescribeUserProfilesOutput

type DescribeUserProfilesOutput struct {
	// A Users object that describes the specified users.
	UserProfiles []*types.UserProfile

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeUserProfiles request.

type DescribeVolumesInput

type DescribeVolumesInput struct {
	// A stack ID. The action describes the stack's registered Amazon EBS volumes.
	StackId *string
	// Am array of volume IDs. If you use this parameter, DescribeVolumes returns
	// descriptions of the specified volumes. Otherwise, it returns a description of
	// every volume.
	VolumeIds []*string
	// The RAID array ID. If you use this parameter, DescribeVolumes returns
	// descriptions of the volumes associated with the specified RAID array.
	RaidArrayId *string
	// The instance ID. If you use this parameter, DescribeVolumes returns descriptions
	// of the volumes associated with the specified instance.
	InstanceId *string
}

type DescribeVolumesOutput

type DescribeVolumesOutput struct {
	// An array of volume IDs.
	Volumes []*types.Volume

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a DescribeVolumes request.

type DetachElasticLoadBalancerInput

type DetachElasticLoadBalancerInput struct {
	// The ID of the layer that the Elastic Load Balancing instance is attached to.
	LayerId *string
	// The Elastic Load Balancing instance's name.
	ElasticLoadBalancerName *string
}

type DetachElasticLoadBalancerOutput

type DetachElasticLoadBalancerOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type DisassociateElasticIpInput

type DisassociateElasticIpInput struct {
	// The Elastic IP address.
	ElasticIp *string
}

type DisassociateElasticIpOutput

type DisassociateElasticIpOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type EndpointResolver

type EndpointResolver interface {
	ResolveEndpoint(region string, options ResolverOptions) (aws.Endpoint, error)
}

EndpointResolver interface for resolving service endpoints.

func WithEndpointResolver

func WithEndpointResolver(awsResolver aws.EndpointResolver, fallbackResolver EndpointResolver) EndpointResolver

WithEndpointResolver returns an EndpointResolver that first delegates endpoint resolution to the awsResolver. If awsResolver returns aws.EndpointNotFoundError error, the resolver will use the the provided fallbackResolver for resolution. awsResolver and fallbackResolver must not be nil

type EndpointResolverFunc

type EndpointResolverFunc func(region string, options ResolverOptions) (aws.Endpoint, error)

EndpointResolverFunc is a helper utility that wraps a function so it satisfies the EndpointResolver interface. This is useful when you want to add additional endpoint resolving logic, or stub out specific endpoints with custom values.

func (EndpointResolverFunc) ResolveEndpoint

func (fn EndpointResolverFunc) ResolveEndpoint(region string, options ResolverOptions) (endpoint aws.Endpoint, err error)

type GetHostnameSuggestionInput

type GetHostnameSuggestionInput struct {
	// The layer ID.
	LayerId *string
}

type GetHostnameSuggestionOutput

type GetHostnameSuggestionOutput struct {
	// The layer ID.
	LayerId *string
	// The generated host name.
	Hostname *string

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a GetHostnameSuggestion request.

type GrantAccessInput

type GrantAccessInput struct {
	// The instance's AWS OpsWorks Stacks ID.
	InstanceId *string
	// The length of time (in minutes) that the grant is valid. When the grant expires
	// at the end of this period, the user will no longer be able to use the
	// credentials to log in. If the user is logged in at the time, he or she
	// automatically will be logged out.
	ValidForInMinutes *int32
}

type GrantAccessOutput

type GrantAccessOutput struct {
	// A TemporaryCredential object that contains the data needed to log in to the
	// instance by RDP clients, such as the Microsoft Remote Desktop Connection.
	TemporaryCredential *types.TemporaryCredential

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a GrantAccess request.

type HTTPClient

type HTTPClient interface {
	Do(*http.Request) (*http.Response, error)
}

type HTTPSignerV4

type HTTPSignerV4 interface {
	SignHTTP(ctx context.Context, credentials aws.Credentials, r *http.Request, payloadHash string, service string, region string, signingTime time.Time) error
}

type ListTagsInput

type ListTagsInput struct {
	// The stack or layer's Amazon Resource Number (ARN).
	ResourceArn *string
	// Do not use. A validation exception occurs if you add a NextToken parameter to a
	// ListTagsRequest call.
	NextToken *string
	// Do not use. A validation exception occurs if you add a MaxResults parameter to a
	// ListTagsRequest call.
	MaxResults *int32
}

type ListTagsOutput

type ListTagsOutput struct {
	// A set of key-value pairs that contain tag keys and tag values that are attached
	// to a stack or layer.
	Tags map[string]*string
	// If a paginated request does not return all of the remaining results, this
	// parameter is set to a token that you can assign to the request object's
	// NextToken parameter to get the next set of results. If the previous paginated
	// request returned all of the remaining results, this parameter is set to null.
	NextToken *string

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a ListTags request.

type Options

type Options struct {
	// Set of options to modify how an operation is invoked. These apply to all
	// operations invoked for this client. Use functional options on operation call to
	// modify this list for per operation behavior.
	APIOptions []func(*middleware.Stack) error

	// The credentials object to use when signing requests.
	Credentials aws.CredentialsProvider

	// The endpoint options to be used when attempting to resolve an endpoint.
	EndpointOptions ResolverOptions

	// The service endpoint resolver.
	EndpointResolver EndpointResolver

	// Signature Version 4 (SigV4) Signer
	HTTPSignerV4 HTTPSignerV4

	// The region to send requests to. (Required)
	Region string

	// Retryer guides how HTTP requests should be retried in case of recoverable
	// failures. When nil the API client will use a default retryer.
	Retryer retry.Retryer

	// The HTTP client to invoke API calls with. Defaults to client's default HTTP
	// implementation if nil.
	HTTPClient HTTPClient
}

func (Options) Copy

func (o Options) Copy() Options

Copy creates a clone where the APIOptions list is deep copied.

func (Options) GetCredentials

func (o Options) GetCredentials() aws.CredentialsProvider

func (Options) GetEndpointOptions

func (o Options) GetEndpointOptions() ResolverOptions

func (Options) GetEndpointResolver

func (o Options) GetEndpointResolver() EndpointResolver

func (Options) GetHTTPSignerV4

func (o Options) GetHTTPSignerV4() HTTPSignerV4

func (Options) GetRegion

func (o Options) GetRegion() string

func (Options) GetRetryer

func (o Options) GetRetryer() retry.Retryer

type RebootInstanceInput

type RebootInstanceInput struct {
	// The instance ID.
	InstanceId *string
}

type RebootInstanceOutput

type RebootInstanceOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type RegisterEcsClusterInput

type RegisterEcsClusterInput struct {
	// The cluster's ARN.
	EcsClusterArn *string
	// The stack ID.
	StackId *string
}

type RegisterEcsClusterOutput

type RegisterEcsClusterOutput struct {
	// The cluster's ARN.
	EcsClusterArn *string

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a RegisterEcsCluster request.

type RegisterElasticIpInput

type RegisterElasticIpInput struct {
	// The Elastic IP address.
	ElasticIp *string
	// The stack ID.
	StackId *string
}

type RegisterElasticIpOutput

type RegisterElasticIpOutput struct {
	// The Elastic IP address.
	ElasticIp *string

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a RegisterElasticIp request.

type RegisterInstanceInput

type RegisterInstanceInput struct {
	// The instances public RSA key. This key is used to encrypt communication between
	// the instance and the service.
	RsaPublicKey *string
	// The instance's private IP address.
	PrivateIp *string
	// The instances public RSA key fingerprint.
	RsaPublicKeyFingerprint *string
	// The ID of the stack that the instance is to be registered with.
	StackId *string
	// The instance's hostname.
	Hostname *string
	// An InstanceIdentity object that contains the instance's identity.
	InstanceIdentity *types.InstanceIdentity
	// The instance's public IP address.
	PublicIp *string
}

type RegisterInstanceOutput

type RegisterInstanceOutput struct {
	// The registered instance's AWS OpsWorks Stacks ID.
	InstanceId *string

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a RegisterInstanceResult request.

type RegisterRdsDbInstanceInput

type RegisterRdsDbInstanceInput struct {
	// The Amazon RDS instance's ARN.
	RdsDbInstanceArn *string
	// The database password.
	DbPassword *string
	// The database's master user name.
	DbUser *string
	// The stack ID.
	StackId *string
}

type RegisterRdsDbInstanceOutput

type RegisterRdsDbInstanceOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type RegisterVolumeInput

type RegisterVolumeInput struct {
	// The stack ID.
	StackId *string
	// The Amazon EBS volume ID.
	Ec2VolumeId *string
}

type RegisterVolumeOutput

type RegisterVolumeOutput struct {
	// The volume ID.
	VolumeId *string

	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Contains the response to a RegisterVolume request.

type ResolveEndpoint

type ResolveEndpoint struct {
	Resolver EndpointResolver
	Options  ResolverOptions
}

func (*ResolveEndpoint) HandleSerialize

func (*ResolveEndpoint) ID

func (*ResolveEndpoint) ID() string

type ResolveEndpointMiddlewareOptions

type ResolveEndpointMiddlewareOptions interface {
	GetEndpointResolver() EndpointResolver
	GetEndpointOptions() ResolverOptions
}

type ResolverOptions

type ResolverOptions = internalendpoints.Options

ResolverOptions is the service endpoint resolver options

type SetLoadBasedAutoScalingInput

type SetLoadBasedAutoScalingInput struct {
	// An AutoScalingThresholds object with the upscaling threshold configuration. If
	// the load exceeds these thresholds for a specified amount of time, AWS OpsWorks
	// Stacks starts a specified number of instances.
	UpScaling *types.AutoScalingThresholds
	// The layer ID.
	LayerId *string
	// Enables load-based auto scaling for the layer.
	Enable *bool
	// An AutoScalingThresholds object with the downscaling threshold configuration. If
	// the load falls below these thresholds for a specified amount of time, AWS
	// OpsWorks Stacks stops a specified number of instances.
	DownScaling *types.AutoScalingThresholds
}

type SetLoadBasedAutoScalingOutput

type SetLoadBasedAutoScalingOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type SetPermissionInput

type SetPermissionInput struct {
	// The user's IAM ARN. This can also be a federated user's ARN.
	IamUserArn *string
	// The user is allowed to use SSH to communicate with the instance.
	AllowSsh *bool
	// The stack ID.
	StackId *string
	// The user is allowed to use sudo to elevate privileges.
	AllowSudo *bool
	// The user's permission level, which must be set to one of the following strings.
	// You cannot set your own permissions level.
	//
	//     * deny
	//
	//     * show
	//
	//     *
	// deploy
	//
	//     * manage
	//
	//     * iam_only
	//
	// For more information about the permissions
	// associated with these levels, see Managing User Permissions
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html).
	Level *string
}

type SetPermissionOutput

type SetPermissionOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type SetTimeBasedAutoScalingInput

type SetTimeBasedAutoScalingInput struct {
	// The instance ID.
	InstanceId *string
	// An AutoScalingSchedule with the instance schedule.
	AutoScalingSchedule *types.WeeklyAutoScalingSchedule
}

type SetTimeBasedAutoScalingOutput

type SetTimeBasedAutoScalingOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type StartInstanceInput

type StartInstanceInput struct {
	// The instance ID.
	InstanceId *string
}

type StartInstanceOutput

type StartInstanceOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type StartStackInput

type StartStackInput struct {
	// The stack ID.
	StackId *string
}

type StartStackOutput

type StartStackOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type StopInstanceInput

type StopInstanceInput struct {
	// The instance ID.
	InstanceId *string
	// Specifies whether to force an instance to stop. If the instance's root device
	// type is ebs, or EBS-backed, adding the Force parameter to the StopInstances API
	// call disassociates the AWS OpsWorks Stacks instance from EC2, and forces
	// deletion of only the OpsWorks Stacks instance. You must also delete the
	// formerly-associated instance in EC2 after troubleshooting and replacing the AWS
	// OpsWorks Stacks instance with a new one.
	Force *bool
}

type StopInstanceOutput

type StopInstanceOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type StopStackInput

type StopStackInput struct {
	// The stack ID.
	StackId *string
}

type StopStackOutput

type StopStackOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type TagResourceInput

type TagResourceInput struct {
	// The stack or layer's Amazon Resource Number (ARN).
	ResourceArn *string
	// A map that contains tag keys and tag values that are attached to a stack or
	// layer.
	//
	//     * The key cannot be empty.
	//
	//     * The key can be a maximum of 127
	// characters, and can contain only Unicode letters, numbers, or separators, or the
	// following special characters: + - = . _ : /
	//
	//     * The value can be a maximum
	// 255 characters, and contain only Unicode letters, numbers, or separators, or the
	// following special characters: + - = . _ : /
	//
	//     * Leading and trailing white
	// spaces are trimmed from both the key and value.
	//
	//     * A maximum of 40 tags is
	// allowed for any resource.
	Tags map[string]*string
}

type TagResourceOutput

type TagResourceOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type UnassignInstanceInput

type UnassignInstanceInput struct {
	// The instance ID.
	InstanceId *string
}

type UnassignInstanceOutput

type UnassignInstanceOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type UnassignVolumeInput

type UnassignVolumeInput struct {
	// The volume ID.
	VolumeId *string
}

type UnassignVolumeOutput

type UnassignVolumeOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type UntagResourceInput

type UntagResourceInput struct {
	// A list of the keys of tags to be removed from a stack or layer.
	TagKeys []*string
	// The stack or layer's Amazon Resource Number (ARN).
	ResourceArn *string
}

type UntagResourceOutput

type UntagResourceOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type UpdateAppInput

type UpdateAppInput struct {
	// A Source object that specifies the app repository.
	AppSource *types.Source
	// An array of EnvironmentVariable objects that specify environment variables to be
	// associated with the app. After you deploy the app, these variables are defined
	// on the associated app server instances.For more information, see  Environment
	// Variables
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingapps-creating.html#workingapps-creating-environment).
	// There is no specific limit on the number of environment variables. However, the
	// size of the associated data structure - which includes the variables' names,
	// values, and protected flag values - cannot exceed 20 KB. This limit should
	// accommodate most if not all use cases. Exceeding it will cause an exception with
	// the message, "Environment: is too large (maximum is 20 KB)." If you have
	// specified one or more environment variables, you cannot modify the stack's Chef
	// version.
	Environment []*types.EnvironmentVariable
	// One or more user-defined key/value pairs to be added to the stack attributes.
	Attributes map[string]*string
	// Whether SSL is enabled for the app.
	EnableSsl *bool
	// The app name.
	Name *string
	// The app type.
	Type types.AppType
	// The app's data sources.
	DataSources []*types.DataSource
	// The app ID.
	AppId *string
	// The app's virtual host settings, with multiple domains separated by commas. For
	// example: 'www.example.com, example.com'
	Domains []*string
	// A description of the app.
	Description *string
	// An SslConfiguration object with the SSL configuration.
	SslConfiguration *types.SslConfiguration
}

type UpdateAppOutput

type UpdateAppOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type UpdateElasticIpInput

type UpdateElasticIpInput struct {
	// The new name.
	Name *string
	// The IP address for which you want to update the name.
	ElasticIp *string
}

type UpdateElasticIpOutput

type UpdateElasticIpOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type UpdateInstanceInput

type UpdateInstanceInput struct {
	// The instance ID.
	InstanceId *string
	// For load-based or time-based instances, the type. Windows stacks can use only
	// time-based instances.
	AutoScalingType types.AutoScalingType
	// The instance architecture. Instance types do not necessarily support both
	// architectures. For a list of the architectures that are supported by the
	// different instance types, see Instance Families and Types
	// (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html).
	Architecture types.Architecture
	// The instance type, such as t2.micro. For a list of supported instance types,
	// open the stack in the console, choose Instances, and choose + Instance. The Size
	// list contains the currently supported types. For more information, see Instance
	// Families and Types
	// (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html). The
	// parameter values that you use to specify the various types are in the API Name
	// column of the Available Instance Types table.
	InstanceType *string
	// The default AWS OpsWorks Stacks agent version. You have the following options:
	//
	//
	// * INHERIT - Use the stack's default agent version setting.
	//
	//     * version_number
	// - Use the specified agent version. This value overrides the stack's default
	// setting. To update the agent version, you must edit the instance configuration
	// and specify a new version. AWS OpsWorks Stacks then automatically installs that
	// version on the instance.
	//
	// The default setting is INHERIT. To specify an agent
	// version, you must use the complete version number, not the abbreviated number
	// shown on the console. For a list of available agent version numbers, call
	// DescribeAgentVersions (). AgentVersion cannot be set to Chef 12.2.
	AgentVersion *string
	// Whether to install operating system and package updates when the instance boots.
	// The default value is true. To control when updates are installed, set this value
	// to false. You must then update your instances manually by using CreateDeployment
	// () to run the update_dependencies stack command or by manually running yum
	// (Amazon Linux) or apt-get (Ubuntu) on the instances. We strongly recommend using
	// the default value of true, to ensure that your instances have the latest
	// security updates.
	InstallUpdatesOnBoot *bool
	// The instance host name.
	Hostname *string
	// This property cannot be updated.
	EbsOptimized *bool
	// The instance's layer IDs.
	LayerIds []*string
	// The ID of the AMI that was used to create the instance. The value of this
	// parameter must be the same AMI ID that the instance is already using. You cannot
	// apply a new AMI to an instance by running UpdateInstance. UpdateInstance does
	// not work on instances that are using custom AMIs.
	AmiId *string
	// The instance's operating system, which must be set to one of the following. You
	// cannot update an instance that is using a custom AMI.
	//
	//     * A supported Linux
	// operating system: An Amazon Linux version, such as Amazon Linux 2018.03, Amazon
	// Linux 2017.09, Amazon Linux 2017.03, Amazon Linux 2016.09, Amazon Linux 2016.03,
	// Amazon Linux 2015.09, or Amazon Linux 2015.03.
	//
	//     * A supported Ubuntu
	// operating system, such as Ubuntu 16.04 LTS, Ubuntu 14.04 LTS, or Ubuntu 12.04
	// LTS.
	//
	//     * CentOS Linux 7
	//
	//     * Red Hat Enterprise Linux 7
	//
	//     * A supported
	// Windows operating system, such as Microsoft Windows Server 2012 R2 Base,
	// Microsoft Windows Server 2012 R2 with SQL Server Express, Microsoft Windows
	// Server 2012 R2 with SQL Server Standard, or Microsoft Windows Server 2012 R2
	// with SQL Server Web.
	//
	// For more information about supported operating systems,
	// see AWS OpsWorks Stacks Operating Systems
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-os.html).
	// The default option is the current Amazon Linux version. If you set this
	// parameter to Custom, you must use the AmiId parameter to specify the custom AMI
	// that you want to use. For more information about supported operating systems,
	// see Operating Systems
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-os.html).
	// For more information about how to use custom AMIs with OpsWorks, see Using
	// Custom AMIs
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-custom-ami.html).
	// You can specify a different Linux operating system for the updated stack, but
	// you cannot change from Linux to Windows or Windows to Linux.
	Os *string
	// The instance's Amazon EC2 key name.
	SshKeyName *string
}

type UpdateInstanceOutput

type UpdateInstanceOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type UpdateLayerInput

type UpdateLayerInput struct {
	//
	LifecycleEventConfiguration *types.LifecycleEventConfiguration
	// The ARN of an IAM profile to be used for all of the layer's EC2 instances. For
	// more information about IAM ARNs, see Using Identifiers
	// (https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html).
	CustomInstanceProfileArn *string
	// The layer name, which is used by the console.
	Name *string
	// For stacks that are running in a VPC, whether to automatically assign a public
	// IP address to the layer's instances. For more information, see How to Edit a
	// Layer
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinglayers-basics-edit.html).
	AutoAssignPublicIps *bool
	// For custom layers only, use this parameter to specify the layer's short name,
	// which is used internally by AWS OpsWorks Stacks and by Chef. The short name is
	// also used as the name for the directory where your app files are installed. It
	// can have a maximum of 200 characters and must be in the following format:
	// /\A[a-z0-9\-\_\.]+\Z/. The built-in layers' short names are defined by AWS
	// OpsWorks Stacks. For more information, see the Layer Reference
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/layers.html)
	Shortname *string
	// Whether to disable auto healing for the layer.
	EnableAutoHealing *bool
	// An array of Package objects that describe the layer's packages.
	Packages []*string
	// Specifies CloudWatch Logs configuration options for the layer. For more
	// information, see CloudWatchLogsLogStream ().
	CloudWatchLogsConfiguration *types.CloudWatchLogsConfiguration
	// Whether to use Amazon EBS-optimized instances.
	UseEbsOptimizedInstances *bool
	// Whether to install operating system and package updates when the instance boots.
	// The default value is true. To control when updates are installed, set this value
	// to false. You must then update your instances manually by using CreateDeployment
	// () to run the update_dependencies stack command or manually running yum (Amazon
	// Linux) or apt-get (Ubuntu) on the instances. We strongly recommend using the
	// default value of true, to ensure that your instances have the latest security
	// updates.
	InstallUpdatesOnBoot *bool
	// One or more user-defined key/value pairs to be added to the stack attributes.
	Attributes map[string]*string
	// A VolumeConfigurations object that describes the layer's Amazon EBS volumes.
	VolumeConfigurations []*types.VolumeConfiguration
	// Whether to automatically assign an Elastic IP address
	// (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html)
	// to the layer's instances. For more information, see How to Edit a Layer
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinglayers-basics-edit.html).
	AutoAssignElasticIps *bool
	// The layer ID.
	LayerId *string
	// An array containing the layer's custom security group IDs.
	CustomSecurityGroupIds []*string
	// A JSON-formatted string containing custom stack configuration and deployment
	// attributes to be installed on the layer's instances. For more information, see
	// Using Custom JSON
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingcookbook-json-override.html).
	CustomJson *string
	// A LayerCustomRecipes object that specifies the layer's custom recipes.
	CustomRecipes *types.Recipes
}

type UpdateLayerOutput

type UpdateLayerOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type UpdateMyUserProfileInput

type UpdateMyUserProfileInput struct {
	// The user's SSH public key.
	SshPublicKey *string
}

type UpdateMyUserProfileOutput

type UpdateMyUserProfileOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type UpdateRdsDbInstanceInput

type UpdateRdsDbInstanceInput struct {
	// The Amazon RDS instance's ARN.
	RdsDbInstanceArn *string
	// The master user name.
	DbUser *string
	// The database password.
	DbPassword *string
}

type UpdateRdsDbInstanceOutput

type UpdateRdsDbInstanceOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type UpdateStackInput

type UpdateStackInput struct {
	// Whether to associate the AWS OpsWorks Stacks built-in security groups with the
	// stack's layers. AWS OpsWorks Stacks provides a standard set of built-in security
	// groups, one for each layer, which are associated with layers by default.
	// UseOpsworksSecurityGroups allows you to provide your own custom security groups
	// instead of using the built-in groups. UseOpsworksSecurityGroups has the
	// following settings:
	//
	//     * True - AWS OpsWorks Stacks automatically associates
	// the appropriate built-in security group with each layer (default setting). You
	// can associate additional security groups with a layer after you create it, but
	// you cannot delete the built-in security group.
	//
	//     * False - AWS OpsWorks
	// Stacks does not associate built-in security groups with layers. You must create
	// appropriate EC2 security groups and associate a security group with each layer
	// that you create. However, you can still manually associate a built-in security
	// group with a layer on. Custom security groups are required only for those layers
	// that need custom settings.
	//
	// For more information, see Create a New Stack
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-creating.html).
	UseOpsworksSecurityGroups *bool
	// The stack's default Availability Zone, which must be in the stack's region. For
	// more information, see Regions and Endpoints
	// (https://docs.aws.amazon.com/general/latest/gr/rande.html). If you also specify
	// a value for DefaultSubnetId, the subnet must be in the same zone. For more
	// information, see CreateStack ().
	DefaultAvailabilityZone *string
	// The ARN of an IAM profile that is the default profile for all of the stack's EC2
	// instances. For more information about IAM ARNs, see Using Identifiers
	// (https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html).
	DefaultInstanceProfileArn *string
	// The stack's new host name theme, with spaces replaced by underscores. The theme
	// is used to generate host names for the stack's instances. By default,
	// HostnameTheme is set to Layer_Dependent, which creates host names by appending
	// integers to the layer's short name. The other themes are:
	//
	//     * Baked_Goods
	//
	//
	// * Clouds
	//
	//     * Europe_Cities
	//
	//     * Fruits
	//
	//     * Greek_Deities_and_Titans
	//
	//
	// * Legendary_creatures_from_Japan
	//
	//     * Planets_and_Moons
	//
	//     * Roman_Deities
	//
	//
	// * Scottish_Islands
	//
	//     * US_Cities
	//
	//     * Wild_Cats
	//
	// To obtain a generated host
	// name, call GetHostNameSuggestion, which returns a host name based on the current
	// theme.
	HostnameTheme *string
	// The default AWS OpsWorks Stacks agent version. You have the following options:
	//
	//
	// * Auto-update - Set this parameter to LATEST. AWS OpsWorks Stacks automatically
	// installs new agent versions on the stack's instances as soon as they are
	// available.
	//
	//     * Fixed version - Set this parameter to your preferred agent
	// version. To update the agent version, you must edit the stack configuration and
	// specify a new version. AWS OpsWorks Stacks then automatically installs that
	// version on the stack's instances.
	//
	// The default setting is LATEST. To specify an
	// agent version, you must use the complete version number, not the abbreviated
	// number shown on the console. For a list of available agent version numbers, call
	// DescribeAgentVersions (). AgentVersion cannot be set to Chef 12.2. You can also
	// specify an agent version when you create or update an instance, which overrides
	// the stack's default setting.
	AgentVersion *string
	// Whether the stack uses custom cookbooks.
	UseCustomCookbooks *bool
	// A default Amazon EC2 key-pair name. The default value is none. If you specify a
	// key-pair name, AWS OpsWorks Stacks installs the public key on the instance and
	// you can use the private key with an SSH client to log in to the instance. For
	// more information, see  Using SSH to Communicate with an Instance
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-ssh.html)
	// and  Managing SSH Access
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/security-ssh-access.html).
	// You can override this setting by specifying a different key pair, or no key
	// pair, when you  create an instance
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-add.html).
	DefaultSshKeyName *string
	// The stack ID.
	StackId *string
	// The stack's default VPC subnet ID. This parameter is required if you specify a
	// value for the VpcId parameter. All instances are launched into this subnet
	// unless you specify otherwise when you create the instance. If you also specify a
	// value for DefaultAvailabilityZone, the subnet must be in that zone. For
	// information on default values and when this parameter is required, see the VpcId
	// parameter description.
	DefaultSubnetId *string
	// The configuration manager. When you update a stack, we recommend that you use
	// the configuration manager to specify the Chef version: 12, 11.10, or 11.4 for
	// Linux stacks, or 12.2 for Windows stacks. The default value for Linux stacks is
	// currently 12.
	ConfigurationManager *types.StackConfigurationManager
	// A string that contains user-defined, custom JSON. It can be used to override the
	// corresponding default stack configuration JSON values or to pass data to
	// recipes. The string should be in the following format: "{\"key1\": \"value1\",
	// \"key2\": \"value2\",...}" For more information about custom JSON, see Use
	// Custom JSON to Modify the Stack Configuration Attributes
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-json.html).
	CustomJson *string
	// The default root device type. This value is used by default for all instances in
	// the stack, but you can override it when you create an instance. For more
	// information, see Storage for the Root Device
	// (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ComponentsAMIs.html#storage-for-the-root-device).
	DefaultRootDeviceType types.RootDeviceType
	// Contains the information required to retrieve an app or cookbook from a
	// repository. For more information, see Adding Apps
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingapps-creating.html)
	// or Cookbooks and Recipes
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingcookbook.html).
	CustomCookbooksSource *types.Source
	// A ChefConfiguration object that specifies whether to enable Berkshelf and the
	// Berkshelf version on Chef 11.10 stacks. For more information, see Create a New
	// Stack
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-creating.html).
	ChefConfiguration *types.ChefConfiguration
	// One or more user-defined key-value pairs to be added to the stack attributes.
	Attributes map[string]*string
	// Do not use this parameter. You cannot update a stack's service role.
	ServiceRoleArn *string
	// The stack's new name.
	Name *string
	// The stack's operating system, which must be set to one of the following:
	//
	//     *
	// A supported Linux operating system: An Amazon Linux version, such as Amazon
	// Linux 2018.03, Amazon Linux 2017.09, Amazon Linux 2017.03, Amazon Linux 2016.09,
	// Amazon Linux 2016.03, Amazon Linux 2015.09, or Amazon Linux 2015.03.
	//
	//     * A
	// supported Ubuntu operating system, such as Ubuntu 16.04 LTS, Ubuntu 14.04 LTS,
	// or Ubuntu 12.04 LTS.
	//
	//     * CentOS Linux 7
	//
	//     * Red Hat Enterprise Linux 7
	//
	//
	// * A supported Windows operating system, such as Microsoft Windows Server 2012 R2
	// Base, Microsoft Windows Server 2012 R2 with SQL Server Express, Microsoft
	// Windows Server 2012 R2 with SQL Server Standard, or Microsoft Windows Server
	// 2012 R2 with SQL Server Web.
	//
	//     * A custom AMI: Custom. You specify the custom
	// AMI you want to use when you create instances. For more information about how to
	// use custom AMIs with OpsWorks, see Using Custom AMIs
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-custom-ami.html).
	//
	// The
	// default option is the stack's current operating system. For more information
	// about supported operating systems, see AWS OpsWorks Stacks Operating Systems
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-os.html).
	DefaultOs *string
}

type UpdateStackOutput

type UpdateStackOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type UpdateUserProfileInput

type UpdateUserProfileInput struct {
	// The user's SSH user name. The allowable characters are [a-z], [A-Z], [0-9], '-',
	// and '_'. If the specified name includes other punctuation marks, AWS OpsWorks
	// Stacks removes them. For example, my.name will be changed to myname. If you do
	// not specify an SSH user name, AWS OpsWorks Stacks generates one from the IAM
	// user name.
	SshUsername *string
	// Whether users can specify their own SSH public key through the My Settings page.
	// For more information, see Managing User Permissions
	// (https://docs.aws.amazon.com/opsworks/latest/userguide/security-settingsshkey.html).
	AllowSelfManagement *bool
	// The user IAM ARN. This can also be a federated user's ARN.
	IamUserArn *string
	// The user's new SSH public key.
	SshPublicKey *string
}

type UpdateUserProfileOutput

type UpdateUserProfileOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

type UpdateVolumeInput

type UpdateVolumeInput struct {
	// The new mount point.
	MountPoint *string
	// The volume ID.
	VolumeId *string
	// The new name.
	Name *string
}

type UpdateVolumeOutput

type UpdateVolumeOutput struct {
	// Metadata pertaining to the operation's result.
	ResultMetadata middleware.Metadata
}

Source Files

Directories

Path Synopsis
internal

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL