The ironic.api.controllers.v1.port Module

class ironic.api.controllers.v1.port.Port(**kwargs)

Bases: ironic.api.controllers.base.APIBase

API representation of a port.

This class enforces type checking and value constraints, and converts between the internal object model and the API representation of a port.

classmethod convert_with_links(rpc_port, fields=None)

classmethod sample(expand=True)

class ironic.api.controllers.v1.port.PortCollection(**kwargs)

Bases: ironic.api.controllers.v1.collection.Collection

API representation of a collection of ports.

static convert_with_links(rpc_ports, limit, url=None, fields=None, **kwargs)

classmethod sample()

class ironic.api.controllers.v1.port.PortPatchType(**kw)

Bases: ironic.api.controllers.v1.types.JsonPatchType

static internal_attrs()

class ironic.api.controllers.v1.port.PortsController(node_ident=None)

Bases: pecan.rest.RestController

REST controller for Ports.

delete(*args, **kwargs)

Delete a port.

Parameters:port_uuid – UUID of a port.

detail(*args, **kwargs)

Retrieve a list of ports with detail.

Note that the ‘node_uuid’ interface is deprecated in favour of the ‘node’ interface

Parameters:

• node – UUID or name of a node, to get only ports for that node.
• node_uuid – UUID of a node, to get only ports for that node.
• address – MAC address of a port, to get the port which has this MAC address.
• marker – pagination marker for large data sets.
• limit – maximum number of resources to return in a single result. This value cannot be larger than the value of max_limit in the [api] section of the ironic configuration, or only max_limit resources will be returned.
• sort_key – column to sort results by. Default: id.
• sort_dir – direction to sort. “asc” or “desc”. Default: asc.

Raises:

NotAcceptable, HTTPNotFound

get_all(*args, **kwargs)

Retrieve a list of ports.

Note that the ‘node_uuid’ interface is deprecated in favour of the ‘node’ interface

Parameters:

• node – UUID or name of a node, to get only ports for that node.
• node_uuid – UUID of a node, to get only ports for that node.
• address – MAC address of a port, to get the port which has this MAC address.
• marker – pagination marker for large data sets.
• limit – maximum number of resources to return in a single result. This value cannot be larger than the value of max_limit in the [api] section of the ironic configuration, or only max_limit resources will be returned.
• sort_key – column to sort results by. Default: id.
• sort_dir – direction to sort. “asc” or “desc”. Default: asc.
• fields – Optional, a list with a specified set of fields of the resource to be returned.

Raises:

NotAcceptable

get_one(*args, **kwargs)

Retrieve information about the given port.

Parameters:

• port_uuid – UUID of a port.
• fields – Optional, a list with a specified set of fields of the resource to be returned.

Raises:

NotAcceptable

patch(*args, **kwargs)

Update an existing port.

Parameters:

• port_uuid – UUID of a port.
• patch – a json PATCH document to apply to this port.

Raises:

NotAcceptable

post(*args, **kwargs)

Create a new port.

Parameters:port – a port within the request body. Raises:NotAcceptable