ListVpds - 查询灵骏网段

查询一个或多个灵骏网段的详细信息,包括灵骏网段状态,Cidr地址,服务网段,Subnet等。

调试

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

授权信息

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

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

请求参数

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

灵骏网段(VPD)实例名称。

vpd-1
RegionIdstring

地域 ID。

cn-wulanchabu
VpdIdstring

灵骏网段(VPD)实例 ID。

vpd-fuliephf
Statusstring

实例状态。可能值:

  • Available:正常 。
  • Not Available:不可用。
  • Executing:执行中。
  • Deleting:删除中。
Available
WithDependenceboolean

是否带依赖资源信息,建议分页查询的时候不查询依赖信息,删除的时候可以单独查询,可能值:

  • true : 带依赖信息。
  • false :不带依赖信息。
false
ForSelectboolean

下拉选择时使用,只返回基础信息(包括实例 ID、实例名称),可能值:

  • true :下拉选择查询使用。
  • false :正常查询使用。
true
WithoutVccboolean

查询未绑定 VCC(灵骏连接)的 VPD(灵骏网段)信息,可能值:

  • true : 过滤掉已绑定过 VCC 的 VPD
  • false :不过滤已绑定过 VCC 的 VPD
true
FilterErIdstring

查询未绑定过指定灵骏 HUB 的灵骏网段信息。

er-kkopgtne
ResourceGroupIdstring

资源组 ID。

关于资源组的更多信息,请参见什么是资源组

rg-aeky5f3qx6ceapq
Tagarray<object>

标签信息。

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

Tagobject

标签信息。

Keystring

资源的标签键。

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

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

tag-vpd-region
Valuestring

资源的标签值。

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

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

wulanchabu
PageNumberinteger

当前页码。起始值:1 默认值:1。

1
PageSizeinteger

分页大小。

20
EnablePageboolean

是否开启分页查询。

false

返回参数

名称类型描述示例值
object

请求响应对象。

Codeinteger

响应码。

0
Messagestring

返回信息。

success
RequestIdstring

请求 ID。

9C50C9CD-E799-54DA-BA7A-1FAF3DF80857
Contentobject

响应内容。

Totallong

总记录数。

0
Dataarray<object>

返回数据信息。

Dataobject

附加说明信息。

TenantIdstring

租户 ID。

1655449505171
RegionIdstring

地域 ID。

cn-wulanchabu
VpdIdstring

灵骏网段(VPD)实例 ID

vpd-lg4dppgi
VpdNamestring

灵骏网段(VPD)名称。

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
ServiceCidrstring

服务网段。

169.254.252.0/23
Statusstring

状态。

Available
Messagestring

提示信息。

成功
NcCountinteger

nc 数量。

16
NetworkInterfaceCountinteger

灵骏网卡数量

1
SubnetCountinteger

Subnet 数量。

1
CreateTimestring

创建时间。

1678273219000
GmtModifiedstring

修改时间。

1678273219000
Dependenceobject

依赖项。

any

依赖信息列表。

{ "subnet": [ { "tenantId": "1620939556166277", "regionId": "cn-wulanchabu", "zoneId": "cn", "type": null, "subnetId": "subnet-zqebaxa0", "name": "lql_testVPD" } ], "nc": [{}] }
ErInfosarray<object>

已绑定的灵骏 HUB(ER)信息列表。

ErInfoobject

已绑定的灵骏 HUB(ER)信息。

CreateTimestring

创建时间。

1678273219000
GmtModifiedstring

修改时间。

1678273219000
Messagestring

提示信息。

成功
ErIdstring

弹性路由器(ER)实例 ID。

er-63vzm0fw
RegionIdstring

地域信息。

cn-wulanchabu
TenantIdstring

租户 ID。

1620939556166277
Statusstring

状态。

Available
ErNamestring

灵骏 HUB(ER)实例名称。

er-1
MasterZoneIdstring

主可用区。

cn-wulanchabu-b
Descriptionstring

描述。

描述
Connectionslong

连接数。

2
RouteMapslong

路由策略数量。

2
Tagsarray<object>

标签信息。

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

Tagobject

标签信息。

TagKeystring

资源的标签键。

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

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

tag-vpd-region
TagValuestring

资源的标签值。

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

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

cn-wulanchabu
ResourceGroupIdstring

资源组 ID。

关于资源组的更多信息,请参见什么是资源组

rg-aek2l4sq6l7unhi
SecondaryCidrBlocksarray

附加网段信息列表。

SecondaryCidrBlockstring

VPD 的附加网段。

10.0.0.0/8

示例

正常返回示例

JSON格式

{
  "Code": 0,
  "Message": "success",
  "RequestId": "9C50C9CD-E799-54DA-BA7A-1FAF3DF80857",
  "Content": {
    "Total": 0,
    "Data": [
      {
        "TenantId": "1655449505171",
        "RegionId": "cn-wulanchabu",
        "VpdId": "vpd-lg4dppgi",
        "VpdName": "vpd-1",
        "Cidr": "10.0.0.0/8",
        "ServiceCidr": "169.254.252.0/23",
        "Status": "Available",
        "Message": "成功",
        "NcCount": 16,
        "NetworkInterfaceCount": 1,
        "SubnetCount": 1,
        "CreateTime": "1678273219000",
        "GmtModified": "1678273219000",
        "Dependence": {
          "key": "{\n    \"subnet\": [\n        {\n            \"tenantId\": \"1620939556166277\",\n            \"regionId\": \"cn-wulanchabu\",\n            \"zoneId\": \"cn\",\n            \"type\": null,\n            \"subnetId\": \"subnet-zqebaxa0\",\n            \"name\": \"lql_testVPD\"\n        }\n    ],\n    \"nc\": [{}]\n}"
        },
        "ErInfos": [
          {
            "CreateTime": "1678273219000",
            "GmtModified": "\t\n1678273219000",
            "Message": "成功",
            "ErId": "er-63vzm0fw",
            "RegionId": "cn-wulanchabu",
            "TenantId": "1620939556166277",
            "Status": "Available",
            "ErName": "er-1",
            "MasterZoneId": "cn-wulanchabu-b",
            "Description": "描述",
            "Connections": 2,
            "RouteMaps": 2
          }
        ],
        "Tags": [
          {
            "TagKey": "tag-vpd-region",
            "TagValue": "cn-wulanchabu"
          }
        ],
        "ResourceGroupId": "rg-aek2l4sq6l7unhi",
        "SecondaryCidrBlocks": [
          "10.0.0.0/8"
        ]
      }
    ]
  }
}

错误码

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

变更历史

变更时间变更内容概要操作
2023-08-01OpenAPI 返回结构发生变更查看变更详情