すべてのリストア操作の表示
/paas/api/v1.1/instancemgmt/{identityDomainId}/services/jaas/instances/{serviceId}/restoredbackups
デフォルトでは、成功したリストア操作のみが含まれます。 成功したリストア操作と失敗したリストア操作の両方を含めるには、?includeFailed
問合せパラメータをtrue
に設定します。
注意: 従来のパス/paas/service/jcs/api/v1.1/instances/{identityDomainId}/{serviceId}/restoredbackupsは推奨されていませんが、近いうちに引き続きサポートされます。 ただし、今後非推奨のURL構造がサポートされなくなった場合に、中断を最小限に抑えるために、新しいパスを使用するようにアプリケーションを移行することをお勧めします。
リクエスト
- identityDomainId
-
型:
string
必須:true
Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。
- serviceId
型:string
必須:true
Oracle Java Cloud Serviceインスタンスの名前。
- includeFailed
-
型:
boolean
失敗したリストア操作を含める(true
)か、除外する(false
)かを指定するフラグ。 デフォルトはfalse
です。
- X-ID-TENANT-NAME
-
型:
string
必須:true
Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。
レスポンス
- application/json
- restoreHistory
-
型:
array
restoreHistory完了したすべてのリストア操作をグループ化します。 - restoreInProgress
-
型:
array
restoreInProgress現在進行中のリストア操作がある場合、その詳細をグループ化します。
- backupDate
-
型:
string
バックアップの日時。 - backupId
-
型:
string
バックアップID。 - configDataIncluded
-
型:
boolean
構成データがリストアされたことを指定するフラグ(true
)。 - databaseIncluded
-
型:
boolean
この属性は、Oracle Public Cloudにのみ適用されます。 関連付けられたDatabase Cloud Serviceデータベース・デプロイメントのデータベース・ファイルを指定するフラグは、Oracle Java Cloud Serviceインスタンスのリストア操作に含まれませんでした(false
)。 データベース・バックアップが実行された場合、データベース・ファイルを手動でリストアする必要があります。 - jobId
-
型:
string
リストア操作のジョブID。 - notes
-
型:
string
リストア操作に関する追加情報を提供する自由形式のテキスト。 - otdIncluded
-
型:
boolean
ロード・バランサがリストアされたかどうかを指定するフラグ(true
)。 OTDがプロビジョニングされず、バックアップ時にプロビジョニングされなかった場合、値はfalse
です。 - recoveryCompleteDate
-
型:
string
リストア操作の完了日時。 この情報は、進行中のリストアの場合は表示されません。 - recoveryStartDate
-
型:
string
リストア操作が開始された日時。 - restoreBinariesType
-
型:
string
バイナリのリストアが明示的に呼び出されたか(resetBinaries
はtrue
)、パッチ・ロールバックの一部として呼び出されたかを示すバイナリ・リストアのタイプ。 有効な値は、Reset
またはRollback
です。staticDataIncluded
がtrue
の場合、正確な静的リストア・タイプが表示されます。 - staticDataIncluded
-
型:
boolean
リストア操作に静的バイナリ・ファイルが組み込まれていない(false
)か、組み込まれている(true
)ことを指定するフラグ。 - status
-
型:
string
操作の状態 有効な値は、Completed
、Failed
またはIn Progress
です。 - statusDetails
-
型:
string
システム・メッセージの履歴。 各メッセージは、省略記号(...)で区切られます。
例
次の例では、cURLを使用してRESTリソースに対するGETリクエストを発行することによってOracle Java Cloud Serviceインスタンスのすべてのリストア操作を表示する方法を示しています。
注意: この例のコマンドでは、URL構造https://rest_server_url/resource-pathが使用されています。ここで、rest_server_urlはアイデンティティ・ドメインまたはテナント名を問い合せるためのOracle Public CloudまたはOracle Cloud MachineのRESTサーバーです。 Oracle Public CloudまたはOracle Cloud Machineに使用する適切なURL構造の詳細は、リクエストの送信を参照してください。
cURLコマンド
curl -i -X GET -u username:userPassword1! -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/api/v1.1/instancemgmt/ExampleIdentityDomain/services/jaas/instances/ExampleInstance/restoredbackups
レスポンス・ヘッダーの例
レスポンス・ヘッダーの例を次に示します。
HTTP/1.1 200 OK Date: Tue, 08 Dec 2015 23:44:33 GMT Transfer-Encoding: chunked Content-Type: application/json
レスポンス本文の例(Oracle Public Cloud)
JSON形式のレスポンス本文の例を次に示します。
{ "restoreHistory":[ { "backupId":"1449332100032", "backupDate":"Sat Dec 05 16:15:00 GMT 2015", "jobId":"8226", "recoveryStartDate":"Sat Dec 05 23:39:02 GMT 2015", "recoveryCompleteDate":"Sat Dec 05 23:57:53 GMT 2015", "status":"Completed", "statusDetails":"The backup archive already exists in the block storage and does not need to be downloaded from the Oracle Storage Cloud Service container... Submitted the restoration precheck for remote execution... Restoration precheck passed...Disabled the load balancer...Submitted the restoration for remote execution... These managed servers were added after the backup was created: ['exampleinstance-wls-3']. The instance will be scaled in with force=true to remove these managed servers...Stopping WebLogic Server... Stopped WebLogic Server...Restoring the configuration data for WebLogic Server administration server on host exampleinstance-wls-1... Restored the configuration data for WebLogic Server administration server on host exampleinstance-wls-1...Restoring Oracle Traffic Director on host exampleinstance-lb-1... Restored Oracle Traffic Director on host exampleinstance-lb-1...Restoring the configuration data for WebLogic Server administration server on host exampleinstance-wls-2... Restored the configuration data for WebLogic Server administration server on host exampleinstance-wls-2...Starting WebLogic Server... Started WebLogic Server...Unlocked the WebLogic Server domain configuration... Completed the restoration...Enabled the load balancer...Validated the load balancer", "staticDataIncluded":false, "configDataIncluded":true, "otdIncluded":true, "databaseIncluded":false }], "restoreInProgress": { "backupId":"1449340039298", "backupDate":"Sat Dec 05 18:27:19 GMT 2015", "jobId":"8386", "recoveryStartDate":"Tue Dec 08 23:43:49 GMT 2015", "status":"In Progress", "staticDataIncluded":true, "restoreBinariesType":"reset", "configDataIncluded":true, "otdIncluded":true, "databaseIncluded":false, "notes":"Restore and reset binary files" } }
レスポンス本文の例(Oracle Cloud Machine)
JSON形式のレスポンス本文の例を次に示します。
{ "restoreHistory":[ { "backupId":"1472840593076", "backupDate":"Fri Sep 02 18:23:13 GMT 2016", "jobId":"841", "recoveryStartDate":"Fri Sep 02 18:43:15 GMT 2016", "recoveryCompleteDate":"Fri Sep 02 18:52:03 GMT 2016", "status":"Completed", "statusDetails":"Downloading the MWH archive from the remote filesystem...Downloaded the MWH archive from the Oracle Storage Cloud Service container... The backup archive already exists in the block storage and does not need to be downloaded from the Oracle Storage Cloud Service container... Submitted the restoration precheck for remote execution...Restoration precheck passed... Submitted the restoration for remote execution...Stopping WebLogic Server... Stopped WebLogic Server...Restoring the binary data for WebLogic Server administration server on host exampleinstance-wls-1... JDK home restoration is not requested...Restored the binary data for WebLogic Server administration server on host exampleinstance-wls-1... Restoring the binary data for WebLogic Server administration server on host exampleinstance-wls-2... JDK home restoration is not requested...Restored the binary data for WebLogic Server administration server on host exampleinstance-wls-2... Starting WebLogic Server...Started WebLogic Server...Unlocked the WebLogic Server domain configuration... Completed the restoration", "staticDataIncluded":true, "restoreBinariesType":"rollback", "configDataIncluded":false, "otdIncluded":false, "databaseIncluded":false, "notes":"Roll back PSU" }, { "backupId":"1472874600045", "backupDate":"Sat Sep 03 03:50:00 GMT 2016", "jobId":"1267", "recoveryStartDate":"Wed Sep 07 22:28:33 GMT 2016", "recoveryCompleteDate":"Wed Sep 07 22:39:21 GMT 2016", "status":"Completed", "statusDetails":"The backup archive already exists in the block storage and does not need to be downloaded from the Oracle Storage Cloud Service container... Submitted the restoration precheck for remote execution...Restoration precheck passed... Submitted the restoration for remote execution...Stopping WebLogic Server...Stopped WebLogic Server... Restoring the configuration data for WebLogic Server administration server on host exampleinstance-wls-1... Restored the configuration data for WebLogic Server administration server on host exampleinstance-wls-1... Restoring the configuration data for WebLogic Server administration server on host exampleinstance-wls-2... Restored the configuration data for WebLogic Server administration server on host exampleinstance-wls-2... Starting WebLogic Server...Started WebLogic Server...Unlocked the WebLogic Server domain configuration... Completed the restoration", "staticDataIncluded":false, "configDataIncluded":true, "otdIncluded":false, "databaseIncluded":false, "notes":"restore using default values" } ] }