voxel.chef.nodes.list

LABS: this method is considered a Labs method and may only be accessed if your account has been granted Labs access. To access Labs methods contact agile-support@internap.com.

This method will allow hAPI clients to list nodes stored on a chef server instance.

Parameters

chef_client (optional)Labs
Name of the chef client to use for authentication against chef.
chef_server (optional)Labs
Device ID of a Chef Server to use in lieu of the default.

Example Response

<?xml version="1.0"?>
<rsp stat="ok">
  <provider>
    <chef>
      <nodes>
        <node>
          <name>foo</name>
        </node>
        <node>
          <name>bar</name>
        </node>
      </nodes>
    </chef>
  </provider>
</rsp>

Notes

The chef_client provided here should match the name of the client you created. The chef_server should match the ubersmith device_id of your chef device.

Method Specific Error Codes

127: Unknown chef client
The chef client specified was not found in the chef server or its validation key is missing in ubersmith. Use voxel.chef.clients.create to create a new client.
125: Unknown chef server
The chef server specified was not found in ubersmith.