OpsWorks / Client / unassign_instance

unassign_instance#

OpsWorks.Client.unassign_instance(**kwargs)#

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

Request Syntax

response = client.unassign_instance(
    InstanceId='string'
)

Parameters:

InstanceId (string) –

[REQUIRED]

The instance ID.

Returns:

None

Exceptions

OpsWorks.Client.exceptions.ValidationException
OpsWorks.Client.exceptions.ResourceNotFoundException