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

適用されたパッチの表示

get

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

Oracle Java Cloud Serviceインスタンスのすべての適用済パッチのリストを返します。

リクエスト

パス・パラメータ
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インスタンスの名前。
問合せパラメータ
filter
型: string
結果のフィルタリングに使用する文字列。 有効な値は、=、!=、>=および<=です。 たとえば、特定のパッチ・カテゴリとタイプを基準に結果をフィルタリングするには、patchCategory=general,patchType!=securityのようにフィルタを設定します。 この値のデフォルトはnullです。
ヘッダー・パラメータ
X-ID-TENANT-NAME
型: string
必須: true
Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。

Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。

レスポンス

サポートされているメディア・タイプ
  • application/json
200レスポンス
OK。 返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。
本文
レスポンス本文には、適用されたパッチすべてに関する詳細が含まれます。
ルート・スキーマ: applied-patches-response
型: array
レスポンス本文には、適用されたパッチすべてに関する詳細が含まれます。
ネストされたスキーマ: applied-patch
適用されたパッチに関する情報。
ネストされたスキーマ: componentPatches
タイプ: object
パッチのコンポーネントの詳細をグループ化するマップ。 コンポーネントは、WLS、JDK、OTD_JDKまたはORACLE_TOOLSです。
ネストされたスキーマ: patching-result
タイプ: object
パッチの結果に関する情報をグループ化します。
ネストされたスキーマ: rollback-result
タイプ: object
ロールバック操作の結果に関する情報をグループ化します。 この属性は、パッチのロールバックが実行された場合にのみ表示されます。
ネストされたスキーマ: zipBundles
タイプ: object
パッチ適用済のバイナリまたはサービス・ボリュームのパッチを含むzip。
ネストされたスキーマ: progressMessages
型: array
パッチの進行状況メッセージのリスト。
ネストされたスキーマ: progressMessages
型: array
ロールバックの進行状況メッセージのリスト。

例

次の例では、cURLを使用してRESTリソースに対するGETリクエストを発行することによって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 GET -u username:userPassword1! -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/api/v1.1/instancemgmt/ExampleIdentityDomain/services/jaas/instances/ExampleInstance/patches/applied

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

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

HTTP/1.1 200 OK
Date: Fri, 06 May 2016 21:40:25 GMT
Transfer-Encoding: chunked
Content-Type: application/json

レスポンス本文の例

適用済のJDKパッチの詳細を示すJSON形式のレスポンス本文の例を次に示します。

[
    {
        "backupStatus": "Available",
        "additionalNote":"Patching JDK.",
        "appliedBy":"username",
        "appliedDate":"May 6, 2016 8:55:42 PM",
        "totalTime":"39 min, 52 sec",
        "patchId":"Patch_jdk1.7.0_95",
        "patchDescription":"Update to latest version of JDK, 1.7.0_95.",
        "patchReleaseUrl":"http://www.oracle.com/technetwork/java/javase/7u95-relnotes-2775806.html",
        "releaseDate":"Jan 15, 2016 8:00:00 AM",
        "resultMessage":"Patching completed",
        "lastStatus":"COMPLETED",
        "lastStatusMessage":"Patching completed",
        "componentPatches":
        {
          "JDK":
          {
            "id":1167,
            "version":"1.7.0_95",
            "releaseVersion":"1.7.0_95",
            "zipBundles":
            {
              "JDK":
              {
                "id":1134,
                "md5sum":"4d26465bff5b0744ff7ccbeed11dd308",
                "provisioningObjectRef":"JDK/7.0.95/151225/jdk.zip",
                "storageKey":"PATCH/JDK/jdk1.7.0_95",
                "zipVersion":"1.7.0_95"
              }
            }
          }
        },
        "patchType":"JDK",
        "patchCategory":"JDK",
        "patchSeverity":"Normal",
        "jobId":"670607",
        "displayName":"1.7.0_95",
        "backupId":"1462569267815",
        "inProgress":false,
        "operationType":"None",
        "id":78991,
        "patchingResult":
        {
            "patchingId":76841,
            "backupId":"1462569267815",
            "versionBeforeThisPatch":"JDK 1.7.0_91",
            "strategy":"Rolling",
            "customRollbackId":"670607_1462568142007",
            "startDate":"May 6, 2016 8:55:42 PM",
            "endDate":"May 6, 2016 9:35:34 PM",
            "patchingStatus":"COMPLETED",
            "resultMessage":"Patching completed",
            "additionalNote":"Patching JDK.",
            "appliedBy":"username",
            "jobId":"670607",
            "completeLog":"",
            "progressMessages":
            [
                "8:55:41.996 PM Phase initialize started",
                "8:55:42.045 PM Phase initialize completed",
                "8:55:42.084 PM Phase pre-check started",
                ...
                "9:35:33.639 PM Phase patch-rex completed",
                "9:35:33.954 PM Phase patch completed",
                "9:35:34.016 PM Phase finalize started",
                "9:35:34.057 PM Completed""
            ]
        },
        "rollbackId":"78991",
        "rollbackVersion":"JDK 1.7.0_91",
        "currentPatchLevel":"JDK 1.7.0_95",       
    }
]

適用済のパッチがロールバックされた場合は、rollbackResultも表示されます。 

        "rollbackResult":
        {
            "rollbackId":151,
            "startDate":"Jun 3, 2016 4:32:59 PM",
            "endDate":"Jun 3, 2016 4:46:17 PM",
            "patchingStatus":"COMPLETED_ROLLBACK",
            "resultMessage":"Completed",
            "additionalNote":"Rolling back the WLS patch",
            "appliedBy":"username",
            "jobId":"4538993",
            "completeLog":"",
            "progressMessages":
            [
                "4:32:59.860 PM Phase initialize started",
                "4:32:59.895 PM Phase initialize completed",
                "4:32:59.936 PM Phase restore started",
                "4:46:17.548 PM Phase restore completed",
                "4:46:17.578 PM Phase finalize started",
                "4:46:17.596 PM Completed"
            ]
        }