Copyright | (c) 2013-2018 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay+amazonka@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
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 (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.
Synopsis
- associateNode :: Text -> Text -> AssociateNode
- data AssociateNode
- anServerName :: Lens' AssociateNode Text
- anNodeName :: Lens' AssociateNode Text
- anEngineAttributes :: Lens' AssociateNode [EngineAttribute]
- associateNodeResponse :: Int -> AssociateNodeResponse
- data AssociateNodeResponse
- anrsNodeAssociationStatusToken :: Lens' AssociateNodeResponse (Maybe Text)
- anrsResponseStatus :: Lens' AssociateNodeResponse Int
Creating a Request
Creates a value of AssociateNode
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
anServerName
- The name of the server with which to associate the node.anNodeName
- The name of the node.anEngineAttributes
- 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 nameddefault
can exist. *CHEF_NODE_PUBLIC_KEY
: A PEM-formatted public key. This key is required for thechef-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.
data AssociateNode Source #
See: associateNode
smart constructor.
Instances
Request Lenses
anServerName :: Lens' AssociateNode Text Source #
The name of the server with which to associate the node.
anNodeName :: Lens' AssociateNode Text Source #
The name of the node.
anEngineAttributes :: Lens' AssociateNode [EngineAttribute] Source #
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.
Destructuring the Response
associateNodeResponse Source #
Creates a value of AssociateNodeResponse
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
anrsNodeAssociationStatusToken
- Contains a token which can be passed to theDescribeNodeAssociationStatus
API call to get the status of the association request.anrsResponseStatus
- -- | The response status code.
data AssociateNodeResponse Source #
See: associateNodeResponse
smart constructor.
Instances
Response Lenses
anrsNodeAssociationStatusToken :: Lens' AssociateNodeResponse (Maybe Text) Source #
Contains a token which can be passed to the DescribeNodeAssociationStatus
API call to get the status of the association request.
anrsResponseStatus :: Lens' AssociateNodeResponse Int Source #
- - | The response status code.