サービス・インスタンスのバックアップのダウンロードまたはアーカイブ
Oracle Java Cloud Serviceインスタンスのバックアップをダウンロードする際には、バックアップをクラウド・ストレージ・コンテナ(Oracle Public Cloudの場合)またはNFSリモート・ストレージ・ディスク(Oracle Cloud Machineの場合)から管理サーバー上のブロック・ストレージに移動します。 サービス・インスタンスのバックアップをアーカイブする場合は、バックアップを管理サーバーVMのブロック・ストレージからクラウド・ストレージ・コンテナ(Oracle Public Cloud)またはNFSリモート・ストレージ・ディスク(Oracle Cloud Machine)に移動します。
注意: cURLコマンドの例では、URL構造https://rest_server_url/resource-pathが使用されています。ここで、rest_server_urlはアイデンティティ・ドメインまたはテナント名を問い合せるためのOracle Public CloudまたはOracle Cloud MachineのRESTサーバーです。 Oracle Public CloudまたはOracle Cloud Machineに使用する適切なURL構造の詳細は、リクエストの送信を参照してください。
Oracle Java Cloud Serviceインスタンスのバックアップのダウンロード手順:
- ダウンロードするバックアップのIDを取得するために、現在定義されているすべてのバックアップを確認します。
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/backups
cURLコマンドラインで次のオプションを指定します。
出力にHTTPヘッダーを含める-iオプション。 このオプションは省略可能です。
リクエストのタイプ(GET)を指定する-Xオプション。
認証のためのOracle Java Cloud Serviceアカウントのユーザー名とパスワードを指定する-uオプション。
アイデンティティ・ドメインIDまたはテナント名を識別するカスタム・ヘッダーX-ID-TENANT-NAMEを定義する-H。
詳細は、すべてのバックアップの表示を参照してください。
JSON形式のレスポンスのコンテンツの例を次に示します。 完了したバックアップが1つあります。
{ "backups":[ { "backupId":"1449345407188", "jobId":"8218", "backupStartDate":"Sat Dec 05 19:56:47 GMT 2015", "backupCompleteDate":"Sat Dec 05 19:59:21 GMT 2015", "expirationDate":null, "initiatedBy":"username", "full":true, "local":false, "localCopy":true, "databaseIncluded":false, "size":"23MB", "sizeInBytes":24165234, "status":"Completed", "href":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/ExampleIdentityDomain\/ExampleInstance\/backups\/1449345407188", "serviceComponents":[ { "type":"OTD", "version":"11.1.1.9.x" }, { "type":"WLS", "version":"12.1.3.0.x" }, { "type":"JDK", "version":"1.7.0_xx" }, { "type":"OTD_JDK", "version":"1.7.0_xx" }], "notes":"On-demand full backup request." }] } - ダウンロード操作の詳細を定義するJSONドキュメントdownload.jsonを作成します。
JSON形式のリクエスト・ドキュメントの例を次に示します。 この例では、local属性はtrueに設定されています。
request属性の詳細については、「バックアップの移動(ダウンロードまたはアーカイブ)」を参照してください。
{ "local": true } - ステップ2で作成したJSONドキュメントを渡して、バックアップをダウンロードします。
curl -i -X POST -u username:userPassword1! -d @download.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/backups/1449345407188
cURLコマンドラインで次のオプションを指定します。
出力にHTTPヘッダーを含める-iオプション。 このオプションは省略可能です。
リクエストのタイプ(POST)を指定する-Xオプション。
認証のためのOracle Java Cloud Serviceアカウントのユーザー名とパスワードを指定する-uオプション。
ローカル・マシン上でJSON形式のリクエスト・ドキュメント(download.json)を識別する-dオプション。
コンテンツ・タイプをapplication/jsonとして識別し、アイデンティティ・ドメインIDまたはテナント名を識別するカスタム・ヘッダーX-ID-TENANT-NAMEを定義する-H。
RESTリソースの詳細については、「バックアップの移動(ダウンロードまたはアーカイブ)」を参照してください。
バックアップの表示に使用できるバックアップURIを含む、JSON形式のレスポンス本文の例を次に示します。
{ "operationName":"move-backup", "target_uri":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/ExampleIdentityDomain\/ExampleInstance\/backups\/1449345407188", "job_id":"8326" } - レスポンス本文で返されるバックアップのURI (target_uri)を使用して、バックアップに関する詳細な情報を表示します。
curl -i -X GET -u username:userPassword1! -H "-ID-TENANT-NAME:ExampleIdentityDomain"https://rest_server_url/paas/api/v1.1/instancemgmt/ExampleIdentityDomain/services/jaas/instances/ExampleInstance/backups/1449345407188
オプションで、?includeLinkedDetails問合せパラメータを指定すると、関連バックアップに関する情報を含めることができます。
cURLコマンドラインで次のオプションを指定します。
出力にHTTPヘッダーを含める-iオプション。 このオプションは省略可能です。
リクエストのタイプ(GET)を指定する-Xオプション。
認証のためのOracle Java Cloud Serviceアカウントのユーザー名とパスワードを指定する-uオプション。
アイデンティティ・ドメインIDまたはテナント名を識別するカスタム・ヘッダーX-ID-TENANT-NAMEを定義する-H。
詳細はバックアップの表示を参照してください
Oracle Public CloudでのJSON形式のレスポンス本文の例を次に示します。 jobHistoryのdownload操作に注意してください。
{ "backupId":"1449345407188", "jobId":"8218", "backupStartDate":"Sat Dec 05 19:56:47 GMT 2015", "backupCompleteDate":"Sat Dec 05 19:59:21 GMT 2015", "expirationDate":null, "initiatedBy":"username", "full":true, "local":true, "localCopy":false, "databaseIncluded":false, "size":"23MB", "sizeInBytes":24165234, "status":"Completed", "href":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/ExampleIdentityDomain\/ExampleInstance\/backups\/1449345407188", "serviceComponents":[ { "type":"OTD", "version":"11.1.1.9.x" }, { "type":"OTD_JDK", "version":"1.7.0_xx" }, { "type":"JDK", "version":"1.7.0_xx" }, { "type":"WLS", "version":"12.1.3.0.x" }], "jobHistory":[ { "operation":"backup", "jobId":"8218", "status":"Completed", "startDate":"Sat Dec 05 19:56:47 GMT 2015", "completeDate":"Sat Dec 05 19:59:21 GMT 2015", "statusDetails":"Backup health check passed...Locked the WebLogic Server domain configuration... Started the backup of configuration data for WebLogic Server managed servers on these hosts: exampleinstance-wls-1 ... Completed the backup of configuration data for WebLogic Server managed servers on these hosts: exampleinstance-wls-1 ... Unlocked the WebLogic Server domain configuration...Uploading the backup archive to the Oracle Storage Cloud Service container... Uploaded the backup archive to the Oracle Storage Cloud Service container..." }, { "operation":"download", "jobId":"8326", "status":"Completed", "startDate":"Mon Dec 07 23:33:53 GMT 2015", "completeDate":"Mon Dec 07 23:34:24 GMT 2015", "statusDetails":"The backup archive already exists in the block storage and does not need to be downloaded from the Oracle Storage Cloud Service container... Deleting the backup archive in the Oracle Storage Cloud Service container... Deleted the backup archive in the Oracle Storage Cloud Service container..." }], "notes":"On-demand full backup request." }Oracle Cloud Machineでは、同様の出力が表示されますが、ステータス・メッセージが異なります。 download操作の場合、かわりに次のstatusDetailsが表示されます。
"statusDetails":"The backup archive already exists in the block storage and does not need to be downloaded from the Oracle Storage Cloud Service container... Deleting the backup archive from the remote filesystem... Deleted \/tmp\/far_storage_root\/JCSBackup_ExampleInstance\/2015-12-30\/P_1449345407188.zip from the remote filesystem" - バックアップをアーカイブするには、アーカイブ操作の詳細を定義するJSONドキュメントarchive.jsonを作成します。
JSON形式のリクエスト・ドキュメントの例を次に示します。 この例では、local属性はfalseに設定されています。
{ "local": false } - ステップ5で作成したJSONドキュメントを渡して、バックアップをアーカイブします。
curl -i -X POST -u username:userPassword1! -d @archive.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/backups/1443035291288
cURLコマンドラインで次のオプションを指定します。
出力にHTTPヘッダーを含める-iオプション。 このオプションは省略可能です。
リクエストのタイプ(POST)を指定する-Xオプション。
認証のためのOracle Java Cloud Serviceアカウントのユーザー名とパスワードを指定する-uオプション。
ローカル・マシン上でJSON形式のリクエスト・ドキュメント(archive.json)を識別する-dオプション。
コンテンツ・タイプをapplication/jsonとして識別し、アイデンティティ・ドメインIDまたはテナント名を識別するカスタム・ヘッダーX-ID-TENANT-NAMEを定義する-H。
バックアップの表示に使用できるバックアップURIを含む、JSON形式のレスポンス本文の例を次に示します。
{ "operationName":"move-backup", "target_uri":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/ExampleIdentityDomain\/ExampleInstance\/backups\/1449345407188", "job_id":"8327" } - レスポンス本文で返されるバックアップのURI (target_uri)を使用して、バックアップに関する詳細な情報を表示します。
curl -i -X GET -u username:userPassword1! -H "-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/api/v1.1/instancemgmt/ExampleIdentityDomain/services/jaas/instances/ExampleInstance/backups/1443035291288
オプションで、?includeLinkedDetails問合せパラメータを指定すると、関連バックアップに関する情報を含めることができます。
cURLコマンドラインで次のオプションを指定します。
出力にHTTPヘッダーを含める-iオプション。 このオプションは省略可能です。
リクエストのタイプ(GET)を指定する-Xオプション。
認証のためのOracle Java Cloud Serviceアカウントのユーザー名とパスワードを指定する-uオプション。
アイデンティティ・ドメインIDまたはテナント名を識別するカスタム・ヘッダーX-ID-TENANT-NAMEを定義する-H。
Oracle Public CloudでのJSON形式のレスポンス本文の例を次に示します。 jobHistoryのupload操作に注意してください。
{ "backupId":"1449345407188", "jobId":"8218", "backupStartDate":"Sat Dec 05 19:56:47 GMT 2015", "backupCompleteDate":"Sat Dec 05 19:59:21 GMT 2015", "expirationDate":null, "initiatedBy":"username", "full":true, "local":false, "localCopy":false, "databaseIncluded":false, "size":"23MB", "sizeInBytes":24165234, "status":"Completed", "href":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/ExampleIdentityDomain\/ExampleInstance\/backups\/1449345407188", "serviceComponents":[ { "type":"WLS", "version":"12.1.3.0.x" }, { "type":"OTD_JDK", "version":"1.7.0_xx" }, { "type":"OTD", "version":"11.1.1.9.x" }, { "type":"JDK", "version":"1.7.0_xxx" }], "jobHistory":[ { "operation":"backup", "jobId":"8218", "status":"Completed", "startDate":"Sat Dec 05 19:56:47 GMT 2015", "completeDate":"Sat Dec 05 19:59:21 GMT 2015", "statusDetails":"Backup health check passed...Locked the WebLogic Server domain configuration... Started the backup of configuration data for WebLogic Server managed servers on these hosts: exampleinstance-wls-1 ... Completed the backup of configuration data for WebLogic Server managed servers on these hosts: exampleinstance-wls-1 ... Unlocked the WebLogic Server domain configuration...Uploading the backup archive to the Oracle Storage Cloud Service container... Uploaded the backup archive to the Oracle Storage Cloud Service container..." }, { "operation":"upload", "jobId":"8327", "status":"Completed", "startDate":"Mon Dec 07 23:44:36 GMT 2015", "completeDate":"Mon Dec 07 23:45:37 GMT 2015", "statusDetails":"Uploading the backup archive to the Oracle Storage Cloud Service container... Uploaded the backup archive to the Oracle Storage Cloud Service container... Deleted the local backup..." }, { "operation":"download", "jobId":"8326", "status":"Completed", "startDate":"Mon Dec 07 23:33:53 GMT 2015", "completeDate":"Mon Dec 07 23:34:24 GMT 2015", "statusDetails":"The backup archive already exists in the block storage and does not need to be downloaded from the Oracle Storage Cloud Service container... Deleting the backup archive in the Oracle Storage Cloud Service container... Deleted the backup archive in the Oracle Storage Cloud Service container..." }], "notes":"On-demand full backup request." }Oracle Cloud Machineでは、同様の出力が表示されますが、ステータス・メッセージが異なります。 upload操作の場合、かわりに次のstatusDetailsが表示されます。
"statusDetails":"Uploading the backup archive to the remote filesystem... Uploaded the backup archive to the remote filesystem Deleted the local backup..."