You need to enable JavaScript to run this app.
导航
ModifySubnetAttributes
最近更新时间:2024.05.17 08:35:45首次发布时间:2021.07.29 14:11:53

调用 ModifySubnetAttributes 接口,修改指定子网的信息。

调用说明

以下可选参数如不配置,则保持原有配置。

调试

请求参数

参数名称
类型
是否必选
示例值
描述
ActionStringModifySubnetAttributes要执行的操作,取值: ModifySubnetAttributes。
VersionString2020-04-01API版本信息,取值为:2020-04-01。

SubnetId

String

subnet-bp1qtch57ywecf****

待修改信息的子网的ID。
您可以调用 DescribeSubnets 接口,查询子网的ID。

SubnetName

String

test

子网的名称。

  • 长度限制为1 ~ 128个字符。
  • 需要以字母、中文或数字开头,可包含点号(.)、下划线(_)和短横线(-)。

Description

String

This is my subnet.

子网的描述信息。

  • 长度限制为0~ 255个字符。
  • 需要以字母、中文或数字开头。可包含英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、短横线(-)、中文逗号(,)、中文句号(。)。

EnableIpv6

Boolean

false

开启/关闭IPv6功能。仅当子网所属的VPC开通IPv6功能时,可配置此参数。

  • true:开启。
  • false:关闭。仅当子网内没有分配IPv6地址的云资源时,可配置此取值。

说明

IPv6功能正在邀测中,如需试用,请联系客户经理。

Ipv6CidrBlock

Integer

99

子网IPv6网段的最后8比特位,取值范围:0~255。

说明

仅当EnableIpv6设置为true时,支持配置本参数。IPv6功能正在邀测中,如需试用,请联系客户经理。

返回数据

参数名称
类型
示例值
描述
RequestIdString2021062415303301022514515207C4****请求ID。

请求示例

GET /?Action=ModifySubnetAttributes&Version=2020-04-01&SubnetId=subnet-bp15qtc7ywecf****&Description=This is my subnet&SubnetName=subnet-1 HTTP/1.1
Host: open.volcengineapi.com
Service: vpc
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2021062415303301022514515207C4****",
        "Action": "ModifySubnetAttributes",
        "Version": "2020-04-01",
        "Service": "vpc",
        "Region": "cn-beijing"
    },
   "Result": {
        "RequestId": "2021062415303301022514515207C4****"
    }
}

错误码

此处仅展示当前API的错误码,更多错误码请参见公共错误码

HttpCode
错误码
错误信息
描述
400InvalidCidr.MalformedThe specified cidr block is malformed.指定的网段格式不合法。
400InvalidName.MalformedThe specified name is malformed. Ensure the maximum length of name is 128.指定的名称格式不合法。名称长度不能超过128个字符。
400InvalidName.MalformedThe specified name is malformed.指定的名称格式不合法。请修复名称格式后重试。
400InvalidDescription.MalformedThe specified description is malformed. Ensure the maximum length of description is 255.指定的描述格式不合法。描述长度不能超过255个字符。
400InvalidDescription.MalformedThe specified description is malformed.指定的描述格式不合法。请修复描述格式后重试。
400InvalidParameter.EnableIpv6Operation failed because IPv6 for the vpc of this subnet is not enabled.子网所属的VPC尚未开启IPv6。
400InvalidParameter.EnableIpv6Operation failed because IPv6 for the subnet is enabled already.子网已经开启IPv6。
400InvalidParameter.EnableIpv6Operation failed because IPv6 is not enabled for the subnet.子网未开启IPv6。
400InvalidParameter.Ipv6CidrBlockSpecified subnet IPv6CidrBlock is invalid.子网IPv6网段不合法。
400InvalidSubnet.InvalidStatusThe specified subnet is not in the correct status for the request.指定的子网所处的状态无法响应该请求。
400InvalidSubnetCidr.MalformedThe specified subnet cidr is malformed. If you are specifying a subnet cidr, ensure the CIDR of the subnet must fall into the range of the CIDR of the VPC to which the subnet belongs to.指定的子网网段不合法。请确保子网网段必须从属于所在VPC的网段。
404InvalidSubnet.NotFoundThe specified subnet does not exist.指定的子网不存在。