AssociateNetworkCidrBlock - 为网络添加附加网段

更新时间:
复制 MD 格式

为网络添加附加网段。

接口说明

一个网络最多支持添加的附加网段个数如下:

  • 一个网络最多支持添加 5 个附加 IPv4 网段。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ens:AssociateNetworkCidrBlock

create

*全部资源

*

无 无

请求参数

名称

类型

必填

描述

示例值

NetworkId

string

是

网络 ID。

n-257gqcdfvx6n****

SecondaryCidrBlock

string

否

需要添加的附加 IPv4 网段,网段要求如下:

  • 网段范围需要在 10.0.0.0/8、172.16.0.0/12、192.168.0.0/16 的范围内。

  • 附加网段不得与网络主网段及已添加的附加网段重叠。

10.XX.XX.0/24

IpVersion

string

否

IP 地址的版本类型。取值:

  • IPV4:IPv4 地址。

  • IPV6:IPv6 地址。

IPV6

Ipv6Isp

string

否

IPV6 地址段的运营商。取值:

  • cmcc。

  • unicom。

  • telecom。

telecom

返回参数

名称

类型

描述

示例值

object

Schema of Response

CidrBlock

string

分配的辅助网段。

2408:XXXX:0:a600::/110

IpVersion

string

附加网段的 IP 地址类型。取值:

  • IPV4:IPv4 地址。

  • IPV6:IPv6 地址。

IPV6

RequestId

string

请求 ID。

CEF72CEB-54B6-4AE8-B225-F876FF7BA984

示例

正常返回示例

JSON格式

{
  "CidrBlock": "2408:XXXX:0:a600::/110",
  "IpVersion": "IPV6",
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

错误码

HTTP status code

错误码

错误信息

描述

400 Missing%s You must specify the parameter %s.
400 Invalid%s The specified parameter %s is invalid.
400 IncorrectStatus.Network The status of the network is incorrect. 网络的状态不正确。
400 InvalidCidrBlock.Malformed Specified CIDR block is not valid. 目标网段格式错误。
400 QuotaExceeded.SecondaryCidrBlock The number of Secondary CIDR blocks in the Network exceeds the limit. 网络中的附加网段数超过了限制。
400 SecondaryCidrBlockOverLapped The input Secondary CIDR block overlaps with the existing ones. 输入的辅助网段和现有的网段重叠。
400 CallInterface Call Interface Happen Error. 接口调用出错。
400 EnsRegionDoesNotSupportFeature The specified ens region does not support this feature. 指定的ENS节点不支持该功能。
400 InvalidNetworkType.NotSupported The specified network type does not supported. 网络的类型不支持。
400 InsufficientIpv6Cidr Insufficient IPv6 CIDR stock in the specified region. 指定地域下 IPv6 CIDR 资源库存不足。
400 NetworkNotFound The specified network is not found. 找不到网络,请检查网络id。

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。