调用UpdateUserBackupFile变更用户备份的备注信息和保留时长。
说明 用户备份即MySQL自建库的全量备份数据，您可以将用户备份恢复至云上。更多信息，请参见自建MySQL 5.7数据库全量上云。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | UpdateUserBackupFile |
系统规定参数。取值：UpdateUserBackupFile。 |
| BackupId | String | 是 | b-kwwvr7v8t7of******** |
用户备份ID。可调用ListUserBackupFiles获取。 |
| RegionId | String | 是 | cn-hangzhou |
地域ID。可调用DescribeRegions获取。 |
| Comment | String | 否 | CommentTest |
需要修改的备注信息。 |
| Retention | Integer | 否 | 30 |
需要修改的用户备份保留时长。单位：天。取值为大于0的Integer类型整数。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| BackupId | String | b-g14d0m772f7b******** |
用户备份ID。 |
| RequestId | String | 6A236067-4727-4B42-92CF-734E417ED69A |
请求ID。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=UpdateUserBackupFile
&BackupId=b-g14d0m772f7b********
&RegionId=cn-hangzhou
&Comment=CommentTest
&Retention=30
&<公共请求参数>正常返回示例
XML格式
<UpdateUserBackupFileResponse>
<RequestId>6A236067-4727-4B42-92CF-734E417ED69A</RequestId>
<BackupId>b-g14d0m772f7b********</BackupId>
</UpdateUserBackupFileResponse>JSON格式
{
"RequestId": "6A236067-4727-4B42-92CF-734E417ED69A",
"BackupId": "b-g14d0m772f7b********"
}错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidParam | The specified parameter is invalid. | 无效参数 |
| 400 | OperationDenied.Product | The product code is not supported. | 不支持产品代码 |
访问错误中心查看更多错误码。