Loading
close

虚拟网卡

time 更新时间:2024-04-25 08:33:39

虚拟网卡

列举虚拟网卡

功能介绍

‎列举租户有权限访问的网卡

URI

GET /v2.0/ports

请求消息

参数 参数类型 是否必选 描述
fields string 使用fields参数,API只返回请求的属性集,可以指定多次。例如,URL中指定’ fields=id&fields=name’,那么API只会返回’id’和’name’属性。
project_id string 指定项目ID进行查询。

响应消息

参数 参数类型 描述
ports array 网卡列表。
admin_state_up boolean 网卡的 admin 状态,取值 true 或 false。
allowed_address_pairs array 网卡允许访问的地址 pair 列表,每个 pair 包含一个单独 IP 或一个 IP 和 MAC 。
binding:host_id string 网卡所属的 host ID。
binding:profile object 网卡信息字典,传递和接收用于后端网 络插件处理的网卡信息。
binding:vif_details object 网卡附加信息字典,目前主要字段是 port_filter 和 ovs_hybrid_plug。
binding:vif_type string 网卡绑定使用的 ml2 插件类型,比如 ovs,bridge,macvtap,未绑定是 unbound,失败是 binding_failed。
binding:vnic_type string 网卡挂载的类型,比如 normal,direct,baremetal。
created_at string 网卡创建时间 (in UTC ISO8601 format)。
description string 用户描述。
device_id sttring 使用该网卡的设备 ID,比如一个虚机 uuid。
device_owner sting 使用该网卡的设备类型,比如 network:distributed 表示 metadata port,network:vip表示虚拟 IP,network:secondary表示辅助私网 IP。
extra_dhcp_opts array 额外的 DHCP 参数列表。
fixed_ips array 网卡的固定 IP 列表。
id string 网卡的 ID。
mac_address string 网卡的 MAC 地址。
name string 网卡的名称。
network_id string 网卡所属的网络 ID。
port_security_enabled boolean 网卡的安全状态。true 或者 false,如果 是 true 将会配置安全组规则和 anti-spoofing 规则,否则不会处理。
project_id string 网卡所属的 project ID。
qos_policy_id string 网卡关联的 QoS 策略 ID。
revision_number integer 网卡的版本号。
security_groups array 网卡关联的安全组列表。
status string 网卡的状态: ACTIVE, DOWN, BUILD and ERROR。
tags array 网卡的标签列表。
qos_network_policy_id string 网卡所属 network 绑定的 Qos policy ID。
tenant_id string 网卡所属的 tenant ID。
updated_at string 网卡最近更新的时间(in UTC ISO8601 format)。

请求示例

GET https://{endpoint}/v2.0/ports

正常响应示例

{
  "ports": [
    {
      "admin_state_up": true,
      "allowed_address_pairs": [],
      "binding:host_id": "node-10.domain.tld",
      "binding:profile": {},
      "binding:vif_details": {
        "ovs_hybrid_plug": false,
        "port_filter": true
      },
      "binding:vif_type": "ovs",
      "binding:vnic_type": "normal",
      "created_at": "2021-02-24T02:41:53Z",
      "description": "",
      "device_id": "f9583498-c576-4e2e-86ad-c6a662b000a8",
      "device_owner": "compute:kuryr",
      "extra_dhcp_opts": [],
      "fixed_ips": [
        {
          "ip_address": "192.168.111.12",
          "subnet_id": "f32a3ab8-6a5a-41c6-a202-cfe7bea9348a"
        }
      ],
      "id": "04c4339b-d13f-4f14-9be5-8f7477cbea4e",
      "mac_address": "fa:16:3e:f8:72:bb",
      "name": "d717c61a2",
      "network_id": "7b0343bd-cf33-45af-bb2b-25bea12eb2c9",
      "port_security_enabled": true,
      "project_id": "d717c61a263f4a0b9271d0a271653c2a",
      "qos_policy_id": null,
      "revision_number": 8,
      "security_groups": [
        "a8c01103-2cf1-4f6a-a8f1-ed84ec2f794f"
      ],
      "status": "ACTIVE",
      "qos_network_policy_id": null,
      "tenant_id": "d717c61a263f4a0b9271d0a271653c2a",
      "updated_at": "2021-02-24T02:42:13Z"
    }
  ]
}

正常响应代码

200

错误码

400,401,403,404,409,413

创建虚拟网卡

功能介绍

‎创建一个虚拟网卡

URI

POST /v2.0/ports

请求消息

参数 参数类型 是否必选 Description
port object 网卡对象。
admin_state_up boolean 网卡的admin状态,取值true或false。
allowed_address_pairs array 网卡允许访问的地址 pair 列表,每个 pair 包含一个单独 IP 或一个 IP 和 MAC 。
binding:host_id string 网卡所属的 host ID。
binding:profile object 网卡信息字典,传递和接收用于后端网络插件处理的网卡信息。
binding:vnic_type string 网卡挂载的类型,比如normal,direct,baremetal,默认normal。
description string 用户描述。
device_id string 使用该网卡的设备ID,比如一个虚机uuid。
device_owner string 使用该网卡的设备类型,比如 network:distributed 表示 metadata port,network:vip 表示虚拟 IP,network:secondary 表示辅助私网 IP。
extra_dhcp_opts array 额外的 DHCP 参数列表。
fixed_ips array 网卡的固定 IP 列表。
mac_address string 网卡的 MAC 地址。
name satring 网卡的名称。
network_id string 网卡所属的网络ID。
port_security_enabled boolean 网卡的安全状态。true或者false,如果是true将会配置安全组规则和anti-spoofing规则,否则不会处理。
project_id string 网卡所属的 project ID。
qos_policy_id string 网卡关联的 QoS 策略 ID。
security_groups array 网卡关联的安全组列表。
tags array 网卡的标签列表。
tenant_id string 网卡所属的 tenant ID。

响应消息

参数 参数类型 描述
ports array 网卡列表。
admin_state_up boolean 网卡的 admin 状态,取值 true 或 false。
allowed_address_pairs array 网卡允许访问的地址 pair 列表,每个 pair 包含一个单独 IP 或一个 IP 和 MAC 。
binding:host_id string 网卡所属的 host ID。
binding:profile object 网卡信息字典,传递和接收用于后端网 络插件处理的网卡信息。
binding:vif_details object 网卡附加信息字典,目前主要字段是 port_filter 和 ovs_hybrid_plug。
binding:vif_type string 网卡绑定使用的 ml2 插件类型,比如 ovs,bridge,macvtap,未绑定是 unbound,失败是 binding_failed。
binding:vnic_type string 网卡挂载的类型,比如 normal,direct,baremetal。
created_at string 网卡创建时间 (in UTC ISO8601 format)。
description string 用户描述。
device_id sttring 使用该网卡的设备 ID,比如一个虚机 uuid。
device_owner sting 使用该网卡的设备类型,比如 network:distributed 表示 metadata port,network:vip 表示虚拟 IP,network:secondary 表示辅助私网IP。
extra_dhcp_opts array 额外的 DHCP 参数列表。
fixed_ips array 网卡的固定 IP 列表。
id string 网卡的 ID。
mac_address string 网卡的 MAC 地址。
name string 网卡的名称。
network_id string 网卡所属的网络 ID。
port_security_enabled boolean 网卡的安全状态。true 或者 false,如果 是 true 将会配置安全组规则和 anti-spoofing 规则,否则不会处理。
project_id string 网卡所属的 project ID。
qos_policy_id string 网卡关联的 QoS 策略 ID。
revision_number integer 网卡的版本号。
security_groups array 网卡关联的安全组列表。
status string 网卡的状态: ACTIVE, DOWN, BUILD and ERROR。
tags array 网卡的标签列表。
qos_network_policy_id string 网卡所属network绑定的 QoS policy ID。
tenant_id string 网卡所属的 tenant ID。
updated_at string 网卡最近更新的时间(in UTC ISO8601 format)。

请求示例

POST http://{endpoint}/v2.0/ports
{
    "port": {
        "admin_state_up": true,
        "name": "test",
        "network_id": "1191a2fd-42c6-44b9-b153-3378407468f2"
    }
}

正常响应示例

{
    "port": {
        "admin_state_up": true,
        "allowed_address_pairs": [],
        "binding:host_id": "",
        "binding:profile": {},
        "binding:vif_details": {},
        "binding:vif_type": "unbound",
        "binding:vnic_type": "normal",
        "created_at": "2021-02-24T07:01:14Z",
        "description": "",
        "device_id": "",
        "device_owner": "",
        "extra_dhcp_opts": [],
        "fixed_ips": [
            {
                "ip_address": "172.16.0.14",
                "subnet_id": "95347c6c-181d-4739-998d-0365487c9ac6"
            }
        ],
        "id": "602debb5-289d-4ecc-bc86-6a2f84a4b677",
        "mac_address": "fa:16:3e:91:6b:15",
        "name": "test",
        "network_id": "1191a2fd-42c6-44b9-b153-3378407468f2",
        "port_security_enabled": true,
        "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "qos_policy_id": null,
        "revision_number": 5,
        "security_groups": [
            "65db6fc3-7ba5-42e9-95f1-d45145f1e65f"
        ],
        "status": "DOWN",
        "qos_network_policy_id": null,
        "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "updated_at": "2021-02-24T07:01:15Z"
    }
}

正常响应代码

201

错误码

400,401,403,404,409,413

创建辅助私网IP网卡

功能介绍

‎创建一个辅助私网IP的网卡。使用本辅助私网 IP,需将辅助私网 IP 地址添加到业务网卡的 allowed_address_pairs 里,可以参考增加虚拟网卡的allowed_address_pairs

URI

POST /v2.0/ports

请求消息

参数 参数类型 是否必选 Description
port object 网卡对象。
description string 用户描述。
device_id string 指定使用该辅助私网 IP 的 port ID。
device_owner string 指定为 network:secondary表示辅助私网 IP。
fixed_ips array 网卡的固定 IP 列表。
name string 网卡的名称。
network_id string 网卡所属的网络 ID。
tenant_id string 网卡所属的 tenant ID。

响应消息

参数 参数类型 描述
ports array 网卡列表。
admin_state_up boolean 网卡的 admin 状态,取值 true 或 false。
allowed_address_pairs array 网卡允许访问的地址 pair 列表,每个 pair 包含一个单独 IP 或 一个 IP 和 MAC 。
binding:host_id string 网卡所属的 host ID。
binding:profile object 网卡信息字典,传递和接收用于后端网 络插件处理的网卡信息。
binding:vif_details object 网卡附加信息字典,目前主要字段是 port_filter 和 ovs_hybrid_plug。
binding:vif_type string 网卡绑定使用的 ml2 插件类型,比如 ovs,bridge,macvtap,未绑定是 unbound,失败是 binding_failed。
binding:vnic_type string 网卡挂载的类型,比如 normal,direct,baremetal。
created_at string 网卡创建时间 (in UTC ISO8601 format)。
description string 用户描述。
device_id string 使用该网卡的设备 ID,比如一个虚机 uuid。
device_owner string network:secondary 表示辅助私网 IP。
extra_dhcp_opts array 额外的 DHCP 参数列表。
fixed_ips array 网卡的固定 IP 列表。
id string 网卡的 ID。
mac_address string 网卡的 MAC 地址。
name string 网卡的名称。
network_id string 网卡所属的网络 ID。
port_security_enabled boolean 网卡的安全状态。true 或者 false,如果 是 true 将会配置安全组规则和 anti-spoofing 规则,否则不会处理。
project_id string 网卡所属的 project ID。
qos_policy_id string 网卡关联的 QoS 策略 ID。
revision_number integer 网卡的版本号。
security_groups array 网卡关联的安全组列表。
status string 网卡的状态: ACTIVE, DOWN, BUILD and ERROR。
tags array 网卡的标签列表。
qos_network_policy_id string 网卡所属network绑定的 QoS policy ID。
tenant_id string 网卡所属的 tenant ID。
updated_at string 网卡最近更新的时间(in UTC ISO8601 format)。

请求示例

POST http://{endpoint}/v2.0/ports
{
    "port": {
        "name": "secondary port",
        "device_id": "34b23ff6-aae0-411a-89c8-dba87be9bf59",
        "device_owner": "network:secondary",
        "network_id": "1191a2fd-42c6-44b9-b153-3378407468f2"
    }
}

正常响应示例

{
    "port": {
        "admin_state_up": true,
        "allowed_address_pairs": [],
        "binding:host_id": "",
        "binding:profile": {},
        "binding:vif_details": {},
        "binding:vif_type": "unbound",
        "binding:vnic_type": "normal",
        "created_at": "2021-02-24T07:01:14Z",
        "description": "",
        "device_id": "34b23ff6-aae0-411a-89c8-dba87be9bf59",
        "device_owner": "network:secondary",
        "extra_dhcp_opts": [],
        "fixed_ips": [
            {
                "ip_address": "172.16.0.14",
                "subnet_id": "95347c6c-181d-4739-998d-0365487c9ac6"
            }
        ],
        "id": "602debb5-289d-4ecc-bc86-6a2f84a4b677",
        "mac_address": "fa:16:3e:91:6b:15",
        "name": "secondary port",
        "network_id": "1191a2fd-42c6-44b9-b153-3378407468f2",
        "port_security_enabled": true,
        "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "qos_policy_id": null,
        "revision_number": 5,
        "security_groups": [
            "65db6fc3-7ba5-42e9-95f1-d45145f1e65f"
        ],
        "status": "DOWN",
        "qos_network_policy_id": null,
        "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "updated_at": "2021-02-24T07:01:15Z"
    }
}

正常响应代码

201

错误码

400,401,403,404,409,413

创建虚拟IP网卡

功能介绍

‎创建一个虚拟IP的网卡。使用本虚拟IP,需将虚拟IP地址添加到业务网卡的 allowed_address_pairs 里,可以参考增加虚拟网卡的allowed_address_pairs

URI

POST /v2.0/ports

请求消息

参数 参数类型 是否必选 Description
port object 网卡对象。
description string 用户描述。
device_owner string 指定为 network:vip 表示虚拟IP。
fixed_ips array 网卡的固定 IP 列表。
name string 网卡的名称。
network_id string 网卡所属的网络 ID。
tenant_id string 网卡所属的 tenant ID。

响应消息

参数 参数类型 描述
ports array 网卡列表。
admin_state_up boolean 网卡的 admin 状态,取值 true 或 false。
allowed_address_pairs array 网卡允许访问的地址 pair 列表,每个 pair 包含一个单独 IP 或 一个 IP 和 MAC 。
binding:host_id string 网卡所属的 host ID。
binding:profile object 网卡信息字典,传递和接收用于后端网 络插件处理的网卡信息。
binding:vif_details object 网卡附加信息字典,目前主要字段是 port_filter 和 ovs_hybrid_plug。
binding:vif_type string 网卡绑定使用的 ml2 插件类型,比如 ovs,bridge,macvtap,未绑定是 unbound,失败是 binding_failed。
binding:vnic_type string 网卡挂载的类型,比如 normal,direct,baremetal。
created_at string 网卡创建时间 (in UTC ISO8601 format)。
description string 用户描述。
device_id string 使用该网卡的设备 ID,比如一个虚机 uuid。
device_owner string network:vip 表示虚拟IP。
extra_dhcp_opts array 额外的 DHCP 参数列表。
fixed_ips array 网卡的固定 IP 列表。
id string 网卡的 ID。
mac_address string 网卡的 MAC 地址。
name string 网卡的名称。
network_id string 网卡所属的网络 ID。
port_security_enabled boolean 网卡的安全状态。true 或者 false,如果 是 true 将会配置安全组规则和 anti-spoofing 规则,否则不会处理。
project_id string 网卡所属的 project ID。
qos_policy_id string 网卡关联的 QoS 策略 ID。
revision_number integer 网卡的版本号。
security_groups array 网卡关联的安全组列表。
status string 网卡的状态: ACTIVE, DOWN, BUILD and ERROR。
tags array 网卡的标签列表。
qos_network_policy_id string 网卡所属network绑定的 QoS policy ID。
tenant_id string 网卡所属的 tenant ID。
updated_at string 网卡最近更新的时间(in UTC ISO8601 format)。

请求示例

POST http://{endpoint}/v2.0/ports
{
    "port": {
        "name": "VIP port",
        "device_owner": "network:vip",
        "network_id": "1191a2fd-42c6-44b9-b153-3378407468f2"
    }
}

正常响应示例

{
    "port": {
        "admin_state_up": true,
        "allowed_address_pairs": [],
        "binding:host_id": "",
        "binding:profile": {},
        "binding:vif_details": {},
        "binding:vif_type": "unbound",
        "binding:vnic_type": "normal",
        "created_at": "2021-02-24T07:01:14Z",
        "description": "",
        "device_id": "",
        "device_owner": "network:vip",
        "extra_dhcp_opts": [],
        "fixed_ips": [
            {
                "ip_address": "172.16.0.14",
                "subnet_id": "95347c6c-181d-4739-998d-0365487c9ac6"
            }
        ],
        "id": "602debb5-289d-4ecc-bc86-6a2f84a4b677",
        "mac_address": "fa:16:3e:91:6b:15",
        "name": "VIP port",
        "network_id": "1191a2fd-42c6-44b9-b153-3378407468f2",
        "port_security_enabled": true,
        "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "qos_policy_id": null,
        "revision_number": 2,
        "security_groups": [
            "65db6fc3-7ba5-42e9-95f1-d45145f1e65f"
        ],
        "status": "DOWN",
        "qos_network_policy_id": null,
        "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "updated_at": "2021-02-24T07:01:15Z"
    }
}

正常响应代码

201

错误码

400,401,403,404,409,413

获取虚拟网卡

功能介绍

‎获取一个虚拟网卡的详情

URI

GET /v2.0/ports/{port_id}

参数 是否必选 描述
port_id 虚拟网卡的ID

请求消息

响应消息

参数 参数类型 描述
ports array 网卡列表。
admin_state_up boolean 网卡的 admin 状态,取值 true 或 false。
allowed_address_pairs array 网卡允许访问的地址 pair 列表,每个 pair 包含一个 单独IP 或一个 IP 和 MAC。
binding:host_id string 网卡所属的 host ID。
binding:profile object 网卡信息字典,传递和接收用于后端网 络插件处理的网卡信息。
binding:vif_details object 网卡附加信息字典,目前主要字段是 port_filter 和 ovs_hybrid_plug。
binding:vif_type string 网卡绑定使用的 ml2 插件类型,比如 ovs,bridge,macvtap,未绑定是 unbound,失败是 binding_failed。
binding:vnic_type string 网卡挂载的类型,比如 normal,direct,baremetal。
created_at string 网卡创建时间 (in UTC ISO8601 format)。
description string 用户描述。
device_id sttring 使用该网卡的设备 ID,比如一个虚机 uuid。
device_owner sting 使用该网卡的设备类型,比如 network:distributed表示 metadata port,network:vip 表示虚拟 IP,network:secondary 表示辅助私网 IP。
extra_dhcp_opts array 额外的 DHCP 参数列表。
fixed_ips array 网卡的固定 IP 列表。
id string 网卡的 ID。
mac_address string 网卡的 MAC 地址。
name string 网卡的名称。
network_id string 网卡所属的网络 ID。
port_security_enabled boolean 网卡的安全状态。true 或者 false,如果 是 true 将会配置安全组规则和 anti-spoofing 规则,否则不会处理。
project_id string 网卡所属的 project ID。
qos_policy_id string 网卡关联的 QoS 策略 ID。
revision_number integer 网卡的版本号。
security_groups array 网卡关联的安全组列表。
status string 网卡的状态: ACTIVE, DOWN, BUILD and ERROR。
tags array 网卡的标签列表。
qos_network_policy_id string 网卡所属network绑定的 QoS policy ID。
tenant_id string 网卡所属的 tenant ID。
updated_at string 网卡最近更新的时间(in UTC ISO8601 format)。

请求示例

GET https://{endpoint}/v2.0/ports/01a9c14a-d4bb-4b28-a5c8-fd0458b8c94e

正常响应示例

{
  "port": {
    "admin_state_up": false,
    "allowed_address_pairs": [],
    "binding:host_id": "",
    "binding:profile": {},
    "binding:vif_details": {},
    "binding:vif_type": "unbound",
    "binding:vnic_type": "normal",
    "created_at": "2021-02-22T12:29:22Z",
    "description": "",
    "device_id": "",
    "device_owner": "",
    "extra_dhcp_opts": [],
    "fixed_ips": [
      {
        "ip_address": "172.16.0.9",
        "subnet_id": "c12ac01a-2422-473a-b297-baca99b2d690"
      }
    ],
    "id": "01a9c14a-d4bb-4b28-a5c8-fd0458b8c94e",
    "mac_address": "fa:16:3e:01:74:c7",
    "name": "kw-2_kw-test_1edaecca",
    "network_id": "328878f3-5805-42f1-82dd-40dcdd1f79f1",
    "port_security_enabled": true,
    "project_id": "8cd7d3e275584638964ff92ddd3b1596",
    "qos_policy_id": null,
    "revision_number": 5,
    "security_groups": [
      "dbd9b12d-1d79-4594-ba18-36967bc4b9ae"
    ],
    "status": "DOWN",
    "qos_network_policy_id": null,
    "tenant_id": "8cd7d3e275584638964ff92ddd3b1596",
    "updated_at": "2021-02-22T12:29:22Z"
  }
}

正常响应代码

200

错误码

400,401,403,404,409,413

更新虚拟网卡

功能介绍

‎更新一个指定虚拟网卡

URI

PUT /v2.0/ports/{port_id}

参数 是否必选 描述
port_id 虚拟网卡的ID

请求消息

参数 参数类型 是否必选 描述
port object 网卡对象。
admin_state_up boolean 网卡的admin状态,取值true或false。
allowed_address_pairs array 网卡允许访问的地址 pair 列表,每个 pair 包含一个单独 IP 或一个IP 和 MAC 。
binding:host_id string 网卡所属的 host ID。
binding:profile object 网卡信息字典,传递和接收用于后端网络插件处理的网卡信息。
binding:vnic_type string 网卡挂载的类型,比如normal,direct,baremetal,默认normal。
description string 用户描述。
device_id sttring 使用该网卡的设备ID,比如一个虚机uuid。
device_owner string 使用该网卡的设备类型,比如 network:distributed 表示 metadata port,network:vip 表示虚拟 IP,network:secondary 表示辅助私网 IP。
extra_dhcp_opts array 额外的 DHCP 参数列表。
fixed_ips array 网卡的固定 IP 列表。
mac_address string 网卡的 MAC 地址。
name satring 网卡的名称。
port_security_enabled boolean 网卡的安全状态。true或者false,如果是true将会配置安全组规则和anti-spoofing规则,否则不会处理。
qos_policy_id string 网卡关联的 QoS 策略 ID。
security_groups array 网卡关联的安全组列表。

响应消息

参数 参数类型 描述
port object 网卡对象。
admin_state_up boolean 网卡的admin状态,取值true或false。
allowed_address_pairs array 网卡允许访问的地址 pair 列表,每个 pair 包含一个单独 IP 或一个 IP 和 MAC 。
binding:host_id string 网卡所属的 host ID。
binding:profile object 网卡信息字典,传递和接收用于后端网络插件处理的网卡信息。
binding:vif_details object 网卡附加信息字典,目前主要字段是port_filter和ovs_hybrid_plug。
binding:vif_type string 网卡绑定使用的ml2插件类型,比如ovs,bridge,macvtap,未绑定是unbound,失败是binding_failed。
binding:vnic_type string 网卡挂载的类型,比如normal,direct,baremetal。
created_at string 网卡创建时间 (UTC ISO8601格式)。
description string 用户描述。
device_id sttring 使用该网卡的设备ID,比如一个虚机uuid。
device_owner sting 使用该网卡的设备类型,比如 network:distributed 表示 metadata port,network:vip 表示虚拟 IP,network:secondary 表示辅助私网 IP。
extra_dhcp_opts array 额外的 DHCP 参数列表。
fixed_ips array 网卡的固定 IP 列表。
id string 网卡的ID。
mac_address string 网卡的 MAC 地址。
name satring 网卡的名称。
network_id string 网卡所属的网络ID。
port_security_enabled boolean 网卡的安全状态。true或者false,如果是true将会配置安全组规则和anti-spoofing规则,否则不会处理。
project_id string 网卡所属的 project ID。
qos_policy_id string 网卡关联的 QoS 策略 ID。
revision_number integer 网卡的版本号。
security_groups array 网卡关联的安全组列表。
status string 网卡的状态: ACTIVE, DOWN, BUILD and ERROR。
tags array 网卡的标签列表。
qos_network_policy_id string 网卡所属network绑定的 QoS policy ID。
tenant_id string 网卡所属的 tenant ID。
updated_at string 网卡最近更新的时间(UTC ISO8601 格式)。

请求示例

PUT http://{endpoint}/v2.0/ports/602debb5-289d-4ecc-bc86-6a2f84a4b677
{
    "port": {
        "fixed_ips": [
            {
                "ip_address": "172.16.0.115",
                "subnet_id": "95347c6c-181d-4739-998d-0365487c9ac6"
            }
        ]
    }
}

正常响应示例

{
    "port": {
        "admin_state_up": true,
        "allowed_address_pairs": [],
        "binding:host_id": "",
        "binding:profile": {},
        "binding:vif_details": {},
        "binding:vif_type": "unbound",
        "binding:vnic_type": "normal",
        "created_at": "2021-02-24T07:01:14Z",
        "description": "",
        "device_id": "",
        "device_owner": "",
        "extra_dhcp_opts": [],
        "fixed_ips": [
            {
                "ip_address": "172.16.0.115",
                "subnet_id": "95347c6c-181d-4739-998d-0365487c9ac6"
            }
        ],
        "id": "602debb5-289d-4ecc-bc86-6a2f84a4b677",
        "mac_address": "fa:16:3e:91:6b:15",
        "name": "test",
        "network_id": "1191a2fd-42c6-44b9-b153-3378407468f2",
        "port_security_enabled": true,
        "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "qos_policy_id": null,
        "revision_number": 8,
        "security_groups": [
            "65db6fc3-7ba5-42e9-95f1-d45145f1e65f"
        ],
        "status": "DOWN",
        "qos_network_policy_id": null,
        "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "updated_at": "2021-02-24T08:35:26Z"
    }
}

正常响应代码

200

错误码

400,401,403,404,409,413

增加虚拟网卡的allowed_address_pairs

功能介绍

‎给指定虚拟网卡增加allowed_address_pairs

URI

PUT /v2.0/ports/{port_id}/add_allowed_address_pairs

参数 是否必选 描述
port_id 虚拟网卡的ID

请求消息

参数 参数类型 是否必选 描述
port object 网卡对象。
allowed_address_pairs array 网卡允许访问的地址 pair 列表,每个 pair 包含一个单独 IP 或一个 IP 和 MAC ,辅助私网IP和虚拟IP每个 pair 使用单独一个IP即可。

响应消息

参数 参数类型 描述
port object 网卡对象。
admin_state_up boolean 网卡的 admin 状态,取值 true 或 false。
allowed_address_pairs array 网卡允许访问的地址 pair 列表,每个 pair 包含一个单独 IP 或一个 IP 和 MAC 。
binding:host_id string 网卡所属的 host ID。
binding:profile object 网卡信息字典,传递和接收用于后端网络插件处理的网卡信息。
binding:vif_details object 网卡附加信息字典,目前主要字段是 port_filter 和 ovs_hybrid_plug。
binding:vif_type string 网卡绑定使用的 ml2 插件类型,比如 ovs,bridge,macvtap,未绑定是 unbound,失败是 binding_failed。
binding:vnic_type string 网卡挂载的类型,比如normal,direct,baremetal。
created_at string 网卡创建时间 (UTC ISO8601格式)。
description string 用户描述。
device_id sttring 使用该网卡的设备ID,比如一个虚机uuid。
device_owner sting 使用该网卡的设备类型,比如 network:distributed 表示 metadata port,network:vip 表示虚拟 IP,network:secondary 表示辅助私网 IP。
extra_dhcp_opts array 额外的 DHCP 参数列表。
fixed_ips array 网卡的固定 IP 列表。
id string 网卡的ID。
mac_address string 网卡的 MAC 地址。
name satring 网卡的名称。
network_id string 网卡所属的网络ID。
port_security_enabled boolean 网卡的安全状态。true 或者 false,如果是 true 将会配置安全组规则和 anti-spoofing 规则,否则不会处理。
project_id string 网卡所属的 project ID。
qos_policy_id string 网卡关联的 QoS 策略 ID。
revision_number integer 网卡的版本号。
security_groups array 网卡关联的安全组列表。
status string 网卡的状态: ACTIVE, DOWN, BUILD and ERROR。
tags array 网卡的标签列表。
qos_network_policy_id string 网卡所属 network 绑定的 QoS policy ID。
tenant_id string 网卡所属的 tenant ID。
updated_at string 网卡最近更新的时间(UTC ISO8601 格式)。

请求示例

PUT http://{endpoint}/v2.0/ports/602debb5-289d-4ecc-bc86-6a2f84a4b677/add_allowed_address_pairs
{
    "port": {
        "allowed_address_pairs": [
            {
                "ip_address": "192.168.13.7",
                "mac_address": "fa:16:3e:09:1f:b2"
            }
        ]
    }
}

正常响应示例

{
    "port": {
        "admin_state_up": true,
        "allowed_address_pairs": [],
        "binding:host_id": "",
        "binding:profile": {},
        "binding:vif_details": {},
        "binding:vif_type": "unbound",
        "binding:vnic_type": "normal",
        "created_at": "2021-02-24T07:01:14Z",
        "description": "",
        "device_id": "",
        "device_owner": "",
        "extra_dhcp_opts": [],
        "fixed_ips": [
            {
                "ip_address": "192.168.13.7",
                "mac_address": "fa:16:3e:09:1f:b2"
            }
        ],
        "id": "602debb5-289d-4ecc-bc86-6a2f84a4b677",
        "mac_address": "fa:16:3e:91:6b:15",
        "name": "test",
        "network_id": "1191a2fd-42c6-44b9-b153-3378407468f2",
        "port_security_enabled": true,
        "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "qos_policy_id": null,
        "revision_number": 8,
        "security_groups": [
            "65db6fc3-7ba5-42e9-95f1-d45145f1e65f"
        ],
        "status": "DOWN",
        "qos_network_policy_id": null,
        "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "updated_at": "2021-02-24T08:35:26Z"
    }
}

正常响应代码

200

错误码

400,401,403,404,409,413

移除虚拟网卡的allowed_address_pairs

功能介绍

‎给指定虚拟网卡移除allowed_address_pairs

URI

PUT /v2.0/ports/{port_id}/remove_allowed_address_pairs

参数 是否必选 描述
port_id 虚拟网卡的ID

请求消息

参数 参数类型 是否必选 描述
port object 网卡对象。
allowed_address_pairs array 网卡允许访问的地址 pair 列表,每个pair包含一个单独 IP 或一个 IP 和 MAC 。

响应消息

参数 参数类型 描述
port object 网卡对象。
admin_state_up boolean 网卡的 admin 状态,取值 true 或 false。
allowed_address_pairs array 网卡允许访问的地址 pair 列表,每个 pair 包含一个单独 IP 或一个 IP 和 MAC 。
binding:host_id string 网卡所属的 host ID。
binding:profile object 网卡信息字典,传递和接收用于后端网络插件处理的网卡信息。
binding:vif_details object 网卡附加信息字典,目前主要字段是 port_filter 和 ovs_hybrid_plug。
binding:vif_type string 网卡绑定使用的 ml2 插件类型,比如 ovs,bridge,macvtap,未绑定是 unbound,失败是 binding_failed。
binding:vnic_type string 网卡挂载的类型,比如 normal,direct,baremetal。
created_at string 网卡创建时间 (UTC ISO8601格式)。
description string 用户描述。
device_id sttring 使用该网卡的设备 ID,比如一个虚机 uuid。
device_owner sting 使用该网卡的设备类型,比如 network:distributed 表示 metadata port,network:vip 表示虚拟 IP,network:secondary 表示辅助私网 IP。
extra_dhcp_opts array 额外的 DHCP 参数列表。
fixed_ips array 网卡的固定 IP 列表。
id string 网卡的 ID。
mac_address string 网卡的 MAC 地址。
name satring 网卡的名称。
network_id string 网卡所属的网络 ID。
port_security_enabled boolean 网卡的安全状态。true 或者 false ,如果是 true 将会配置安全组规则和 anti-spoofing 规则,否则不会处理。
project_id string 网卡所属的 project ID。
qos_policy_id string 网卡关联的 QoS 策略 ID。
revision_number integer 网卡的版本号。
security_groups array 网卡关联的安全组列表。
status string 网卡的状态: ACTIVE, DOWN, BUILD and ERROR。
tags array 网卡的标签列表。
qos_network_policy_id string 网卡所属 network 绑定的 QoS policy ID。
tenant_id string 网卡所属的 tenant ID。
updated_at string 网卡最近更新的时间(UTC ISO8601 格式)。

请求示例

PUT http://{endpoint}/v2.0/ports/602debb5-289d-4ecc-bc86-6a2f84a4b677/remove_allowed_address_pairs
{
    "port": {
        "allowed_address_pairs": [
            {
                "ip_address": "192.168.13.7",
                "mac_address": "fa:16:3e:09:1f:b2"
            }
        ]
    }
}

正常响应示例

{
    "port": {
        "admin_state_up": true,
        "allowed_address_pairs": [],
        "binding:host_id": "",
        "binding:profile": {},
        "binding:vif_details": {},
        "binding:vif_type": "unbound",
        "binding:vnic_type": "normal",
        "created_at": "2021-02-24T07:01:14Z",
        "description": "",
        "device_id": "",
        "device_owner": "",
        "extra_dhcp_opts": [],
        "fixed_ips": [
            {
                "ip_address": "192.168.13.7",
                "mac_address": "fa:16:3e:09:1f:b2"
            }
        ],
        "id": "602debb5-289d-4ecc-bc86-6a2f84a4b677",
        "mac_address": "fa:16:3e:91:6b:15",
        "name": "test",
        "network_id": "1191a2fd-42c6-44b9-b153-3378407468f2",
        "port_security_enabled": true,
        "project_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "qos_policy_id": null,
        "revision_number": 8,
        "security_groups": [
            "65db6fc3-7ba5-42e9-95f1-d45145f1e65f"
        ],
        "status": "DOWN",
        "qos_network_policy_id": null,
        "tenant_id": "8dac1bf1c3a24be18809f82e1f9a845d",
        "updated_at": "2021-02-24T08:35:26Z"
    }
}

正常响应代码

200

错误码

400,401,403,404,409,413

删除虚拟网卡

功能介绍

‎删除一个指定虚拟网卡

URI

DELETE /v2.0/ports/{port_id}

参数 是否必选 描述
port_id 虚拟网卡的ID

请求消息

请求示例

DELETE http://{endpoint}/v2.0/ports/01a9c14a-d4bb-4b28-a5c8-fd0458b8c94e

正常响应代码

204

错误码

400,401,403,404,409,413

此篇文章对你是否有帮助?
没帮助
locked-file

您暂无权限访问该产品