機械翻訳について
  1. Oracle Java Cloud ServiceのREST API
  2. タスク
  3. パッチ

パッチ適用前チェックの実行

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 Response
Accepted. 返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。
ヘッダー
Location
型: string
事前チェック操作の進行状況および完了のチェックに使用できるREST URI。
本文
レスポンス本文には、操作に関する情報が含まれます。
ルート・スキーマ: patch-response
レスポンス本文には、操作に関する情報が含まれます。
ネストされたスキーマ: details
タイプ: object
操作の詳細をグループ化します。

例

次の例は、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"
}