disassociate_node

disassociate_node(**kwargs)

Disassociates a node from an AWS OpsWorks CM server, and removes the node from the server's managed nodes. After a node is disassociated, the node key pair is no longer valid for accessing the configuration manager's API. For more information about how to associate a node, see AssociateNode.

A node can can only be disassociated from a server that is in a HEALTHY state. Otherwise, an InvalidStateException is thrown. A ResourceNotFoundException is thrown when the server does not exist. A ValidationException is raised when parameters of the request are not valid.

See also: AWS API Documentation

Request Syntax

response = client.disassociate_node(
    ServerName='string',
    NodeName='string',
    EngineAttributes=[
        {
            'Name': 'string',
            'Value': 'string'
        },
    ]
)

Parameters

• ServerName (string) --

  [REQUIRED]

  The name of the server from which to disassociate the node.

• NodeName (string) --

  [REQUIRED]

  The name of the client node.

• EngineAttributes (list) --

  Engine attributes that are used for disassociating the node. No attributes are required for Puppet.

  Attributes required in a DisassociateNode request for Chef

  • CHEF_ORGANIZATION : The Chef organization with which the node was associated. By default only one organization named default can exist.
  • (dict) --

    A name and value pair that is specific to the engine of the server.

    • Name (string) --

      The name of the engine attribute.

    • Value (string) --

      The value of the engine attribute.

Return type

dict

Returns

Response Syntax

{
    'NodeAssociationStatusToken': 'string'
}

Response Structure

• (dict) --

  • NodeAssociationStatusToken (string) --

    Contains a token which can be passed to the DescribeNodeAssociationStatus API call to get the status of the disassociation request.

Exceptions

• OpsWorksCM.Client.exceptions.InvalidStateException
• OpsWorksCM.Client.exceptions.ResourceNotFoundException
• OpsWorksCM.Client.exceptions.ValidationException