Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com> Co-authored-by: Wang , Deng Ke <wangdengke2@huawei.com> Co-committed-by: Wang , Deng Ke <wangdengke2@huawei.com>
9.8 KiB
Obtaining an Automated Backup Policy
Function
This API is used to obtain an automated backup policy.
- Learn how to authorize and authenticate this API before using it.
- Before calling this API, obtain the required region and endpoint.
URI
- URI format
GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/backups/policy
- Example
https://rds.eu-de.otc.t-systems.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/backups/policy
- Parameter description
Table 1 Parameter description Name
Mandatory
Description
project_id
Yes
Specifies the project ID of a tenant in a region.
For details about how to obtain the project ID, see Obtaining a Project ID.
instance_id
Yes
Specifies the DB instance ID.
Request
None
Response
- Normal response
Table 2 Parameter description Name
Type
Description
backup_policy
Object
Indicates the backup policy objects, including the backup retention period (days) and backup start time.
For details, see Table 3.
Table 3 backup_policy field data structure description Name
Type
Description
keep_days
Integer
Indicates the number of days to retain the backup files.
start_time
String
Indicates the backup time window. Automated backups will be triggered during the backup time window.
period
String
Indicates the backup cycle configuration. Data will be automatically backed up on the selected days every week.
- Example normal response
When the automated backup policy is disabled:
{ "backup_policy": { "keep_days": 0 } }
When the automated backup policy is enabled:
{ "backup_policy": { "keep_days": 7, "start_time": "19:00-20:00", "period": "1,2" } }
- Abnormal Response
For details, see Abnormal Request Results.
Status Code
For details, see Status Codes.
Error Code
For details, see Error Codes.