OpsWorksCM / Client / associate_node



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.

See also: AWS API Documentation

Request Syntax

response = client.associate_node(
            'Name': 'string',
            'Value': 'string'
  • ServerName (string) –


    The name of the server with which to associate the node.

  • NodeName (string) –


    The name of the node.

  • EngineAttributes (list) –


    Engine attributes used for associating the node.

    Attributes accepted in a AssociateNode request for Chef

    • CHEF_ORGANIZATION: The Chef organization with which the node is associated. By default only one organization named default can exist.

    • CHEF_NODE_PUBLIC_KEY: A PEM-formatted public key. This key is required for the chef-client agent to access the Chef API.

    Attributes accepted in a AssociateNode request for Puppet

    • PUPPET_NODE_CSR: A PEM-formatted certificate-signing request (CSR) that is created by the node.

    • (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:



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 association request.


  • OpsWorksCM.Client.exceptions.InvalidStateException

  • OpsWorksCM.Client.exceptions.ResourceNotFoundException

  • OpsWorksCM.Client.exceptions.ValidationException