The Allowed Address Pair Extension

The Allowed Address Pair Extension The Allowed Address Pair extension extends the port attribute to allow one to specify arbitrary mac_address/ip_address(cidr) pairs that are allowed to pass through a port regardness of the subnet associated with the network.

Port API operations with allowed address pair extension This section discusses operations for setting and retrieving the allowed address pair extension attributes for port objects.

List Ports Verb URI Description &GET; /ports Returns a list of ports with their allowed address pair attributes. Normal Response Code: 200 OK Error Response Codes: 401 Unauthorized This operation returns, for each port, its allowed address pair attributes as well as all the attributes normally returned by the list port operation. List Ports with allowed address pair attributes: JSON Response List Ports with allowed address pair attributes: XML Response

Show Port Verb URI Description &GET; /ports/port_id Returns details about a specific port, including allowed address pair attributes. Normal Response Code: 200 OK Error Response Code: 401 Unauthorized, 404 Not Found Show port with allowed address pair attributes: JSON Response Show port with allowed address pair attributes: XML Response

Create Port Verb URI Description &POST; /ports Creates a new port and explicitly specify the allowed address pair attributes. Normal Response Code: 201 Error Response Code: 400 Bad Request, 401 Unauthorized, 403 Forbidden Bad request is returned if an allowed address pair matches the mac_address and ip_address on port. Note: If the mac_address field is left out of the body of the request the mac_address assigned to the port will be used. Create Port with allowed address pair attributes: JSON Request

Update Port Verb URI Description &PUT; /ports/port_id Updates a port, with new allowed address pair values. Normal Response Code: 200 OK Error Response Code: 400 Bad Request, 401 Unauthorized, 404 Not Found, 403 Forbidden Update allowed address pair attributes for a port: JSON Request