DescribeAvailableCrossRegion--缓存数据库 Redis 版-火山引擎

文档中心

立即注册

导航

DescribeAvailableCrossRegion

最近更新时间：2025.08.14 15:33:44首次发布时间：2025.06.24 23:01:41

调用 DescribeAvailableCrossRegion 接口查询目标 Redis 实例中可作为跨地域备份目的地域列表。

请求类型

同步请求。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数	类型	是否必选	示例值	描述
InstanceId	String	是	redis-cn0212gzmh2xs****	实例 ID。指定后可查询该实例可用于跨地域备份的地域。说明您可以调用 DescribeDBInstances 接口查询目标地域下所有 Redis 实例的基本信息，包括实例 ID。

返回参数

参数	类型	示例值	描述
TargetRegionIds	String[]	[ "cn-shanghai", "cn-guangzhou" ]	当前实例中可作为跨地域备份目的地域的列表。

示例

请求示例

POST https://redis.cn-beijing.volcengineapi.com/?Action=DescribeAvailableCrossRegion&Version=2020-12-07 HTTP/1.1
Host: redis.cn-beijing.volcengineapi.com
Content-Type: application/json; charset=utf-8
X-Date: 20201103T104027Z
Authorization: HMAC-SHA256 Credential=AK****/20201103/cn-beijing/Redis/request,SignedHeaders=content-type;host;x-date,Signature=****
{
    "InstanceId": "redis-cn0212gzmh2xs****"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****10023228002****",
        "Action": "DescribeAvailableCrossRegion",
        "Version": "2020-12-07",
        "Service": "Redis",
        "Region": "cn-beijing"
    },
    "Result": {
        "TargetRegionIds": [
            "cn-shanghai",
            "cn-guangzhou"
        ]
    }
}

错误码

更多详情，请参见错误码。