ListSubnets - 查询灵骏子网

更新时间:
复制 MD 格式

查询一个或多个灵骏子网的详细信息,包括灵骏子网类型,网络地址段,所属灵骏网段实例ID等。

调试

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

调试

授权信息

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

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

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

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

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

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

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

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

操作

访问级别

资源类型

条件关键字

关联操作

eflo:ListSubnets

get

*Subnet

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

请求参数

名称

类型

必填

描述

示例值

RegionId

string

地域。

cn-wulanchabu

ZoneId

string

可用区。

cn-wulanchabu-a

SubnetId

string

灵骏子网实例 ID。

subnet-anhtskts

SubnetName

string

灵骏子网实例名称。

subnet-1

VpdId

string

所属灵骏网段实例 ID。

vpd-fuliephf

Status

string

实例状态。可能值:

  • Available:正常

  • Not Available:不可用

  • Executing:执行中

  • Deleting:删除中

Available

Type

string

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

  • 通用类型不填

  • OOB:OOB 类型

  • LB:LB 类型

Null

ResourceGroupId

string

资源组ID。

rg-aeky5f3qx6ceapq

Tag

array<object>

标签信息。

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

object

标签信息。

Key

string

资源的标签键。

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

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

rg-subnet

Value

string

资源的标签值。

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

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

subnet-group-1

PageNumber

integer

当前页数。 取值范围:大于 0。 默认值:1。

1

PageSize

integer

每页返回值的个数。 取值范围:1~100。 默认值:20。

20

EnablePage

boolean

是否分页查询,可选值:

  • true :开启

  • false :不开启

false

返回参数

名称

类型

描述

示例值

object

返回信息。

Code

integer

响应码。

0

Message

string

响应信息。

SUCCESS

RequestId

string

当次请求的 Request ID。

7F9082CC-3D94-560F-A575-8E8EF6CE2CB8

Content

object

响应内容。

Total

integer

总条数。

10

Data

array<object>

灵骏子网信息列表。

array<object>

灵骏子网信息。

CreateTime

string

创建时间。

1678273219000

GmtModified

string

修改时间。

1678273219000

TenantId

string

租户 ID。

1655449505171

RegionId

string

地域 ID。

cn-wulanchabu

ZoneId

string

可用区 ID。

cn-wulanchabu-b

Type

string

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

  • 通用类型不填

  • OOB:OOB 类型

  • LB:LB 类型

OOB

SubnetId

string

灵骏子网实例 ID。

subnet-c6wci55i

SubnetName

string

灵骏子网实例名称。

yzp-rg-test3

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 地址为系统保留地址。

172.18.0.0/24

VpdId

string

所属灵骏网段实例 ID。

vpd-ze3na0wf

Status

string

实例状态。可能值:

  • Available:正常

  • Not Available:不可用

  • Executing:执行中

  • Deleting:删除中

Available

Message

string

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

成功

VpdBaseInfo

object

vpd 基本信息。

VpdId

string

灵骏网段实例 ID。

vpd-d3isyds4

VpdName

string

灵骏网段实例名称。

yzp-rg-test3

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

NcCount

integer

NC 数量。

16

NetworkInterfaceCount

integer

灵骏网卡数量。

1

ResourceGroupId

string

资源组ID。

rg-aek2l4sq6l7unhi

Tags

array<object>

标签信息。

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

object

标签信息。

TagKey

string

资源的标签键。

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

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

tag-subnet

TagValue

string

资源的标签值。

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

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

subnet-group-1

AccessDeniedDetail

string

访问被拒绝详细信息。

None

示例

正常返回示例

JSON格式

{
  "Code": 0,
  "Message": "SUCCESS",
  "RequestId": "7F9082CC-3D94-560F-A575-8E8EF6CE2CB8",
  "Content": {
    "Total": 10,
    "Data": [
      {
        "CreateTime": "1678273219000",
        "GmtModified": "1678273219000",
        "TenantId": "1655449505171",
        "RegionId": "cn-wulanchabu",
        "ZoneId": "cn-wulanchabu-b",
        "Type": "OOB",
        "SubnetId": "subnet-c6wci55i",
        "SubnetName": "yzp-rg-test3",
        "Cidr": "172.18.0.0/24",
        "VpdId": "vpd-ze3na0wf",
        "Status": "Available",
        "Message": "成功",
        "VpdBaseInfo": {
          "VpdId": "vpd-d3isyds4",
          "VpdName": "yzp-rg-test3",
          "Cidr": "10.0.0.0/8",
          "CreateTime": "1678273219000"
        },
        "NcCount": 16,
        "NetworkInterfaceCount": 1,
        "ResourceGroupId": "rg-aek2l4sq6l7unhi",
        "Tags": [
          {
            "TagKey": "tag-subnet",
            "TagValue": "subnet-group-1"
          }
        ]
      }
    ]
  },
  "AccessDeniedDetail": "None"
}

错误码

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

变更历史

更多信息,参考变更详情