機械翻訳について
  1. Oracle Java Cloud ServiceのREST API
  2. タスク
  3. バックアップとリストア

オンデマンド・バックアップの開始

post

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

Oracle Java 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
パス・パラメータ
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の場合)。

本文パラメータ
リクエスト本文には、オンデマンド・バックアップ・リクエストの詳細が含まれます。
ルート・スキーマ: ondemand-request
リクエスト本文には、オンデマンド・バックアップ操作に関する情報が含まれます。 必須の属性はありません。

レスポンス

サポートされているメディア・タイプ
  • application/json
202 Response
Accepted. 返される可能性のあるその他のHTTPステータス・コードの詳細は、ステータス・コードを参照してください。
本文
レスポンス本文には、オンデマンド・バックアップ操作に関する情報が含まれます。
ルート・スキーマ: ondemand-response
レスポンス本文には、オンデマンド・バックアップ操作に関する情報が含まれます。

例

次の例では、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 @backup.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

注意: リクエストでは、keepForeverをtrueに設定してバックアップを無期限に、または手動で削除するまで保持します。 (これは、expirationDateが nullに設定されたのと同じ動作ですが、これは非推奨です)。

リクエスト本文の例(Oracle Public Cloud)

JSON形式のリクエスト本文の例を次に示します。 

{
   "databaseIncluded":true,
   "keepForever":true,
   "full":true,
   "notes":"On-demand full backup request."
}

リクエスト本文の例(Oracle Cloud Machine)

JSON形式のリクエスト本文の例を次に示します。 

{
   "keepForever":true,
   "full":true,
   "notes":"On-demand full backup request."
}

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

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

HTTP/1.1 202 Accepted
Date: Sat, 05 Dec 2015 19:56:47 GMT
Transfer-Encoding: chunked
Content-Type: application/json

レスポンス本文の例

JSON形式のレスポンス本文の例を次に示します。 バックアップの表示、削除、アーカイブまたはダウンロードに使用できるバックアップURIに注意してください。 

{
    "operationName":"start-backup",
    "target_uri":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/ExampleIdentityDomain\/ExampleInstance\/backups\/1449345407188",
    "job_id":"8218"
}