调用CreateNetwork创建一个专有网络。

使用说明

  • API调用频率：100次/秒。
  • 单用户调用频率：5次/秒。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CreateNetwork

系统规定参数。取值：CreateNetwork。

EnsRegionId String 是 cn-beijing-telecom

ENS的节点ID。
CidrBlock String 是 192.168.0.0/24

网络的网段。您可以使用以下网段或其子集作为network的网段：

  • 10.0.0.0/8（默认值）。
  • 172.16.0.0/12。
  • 192.168.0.0/16。
NetworkName String 否 abc

网络名称。命名规则如下：

  • 长度为2~128个英文或中文字符。
  • 必须以大小字母或中文开头，不能以 http://和https://开头。
  • 可以包含数字、英文冒号（:）、下划线（_）或者短划线（-）。
Description String 否 this is my first network

描述信息。

长度为2~256个字符，必须以字母或中文开头，但不能以http://或https://开头。

返回数据

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。
NetworkId String n-5***

网络ID。

示例

请求示例

http(s)://ens.aliyuncs.com/?Action=CreateNetwork
&EnsRegionId=cn-beijing-telecom
&CidrBlock=192.168.0.0/24
&NetworkName=abc
&Description=this is my first network
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateNetworkResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <NetworkId>n-5***</NetworkId>
</CreateNetworkResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "NetworkId" : "n-5***"
}

错误码

HttpCode 错误码 错误信息 描述
400 NoPermission Permission denied. 没有足够的权限，请联系云账号管理员授予您相应权限。

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