Oracle Java Cloud Service REST API

サービス・インスタンスのオンデマンド・バックアップの開始

次の手順で説明するように、RESTリソースを使用してOracle Java Cloud Serviceインスタンスのオンデマンド・バックアップを開始できます。

ノート:

Oracle Identity Cloud Serviceと統合されているアカウントでは、アイデンティティ・ドメインIDはIdentity Cloud Serviceテナント名です。このテナント名は、idcs-の後に数字と文字列(idcs-98888f7964454b658ac6d2f625b29030など)が続きます。ブラウザでOracle Identity Cloud Serviceコンソールにアクセスし、URLでテナント名を見つけます。また、Oracle Cloudアカウントへのサインイン時に名前を検索し、「アイデンティティ」にナビゲートして、「フェデレーション」を選択することもできます。
cURLコマンドの例では、URL構造https://rest_server_url/resource-pathを使用しています。rest_server_urlは、アイデンティティ・ドメインに接続するRESTサーバーです。「リクエストの送信」を参照してください。

Oracle Java Cloud Serviceインスタンスのオンデマンド・バックアップを開始するには:

バックアップの詳細を定義するJSONドキュメントbackup.jsonを作成します。
JSON形式のリクエスト・ドキュメントの例を次に示します。この例の詳細は次のとおりです。
- keepForeverはtrueに設定されます。これは、バックアップが無期限に、または手動で削除されるまで保存されることを示します。「サービス・インスタンスの自動バックアップの構成」で説明しているように、デフォルトでは、バックアップはバックアップ構成で定義されているデフォルトの保存期間、保存されます。
- notesには、バックアップに関する追加のノートが含まれます。
リクエスト属性の詳細は、「オンデマンド・バックアップの開始」を参照してください。
```
{
    "keepForever": true,
    "notes": "This full backup has no expiration date."
}
```
"databaseIncluded": trueを追加することで、このオンデマンド・バックアップ操作の一部としてデータベース・バックアップを含めることができます。ただし、関連するOracle Database Cloud Serviceデータベース・デプロイメントがOracle Real Application Clusters (Oracle RAC)データベースをホストしている場合、keepForeverがtrueの場合、データベース・バックアップはサービス・インスタンスのオンデマンド・バックアップの一部として実行できません。
ステップ1で作成したJSONドキュメントを渡して、オンデマンド・バックアップを開始します。
```
curl -i -X POST -u username:password -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
```
cURLコマンドラインで次のオプションを指定します。
- -i出力にHTTPヘッダーを含めるためのオプション。このオプションは省略可能です。
- リクエストのタイプを示す-Xオプション(POST)。
- -uオプションを使用して、認証のためのOracle Java Cloud Serviceアカウントのユーザー名とパスワードを指定します。
- -dオプションを使用して、ローカル・マシン(backup.json)のリクエスト文書をJSON形式で識別します。
- -H:コンテンツ・タイプをapplication/jsonとして識別し、アイデンティティ・ドメインIDを識別するカスタム・ヘッダーX-ID-TENANT-NAMEを定義します。
ノート: 指定したサービス・インスタンスのバックアップ・サービスがDISABLED状態の場合、オンデマンド・バックアップを開始できません。

詳細は、「オンデマンド・バックアップの開始」を参照してください。

JSON形式のレスポンス本文の例を次に示します。
```
{
    "operationName":"start-backup",
    "target_uri":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/ExampleIdentityDomain\/ExampleInstance\/backups\/1449345407188",
    "job_id":"8218"
}
```

レスポンス本文で返されるバックアップIDを使用して、バックアップに関する詳細な情報を表示します。

curl -i -X GET -u username:password -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/api/v1.1/instancemgmt/ExampleIdentityDomain/services/jaas/instances/ExampleInstance/backups/1449345407188

cURLコマンドラインで次のオプションを指定します。

-i出力にHTTPヘッダーを含めるためのオプション。このオプションは省略可能です。
リクエストのタイプを示す-Xオプション(GET)。
-uオプションを使用して、認証のためのOracle Java Cloud Serviceアカウントのユーザー名とパスワードを指定します。
-H:アイデンティティ・ドメインIDを識別するカスタム・ヘッダーX-ID-TENANT-NAMEを定義します。

詳細は「バックアップの表示」を参照してください。

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

{
    "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",
    "storageContainer":"Storage-ExampleIdentityDomain\/JCSBackups",
    "href":"https:\/\/rest_server_url\/paas\/api\/v1.1\/instancemgmt\/ExampleIdentityDomain\/services\/jaas\/instances\/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 administration server and managed servers...
          Completed the backup of configuration data for WebLogic administration server and managed servers...Capturing the service metadata...
          Completed the backup of service metadata...Unlocked the WebLogic Server domain configuration...
          Uploading the backup archive to the Oracle Storage Cloud Service container...Uploaded the object to the Oracle Storage Cloud Service container..."
    }],
    "notes":"This full backup has no expiration date."
}