Modifies a backup policy.
Operation description
If you modify a backup policy, the modification takes effect on all data sources that are bound to the backup policy. Proceed with caution.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
PolicyId | string | No | The ID of the backup policy. | po-000************viy |
PolicyName | string | No | The name of the backup policy. | Daily Local Backup + Remote Backup |
PolicyDescription | string | No | The description of the backup policy. | Data is backed up at 10:00:00 every day and replicated to the China (Shanghai) region for geo-redundancy. |
Rules | object [] | No | The rules in the backup policy. | |
RuleId | string | No | The rule ID. | rule-000************rof |
RuleType | string | No | The type of the rule. Each backup policy must have at least one rule of the BACKUP type and only one rule of the TRANSITION type.
| BACKUP |
Schedule | string | No | This parameter is required only if the RuleType parameter is set to BACKUP. This parameter specifies the backup schedule settings. Format:
| I|1648647166|P1D |
BackupType | string | No | This parameter is required only if the RuleType parameter is set to BACKUP. This parameter specifies the backup type. Valid value: COMPLETE, which indicates full backup. | COMPLETE |
Retention | long | No | This parameter is required only if the RuleType parameter is set to TRANSITION or REPLICATION.
| 7 |
ReplicationRegionId | string | No | This parameter is required only if the RuleType parameter is set to REPLICATION. This parameter specifies the ID of the destination region. | cn-shanghai |
ArchiveDays | long | No | This parameter is required only if the RuleType parameter is set to TRANSITION. This parameter specifies the time when data is dumped from a backup vault to an archive vault. Unit: days. | 90 |
ColdArchiveDays | long | No | This parameter is required only if the RuleType parameter is set to TRANSITION. This parameter specifies the time when data is dumped from a backup vault to a cold archive vault. Unit: days. | 365 |
RetentionRules | object [] | No | This parameter is required only if the RuleType parameter is set to TRANSITION. This parameter specifies the special retention rules. | |
AdvancedRetentionType | string | No | The type of the special retention rule. Valid values:
| YEARLY |
WhichSnapshot | long | No | Specifies which backup is retained based on the special retention rule. Only the first backup can be retained. | 1 |
Retention | long | No | The retention period of the backup data. Minimum value: 1. Unit: days. | 365 |
KeepLatestSnapshots | long | No | Specifies whether to enable the feature of keeping at least one backup version. Valid values:
| 1 |
Response parameters
Examples
Sample success responses
JSON
format
{
"Success": true,
"Code": "200",
"Message": "successful",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
Error codes
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation | ||
---|---|---|---|---|
2024-02-21 | The internal configuration of the API is changed, but the call is not affected | see changesets | ||
| ||||
2023-03-29 | The internal configuration of the API is changed, but the call is not affected | see changesets | ||
|