You need to enable JavaScript to run this app.
导航
云数据库 MySQL 版
  • 文档首页
    • /
  • 云数据库 MySQL 版

DescribeBinlogFiles

最近更新时间：2023.12.04 15:06:14

首次发布时间：2023.05.23 18:46:16

我的收藏

调用 DescribeBinlogFiles 接口查询 Binlog 备份文件。

请求参数

名称类型是否必选示例值描述
InstanceIdString是mysql-ce48081d****实例 ID。
StartTimeString是2022-06-01T15:00:00Z查询开始时间。格式为 yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。
EndTimeString是2022-06-20T15:00:00Z查询结束时间。格式为 yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。查询结束时间应晚于查询开始时间，且时间范围不大于 15 天。
ContextString否rds/mysql-603e30e6bd95/mysql-603e30e6bd95-0/binlog/binlog-1683409831637741726-binlog.000041索引信息，用于指定此次返回的备份信息的起始位置。指定后，会从 Context 指定的备份文件的下一个开始返回备份信息。
BackupFileNumberInteger否10备份文件数量，默认值为 10，最大值为 500。

返回参数

名称类型示例值描述
TotalInteger9备份文件个数。
ContextStringrds/mysql-603e30e6****/mysql-603e30e6****-0/binlog/binlog-1683547416864283247-binlog.000081索引信息。以最后一个备份文件作为索引进行返回。可作为下一次请求的参数，加载更多时选择。

BinlogFiles

Array of BinlogFilesObject

[
{
"BackupStatus": "Success",
"DownloadStatus": "NotDownload",
"FileName": "binlog-1683269409494461068-binlog.000001",
"FileSize": 169,
"UpdateTime": "2023-05-05T07:13:33.000Z"
}
]

备份列表。 更多关于 BinlogFiles 的详细信息，请参见数据结构。

请求示例

POST /?Action=DescribeBinlogFiles&Version=2022-01-01 HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: rds.volcengineapi.com
X-Date: 20211202T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZjMzY/20211202/cn-beijing/rds_mysql/request, SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645aff88

{
    "InstanceId": "mysql-603e30e6****",
    "StartTime": "2023-05-05T10:49:59Z",
    "EndTime": "2023-05-17T10:49:59Z",
    "BackupFileNumber": 5
}

返回示例

正常返回示例

{
    "ResponseMetadata": {
        "RequestId": "202305082058412F29109E3B606793D1F7",
        "Action": "DescribeBinlogFiles",
        "Version": "2022-01-01",
        "Service": "rds_mysql",
        "Region": "cn-beijing"
    },
    "Result": {
        "BinlogFiles": [
            {
		            "BackupRegion": "cn-beijing",
                "BackupStatus": "Success",
                "DownloadStatus": "NotDownload",
                "FileName": "binlog-1683269409494461068-binlog.000001",
                "FileSize": 169,
                "UpdateTime": "2023-05-05T07:13:33.000Z"
            },
            {
            		"BackupRegion": "cn-beijing",
                "BackupStatus": "Success",
                "DownloadStatus": "NotDownload",
                "FileName": "binlog-1683269413387493959-binlog.000002",
                "FileSize": 3011622,
                "UpdateTime": "2023-05-05T07:13:33.000Z"
            },
            {
            		"BackupRegion": "cn-beijing",
                "BackupStatus": "Success",
                "DownloadStatus": "NotDownload",
                "FileName": "binlog-1683273026662514347-binlog.000003",
                "FileSize": 1123725,
                "UpdateTime": "2023-05-05T07:50:28.000Z"
            },
            {
                "BackupRegion": "cn-beijing",
                "BackupStatus": "Success",
                "DownloadStatus": "NotDownload",
                "FileName": "binlog-1683276626773091536-binlog.000004",
                "FileSize": 1140025,
                "UpdateTime": "2023-05-05T08:50:29.000Z"
            },
            {
                "BackupRegion": "cn-beijing",
                "BackupStatus": "Success",
                "DownloadStatus": "NotDownload",
                "FileName": "binlog-1683280226892626614-binlog.000005",
                "FileSize": 1140087,
                "UpdateTime": "2023-05-05T09:50:27.000Z"
            }
        ],
        "Context": "rds/mysql-603e30e6****/mysql-603e30e6****-0/binlog/binlog-1683280226892626614-binlog.000005",
        "Total": 5
    }
}

错误码

更多详情，请参见错误码。