Node lists

A node list is a static list of nodes (node IDs) created by the user.

Create a node list

1. Create a node list payload in a JSON file:

   {
     "name": "<NODE_LIST_NAME>",
     "nodeIds": [
       "<NODE_ID>",
       ...
       ]
   }
   

   Replace:

   • <NODE_LIST_NAME> with a name for the list
   • <NODE_ID> with a node or a list of nodes that are included in this node list

2. Create the node list:

   chef-node-management-cli management list create-list --body-file <PAYLOAD_FILE> --profile <NODE_MANAGER_PROFILE_NAME>
   

   The response is similar to the following:

   {
       "item": {
           "listId": "ab38aed7-f35a-4e44-90f5-ef9ea11e6464"
       }
   }
   

Archived nodes in lists

You can’t include an archived node in a node list. If a node in a list is archived, it’s excluded from the list until it’s unarchived. When unarchived, it’s automatically re-included in any node lists it previously belonged to.

For more information, see the archive nodes documentation