调用DescribeLogBackups接口查看日志备份列表。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeLogBackups

系统规定参数。取值:DescribeLogBackups

DBInstanceId String gp-bp12ga6v69h86****

实例ID。

说明 您可以调用DescribeDBInstances接口查看目标地域下所有的AnalyticDB PostgreSQL实例的实例ID。
StartTime String 2022-12-12T02:00Z

查询开始时间。格式: yyyy-MM-ddTHH:mmZ(UTC时间)。

EndTime String 2022-12-12T03:00Z

查询结束时间,需要大于查询开始时间。格式:yyyy-MM-ddTHH:mmZ(UTC时间)。

PageSize Integer 30

每页记录数,取值:

  • 30
  • 50
  • 100

默认值:30

PageNumber Integer 1

页码,取值:大于0且不超过Integer的最大值。默认值:1

返回数据

名称 类型 示例值 描述
TotalLogSize Long 386748

符合时间范围内的总日志大小,单位为Byte。

PageSize Integer 30

本页备份集个数。

PageNumber Integer 1

页码。

RequestId String 24B9FCAF-2CBC-51C3-B563-F1C70D750187

请求ID。

TotalCount Integer 5

总记录数。

Items Array of Backup

备份集列表。

LogFileSize Long 77350

备份日志文件大小,单位:Byte。

LogTime String 2022-12-12T02:14:26Z

日志时间戳。

SegmentName String segment-0

节点名称。

LogFileName String 000000010000000400000012

日志文件名(OSS路径)。

DBInstanceId String gp-bp12ga6v69h86****-master

实例的Master节点ID。

BackupId String 12413721782

备份集ID。

示例

请求示例

http(s)://gpdb.aliyuncs.com/?Action=DescribeLogBackups
&DBInstanceId=gp-bp12ga6v69h86****
&StartTime=2022-12-12T02:00Z
&EndTime=2022-12-12T03:00Z
&PageSize=30
&PageNumber=1
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeLogBackupsResponse>
    <TotalCount>5</TotalCount>
    <PageSize>30</PageSize>
    <RequestId>24B9FCAF-2CBC-51C3-B563-F1C70D750187</RequestId>
    <PageNumber>1</PageNumber>
    <Items>
        <SegmentName>segment-0</SegmentName>
        <DBInstanceId>gp-bp12ga6v69h86****-master</DBInstanceId>
        <LogTime>2022-12-12T02:14:26Z</LogTime>
        <LogFileSize>77350</LogFileSize>
        <BackupId>12413721782</BackupId>
        <LogFileName>000000010000000400000012</LogFileName>
    </Items>
    <TotalLogSize>386748</TotalLogSize>
</DescribeLogBackupsResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 5,
  "PageSize" : 30,
  "RequestId" : "24B9FCAF-2CBC-51C3-B563-F1C70D750187",
  "PageNumber" : 1,
  "Items" : [ {
    "SegmentName" : "segment-0",
    "DBInstanceId" : "gp-bp12ga6v69h86****-master",
    "LogTime" : "2022-12-12T02:14:26Z",
    "LogFileSize" : 77350,
    "BackupId" : "12413721782",
    "LogFileName" : "000000010000000400000012"
  } ],
  "TotalLogSize" : 386748
}

错误码

访问错误中心查看更多错误码。