AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Associates a new node with the server. For more information about how to disassociate a node, see DisassociateNode.
On a Chef server: This command is an alternative to knife bootstrap.
Example (Chef): aws opsworks-cm associate-node --server-name MyServer --node-name
MyManagedNode --engine-attributes "Name=CHEF_ORGANIZATION,Value=default"
"Name=CHEF_NODE_PUBLIC_KEY,Value=public-key-pem"
On a Puppet server, this command is an alternative to the puppet cert sign
command that signs a Puppet node CSR.
Example (Puppet): aws opsworks-cm associate-node --server-name MyServer
--node-name MyManagedNode --engine-attributes "Name=PUPPET_NODE_CSR,Value=csr-pem"
A node can can only be associated with servers that are 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. The AssociateNode API call can be integrated
into Auto Scaling configurations, AWS Cloudformation templates, or the user data of
a server's instance.
For .NET Core this operation is only available in asynchronous form. Please refer to AssociateNodeAsync.
Namespace: Amazon.OpsWorksCM
Assembly: AWSSDK.OpsWorksCM.dll
Version: 3.x.y.z
public virtual AssociateNodeResponse AssociateNode( AssociateNodeRequest request )
Container for the necessary parameters to execute the AssociateNode service method.
| Exception | Condition |
|---|---|
| InvalidStateException | The resource is in a state that does not allow you to perform a specified action. |
| ResourceNotFoundException | The requested resource does not exist, or access was denied. |
| ValidationException | One or more of the provided request parameters are not valid. |
.NET Framework:
Supported in: 4.5, 4.0, 3.5