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 create new nodes stored on a chef server instance.


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.
chef_run_list (required)Labs
Chef recipes and roles to install and manage on the chef node. The format of a valid runlist is a comma delimited list of recipes and roles such as chef_run_list="recipe[mongo],role[webserver]".
chef_node (required)Labs
Name of the chef node to be manipulated.
chef_env (optional)Labs
Chef environment that your node will be associated with.

Example Response

<?xml version="1.0"?>
<rsp stat="ok" />


If there already exists a chef node with the same name as the one provided, this method will overwrite the old node with the new runlist and environment information. 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

129: Invalid chef runlist
The chef runlist specified is invalid. A valid runlist should be of the form: recipe[ops::mongo],role[ntp_dev1]
130: Unknown chef node
The chef node specified is invalid. Ensure that the node name is specified correctly.
124: Unknown chef environment
The chef environment specified was not found in the chef server.
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.