OpsWorks / Client / assign_instance

assign_instance#

OpsWorks.Client.assign_instance(**kwargs)#

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 OpsWorks Stacks.

Required Permissions: To use this action, an 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.

See also: AWS API Documentation

Request Syntax

response = client.assign_instance(
    InstanceId='string',
    LayerIds=[
        'string',
    ]
)
Parameters:
  • InstanceId (string) –

    [REQUIRED]

    The instance ID.

  • LayerIds (list) –

    [REQUIRED]

    The layer ID, which must correspond to a custom layer. You cannot assign a registered instance to a built-in layer.

    • (string) –

Returns:

None

Exceptions

  • OpsWorks.Client.exceptions.ValidationException

  • OpsWorks.Client.exceptions.ResourceNotFoundException