ASSOCIATENODE()`¶

About AssociateNode¶

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_AUTOMATE_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, CloudFormation templates, or the user data of a server's instance.

Method Signature¶

METHODS /AWS1/IF_OWC~ASSOCIATENODE
  IMPORTING
    !IV_SERVERNAME TYPE /AWS1/OWCSERVERNAME OPTIONAL
    !IV_NODENAME TYPE /AWS1/OWCNODENAME OPTIONAL
    !IT_ENGINEATTRIBUTES TYPE /AWS1/CL_OWCENGINEATTRIBUTE=>TT_ENGINEATTRIBUTES OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_owcassocnoderesponse
  RAISING
    /AWS1/CX_OWCINVALIDSTATEEX
    /AWS1/CX_OWCRESOURCENOTFOUNDEX
    /AWS1/CX_OWCVALIDATIONEX
    /AWS1/CX_OWCCLIENTEXC
    /AWS1/CX_OWCSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_servername` `TYPE /AWS1/OWCSERVERNAME` `/AWS1/OWCSERVERNAME`¶

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

`iv_nodename` `TYPE /AWS1/OWCNODENAME` `/AWS1/OWCNODENAME`¶

The name of the node.

`it_engineattributes` `TYPE /AWS1/CL_OWCENGINEATTRIBUTE=>TT_ENGINEATTRIBUTES` `TT_ENGINEATTRIBUTES`¶

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_AUTOMATE_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.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_owcassocnoderesponse` `/AWS1/CL_OWCASSOCNODERESPONSE`¶

Domain /AWS1/RT_ACCOUNT_ID

Primitive Type NUMC

Examples¶

Syntax Example¶

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->associatenode(
  it_engineattributes = VALUE /aws1/cl_owcengineattribute=>tt_engineattributes(
    (
      new /aws1/cl_owcengineattribute(
        iv_name = |string|
        iv_value = |string|
      )
    )
  )
  iv_nodename = |string|
  iv_servername = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_nodeassociationstatusto = lo_result->get_nodeassociationstattoken( ).
ENDIF.

/AWS1/IF_OWC=>ASSOCIATENODE()¶