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

:DescribeHanaBackupsAsync

最終更新日:Dec 23, 2025

指定された条件に一致する 1 つ以上の SAP HANA バックアップをクエリします。

操作説明

DescribeHanaBackupsAsync 操作を呼び出して、指定された条件に一致する SAP HANA バックアップを照会した後、DescribeTask 操作を呼び出して最終結果を取得する必要があります。

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター

必須 / 任意

説明

VaultId

string

任意

バックアップボールトの ID。

v-000270c******pi81

ClusterId

string

必須

SAP HANA インスタンスの ID。

cl-00098******yuqvu

PageNumber

integer

任意

ページ番号。ページは 1 から始まります。デフォルト値:1。

1

PageSize

integer

任意

1 ページあたりのエントリ数。有効値:1~99。デフォルト値:10。

10

DatabaseName

string

任意

データベース名。

BPD

Mode

string

任意

リカバリモード。有効な値:

  • RECOVERY_TO_MOST_RECENT:データベースがバックアップされた最新の利用可能な状態にデータベースをリストアします。

  • RECOVERY_TO_POINT_IN_TIME:データベースを指定された特定の時点にリストアします。

  • RECOVERY_TO_SPECIFIC_BACKUP:データベースを指定されたバックアップにリストアします。

  • RECOVERY_TO_LOG_POSITION:データベースを指定されたログポジションにリストアします。

RECOVERY_TO_SPECIFIC_BACKUP

RecoveryPointInTime

integer

任意

データベースをリストアする特定の時点。このパラメーターは、Mode パラメーターを RECOVERY_TO_POINT_IN_TIME に設定した場合にのみ有効です。Cloud Backup は、指定された特定の時点に最も近い状態にデータベースをリストアします。

1649851200

LogPosition

integer

任意

データベースをリストアするログポジション。このパラメーターは、Mode パラメーターを RECOVERY_TO_LOG_POSITION に設定した場合にのみ有効です。

0

VolumeId

integer

任意

リストアするボリュームの ID。このパラメーターは、Mode パラメーターを RECOVERY_TO_LOG_POSITION に設定した場合にのみ有効です。

0

SystemCopy

boolean

任意

データベースを別のインスタンスにリストアするかどうかを指定します。

  • true:データベースを別のインスタンスにリストアします。

  • false:データベースを同じインスタンス内にリストアします。

true

Source

string

任意

ソースシステムの名前。このパラメーターは、リストアするソースデータベースの名前を指定します。パラメーターは <ソースデータベース名>@SID の形式で設定する必要があります。

P01@HP1

SourceClusterId

string

任意

ソース SAP HANA インスタンスの ID。

cl-0000g3m******5cj

IncludeDifferential

boolean

任意

クエリ結果に差分バックアップを含めるかどうかを指定します。有効な値:

  • true:差分バックアップを含めます。

  • false:差分バックアップを除外します。

false

IncludeIncremental

boolean

任意

クエリ結果に増分バックアップを含めるかどうかを指定します。有効な値:

  • true:増分バックアップを含めます。

  • false:増分バックアップを除外します。

true

IncludeLog

boolean

任意

クエリ結果にログバックアップを含めるかどうかを指定します。有効な値:

  • true:ログバックアップを含めます。

  • false:ログバックアップを除外します。

true

UseBackint

boolean

任意

Backint を使用するかどうかを指定します。有効な値:

  • true:Backint を使用します。

  • false:Backint を使用しません。

false

ResourceGroupId

string

任意

リソースグループの ID。

rg-acfmz7mced2ldhy

レスポンスフィールド

フィールド

説明

object

Code

string

応答コード。ステータスコード 200 は、リクエストが成功したことを示します。

200

Message

string

返されるメッセージ。リクエストが成功した場合、「successful」が返されます。リクエストが失敗した場合、エラーメッセージが返されます。

successful

RequestId

string

リクエスト ID。

31F97233-8563-563D-8880-914B00EEA928

TaskId

string

非同期タスクの ID。DescribeTask 操作を呼び出して、非同期タスクの実行結果をクエリできます。

t-0006xmbplrqebt9dhkth

Success

boolean

リクエストが成功したかどうかを示します。有効な値:

  • true

  • false

true

成功レスポンス

JSONJSON

{
  "Code": "200",
  "Message": "successful",
  "RequestId": "31F97233-8563-563D-8880-914B00EEA928",
  "TaskId": "t-0006xmbplrqebt9dhkth",
  "Success": true
}

エラーコード

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

変更履歴

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