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.
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginAssociateNode and EndAssociateNode.
Namespace: Amazon.OpsWorksCM
Assembly: AWSSDK.OpsWorksCM.dll
Version: 3.x.y.z
public virtual Task<AssociateNodeResponse> AssociateNodeAsync( AssociateNodeRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the AssociateNode service method.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
| 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:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5 and newer