適用されたパッチの表示
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
ネストされたスキーマ: applied-patch
適用されたパッチに関する情報。
- additionalNote
-
型:
string
パッチに関する追加情報を提供する、自由形式のテキスト。 - appliedBy
-
型:
string
パッチを適用したユーザーの名前。パッチがスケジュールされた自動更新ジョブによって適用された場合は、system
が表示されます。 - appliedDate
-
型:
string
パッチが適用された日時。 - backupId
-
型:
string
バックアップID。 バックアップIDを使用して、バックアップを管理できます。 - backupStatus
-
型:
string
パッチ適用の前にソフトウェアのバックアップが作成されたかどうか。 有効な値は、Available
、SameVersion
、Unavailable
およびUnknown
です。 - componentPatches
-
タイプ:
object
componentPatchesパッチのコンポーネントの詳細をグループ化するマップ。 コンポーネントは、WLS、JDK、OTD_JDKまたはORACLE_TOOLSです。 - currentPatchLevel
-
型:
string
コンポーネントの現在のパッチ・レベル。 - displayName
-
型:
string
パッチの表示名。 - id
-
型:
integer
パッチ操作の一意のID。 このIDを使用してパッチ適用操作の詳細を取得します。 - inProgress
-
型:
boolean
パッチがまだ進行中かどうかを示すフラグ。 - jobId
-
型:
string
パッチ操作のジョブID。 - lastStatus
-
型:
string
パッチ操作のステータス。 たとえば、IN PROGRESS
、COMPLETED
、FAILED
などです。 適用済のパッチがロールバックされると、COMPLETED_ROLLBACK
が表示されます。 - lastStatusMessage
-
型:
string
パッチ適用が記録された最後のメッセージ。 - operationType
-
型:
string
実行中のパッチ操作。 有効な値は、Rollback
、Patching
およびNone
です。 - patchCategory
-
型:
string
パッチのカテゴリ。 たとえば、General
、Multiple
、Security
などです。 - patchDescription
-
型:
string
パッチの説明。 - patchId
-
型:
string
パッチID。 - patchingResult
-
タイプ:
object
patching-resultパッチの結果に関する情報をグループ化します。 - patchReleaseUrl
-
型:
string
パッチに関する追加情報を提供するURL。 - patchSeverity
-
型:
string
パッチの重大度。 たとえば、Normal
、Mandatory
、Recommended
などです。 - patchType
-
型:
string
パッチ・タイプの分類。 例:COMPOSITE
- 複合パッチJAAS_TOOLS
- Oracle Java Cloud Serviceツール更新JDK
- JDK更新JRF_UPDATE
- Oracle JRF更新PS
- パッチ・セットPSU
- パッチ・セット更新
- releaseDate
-
型:
string
パッチがリリースされた日時。 - resultMessage
-
型:
string
パッチ結果のメッセージ。 - rollbackId
-
型:
string
完了したパッチ適用操作に関連付けられたロールバックのID。 IDがパッチ操作のロールバックに使用されます。 - rollbackResult
-
タイプ:
object
rollback-resultロールバック操作の結果に関する情報をグループ化します。 この属性は、パッチのロールバックが実行された場合にのみ表示されます。 - rollbackVersion
-
型:
string
パッチを適用したコンポーネントをロールバックするバージョン。 - totalTime
-
型:
string
パッチ操作の期間。 - toVersion
-
型:
string
パッチを適用したOracle Java Cloud Serviceインスタンスのバージョン。
ネストされたスキーマ: componentPatches
タイプ:
object
パッチのコンポーネントの詳細をグループ化するマップ。 コンポーネントは、WLS、JDK、OTD_JDKまたはORACLE_TOOLSです。
- id
-
型:
integer
コンポーネント・パッチのID。 - releaseVersion
-
型:
string
このパッチのコンポーネントのリリース・バージョン。 - version
-
型:
string
パッチ・コンポーネントのバージョン。 - zipBundles
-
タイプ:
object
zipBundlesパッチ適用済のバイナリまたはサービス・ボリュームのパッチを含むzip。
ネストされたスキーマ: patching-result
タイプ:
object
パッチの結果に関する情報をグループ化します。
- additionalNote
-
型:
string
パッチに関する追加情報を提供する、自由形式のテキスト。 - appliedBy
-
型:
string
パッチを適用したユーザーの名前。パッチがスケジュールされた自動更新ジョブによって適用された場合は、system
が表示されます。 - backupId
-
型:
string
バックアップID。 バックアップIDを使用して、バックアップを管理できます。 - completeLog
-
型:
string
パッチ操作をトラッキングするシステム・メッセージ。 - customRollbackId
-
型:
string
ロールバック操作で使用されるID。 - endDate
-
型:
string
パッチ操作が終了した日付。 - jobId
-
型:
string
パッチ操作のジョブID。 - metaVersionBeforeThisPatch
-
型:
string
パッチが適用される前のメタデータ・サービス・マネージャのバージョン。 - patchingId
-
型:
integer
適用済のパッチ操作のID。 - patchingStatus
-
型:
string
パッチ適用操作のステータス。 たとえば、COMPLETED
などです。 適用済のパッチがロールバックされると、COMPLETED_ROLLBACK
が表示されます。 - progressMessages
-
タイプ:
array
progressMessagesパッチの進行状況メッセージのリスト。 - resultMessage
-
型:
string
パッチ適用操作を説明するシステム・メッセージ。 - startDate
-
型:
string
パッチ操作を開始した日時。 - strategy
-
型:
string
パッチ適用戦略。 たとえば、Rolling
などです。 サービス中断を最小限に抑えるために、一度に1ノードずつパッチを適用するローリング・パターンでパッチを適用します。 - versionBeforeThisPatch
-
型:
string
パッチ適用前のコンポーネントのバージョン。
ネストされたスキーマ: rollback-result
タイプ:
object
ロールバック操作の結果に関する情報をグループ化します。 この属性は、パッチのロールバックが実行された場合にのみ表示されます。
- additionalNote
-
型:
string
ロールバックに関する追加情報を提供する、自由形式のテキスト。 - appliedBy
-
型:
string
ロールバックを実行したユーザーの名前。 - completeLog
-
型:
string
ロールバック操作をトラッキングするシステム・メッセージ。 - endDate
-
型:
string
ロールバック操作が終了した日付。 - jobId
-
型:
string
ロールバック操作のジョブID。 - patchingStatus
-
型:
string
ロールバック操作のステータス。 たとえば、COMPLETED_ROLLBACK
です。 - progressMessages
-
タイプ:
array
progressMessagesロールバックの進行状況メッセージのリスト。 - resultMessage
-
型:
string
ロールバック操作について説明するシステム・メッセージ。 - rollbackId
-
型:
integer
ロールバック操作のID。 - startDate
-
型:
string
ロールバック操作が開始された日時。
ネストされたスキーマ: zipBundles
タイプ:
object
パッチ適用済のバイナリまたはサービス・ボリュームのパッチを含むzip。
- id
-
型:
integer
コンポーネント・パッチのID。 - md5sum
-
型:
string
パッチのバイナリを評価するためのチェックサム。 - provisioningObjectRef
-
型:
string
新しいサービス・インスタンスの作成時に使用するバイナリの場所。 - storageKey
-
型:
string
クラウド上のパッチzipの場所。 - zipVersion
-
型:
string
zipに含まれているソフトウェア・バージョン。
ネストされたスキーマ: progressMessages
ネストされたスキーマ: progressMessages
例
次の例では、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" ] }