サービス・インスタンスのリストア
/paas/api/v1.1/instancemgmt/{identityDomainId}/services/jaas/instances/{serviceId}/restoredbackups
リストアするバックアップに含まれていない管理対象サーバーとCoherence管理対象サーバーがサービス・インスタンスに含まれている場合、インスタンスのリストアを試行する前に、そのインスタンスをスケール・インする必要があります。 標準的な管理対象サーバーに対しては、forceScaleIn
を使用して、リストアが成功した後にのみ、サービス・インスタンスが自動的にスケール・インされるようにできます。 Coherence管理対象サーバーに対しては、サービス・インスタンスのリストアを試行する前に、その特定の管理対象サーバーを管理する容量単位を削除する必要があります。 Coherenceデータ層上に構成された管理対象サーバーは、managedserver_x_DG
で識別されます。
Oracle Public Cloudの場合、Oracle Java Cloud Serviceの使用の次のトピックを参照してください。
- バックアップの内容およびどのようなファイルをリストアできるかの詳細は、Oracle Java Cloud Serviceインスタンスのバックアップおよびリストアに関する項を参照してください
- バックアップからのリストア後にOracle Java Cloud Serviceインスタンスをサービスに戻すこと
- 特定の容量単位の削除の詳細は、Oracle Java Cloud Serviceコンソールを使用したCoherenceデータ層のスケーリングを参照してください
- バックアップ内のホストとサービス・インスタンスが一致しない状況でのOracle Java Cloud Serviceの処理の詳細は、サービス・インスタンスがリストアされる際に発生する処理を参照してください
Oracle Cloud Machineの場合、OPCMでのOracle Java Cloud Serviceの使用の次のトピックを参照してください。
- バックアップの内容およびどのようなファイルをリストアできるかの詳細は、Oracle Java Cloud Serviceインスタンスのバックアップおよびリストアに関する項を参照してください
- バックアップからのリストア後にOracle Java Cloud Serviceインスタンスをサービスに戻すこと
- 特定の容量単位の削除の詳細は、Oracle Java Cloud Serviceコンソールを使用したCoherenceデータ層のスケーリングを参照してください
- バックアップ内のホストとサービス・インスタンスが一致しない状況でのOracle Java Cloud Serviceの処理の詳細は、サービス・インスタンスがリストアされる際に発生する処理を参照してください
Oracle Public Cloudの場合の注意: Oracle Java Cloud Serviceインスタンス・バックアップにデータベース・バックアップが含まれていた場合、Oracle Java Cloud Serviceインスタンスに関連付けられたOracle Database Cloud Serviceデータベース・デプロイメントのデータベース・ファイルのリストアは、Oracle Java Cloud Serviceインスタンス・リストア操作でサポートされていません。 データベース・ファイルを別個にリストアする必要があります。 Database Cloud Serviceデータベース・デプロイメントが単一インスタンス・データベースをホストしているか、Oracle Real Application Clusters (RAC)データベースをホストしているかに応じて、関連付けられたデータベース・バックアップのRMANタグまたはタイムスタンプを使用して、データベース・ファイルをリストアします。 RMANタグまたはタイムスタンプは、Oracle Java Cloud Serviceインスタンス・バックアップでGETリクエストを使用して返されるdbTag
属性値です(バックアップの表示を参照)。 Oracle Database Cloud Serviceデータベース・ファイルのリストアの詳細は、『Oracle Database Cloud Serviceの使用』の特定のバックアップからのリストアまたは特定のPoint in Timeへのリストアに関する項を参照してください。
注意: 従来のパス/paas/service/jcs/api/v1.1/instances/{identityDomainId}/{serviceId}/restoredbackupsは推奨されていませんが、近いうちに引き続きサポートされます。 ただし、今後非推奨のURL構造がサポートされなくなった場合に、中断を最小限に抑えるために、新しいパスを使用するようにアプリケーションを移行することをお勧めします。
リクエスト
- application/json
- 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インスタンスの名前。
- X-ID-TENANT-NAME
-
型:
string
必須:true
Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。
- backupId
-
型:
string
必須:true
バックアップID。 バックアップIDを取得する方法については、すべてのバックアップの表示を参照してください。 - forceScaleIn
-
型:
boolean
リストアされているバックアップに組み込まれない構成された管理対象サーバーが存在する場合にOracle Java Cloud Serviceインスタンスを自動的にスケール・インするかどうかを指定するフラグ。 この値のデフォルトはfalse
で、サービス・インスタンスが自動的にスケール・インされないことを示します。このフラグが
false
に設定され、リストアされているバックアップに組み込まれない構成された管理対象サーバーがOracle Java Cloud Serviceインスタンスにある場合、操作は失敗し、次のエラー・メッセージが返されます。JAAS-BR-105: Unable to restore configuration data for managed servers that are not part of the backup. The affected managedsServers are: [managedserver_x, managedserver_y]. Scale in the service instance to remove these managed servers' nodes and then try to restore the service instance again.
- notes
-
型:
string
リストア操作に関する追加情報を提供する自由形式のテキスト。 - pauseOTD
-
型:
boolean
リストア・プロセス中にロード・バランサを一時停止するかどうかを指定するフラグ。 この値のデフォルトはfalse
です。true
に設定すると、ロード・バランサは一時停止し、リストア・プロセス中にサービス・インスタンスでの管理対象サーバーへのリクエストの転送を停止し、HTTP 503ステータス・コードでクライアント・リクエストに応答します。 リストア・プロセスの完了後、ロード・バランサが再起動します。ロード・バランサの一時停止または再起動に失敗する場合、ロード・バランサの管理サーバーを使用できないので、リストア・プロセスは続行します。 ただし、ロード・バランサのヘルス・チェックが失敗すると、リストア・プロセスは失敗します。
リストアが完了した後、手動タスクを実行する必要がある場合、この機能を使用するべきではありません。 Oracle Public Cloudの場合、『Oracle Java Cloud Serviceの使用』のバックアップからのリストア後にOracle Java Cloud Serviceインスタンスをサービスに戻すことの項を参照してください。 Oracle Cloud Machineの場合、『OPCMでのOracle Java Cloud Serviceの使用』のバックアップからのリストア後にOracle Java Cloud Serviceインスタンスをサービスに戻すことを参照してください。
注意: このフラグは、ロード・バランサが有効な場合にのみ有効です。
- resetBinaries
-
型:
boolean
Oracle WebLogic ServerとJDKソフトウェアを、Oracle Java Cloud Serviceが現在実行しているソフトウェアの公式のパッチ・セット更新(PSU)レベルに対応するバージョンにリセットするかどうかを指定するフラグ。 この値のデフォルトはfalse
で、バイナリ・ファイルが置換されないことを示します。注意: 古いバージョンにソフトウェアをリストアするには、該当するパッチのロールバックを開始します。
- restoreConfig
-
型:
boolean
構成データがリストアされることを指定するフラグ。 この値のデフォルトはtrue
です。false
は、サポートされていません。
レスポンス
- application/json
- job_id
-
型:
string
リストア操作のジョブID。 ジョブIDを使用して、リストア操作のステータスを表示できます(リストア操作のステータスの表示を参照)。 - operationName
-
型:
string
実行される操作。 この値はrestore-backup
に設定されています。 - target_uri
-
型:
string
リストア・リソースのURI。
例
次の例では、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによって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 POST -u username:userPassword1! -d @restore.json -H "Content-Type:application/json" -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/api/v1.1/instancemgmt/ExampleIdentityDomain/services/jaas/instances/ExampleInstance/restoredbackups
リクエスト本文の例
3つのオプションの値が指定されたJSON形式のリクエスト本文の例を次に示します。 必須の値はbackupIdのみであることに注意してください。
{ "backupId":"1449332100032", "forceScaleIn":true, "notes":"restore from backup before scale out", "pauseOTD":true }
レスポンス・ヘッダーの例
レスポンス・ヘッダーの例を次に示します。
HTTP/1.1 202 Accepted Date: Sat, 05 Dec 2015 23:39:02 GMT Transfer-Encoding: chunked Content-Type: application/json
レスポンス本文の例
レスポンスJSONドキュメントの例を次に示します。 リストア操作のステータスの表示に使用できるジョブIDに注意してください。
{ "operationName":"restore-backup", "job_id":"8226", "target_uri":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/ExampleIdentityDomain\/ExampleInstance\/restoredbackups\/8226" }