调用DescribeCrossRegionLogBackupFiles接口查询跨地域日志备份文件列表。
查询跨地域数据备份文件请参见DescribeCrossRegionBackups。
仅适用于如下实例类型:
- RDS MySQL:支持的实例版本请参见MySQL跨地域备份。
- RDS SQL Server:支持的实例版本请参见SQL Server跨地域备份。
- RDS PostgreSQL :支持的实例版本请参见PostgreSQL跨地域备份。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeCrossRegionLogBackupFiles |
系统规定参数,取值:DescribeCrossRegionLogBackupFiles。 |
DBInstanceId | String | 是 | rm-uf6wjk5xxxxxxxxxx |
实例ID。 |
EndTime | String | 是 | 2019-06-15T12:10:00Z |
查询结束时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
RegionId | String | 是 | cn-hangzhou |
实例所在地域ID。可以通过接口DescribeRegions查看地域ID。 |
StartTime | String | 是 | 2019-05-30T12:10:00Z |
查询开始时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
CrossBackupRegion | String | 否 | cn-shanghai |
跨地域备份目的地域ID。可以通过接口DescribeCrossRegionBackupDBInstance查看地域ID。 |
PageSize | Integer | 否 | 30 |
每页记录数,取值:
默认值:30。 |
PageNumber | Integer | 否 | 1 |
页码,取值:大于0且不超过Integer的最大值。 默认值:1。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
DBInstanceId | String | rm-uf6wjk5xxxxxxxxxx |
实例ID。 |
StartTime | String | 2019-05-30T12:10:00Z |
查询开始时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
EndTime | String | 2019-06-15T12:10:00Z |
查询结束时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
TotalRecordCount | Integer | 100 |
总记录数。 |
PageNumber | Integer | 1 |
页码,取值:大于0且不超过Integer的最大值。 默认值:1。 |
PageRecordCount | Integer | 30 |
本页备份文件个数。 |
RegionId | String | cn-hangzhou |
实例所在地域ID。 |
RequestId | String | DAC241E8-28E6-49DA-BFB0-B2DD090885C1 |
请求ID。 |
Items | Array of Item |
跨地域日志备份列表。 |
|
Item | |||
CrossBackupRegion | String | cn-shanghai |
跨地域备份目的地域ID。 |
CrossDownloadLink | String | http://rdsddrlog-zb.oss-cn-zhangjiakou.aliyuncs.com/xxxxx |
跨地域日志备份外网下载链接。 |
CrossIntranetDownloadLink | String | http://rdsddrlog-zb.oss-cn-zhangjiakou-internal.aliyuncs.com/xxxxx |
跨地域日志备份内网下载链接。 |
CrossLogBackupId | Integer | 14567 |
跨地域日志备份文件ID。 |
CrossLogBackupSize | Long | 5312836 |
跨地域日志备份文件大小,单位:Byte。 |
InstanceId | Integer | 8161055 |
实例编号。 |
LinkExpiredTime | String | 2019-06-30T15:00:00Z |
下载链接过期时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
LogBeginTime | String | 2019-05-30T12:10:00Z |
跨地域日志备份文件记录的开始时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
LogEndTime | String | 2019-05-30T20:10:00Z |
跨地域日志备份文件记录的结束时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
LogFileName | String | cn-hangzhou_rm-bpxxxxx_7198739_mysql-bin.000230 |
跨地域日志备份文件名称。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=DescribeCrossRegionLogBackupFiles
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&StartTime=2019-05-30T12:10:00Z
&EndTime=2019-06-15T12:10:00Z
&<公共请求参数>
正常返回示例
XML
格式
<DescribeCrossRegionLogBackupFilesResponse>
<Items>
<Item>
<LinkExpiredTime>2019-06-02T07:36:18Z</LinkExpiredTime>
<CrossBackupRegion>cn-zhangjiakou</CrossBackupRegion>
<LogEndTime>2019-06-01T06:11:49Z</LogEndTime>
<LogBeginTime>2019-06-01T00:11:44Z</LogBeginTime>
<InstanceId>7198743</InstanceId>
<CrossLogBackupSize>770014</CrossLogBackupSize>
<CrossDownloadLink>http://rdsddrlog-zb.oss-cn-zhangjiakou.aliyuncs.com/xxxxxx</CrossDownloadLink>
<CrossIntranetDownloadLink>http://rdsddrlog-zb.oss-cn-zhangjiakou-internal.aliyuncs.com/xxxxx</CrossIntranetDownloadLink>
</Item>
</Items>
<PageNumber>1</PageNumber>
<TotalRecordCount>52</TotalRecordCount>
<DBInstanceId>rm-xxxxx</DBInstanceId>
<RegionId>cn-hangzhou</RegionId>
<RequestId>A9723BCE-F32F-4F05-9922-8371C0842FA7</RequestId>
<EndTime>EndTime=2019-06-15T12:10:00Z</EndTime>
<StartTime>2019-05-30T12:10:00Z</StartTime>
<PageRecordCount>10</PageRecordCount>
</DescribeCrossRegionLogBackupFilesResponse>
JSON
格式
{"Items":{
"Item":[{
"LinkExpiredTime":"2019-06-02T07:36:18Z",
"CrossBackupRegion":"cn-zhangjiakou",
"LogEndTime":"2019-06-01T06:11:49Z",
"LogBeginTime":"2019-06-01T00:11:44Z",
"InstanceId":7198743,
"CrossLogBackupSize":770014,
"CrossDownloadLink":"http://rdsddrlog-zb.oss-cn-zhangjiakou.aliyuncs.com/xxxxxx",
"CrossIntranetDownloadLink":"http://rdsddrlog-zb.oss-cn-zhangjiakou-internal.aliyuncs.com/xxxxx"}
]},
"PageNumber":1,
"TotalRecordCount":52,
"DBInstanceId":"rm-xxxxx",
"RegionId":"cn-hangzhou",
"RequestId":"A9723BCE-F32F-4F05-9922-8371C0842FA7",
"EndTime":"EndTime=2019-06-15T12:10:00Z",
"StartTime":"2019-05-30T12:10:00Z",
"PageRecordCount":10}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
404 | InvalidDBInstance.NotFound | Specified instance does not exist or not support. | 指定的实例不存在 |
400 | InvalidRegion.Format | Specified Region is not valid. | 指定的region不合法 |
400 | InvalidStartTime.Format | Specified start time is not valid. | 指定的起始时间无效。 |
400 | InvalidEndTime.Format | Specified end time is not valid. | 指定结束时间无效。 |
访问错误中心查看更多错误码。