Description

Name cannnot be changed.

Only the specified parameter will be updated.
(example : If you want to change only "fixed_ips", request only "fixed_ips."

Request URL 

Network API v2.0

PUT /v2.0/ports/{port_id}

Request Paramters

Parameter Value Style Description
X-Auth-Token User Token header
port_id Port ID URI
security_groups(Optional) security groupID Array
fixed_ips(Optional) plain Use this parameter when you want to specify an IP address
allowed_address_pairs(Optional) plain Specify when you use VIP. It cannot be accepted when you use the VIP address you do not own.

The parameter will be different for each network. So you should be careful.

add ip net local net PaaS net External net
security_groups Optional Optional Optional Optional
fixed_ips Optional Optional x x
allowed_address_pairs Optional x x Optional

Request Json 

{
    "port": {
        "fixed_ips": [
            {
                "ip_address": "157.7.80.144",
                "subnet_id": "1ef2a905-9a0e-4845-bf3a-8723df3e72d0"
            },
            {
                "ip_address": "157.7.80.145",
                "subnet_id": "1ef2a905-9a0e-4845-bf3a-8723df3e72d0"
            }
        ],
        "allowed_address_pairs": [
            {
                "ip_address": "157.7.80.32"
            },
            {
                "ip_address": "157.7.80.33"
            }
        ],
        "security_groups": [
            "359710a9-ce31-40d0-9548-32d4f9f2a56a",
            "038f84be-0431-4691-a87c-d846436ea354"
        ]
    }
}

Request Json (the example of associating External Port to VIP address)

IPv6 address will be allocated automatically, so just specify the VIP address you want to be associated. 

{
    "port": {
        "allowed_address_pairs": [
            {
                "ip_address": "157.7.80.144"
            }
        ]
    }
}

Request Json (example of deleting allowed_address_pairs) 

{
    "port": {
        "allowed_address_pairs": []
    }
}

Request Json (example of deleting fixed_ips) 

{
    "port": {
        "fixed_ips": []
    }
}

Request Json (example of deleting security_groups) 

{
    "port": {
        "security_groups": []
    }
}

Normal response codes

200

Example 

curl -i -X PUT -H "Accept: application/json" -H "X-Auth-Token: 0925897a3d4543218ff0dcd2bb378a8e" -d '{"port": {"security_groups": ["bda5122c-81bc-4dc5-b353-2d349c3e2063"]}}' https://networking.tyo1.cloud.z.com/v2.0/ports/490f1e4f-5a60-4df9-88b1-953de
ebdf139
HTTP/1.1 200 OK
Server: openresty/1.7.10.1
Date: Fri, 08 May 2015 10:48:20 GMT
Content-Type: application/json
Content-Length: 564
Connection: keep-alive

{
    "port": {
        "status": "ACTIVE",
        "name": "local-gnct75294078",
        "allowed_address_pairs": [],
        "admin_state_up": true,
        "network_id": "7d9e6cbf-9473-4e16-a501-284b59300f3f",
        "tenant_id": "22394afc818d471ca2f0308c06ae7460",
        "extra_dhcp_opts": [],
        "binding:vnic_type": "normal",
        "device_owner": "compute:None",
        "mac_address": "fa:16:3e:79:c8:30",
        "fixed_ips": [
            {
                "subnet_id": "6c480943-b1e9-4b52-8048-8bf1df550503",
                "ip_address": "10.10.8.1"
            }
        ],
        "id": "490f1e4f-5a60-4df9-88b1-953deebdf139",
        "security_groups": [
            "bda5122c-81bc-4dc5-b353-2d349c3e2063"
        ],
        "device_id": "8ae928f5-238e-4b67-9861-eca74312d897"
    }
}