Setting an Automated Backup Policy¶
Function¶
This API is used to set an automated backup policy.
URI¶
URI format
PATH: /rds/v1/{project_id}/instances/{instanceId}/backups/policy
Method: PUT
Parameter description
Table 1 Parameter description¶ Name
Mandatory
Description
project_id
Yes
Specifies the project ID of a tenant in a region.
instanceId
Yes
Specifies the primary node ID of the DB instance.
Note
This field is not the DB instance ID. You are advised to use API v3 and the DB instance ID to perform related operations.
Request¶
Parameter description
Table 2 Parameter description¶ Name
Mandatory
Type
Description
policy
Yes
Dictionary data structure. For details, see Table 3.
Specifies the backup policy objects, including the backup retention period (days) and backup start time.
Table 3 policy field data structure description¶ Name
Mandatory
Type
Description
keepday
Yes
Int
Specifies the number of days to retain the generated backup files.
The value range is from 0 to 732. If this parameter is 0, the automated backup policy is not set. To extend the retention period, contact customer service. Automated backups can be retained for up to 2562 days.
starttime
Yes
String
Indicates the backup start time that has been set.
Valid value:
The value cannot be empty. The format can be hh:mm:ss or hh:mm and must be valid. The time is in the UTC format.
Request example
{ "policy": { "keepday": 7, "starttime": "00:00:00" } }
Normal Response¶
{}
Abnormal Response¶
For details, see Abnormal Request Results.