Oracle Java Cloud Service REST API

バックアップの移動(ダウンロードまたはアーカイブ)

post

/paas/api/v1.1/instancemgmt/{identityDomainId}/services/jaas/instances/{serviceId}/backups/{backupId}

Oracle Java Cloud Serviceインスタンスのバックアップを次の場所に移動できます。

Oracle Storage Cloud Serviceのコンテナ(アーカイブ)
管理サーバー上のブロック・ストレージ(ダウンロード)

Oracle Public Cloudでのバックアップの内容およびバックアップが格納される場所の詳細は、『Oracle Java Cloud Serviceの使用』のOracle Java Cloud Serviceインスタンスのバックアップおよびリストアに関する項を参照してください。 Oracle Cloud Machineの場合、OPCMでのOracle Java Cloud Serviceの使用のOracle Java Cloud Serviceインスタンスのバックアップおよびリストアに関する項を参照してください。

注意: 従来のパス/paas/service/jcs/api/v1.1/instances/{identityDomainId}/{serviceId}/backupsは推奨されていませんが、近いうちに引き続きサポートされます。ただし、今後非推奨のURL構造がサポートされなくなった場合に、中断を最小限に抑えるために、新しいパスを使用するようにアプリケーションを移行することをお勧めします。

リクエスト

サポートされているメディア・タイプ

application/json

パス・パラメータ

backupId: 型: string

必須: true

バックアップID。バックアップIDを取得する方法については、すべてのバックアップの表示を参照してください。
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の場合)。

本文パラメータ

リクエスト本文には、アーカイブまたはダウンロード・バックアップ・リクエストの詳細が含まれます。

ルート・スキーマ: archivedownload-request

リクエストの本文には、アーカイブまたはダウンロードするバックアップのリクエストの詳細を定義します。

プロパティ

ローカル: 型: boolean

必須: true

バックアップが、ダウンロードされて管理サーバーのブロック・ストレージにローカルに格納される(true)か、アーカイブされてリモートに格納される(false)かを示すフラグ。
Oracle Public Cloudでは、リモート・ストレージは指定されたOracle Storage Cloud Serviceコンテナです。
Oracle Cloud Machineでは、リモート・ストレージは指定されたNFSストレージ・ディスクです。

レスポンス

サポートされているメディア・タイプ

application/json

202 Response

Accepted. 返される可能性のあるその他のHTTPステータス・コードの詳細は、ステータス・コードを参照してください。

本文

レスポンス本文には、アーカイブまたはダウンロード・バックアップ操作に関する情報が含まれます。

ルート・スキーマ: archivedownload-response

レスポンス本文には、アーカイブまたはダウンロード・バックアップ操作に関する情報が含まれます。

プロパティ

job_id: 型: string

バックアップのアーカイブまたはダウンロード操作のジョブID。
operationName: 型: string

実行した操作の名前。 move-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 @movebackup.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/1390442367140

リクエスト本文の例

次の例では、ダウンロード操作に対する、JSON形式のリクエスト本文のコンテンツを示しています。

{
   "local":true
}

次の例では、アーカイブ操作に対する、JSON形式のリクエスト本文のコンテンツを示しています。

{
   "local":false
}

レスポンス・ヘッダーの例

レスポンス・ヘッダーの例を次に示します。

HTTP/1.1 202 Accepted
Date: Mon, 07 Dec 2015 23:33:53 GMT
Transfer-Encoding: chunked
Content-Type: application/json

レスポンス本文の例

JSON形式のレスポンス本文の例を次に示します。

{
   "operationName":"move-backup",
   "target_uri":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/instances\/ExampleIdentityDomain\/ExampleInstance\/backups\/1390442367140",
   "job_id":"101"
}