调用CreateSubnet API在灵骏网段下创建灵骏子网-人工智能平台 PAI-阿里云-智能计算灵骏(LINGJUN)-阿里云帮助中心

用户可以使用该API在灵骏网段下创建一个灵骏子网。

接口说明

在调用该接口创建灵骏子网时，请注意：

您已创建了灵骏网段。
一个灵骏子网只能指定一个网段。
灵骏子网创建后将无法修改网段。
请确保您有足够的灵骏子网配额。
该接口属于异步接口，调用该接口后，系统将返回一个灵骏子网的 ID，此时灵骏网段可能尚未创建完成，系统后台的创建任务仍在进行中。您可以通过 ListSubnets 或者 GetSubnet 查询灵骏网段的状态：
- 当灵骏子网状态是 Executing 时，表示正在创建。
- 当灵骏子网状态是 Available 时，表示创建成功。

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

eflo:CreateSubnet

create

*Subnet

acs:eflo:{#regionId}:{#accountId}:Subnet/*

无

请求参数

名称	类型	必填	描述	示例值
SubnetName	string	是	灵骏子网实例名称	subnet-1
RegionId	string	是	地域 ID	cn-wulanchabu
ZoneId	string	是	可用区 ID	cn-wulanchabu-b
VpdId	string	是	所属灵骏网段实例 ID	vpd-xcuhjyrj
Cidr	string	是	Subnet 的网段。子网的网段必须是其所属灵骏网段的真子集且掩码需在 16 位到 29 位之间，可提供 8 ~ 65536 个地址。例如，灵骏网段的网段为 192.168.0.0/16，该灵骏网段下的子网的网段为 192.168.0.0/17 ~ 192.168.0.0/29。每个子网网段的第一个和最后三个 IP 地址为系统保留地址。例如，子网的网段为 192.168.1.0/24，192.168.1.0、192.168.1.253、192.168.1.254 和 192.168.1.255 这四个 IP 地址为系统保留地址。	10.0.0.0/16
Type	string	否	灵骏子网使用类型；非必选；可选值：通用类型不填 OOB：OOB 类型 LB： LB 类型	OOB
Tag	array<object>	否	标签信息。一次最多支持输入 20 个标签信息。
	object	否	实例的标签信息
Key	string	否	资源的标签键。一旦传入该值，则不允许为空字符串。最多支持 64 个字符，不能以 aliyun 或者 acs:开头，不能包含 http://或者 https://。一次最多支持输入 20 个标签的标签键。	tag-subnet
Value	string	否	资源的标签值。标签值可以为空或输入不超过 128 个字符的字符串，不能以 aliyun 或者 acs:开头，不能包含 http://或者 https://。每一个标签键对应一个标签值，一次最多支持输入 20 个标签键对应的标签值。	subnet-tag-1

返回参数

名称	类型	描述	示例值
	object	AjaxResult
Code	integer	业务码	0
Message	string	错误信息。（当实例状态为异常时，提示异常原因）	成功
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	A88DFED5-24B7-5A3E-87DE-380BF06F3C90
Content	object	响应内容
SubnetId	string	灵骏子网实例 ID	subnet-yuvn29bn
AccessDeniedDetail	string	访问被拒绝的详细原因。	None

示例

正常返回示例

JSON格式

{
  "Code": 0,
  "Message": "成功",
  "RequestId": "A88DFED5-24B7-5A3E-87DE-380BF06F3C90",
  "Content": {
    "SubnetId": "subnet-yuvn29bn"
  },
  "AccessDeniedDetail": "None"
}

错误码

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

变更历史

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