パッチ適用前チェックの実行
put
/paas/api/v1.1/instancemgmt/{identityDomainId}/services/jaas/instances/{serviceId}/patches/checks/{patchId}
指定されたパッチの正常完了を妨げ、サービス・インスタンスに実際にパッチが適用されなくなる可能性のある問題を特定するための事前チェックを実行します。 具体的には、パッチ適用前チェックにより次の状況が報告されます。
- ディスク領域不足
- データベース接続の失敗
- サーバー・アクセスの失敗
- ストレージ・アクセスの失敗
事前チェックでは、パッチ適用を妨げる別の管理タスク(バックアップ、リストア、スケーリングなど)が進行中かどうかはチェックされません。
リクエスト
サポートされているメディア・タイプ
- application/json
パス・パラメータ
- identityDomainId
-
型:
string
必須:true
Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。
- patchId
型:string
必須:true
事前チェックするパッチのID。- 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の場合)。
本文パラメータリクエストには、パッチ適用前操作に関する情報が含まれます。ルート・スキーマ: precheck-requestリクエストはアプリケーション/jsonペイロードを消費します。 ただし、現時点ではペイロードにパラメータはサポートされていません。レスポンス
サポートされているメディア・タイプ- application/json
202 ResponseAccepted. 返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。ヘッダー- Location
-
型:
string
事前チェック操作の進行状況および完了のチェックに使用できるREST URI。
本文レスポンス本文には、操作に関する情報が含まれます。ルート・スキーマ: patch-responseネストされたスキーマ: detailsタイプ:object
操作の詳細をグループ化します。- jobId
-
型:
string
パッチ操作またはパッチ事前チェック操作のジョブID。 - message
-
型:
string
操作を説明するシステム・メッセージ。
例
次の例は、cURLを使用してRESTリソースにPUTリクエストを発行することによって、パッチ適用前チェックを実行する方法を示しています。
注意: この例のコマンドでは、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 PUT -u username:userPassword1! -d @emptyfile.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/patches/checks/otd_jdk1.7.0_95
この時点でリクエスト・ペイロードでサポートされているパラメータはありません。
レスポンス・ヘッダーの例
次にレスポンス・ヘッダーの例を示します。
HTTP/1.1 100 Continue HTTP/1.1 202 Accepted Date: Wed, 15 Jun 2016 23:46:16 GMT Transfer-Encoding: chunked Location: https://rest_server_url/paas/service/jcs/api/v1.1/instancemgmt/ExampleIdentityDomain/services/JaaS/instances/ExampleInstance/patches/checks/job/4883026 Content-Type: application/json
レスポンス本文の例
JSON形式のレスポンス本文の例を次に示します。
{ "details": { "jobId":"4883026", "message":"JCS-PATCHING-5227: Pre-Checking service for patch [otd_jdk1.7.0_95] is submitted as an asynchronous job." }, "status":"Completed" }