文档首页> 虚拟私有云 VPC> API参考> API V3> 辅助弹性网卡> 更新辅助弹性网卡
更新时间：2024-04-29 GMT+08:00
在线调试
CLI示例
查看PDF
分享

更新辅助弹性网卡

功能介绍

更新辅助弹性网卡。

调试

您可以在API Explorer中调试该接口。

URI

PUT /v3/{project_id}/vpc/sub-network-interfaces/{sub_network_interface_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。

sub_network_interface_id

是

String

辅助弹性网卡的唯一标识。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

dry_run

否

Boolean
  • 功能说明：是否只预检此次请求。
  • 取值范围
    • true：发送检查请求，不会更新辅助弹性网卡。检查项包括是否填写了必需参数、请求格式、权限校验。如果检查不通过，则返回对应错误。如果检查通过，则返回响应码202。
    • false（默认值）：发送正常请求，并直接更新辅助弹性网卡。

sub_network_interface

是

UpdateSubNetworkInterfaceOption object

更新辅助弹性网卡请求体。
表3 UpdateSubNetworkInterfaceOption

参数

是否必选

参数类型

描述

description

否

String
  • 功能说明：辅助弹性网卡的描述信息。
  • 取值范围：0-255个字符，不能包含“<”和“>”。

security_groups

否

Array of strings
  • 功能说明：安全组的ID列表，

    例如："security_groups": ["a0608cbf-d047-4f54-8b28-cd7b59853fff"]

响应参数

状态码为 200 时:

表4 响应Body参数

参数

参数类型

描述

request_id

String

请求ID。

sub_network_interface

SubNetworkInterface object

更新辅助弹性网卡的响应体。
表5 SubNetworkInterface

参数

参数类型

描述

id

String
  • 功能说明：辅助弹性网卡的唯一标识。
  • 取值范围：带(-)的标准UUID。

virsubnet_id

String
  • 功能说明：虚拟子网ID，即子网ID，对应控制台子网界面的网络ID。
  • 取值范围：标准UUID。

private_ip_address

String
  • 功能说明：辅助弹性网卡的私有IPv4地址。
  • 取值范围：必须在虚拟子网的网段内，不填则随机在虚拟子网网段内随机分配。

ipv6_ip_address

String
  • 功能说明：辅助弹性网卡的私有IPv6地址。
  • 取值范围：必须在虚拟子网的网段内，不填则随机在虚拟子网网段内随机分配。

mac_address

String
  • 功能说明：辅助弹性网卡的mac地址。
  • 取值范围：合法的mac地址，系统随机分配。

parent_device_id

String
  • 功能说明：设备ID。
  • 取值范围：标准UUID。

parent_id

String
  • 功能说明：宿主网络接口的ID。
  • 取值范围：标准UUID。

description

String
  • 功能说明：辅助弹性网卡的描述信息。
  • 取值范围：0-255个字符，不能包含“<”和“>”。

vpc_id

String
  • 功能说明：辅助弹性网卡所属的VPC_ID。
  • 取值范围：标准UUID。

vlan_id

Integer
  • 功能说明：辅助弹性网卡的VLAN ID。
  • 取值范围：1-4094。
  • 约束：同一个宿主网络接口下唯一。

security_enabled

Boolean
  • 功能说明：辅助弹性网卡安全使能标记，如果不使能则安全组不生效。

security_groups

Array of strings
  • 功能说明：安全组的ID列表，例如："security_groups": ["a0608cbf-d047-4f54-8b28-cd7b59853fff"]。
  • 取值范围：默认值为系统默认安全组。

tags

Array of strings
  • 功能说明：辅助弹性网卡的标签列表。

project_id

String
  • 功能说明：辅助弹性网卡所属项目ID。

created_at

String
  • 功能说明：辅助弹性网卡的创建时间。
  • 取值范围：UTC时间格式：yyyy-MM-ddTHH:mm:ssZ。

请求示例

更新id为2be868f2-f7c9-48db-abc0-eea0b9105b0d的辅助弹性网卡，更新关联的安全组列表。

PUT https://{Endpoint}/v3/8c6fb137a48a428aaf9a0229dca4edb3/vpc/sub-network-interfaces/2be868f2-f7c9-48db-abc0-eea0b9105b0d

{
  "sub_network_interface" : {
    "security_groups" : [ "6727c950-9f01-47a2-a7aa-7d3686c4c95b" ]
  }
}

响应示例

状态码为 200 时:

OK

{
  "sub_network_interface" : {
    "id" : "2be868f2-f7c9-48db-abc0-eea0b9105b0d",
    "project_id" : "8c6fb137a48a428aaf9a0229dca4edb3",
    "virsubnet_id" : "08278e6c-61ca-46c1-9fc3-0d4f6c12f193",
    "private_ip_address" : "10.0.0.225",
    "ipv6_ip_address" : null,
    "mac_address" : "fa:16:3e:48:f8:6f",
    "parent_device_id" : "1ab01f1d-4ef7-4d83-82be-802b3aca0223",
    "security_groups" : [ "6727c950-9f01-47a2-a7aa-7d3686c4c95b" ],
    "vpc_id" : "63b97e6b-3598-430f-9eb8-1caf06937be8",
    "description" : null,
    "parent_id" : "637748df-2986-4350-8303-95d259580fb3",
    "vlan_id" : 2787,
    "tags" : [ ],
    "created_at" : "2020-05-19T01:16:25Z"
  },
  "request_id" : "ceb6273e-1ec9-4168-ac11-3dfeaacfc889"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 辅助弹性网卡
分享：

    相关文档

    相关产品