GetSubnet - 查询灵骏子网详情

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

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
eflo:GetSubnetget
  • Subnet
    acs:eflo:{#regionId}:{#accountId}:subnet/{#SubnetId}

请求参数

名称类型必填描述示例值
RegionIdstring

地域。

cn-wulanchabu
SubnetIdstring

灵骏子网实例 ID。

subnet-2avf0itf
VpdIdstring

所属灵骏网段 ID。

vpd-cxcmdk1m

返回参数

名称类型描述示例值
object

响应结果信息。

Codeinteger

业务码。

0
Messagestring

错误信息。(当实例状态为异常时,提示异常原因)

成功
RequestIdstring

当次请求的 Request ID。

0901F411-28FA-5B9C-BAEE-7776463FF0DC
Contentobject

响应内容。

CreateTimestring

创建时间。

1648085472000
GmtModifiedstring

修改时间。

1678273219000
TenantIdstring

租户 ID。

1655449505171
RegionIdstring

地域 ID。

cn-wulanchabu
ZoneIdstring

可用区 ID。

cn-wulanchabu-b
SubnetIdstring

灵骏子网实例 ID。

subnet-aj93mko8
SubnetNamestring

灵骏子网实例名称。

subnet-1
Cidrstring

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
VpdIdstring

所属灵骏网段实例 ID。

vpd-ze3na0wf
Typestring

灵骏子网使用类型;非必选;可选值:

  • 通用类型返回空
  • OOB:OOB 类型
  • LB: LB 类型
OOB
Statusstring

实例状态。

Available
Messagestring

错误信息。(当实例状态为异常时,提示异常原因)

成功
NcCountinteger

NC 数量。

16
NetworkInterfaceCountinteger

灵骏网卡数量

4
LbCountlong

负载均衡数量。

0
VpdBaseInfoobject

所属灵骏网段信息。

VpdIdstring

灵骏网段实例 ID。

vpd-iv2zm1qf
VpdNamestring

灵骏网段实例名称。

vpd-1
Cidrstring

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
CreateTimestring

创建时间。

1678273219000
ResourceGroupIdstring

资源组 ID。

rg-aek2l4sq6l7unhi
Tagsarray<object>

标签信息。

一次最多支持输入 20 个标签信息。

Tagobject

资源标签信息。

TagKeystring

资源的标签键。

一旦传入该值,则不允许为空字符串。最多支持 64 个字符,不能以 aliyun 或者 acs:开头,不能包含 http://或者 https://。

一次最多支持输入 20 个标签的标签键。

tag-subnet
TagValuestring

资源的标签值。

标签值可以为空或输入不超过 128 个字符的字符串,不能以 aliyun 或者 acs:开头,不能包含 http://或者 https://。

每一个标签键对应一个标签值,一次最多支持输入 20 个标签键对应的标签值。

subnet-group-1
PrivateIpCountlong

辅助私网 IP 总数。

20
AvailableIpsinteger

可用 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-01OpenAPI 返回结构发生变更查看变更详情