文档首页/ 云数据库 GaussDB/ API参考/ API（推荐）/ 容灾管理/ 查询操作记录
更新时间：2025-08-11 GMT+08:00
查看PDF
分享

查询操作记录

功能介绍

查询容灾操作记录。

URI

GET /v3/{project_id}/instances/{instance_id}/disaster-recovery/records

表1 参数说明

名称

是否必选

参数类型

说明

project_id

是

String

参数解释：

租户在某一Region下的项目ID。

获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

instance_id

是

String

参数解释：

实例ID，此参数是用户创建实例的唯一标识。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为36个字符。

默认取值：

不涉及。

entity_id

是

String

参数解释：

实体ID（容灾场景下为容灾关系唯一ID。见表3中容灾关系唯一ID字段）。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

entity_type

是

String

参数解释：

实体类型。

约束限制：

不涉及。

取值范围：

dr：容灾。

默认取值：

不涉及。

offset

否

Integer

参数解释：

索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。例如：该参数指定为0，limit指定为10，则只展示第1-10条数据。

约束限制：

必须为数字，不能为负数。

取值范围：

不涉及。

默认取值：

默认为0（偏移0条数据，表示从第一条数据开始查询）。

limit

否

Integer

参数解释：

查询记录数。例如该参数设定为10，则查询结果最多只显示10条记录。

约束限制：

不涉及。

取值范围：

最小值为1，最大值为100。

默认取值：

100

请求参数

无。

响应参数

表2 响应Body参数列表

名称

参数类型

说明

records

Array of objects

参数解释：

操作记录列表。

详情请参见表3。
表3 records字段数据结构说明

参数

参数类型

描述

id

String

参数解释：

主键ID。

取值范围：

不涉及。

action

String

参数解释：

容灾的操作动作。

取值范围：

  • dr_stream_switchover_to_postcheck：流式容灾主备切换后置检查。
  • dr_stream_switchover_auto_recovery：流式容灾主备切换后置处理。
  • dr_stream_switchover_auto_recovery_result：流式容灾主备切换后置处理结果。
  • dr_stream_switchover：流式主备切换开始。
  • dr_stream_switchover_result：流式主备切换完成。
  • dr_stream_failover：流式升主开始。
  • dr_stream_failover_result：流式升主完成。
  • dr_stream_restore：流式回切开始。
  • dr_stream_restore_result：流式回切完成。

status

String

参数解释：

操作状态。

取值范围：

  • success：操作成功。
  • failed：操作失败。
  • query：查询。

message

String

参数解释：

记录信息。

取值范围：

不涉及。

entity_id

String

参数解释：

实体ID（容灾场景下为：容灾关系唯一ID）。

取值范围：

不涉及。

entity_type

String

参数解释：

实体类型。

取值范围：

dr：容灾。

job_id

String

参数解释：

工作流ID。

取值范围：

不涉及。

instance_id

String

参数解释：

实例ID。

取值范围：

不涉及。

created_at

String

参数解释：

创建时间。

取值范围：

格式为“yyyy-mm-ddThh:mm:ssZ”。

其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。

updated_at

String

参数解释：

更新时间。

取值范围：

格式为“yyyy-mm-ddThh:mm:ssZ”。

其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。

extended_info

Object

参数解释：

扩展信息。

请求示例

GET https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/c04c789b6baa4b6dbcc139c5226f3a2cin14/disaster-recovery/records?offset=0&limit=100&entity_id=643a0dd1-ae7b-47c9-bac4-29590a67b679&entity_type=dr

响应示例

{
    "records": [
        {
            "id": "f34bf1d7-03f9-4f33-aac5-033457ca86f6",
            "action": "dr_stream_failover_result",
            "status": "success",
            "message": "",
            "entity_id": "210c7c5c-618d-4ec9-917a-c2681426df85",
            "entity_type": "dr",
            "job_id": "b4670be1-3372-4f44-b049-9c145abbb5d9",
            "instance_id": "083e6e04bc534727954f9d07ac90ab03in14",
            "created_at": "2024-11-19T11:29:25Z",
            "updated_at": "2024-11-19T11:29:25Z",
            "extended_info": {
                "allExtras": {},
                "extraKeys": [],
                "extra": {}
            }
        },
        {
            "id": "0074ead8-a50c-429f-b602-9d70f4a6dc36",
            "action": "dr_stream_failover",
            "status": "success",
            "message": "",
            "entity_id": "210c7c5c-618d-4ec9-917a-c2681426df85",
            "entity_type": "dr",
            "job_id": "b4670be1-3372-4f44-b049-9c145abbb5d9",
            "instance_id": "083e6e04bc534727954f9d07ac90ab03in14",
            "created_at": "2024-11-19T11:28:49Z",
            "updated_at": "2024-11-19T11:28:49Z",
            "extended_info": {
                "allExtras": {},
                "extraKeys": [],
                "extra": {}
            }
        }
    ]
}

状态码

错误码

请参见错误码。

父主题： 容灾管理