• Relational Database Service

rds
  1. Help Center
  2. Relational Database Service
  3. API Reference
  4. API v3 (Recommended)
  5. Backup and Restoration
  6. Querying the Recovery Time Period

Querying the Recovery Time Period

Function

This API is used to query the recovery time period of a DB instance.

URI

  • URI format

    PATH: /{version_id}/{project_id}/instances/{instance_id}/restore-time

    Method: GET

  • Parameter description
    Table 1 Parameter description

    Name

    Mandatory

    Description

    version_id

    Yes

    Specifies the API version. It is case-sensitive and the value is v3.

    project_id

    Yes

    Specifies the project ID of a tenant in a region.

    instance_id

    Yes

    Specifies the DB instance ID.

Request

None

Normal Response

  • Parameter description
    Table 2 Parameter description

    Name

    Type

    Description

    restore_time

    List data structure

    Indicates the list of the recovery time period.

    For details, see Table 3.

    Table 3 restore_time field data structure description

    Name

    Type

    Description

    start_time

    Int

    Indicates the start time of the recovery time period in the UNIX timestamp format. The unit is millisecond and the time zone is UTC.

    end_time

    Int

    Indicates the end time of the recovery time period in the UNIX timestamp format. The unit is millisecond and the time zone is UTC.

  • Response example
    { 
    	"restore_time": [ 
    		{ 
    			"start_time": 1532001446987, 
    			"end_time": 1532742139000 
    		} 
    	] 
    }

Abnormal Response

For details, see Abnormal Request Results.