全部产品
Search

搜索本产品

    云数据库 Tair（兼容 Redis®）：DescribeGlobalDistributeCache - 查询分布式实例的详细信息

    文档中心

    云数据库 Tair（兼容 Redis®）：DescribeGlobalDistributeCache - 查询分布式实例的详细信息

    更新时间：Aug 28, 2026

    查询分布式实例的详细信息。

    调试

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

    调试

    授权信息

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

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

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

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

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

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

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

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

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    kvstore:DescribeGlobalDistributeCache

    get

    *DBInstance

    acs:kvstore:{#regionId}:{#accountId}:instance/{#instanceId}

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    GlobalInstanceId

    string

    否

    分布式实例 ID。

    gr-bp14rkqrhac****
    PageNumber

    string

    否

    页码，取值为大于 0 且不超过 Integer 数据类型的最大值，默认值为 1。

    1
    PageSize

    string

    否

    每页记录数。

    20
    SubInstanceId

    string

    否

    子实例 ID。

    gr-bp1zcjlobkyrq****

    返回参数

    名称

    类型

    描述

    示例值

    object

    PageSize

    integer

    每页可展示的记录数。

    20
    RequestId

    string

    请求 ID。

    F3F44BE3-5419-4B61-9BAC-E66E295A****
    PageNumber

    integer

    页码。

    1
    TotalRecordCount

    integer

    总记录数。

    1
    GlobalDistributeCaches

    array<object>

    分布式实例详细信息列表。

    array<object>

    Status

    string

    分布式实例状态，返回值：

    • Normal：运行中。

    • Changing：修改中。

    • Creating：创建中。

    Normal
    GlobalInstanceId

    string

    分布式实例 ID。

    gr-bp14rkqrhac****
    SubInstances

    array<object>

    子实例详细信息列表。

    object

    InstanceStatus

    string

    子实例状态，返回值：

    • Normal：正常。

    • Creating：创建中。

    • Changing：修改中。

    • Inactive：被禁用。

    • Flushing：清除中。

    • Released：已释放。

    • Transforming：转换中。

    • Unavailable：服务停止。

    • Error：创建失败。

    • Migrating：迁移中。

    • BackupRecovering：备份恢复中。

    • MinorVersionUpgrading：小版本升级中。

    • NetworkModifying：网络变更中。

    • SSLModifying：SSL 变更中。

    • MajorVersionUpgrading：大版本升级中，可正常访问。

    说明

    更多实例状态及详细信息，请参见实例状态与影响。

    Normal
    InstanceID

    string

    子实例 ID。

    r-bp1zxszhcgatnx****
    InstanceClass

    string

    子实例规格。更多信息，请参见：

    redis.amber.logic.sharding.2g.2db.0rodb.6proxy.multithread
    GlobalInstanceId

    string

    分布式实例 ID。

    gr-bp14rkqrhac****
    RegionId

    string

    地域 ID。

    cn-hangzhou

    示例

    正常返回示例

    JSON格式

    {
  "PageSize": 20,
  "RequestId": "F3F44BE3-5419-4B61-9BAC-E66E295A****",
  "PageNumber": 1,
  "TotalRecordCount": 1,
  "GlobalDistributeCaches": [
    {
      "Status": "Normal",
      "GlobalInstanceId": "gr-bp14rkqrhac****",
      "SubInstances": [
        {
          "InstanceStatus": "Normal",
          "InstanceID": "r-bp1zxszhcgatnx****",
          "InstanceClass": "redis.amber.logic.sharding.2g.2db.0rodb.6proxy.multithread",
          "GlobalInstanceId": "gr-bp14rkqrhac****",
          "RegionId": "cn-hangzhou"
        }
      ]
    }
  ]
}

    错误码

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

    变更历史

    更多信息，参考变更详情。