DescribeGlobalDataNetworkList - 查询所有地域的 PolarFS 全球数据网络(GDN)详情

查询所有地域的 PolarFS 全球数据网络(GDN)详情。

调试

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

调试

授权信息

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

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

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

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

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

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

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

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

操作

访问级别

资源类型

条件关键字

关联操作

polardb:DescribeGlobalDataNetworkList

list

*全部资源

*

请求语法

GET  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

PageNumber

integer

查询结果的页码

1

PageSize

integer

每页记录数

30

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

请求 ID

CD35F3-F3-44CA-AFFF-BAF869******

TotalRecordCount

string

总记录数

1

PageRecordCount

string

本页记录数

1

PageNumber

string

页码

1

Items

object

GDN 详情

Networks

array<object>

GDN 网络列表

object

GDN 网络详情

NetworkId

string

GDN ID

gdn-xxx

NetworkDescription

string

GDN 描述/备注

mygdn

NetworkStatus

string

GDN 状态。取值范围:

  • Creating:创建中

  • Running:运行中

  • Syncing:同步中

  • SyncFinished:同步完成

  • SyncFailed:同步失败

  • SyncPartialFailed:部分同步失败

  • Stopped:已停止

  • Maintaining:维护中

  • Restarting:重启中

  • Locking:锁定中

  • Locked:已锁定

  • Unlocking:解锁中

  • Deleting:删除中

  • Deleted:已删除

Running

NetworkTopology

object

GDN 网络拓扑

Sources

array<object>

同步源的列表

object

同步源

SourceFileSystemPath

string

源路径

/

SourceType

string

源类型,取值范围:

  • pfs:PolarFS 高性能版。

  • pcs:PolarFS 冷存版。

pcs

SourceRegion

string

源地域

cn-wulanchabu

SourceId

string

源 PolarFS 实例

pcs-xxx

Destinations

array<object>

同步目标的列表

object

同步目标

DestinationFileSystemPath

string

目标路径

/

DestinationRegion

string

目标地域

cn-beijing

DestinationType

string

目标类型。取值范围:

  • pfs:PolarFS 高性能版。

  • pcs:PolarFS 冷存版。

pfs

DestinationId

string

目标 PolarFS 实例

pfs-xxx

CreateTime

string

GDN 的创建时间

2025-03-25T09:37:10Z

Channels

array<object>

同步链路列表

object

同步链路

ChannelId

string

同步链路 ID

gdc-xxx

ChannelStatus

string

同步链路状态。取值范围:

  • Creating:创建中

  • Running:运行中

  • Syncing:同步中

  • SyncFinished:同步完成

  • SyncFailed:同步失败

  • SyncPartialFailed:部分同步失败

  • Stopped:已停止

  • Maintaining:维护中

  • Restarting:重启中

  • Locking:锁定中

  • Locked:已锁定

  • Unlocking:解锁中

  • Deleting:删除中

  • Deleted:已删除

Syncing

Progress

string

当前的同步进度

说明

格式为两位小数的浮点百分比

11.45%

FreezeSourceDuringSync

boolean

传输过程中是否冻结源路径

true

示例

正常返回示例

JSON格式

{
  "RequestId": "CD35F3-F3-44CA-AFFF-BAF869******",
  "TotalRecordCount": "1",
  "PageRecordCount": "1",
  "PageNumber": "1",
  "Items": {
    "Networks": [
      {
        "NetworkId": "gdn-xxx",
        "NetworkDescription": "mygdn",
        "NetworkStatus": "Running",
        "NetworkTopology": {
          "Sources": [
            {
              "SourceFileSystemPath": "/",
              "SourceType": "pcs",
              "SourceRegion": "cn-wulanchabu",
              "SourceId": "pcs-xxx"
            }
          ],
          "Destinations": [
            {
              "DestinationFileSystemPath": "/",
              "DestinationRegion": "cn-beijing",
              "DestinationType": "pfs",
              "DestinationId": "pfs-xxx"
            }
          ]
        },
        "CreateTime": "2025-03-25T09:37:10Z",
        "Channels": [
          {
            "ChannelId": "gdc-xxx",
            "ChannelStatus": "Syncing",
            "Progress": "11.45%",
            "FreezeSourceDuringSync": true
          }
        ]
      }
    ]
  }
}

错误码

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

变更历史

更多信息,参考变更详情