すべてのプロダクト
Search
ドキュメントセンター

PolarDB:DescribeOpenBackupSet

最終更新日:Sep 10, 2026

インスタンスのトポロジー情報と商用バックアップセットのダウンロードリンクを公開し、クラウドインスタンスのオフライン復元をサポートします。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

RegionId

string

任意

インスタンスのリージョン ID。

cn-hangzhou

DBInstanceName

string

必須

インスタンス名。

pxc-********

RestoreTime

string

任意

インスタンスを復元するポイントインタイム。時間は yyyy-MM-ddTHH:mm:ssZ フォーマット (協定世界時 (UTC)) で指定します。

2024-10-14T00:00:00Z

レスポンスフィールド

フィールド

型

説明

例

object

レスポンスのスキーマ。

RequestId

string

リクエスト ID。

FEA5DC20-6D8A-5979-97AA-FC57546ADC20

Data

any

インスタンスのトポロジー情報とバックアップセットのダウンロードリンクを含む構造体。

説明

canBinlogRecoverToTimeUTC フィールドは、バックアップセットを復元できるポイントインタイムを示します。このポイントインタイムは入力パラメーター RestoreTime に近い値です。DN の最新のローカル binlog がまだアップロードされていない場合があるため、目的のポイントインタイムへの復元は保証されません。

{"gmsBackupSet": {"pubFullDownloadUrl": "https://xxxxx","dnName": "pxc-xdb-m-xxxxxx","hostInstanceId": 0001,"binlogs": [],"backupEndTime": "2024-10-21T10:11:56Z","backupLinkExpiredTime": "2024-10-23T06:13:54Z","dnBackupSetId": "00088","notCompletedBinlogs": [],"commitIndex": "15249275","innerFullDownloadUrl": "http://xxxxx","backupStartTime": "2024-10-21T10:09:20Z","backupSetSize": 526118912},"dnBackupSets": [],"insName": "pxc-xxxxx","backupSetId": "cb-xxxxx","canBinlogRecoverToTime": 1729567925000,"backupEndTime": "2024-10-21T10:12:16Z","canBinlogRecoverToTimeUTC": "2024-10-22T03:32:05Z","canBackupMinRecoverToTimeUTC": "2024-10-21T10:11:56Z","pitrInvalid": false,"backupStartTime": "2024-10-21T10:09:16Z","canBackupMinRecoverToTime": 1729505516000}

説明

PolarDB-X コミュニティエディションのバックアップセットインポートツールは、Data フィールドの構造体を使用して、コミュニティエディションの復元に必要な構造にバックアップセットをインポートします。

例

成功レスポンス

JSONJSON

{
  "RequestId": "FEA5DC20-6D8A-5979-97AA-FC57546ADC20",
  "Data": "{\"gmsBackupSet\": {\"pubFullDownloadUrl\": \"https://xxxxx\",\"dnName\": \"pxc-xdb-m-xxxxxx\",\"hostInstanceId\": 0001,\"binlogs\": [],\"backupEndTime\": \"2024-10-21T10:11:56Z\",\"backupLinkExpiredTime\": \"2024-10-23T06:13:54Z\",\"dnBackupSetId\": \"00088\",\"notCompletedBinlogs\": [],\"commitIndex\": \"15249275\",\"innerFullDownloadUrl\": \"http://xxxxx\",\"backupStartTime\": \"2024-10-21T10:09:20Z\",\"backupSetSize\": 526118912},\"dnBackupSets\": [],\"insName\": \"pxc-xxxxx\",\"backupSetId\": \"cb-xxxxx\",\"canBinlogRecoverToTime\": 1729567925000,\"backupEndTime\": \"2024-10-21T10:12:16Z\",\"canBinlogRecoverToTimeUTC\": \"2024-10-22T03:32:05Z\",\"canBackupMinRecoverToTimeUTC\": \"2024-10-21T10:11:56Z\",\"pitrInvalid\": false,\"backupStartTime\": \"2024-10-21T10:09:16Z\",\"canBackupMinRecoverToTime\": 1729505516000}"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。