AWS SDK Version 3 for .NET
API Reference

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"

On a Puppet server, this command is an alternative to the puppet cert sign command that signs a Puppet node CSR.

Example (Chef):

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 and PCL 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
Type: Amazon.OpsWorksCM.Model.AssociateNodeRequest

Container for the necessary parameters to execute the AssociateNode service method.

Return Value
The response from the AssociateNode service method, as returned by OpsWorksCM.


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.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also