この API を呼び出して、バックアップログとダウンロードログをダウンロードするための URL を照会できます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、各種 SDK 用のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須/任意 説明
Action String 任意 DescribeBackupLogs

実行する API ( DescribeBackupLogs) を設定します。

DBClusterId String 必須 pc-bpxxxxxxx

管理するクラスターの ID を設定します。

EndTime String 必須 2020-02-12T15:00Z

照会する期間の終了時刻を設定します。 終了時刻は開始時刻よりも後の時刻とする必要があります。 時刻は ISO 8601 規格 (YYYY-MM-DDThh:mmZ 形式) で指定します。 時刻は UTC である必要があります。

StartTime String 必須 2020-02-01T15:00Z

照会する期間の開始時刻を設定します。 時刻は ISO 8601 規格 (YYYY-MM-DDThh:mmZ 形式) で指定します。 時刻は UTC である必要があります。

PageSize Integer 任意 30

返される各ページのエントリ数を設定します。 設定可能な値は以下のとおりです。

  • 30
  • 50
  • 100

デフォルト値:30

PageNumber Integer 任意 1

返されるページの番号を設定します。 ページは 1 ページ目から始まります。

デフォルト値は 1 です。

レスポンスパラメーター

パラメーター データ型 説明
RequestId String ADAC63DB-0691-4ECE-949A-FAEA686A1402

リクエストの ID を示します。

TotalRecordCount String 2

返されたエントリの総数を示します。

PageNumber String 1

返されたページのページ番号を示します。

PageRecordCount String 2

現在のページで返されたエントリの数を示します。

Items Array

返されたバックアップログの詳細を示します。

BackupLogId String 1111111111

バックアップログの ID を示します。

BackupLogName String ib_logfile1

バックアップログの名前を示します。

BackupLogStartTime String 2020-02-12T03:54:43Z

照会された期間の開始時刻を示します。 時刻は、ISO 8601 規格 (YYYY-MM-DD'T'HH:mm:ssZ 形式) に従っています。 時刻は UTC で表示されます。

BackupLogEndTime String 2020-02-12T03:55:31Z

照会された期間の終了時刻。 時刻は、ISO 8601 規格 (YYYY-MM-DD'T'HH:mm:ssZ 形式) に従っています。 時刻は UTC で表示されます。

BackupLogSize String 1073741824

バックアップログのサイズ (バイト単位)。

DownloadLink String http://xxxxxxxxxxx.oss-cn-hangzhou.aliyuncs.com

バックアップログダウンロード用のパブリック URL を示します。

IntranetDownloadLink String http://xxxxxxxxxxx.oss-cn-hangzhou-internal.aliyuncs.com

バックアップログダウンロード用の内部 URL を示します。

LinkExpiredTime String 2020-02-14T08:40:50Z

URL の有効期限 を示します。

コーディング例

リクエストの例

http(s)://[Endpoint]/? Action=DescribeBackupLogs
&DBClusterId=pc-bpxxxxxxx
&EndTime=2020-02-12T15:00Z
&StartTime=2020-02-01T15:00Z
&<共通リクエストパラメーター>

通常のレスポンス例

XML 形式

<TotalRecordCount>2</TotalRecordCount>
<PageRecordCount>2</PageRecordCount>
<RequestId>ADAC63DB-0691-4ECE-949A-FAEA686A1402</RequestId>
<PageNumber>1</PageNumber>
<Items>
    <BackupLog>
        <DownloadLink>http://xxxxxxxxxxx.oss-cn-hangzhou.aliyuncs.com</DownloadLink>
        <BackupLogEndTime>2020-02-12T03:55:31Z</BackupLogEndTime>
        <BackupLogId>1111111111</BackupLogId>
        <BackupLogName>ib_logfile1</BackupLogName>
        <LinkExpiredTime>2020-02-14T08:40:50Z</LinkExpiredTime>
        <BackupLogSize>1073741824</BackupLogSize>
        <IntranetDownloadLink>http://xxxxxxxxxxx.oss-cn-hangzhou-internal.aliyuncs.com</IntranetDownloadLink>
        <BackupLogStartTime>2020-02-12T03:54:43Z</BackupLogStartTime>
    </BackupLog>
    <BackupLog>
        <DownloadLink>http://xxxxxxxxxxx.oss-cn-hangzhou.aliyuncs.com</DownloadLink>
        <BackupLogEndTime>2020-02-12T03:54:45Z</BackupLogEndTime>
        <BackupLogId>2222222222</BackupLogId>
        <BackupLogName>ib_logfile2</BackupLogName>
        <LinkExpiredTime>2020-02-14T08:40:50Z</LinkExpiredTime>
        <BackupLogSize>1073741824</BackupLogSize>
        <IntranetDownloadLink>http://xxxxxxxxxxx.oss-cn-hangzhou-internal.aliyuncs.com</IntranetDownloadLink>
        <BackupLogStartTime>2020-02-12T03:53:55Z</BackupLogStartTime>
    </BackupLog>
</Items>

JSON 形式

{
  "TotalRecordCount": 2,
  "PageRecordCount": 2,
  "RequestId": "ADAC63DB-0691-4ECE-949A-FAEA686A1402",
  "PageNumber": 1,
  "Items": {
    "BackupLog": [
      {
        "DownloadLink": "http://xxxxxxxxxxx.oss-cn-hangzhou.aliyuncs.com",
        "BackupLogEndTime": "2020-02-12T03:55:31Z",
        "BackupLogId": 1111111111,
        "BackupLogName": "ib_logfile1",
        "LinkExpiredTime": "2020-02-14T08:40:50Z",
        "BackupLogSize": 1073741824,
        "IntranetDownloadLink": "http://xxxxxxxxxxx.oss-cn-hangzhou-internal.aliyuncs.com",
        "BackupLogStartTime": "2020-02-12T03:54:43Z"
      },
      {
        "DownloadLink": "http://xxxxxxxxxxx.oss-cn-hangzhou.aliyuncs.com",
        "BackupLogEndTime": "2020-02-12T03:54:45Z",
        "BackupLogId": 2222222222,
        "BackupLogName": "ib_logfile2",
        "LinkExpiredTime": "2020-02-14T08:40:50Z",
        "BackupLogSize": 1073741824,
        "IntranetDownloadLink": "http://xxxxxxxxxxx.oss-cn-hangzhou-internal.aliyuncs.com",
        "BackupLogStartTime": "2020-02-12T03:53:55Z"
      }
    ]
  }
}

エラーコード

エラーコードについては、「API エラーセンター」をご参照ください。