Port attachments

Port attachments

List an attachment information plugged into a logical port

A short description of attachment information currently plugged into the specified logical port.

• tenant_id : a unique id of the tenant (required).
• net_id : a unique id of the network (required).
• port_id : a unique id of the port (required).

GET /tenants/:tenant_id/networks/:net_id/ports/:port_id/attachments

Response

• 200 : OK
• 404 : Not found the specified tenant or network.
• 500 : Internal error.

[
  {
    "id" : "port_mac_created_via_rest_if",
    "mac" : "01:01:01:01:01:01"
  }
]

Plug resources into a logical port

Plug resources into a logical port on a network.

• tenant_id : a unique id of the tenant (required).
• net_id : a unique id of the network (required).
• port_id : a unique id of the logical port (required).

POST /tenants/:tenant_id/networks/:net_id/ports/:port_id/attachments

Input

• id : a unique id of the attachment (mandatory).
• mac : a mac address attached to the logical port (mandatory).

{ 
  "id" : "port_mac_created_via_rest_if", 
  "mac" : "01:01:01:01:01:01" 
}

Response

• 202 : Succeeded.
• 404 : Not found the specified tenant, network or port.
• 422 : The specified parameters are unacceptable.
• 500 : Internal error. (Failed to attach the specified resource.)

Show an attachment information

Show information about the attachment specified by the request URI.

• tenant_id : a unique id of the tenant (required).
• net_id : a unique id of the network (required).
• port_id : a unique id of the logical port (required).
• attachment_id : a unique id of the attachement (required).

GET /tenants/:tenant_id/networks/:net_id/ports/:port_id/attachments/:attachment_id

Response

• 200 :
• 404 : Not found the specified tenant, network, port or attachment.
• 500 : Internal error.

{ 
  "id" : "port_mac_created_via_rest_if", 
  "mac" : "01:01:01:01:01:01" 
}

Remove an attachment

Remove the attachment specified by the request URI.

• tenant_id : a unique id of the tenant (required).
• net_id : a unique id of the network (required).
• port_id : a unique id of the logical port (required).
• attachment_id : a unique id of the attachement (required).

DELETE /tenants/:tenant_id/networks/:net_id/ports/:port_id/attachments/:attachment_id

Response

• 202 : Succeeded.
• 404 : Not found the specified tenant, network, port or attachment.
• 500 : Internal error. (Failed to remove the specified attachment.)