v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14198892.8 KB

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.

post/#X-Amz-Target=OpsWorksCM_V2016_11_01.DisassociateNode

Headers

X-Amz-Target'OpsWorksCM_V2016_11_01.DisassociateNode' required

Request body

ServerNamestring required

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

NodeNamestring required

The name of the client node.

Response

Success

NodeAssociationStatusTokenstring

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