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
The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:
- Operation: the value that you can use in the Action element to specify the operation on a resource.
- Access level: the access level of each operation. The levels are read, write, and list.
- Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level,
All Resourcesis used in the Resource type column of the operation.
- Condition Key: the condition key that is defined by the cloud service.
- Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
| Operation | Access level | Resource type | Condition key | Associated operation |
|---|---|---|---|---|
| hbr:UpdatePolicyV2 | update | *All Resources * |
| none |
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 | array<object> | No | The rules in the backup policy. | |
| Rule | object | No | The details of the rule. | |
| 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. Valid values:
| 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 | array<object> | No | This parameter is required only if the value of the RuleType parameter is TRANSITION. This parameter specifies the special retention rules. | |
| object | No | The special retention rule. | ||
| 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 special retention period of backups. 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 |
| DataSourceFilters | array<object> | No | This parameter is required only if the RuleType parameter is set to TAG. This parameter specifies the data source filter rule. | |
| object | No | |||
| SourceType | string | No | The type of the data source. Valid values:
| UDM_ECS |
| DataSourceIds | array | No | This parameter is deprecated. | |
| string | No | This parameter is deprecated. | deprecated | |
| TagFilters | array<object> | No | This parameter is required only if the RuleType parameter is set to TAG. This parameter specifies the resource tag filter rule. | |
| object | No | |||
| Key | string | No | The tag key. | env |
| Value | string | No | The tag value. If you leave this parameter empty, the value is any value. | prod |
| Operator | string | No | The tag-based matching rule. Valid values:
| EQUAL |
| Immutable | boolean | No | This parameter is required only if the PolicyType parameter is set to UDM_ECS_ONLY. This parameter specifies whether to enable the immutable backup feature. | true |
Response parameters
Examples
Sample success responses
JSONformat
{
"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-11-13 | The internal configuration of the API is changed, but the call is not affected | View Change Details |
| 2024-09-25 | The internal configuration of the API is changed, but the call is not affected | View Change Details |
| 2024-04-18 | The internal configuration of the API is changed, but the call is not affected | View Change Details |
| 2024-02-21 | The internal configuration of the API is changed, but the call is not affected | View Change Details |
| 2023-03-29 | The internal configuration of the API is changed, but the call is not affected | View Change Details |