调用GetSubnet查询灵骏子网详情_人工智能平台 PAI(PAI)-阿里云帮助中心

查询某个灵骏子网的详细信息，包括灵骏子网类型，网络地址段，所属灵骏网段实例ID，实例状态，NC数量等。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
RegionId	string	否	地域。	cn-wulanchabu
SubnetId	string	是	灵骏子网实例 ID。	subnet-2avf0itf
VpdId	string	否	所属灵骏网段 ID。	vpd-cxcmdk1m

返回参数

名称	类型	描述	示例值
	object	响应结果信息。
Code	integer	业务码。	0
Message	string	错误信息。（当实例状态为异常时，提示异常原因）	成功
RequestId	string	当次请求的 Request ID。	0901F411-28FA-5B9C-BAEE-7776463FF0DC
Content	object	响应内容。
CreateTime	string	创建时间。	1648085472000
GmtModified	string	修改时间。	1678273219000
TenantId	string	租户 ID。	1655449505171
RegionId	string	地域 ID。	cn-wulanchabu
ZoneId	string	可用区 ID。	cn-wulanchabu-b
SubnetId	string	灵骏子网实例 ID。	subnet-aj93mko8
SubnetName	string	灵骏子网实例名称。	subnet-1
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.10.10.0/24
VpdId	string	所属灵骏网段实例 ID。	vpd-ze3na0wf
Type	string	灵骏子网使用类型；非必选；可选值：通用类型返回空 OOB：OOB 类型 LB： LB 类型	OOB
Status	string	实例状态。	Available
Message	string	错误信息。（当实例状态为异常时，提示异常原因）	成功
NcCount	integer	NC 数量。	16
NetworkInterfaceCount	integer	灵骏网卡数量	4
LbCount	long	负载均衡数量。	0
VpdBaseInfo	object	所属灵骏网段信息。
VpdId	string	灵骏网段实例 ID。	vpd-iv2zm1qf
VpdName	string	灵骏网段实例名称。	vpd-1
Cidr	string	VPD 的网段。建议您使用 RFC 私网地址作为灵骏网段的网段如 10.0.0.0/8，172.16.0.0/12，192.168.0.0/16，多灵骏网段互通场景或灵骏网段和 VPC 互通场景需确保地址规划不能冲突。您也可以使用除 100.64.0.0/10、224.0.0.0/4、127.0.0.0/8 或 169.254.0.0/16 及其子网外的自定义地址段作为 VPD 的主 IPv4 网段。	10.0.0.0/8
CreateTime	string	创建时间。	1678273219000
ResourceGroupId	string	资源组 ID。	rg-aek2l4sq6l7unhi
Tags	object []	标签信息。一次最多支持输入 20 个标签信息。
TagKey	string	资源的标签键。一旦传入该值，则不允许为空字符串。最多支持 64 个字符，不能以 aliyun 或者 acs:开头，不能包含 http://或者 https://。一次最多支持输入 20 个标签的标签键。	tag-subnet
TagValue	string	资源的标签值。标签值可以为空或输入不超过 128 个字符的字符串，不能以 aliyun 或者 acs:开头，不能包含 http://或者 https://。每一个标签键对应一个标签值，一次最多支持输入 20 个标签键对应的标签值。	subnet-group-1
PrivateIpCount	long	辅助私网 IP 总数。	20
AvailableIps	integer	可用 IP 地址数。	1024

示例

正常返回示例

JSON格式

{
  "Code": 0,
  "Message": "成功",
  "RequestId": "0901F411-28FA-5B9C-BAEE-7776463FF0DC",
  "Content": {
    "CreateTime": "1648085472000",
    "GmtModified": "1678273219000",
    "TenantId": "1655449505171",
    "RegionId": "cn-wulanchabu",
    "ZoneId": "cn-wulanchabu-b",
    "SubnetId": "subnet-aj93mko8",
    "SubnetName": "subnet-1",
    "Cidr": "10.10.10.0/24",
    "VpdId": "vpd-ze3na0wf",
    "Type": "OOB",
    "Status": "Available",
    "Message": "成功",
    "NcCount": 16,
    "NetworkInterfaceCount": 4,
    "LbCount": 0,
    "VpdBaseInfo": {
      "VpdId": "vpd-iv2zm1qf",
      "VpdName": "vpd-1",
      "Cidr": "10.0.0.0/8",
      "CreateTime": "1678273219000"
    },
    "ResourceGroupId": "rg-aek2l4sq6l7unhi",
    "Tags": [
      {
        "TagKey": "tag-subnet",
        "TagValue": "subnet-group-1"
      }
    ],
    "PrivateIpCount": 20,
    "AvailableIps": 1024
  }
}

错误码

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

变更历史

变更时间

变更内容概要

操作

2023-08-01

OpenAPI 返回结构发生变更

看变更集

变更项	变更内容
出参	OpenAPI 返回结构发生变更。