ironicclient.v1.create_resources module

ironicclient.v1.create_resources module

ironicclient.v1.create_resources.create_chassis(client, chassis_list)[source]

Create chassis from dictionaries.

Parameters:
  • client – ironic client instance.
  • chassis_list – list of dictionaries to be POSTed to /chassis endpoint, if some of them contain “nodes” key, its content is POSTed separately to /nodes endpoint.
Returns:

array of exceptions encountered during creation.

ironicclient.v1.create_resources.create_nodes(client, node_list, chassis_uuid=None)[source]

Create nodes from dictionaries.

Parameters:
  • client – ironic client instance.
  • node_list – list of dictionaries to be POSTed to /nodes endpoint, if some of them contain “ports” key, its content is POSTed separately to /ports endpoint.
  • chassis_uuid – UUID of a chassis the nodes should be associated with.
Returns:

array of exceptions encountered during creation.

ironicclient.v1.create_resources.create_portgroups(client, portgroup_list, node_uuid)[source]

Create port groups from dictionaries.

Parameters:
  • client – ironic client instance.
  • portgroup_list – list of dictionaries to be POSTed to /portgroups endpoint, if some of them contain “ports” key, its content is POSTed separately to /ports endpoint.
  • node_uuid – UUID of a node the port groups should be associated with.
Returns:

array of exceptions encountered during creation.

ironicclient.v1.create_resources.create_ports(client, port_list, node_uuid, portgroup_uuid=None)[source]

Create ports from dictionaries.

Parameters:
  • client – ironic client instance.
  • port_list – list of dictionaries to be POSTed to /ports endpoint.
  • node_uuid – UUID of a node the ports should be associated with.
  • portgroup_uuid – UUID of a port group the ports should be associated with, if they are its members.
Returns:

array of exceptions encountered during creation.

ironicclient.v1.create_resources.create_resources(client, filenames)[source]

Create resources using their JSON or YAML descriptions.

Parameters:
  • client – an instance of ironic client;
  • filenames – a list of filenames containing JSON or YAML resources definitions.
Raises:

ClientException if any operation during files processing/resource creation fails.

ironicclient.v1.create_resources.create_single_chassis(client, **params)[source]

Call the client to create a chassis.

Parameters:
  • client – ironic client instance.
  • params – dictionary to be POSTed to /chassis endpoint, excluding “nodes” key.
Returns:

UUID of the created chassis or None in case of exception, and an exception, if it appears.

Raises:

InvalidAttribute, if some parameters passed to client’s create_method are invalid.

Raises:

ClientException, if the creation of the chassis fails.

ironicclient.v1.create_resources.create_single_handler(resource_type)[source]

Catch errors of the creation of a single resource.

This decorator appends an error (which is an instance of some client exception class) to the return value of the create_method, changing the return value from just UUID to (UUID, error), and does some exception handling.

Parameters:resource_type – string value, the type of the resource being created, e.g. ‘node’, used purely for exception messages.
ironicclient.v1.create_resources.create_single_node(client, **params)[source]

Call the client to create a node.

Parameters:
  • client – ironic client instance.
  • params – dictionary to be POSTed to /nodes endpoint, excluding “ports” and “portgroups” keys.
Returns:

UUID of the created node or None in case of exception, and an exception, if it appears.

Raises:

InvalidAttribute, if some parameters passed to client’s create_method are invalid.

Raises:

ClientException, if the creation of the node fails.

ironicclient.v1.create_resources.create_single_port(client, **params)[source]

Call the client to create a port.

Parameters:
  • client – ironic client instance.
  • params – dictionary to be POSTed to /ports endpoint.
Returns:

UUID of the created port or None in case of exception, and an exception, if it appears.

Raises:

InvalidAttribute, if some parameters passed to client’s create_method are invalid.

Raises:

ClientException, if the creation of the port fails.

ironicclient.v1.create_resources.create_single_portgroup(client, **params)[source]

Call the client to create a port group.

Parameters:
  • client – ironic client instance.
  • params – dictionary to be POSTed to /portgroups endpoint, excluding “ports” key.
Returns:

UUID of the created port group or None in case of exception, and an exception, if it appears.

Raises:

InvalidAttribute, if some parameters passed to client’s create_method are invalid.

Raises:

ClientException, if the creation of the portgroup fails.

ironicclient.v1.create_resources.load_from_file(filename)[source]

Deserialize JSON or YAML from file.

Parameters:filename – name of the file containing JSON or YAML.
Returns:a dictionary deserialized from JSON or YAML.
Raises:ClientException if the file can not be loaded or if its contents is not a valid JSON or YAML, or if the file extension is not supported.
Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.