Updated on 2025-08-18 GMT+08:00

Querying the Restoration Time Range

Function

This API is used to query the restoration time range of an instance. Before calling this API:

Learn how to authenticate this API.

URI

GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/restore-time?date={date}

**Table 1** Parameter description
Parameter	Mandatory	Type	Description
project_id	Yes	String	Explanation: Project ID of a tenant in a region. For details about how to obtain the project ID, see Obtaining a Project ID. Restrictions: None Value range: The value can contain 32 characters. Only letters and digits are allowed. Default value: None
instance_id	Yes	String	Instance ID.
date	Yes	String	Date to be queried. The value is in the "yyyy-mm-dd" format, and the time zone is UTC.

Request Parameters

None

Response Parameters

**Table 2** Parameter description
Parameter	Type	Description
restore_time	Array of objects	Restoration time ranges. For details, see Table 3.

**Table 3** restore_time field data structure description
Parameter	Type	Description
start_time	Long	Start time of the restoration time range in the UNIX timestamp format. The unit is millisecond and the time zone is UTC+8.
end_time	Long	End time of the restoration time range in the UNIX timestamp format. The unit is millisecond and the time zone is UTC+8.

Example Request

Querying the restoration time range

GET https://gaussdb-opengauss.eu-west-101.myhuaweicloud.eu/v3/0483b6b16e954cb88930a360d2c4e663/instances/d2113b7c60154636b94bea1320b6a874in14/restore-time?date=2022-04-17

Example Response

Restoration time range queried.

{
    "restore_time": [
        {
            "start_time": 1652084311000,
            "end_time": 1652092839000
        },
        {
            "start_time": 1652092847000,
            "end_time": 1652094792000
        }
    ]
}

Status Code

Normal
200
Abnormal
For details, see Status Codes.

Error Code

For details, see Error Codes.

Parent topic: Backup and Restoration