DescribeRestorableTenants - 查询可恢复租户

查询可恢复 OceanBase 租户。

调试

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

授权信息

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

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

请求参数

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

OceanBase 集群 ID。

ob317v4uif****
IsRemoteboolean

为兼容老版本,可以为空。

true
SetIdstring

备份集 ID。

bak-xxxxx
RestoreModestring

恢复方式。非必填,在 IsRemote=true 时,必填。

from_time_point
Methodstring

备份类型。

native_logical
IsOnlineboolean

目标解析集群是否在线。

说明 为兼容旧版本时可以不填,不填时值为对 isRemote 取反。
true
RestoreObjectTypestring

恢复对象类型。

tenant

返回参数

名称类型描述示例值
object

请求的返回结果。

TotalCountinteger

总数量。

6
RequestIdstring

请求 ID。

EE205C00-30E4-****-****-87E3A8A2AA0C
Tenantsarray<object>

租户信息。

Dataobject

租户的列表信息。

TenantNamestring

租户名称。

sbtest1
Methodstring

备份方式。

枚举值:
  • native_logical:库表逻辑备份native_logical:库表逻辑备份
  • physical:物理备份physical:物理备份
  • logical:逻辑备份(OB2276及以下)logical:逻辑备份(OB2276及以下)
logical
TenantIdstring

租户 ID。

ob317v4uif****
TimeIntervalListarray<object>

租户可恢复时间区间信息列表。

TimeIntervalListobject

租户可恢复时间区间信息。

StartTimestring

可恢复的起始时间。

2023-01-20T16:00:00Z
EndTimestring

可恢复的结束时间。

2023-03-13T02:43:03Z
FromArchiveboolean

是否属于归档恢复。

true
StorageTypestring

备份存储类型。

枚举值:
  • standard:标准存储standard:标准存储
  • archive:归档存储archive:归档存储
standard
ClusterIdstring

集群 ID。

objnf3b2****
ObRpmVersionstring

OceanBase RPM 版本号。

3.2.3.1-2022080510****
ObVersionstring

OceanBase 大版本号。

3.2.3.1
SourceRegionstring

集群所属地域。

cn-hangzhou
TenantAliasstring

租户别名。

aaa
CpuNumlong

租户 CPU 规格。

1
MemoryNumlong

租户存储规格。

100
BackupBucketNamestring

备份目录名。

backup
ObTenantIdstring

租户 ID。

tvd43v****
ClusterNamestring

集群名称。

testCluster
BackupSetsarray<object>

备份集列表。

BackupSetsobject

备份集信息。

Checkpointstring

备份集的快照点。

2024-01-01'T'12:10:10.000'Z'
SetIdstring

备份集 ID。

bak-xxxxx
BackupSetIdstring

恢复所使用的全量备份集 ID。

bak-4n****gacpa8
TenantIdstring

租户 ID

t5********
UsedDisklong

租户磁盘大小。

50
UnitNumlong

租户节点数。

2
TenantModestring

租户模式。

Oracle
TenantDataBackupRemainDaysinteger

租户备份数据剩余有效天数

7

示例

正常返回示例

JSON格式

{
  "TotalCount": 6,
  "RequestId": "EE205C00-30E4-****-****-87E3A8A2AA0C",
  "Tenants": [
    {
      "TenantName": "sbtest1",
      "Method": "logical",
      "TenantId": "ob317v4uif****",
      "TimeIntervalList": [
        {
          "StartTime": "2023-01-20T16:00:00Z",
          "EndTime": "2023-03-13T02:43:03Z",
          "FromArchive": true,
          "StorageType": "standard"
        }
      ],
      "ClusterId": "objnf3b2****",
      "ObRpmVersion": "3.2.3.1-2022080510****",
      "ObVersion": "3.2.3.1",
      "SourceRegion": "cn-hangzhou",
      "TenantAlias": "aaa",
      "CpuNum": 1,
      "MemoryNum": 100,
      "BackupBucketName": "backup",
      "ObTenantId": "tvd43v****",
      "ClusterName": "testCluster",
      "BackupSets": [
        {
          "Checkpoint": "2024-01-01'T'12:10:10.000'Z'",
          "SetId": "bak-xxxxx",
          "BackupSetId": "bak-4n****gacpa8",
          "TenantId": "t5********"
        }
      ],
      "UsedDisk": 50,
      "UnitNum": 2,
      "TenantMode": "Oracle",
      "TenantDataBackupRemainDays": 7
    }
  ]
}

错误码

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

变更历史

变更时间变更内容概要操作
2024-09-02OpenAPI 返回结构发生变更查看变更详情