使用可能なパッチの表示
get
/paas/api/v1.1/instancemgmt/{identityDomainId}/services/jaas/instances/{serviceId}/patches/available
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インスタンスの名前。
ヘッダー・パラメータ
- 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ステータス・コードの詳細は、「ステータス・コード」を参照してください。
本文
レスポンス本文には、使用可能なパッチに関する情報が含まれます。
ルート・スキーマ: available-patches-response
ネストされたスキーマ: available-patches
使用可能なパッチに関する情報。
- availablePatchGuiMetadata
-
タイプ:
object
availablePatchGuiMetadataパッチに関するメタデータUIへの指示。 - componentPatches
-
タイプ:
object
componentPatchesパッチのコンポーネントの詳細をグループ化するマップ。 コンポーネントは、WLS、JDK、OTD_JDKまたはORACLE_TOOLSです。 - displayName
-
型:
string
パッチの表示名。 - entryDate
-
型:
string
パッチが作成される日時。 - entryUserId
-
型:
string
パッチを作成したユーザーの名前。 - includesConfigUpgrade
-
型:
boolean
パッチの適用時に構成のアップグレードが含まれるかどうかを示すフラグ。 - induceDownTime
-
型:
boolean
パッチの適用時にサービスの停止時間が含まれるかどうかを示すフラグ。 - isAutoApply
-
型:
boolean
パッチを自動的に適用できるかどうかを示すフラグ。 - isCustomerVisible
-
型:
boolean
パッチが顧客に表示できるかどうかを示すフラグ。 - isDeleted
-
型:
boolean
このパッチが削除されているかどうか、および現在は使用できないかどうかを示すフラグ。 すべてのパッチの履歴レコードを維持するために、パッチに関する情報は使用可能なパッチのリストから削除されません。 - lastprePreCheckResult
-
タイプ:
object
lastprePreCheckResult最後の事前チェック操作に関する情報をグループ化します。 - metaVersion
-
型:
string
メタデータ・サービス・マネージャのリリース・バージョン。 - minToolsVersion
-
型:
string
このパッチで必要なOracle Cloud Toolsの最小バージョン。 - patchCategory
-
型:
string
パッチのカテゴリ。 例えば:ORACLE_TOOLS
、General
、JDK
、Multiple
、Security
、VM_SCRIPTS
などが含まれる。 - patchCustomActions
-
タイプ:
array
patchCustomActionsパッチ適用時の顧客によるアクションのリスト。 - patchDescription
-
型:
string
パッチの説明。 - patchId
-
型:
string
パッチID。 - patchNumber
-
型:
string
パッチ番号。 - patchReleaseUrl
-
型:
string
パッチに関する追加情報を提供するURL。 - patchSeverity
-
型:
string
パッチの重大度。 たとえば、Critical
、Mandatory
、Recommended
、Optional
など。 - patchType
-
型:
string
パッチ・タイプの分類。 有効な値は次のとおりです。COMPOSITE
- 複合パッチJCS_TOOLS
- Oracle Java Cloud Serviceツールの更新JDK
- JDK更新JRF_UPDATE
- Oracle JRF更新PS
- パッチ・セットPSU
- パッチ・セット更新
- releaseDate
-
型:
string
パッチがリリースされる日時。 - releaseVersion
-
型:
string
このパッチのコンポーネントのリリース・バージョン。 - requiresRestart
-
型:
boolean
パッチの適用時にサービス・インスタンスを再起動する必要があるかどうかを示すフラグ。 - serviceType
-
型:
string
パッチが適用されたサービスのタイプ。 Oracle Java Cloud Serviceの場合、サービス・タイプはJaaS
です。 - serviceTypeVersions
-
型:
string
パッチを適用できるOracle Java Cloud Serviceインスタンスのバージョン。 たとえば、14.1
、Any
です。Any
は、パッチがどのバージョンにも適用できることを示します。 - serviceVersion
-
型:
string
パッチが適用されるOracle Java Cloud Serviceインスタンスのバージョン。 たとえば、12cR3
または11g,12c,12cR3
です。 - supportedStrategy
-
型:
string
サポートされているパッチ適用戦略。 例:In Place
。
ネストされたスキーマ: availablePatchGuiMetadata
タイプ:
object
パッチに関するメタデータUIへの指示。
- supportsPreCheck
-
型:
boolean
パッチの適用時にWebユーザー・インタフェース経由の事前チェックがサポートされるかどうかを示すフラグ。
ネストされたスキーマ: componentPatches
タイプ:
object
パッチのコンポーネントの詳細をグループ化するマップ。 コンポーネントは、WLS、JDK、OTD_JDKまたはORACLE_TOOLSです。
- expectedAppliedPatches
-
型:
string
このパッチをインストールする前に適用しておく必要がある前提条件パッチのリスト。注意: このリストに定義されている以外にカスタム・パッチを適用してある場合は、このパッチの適用後にカスタム・パッチを再度適用する必要があります。
- id
-
型:
integer
コンポーネント・パッチのID。 - releaseVersion
-
型:
string
このパッチのコンポーネントのリリース・バージョン。 - version
-
型:
string
パッチ・コンポーネントのバージョン。 - zipBundles
-
タイプ:
object
zipBundlesパッチ適用済のバイナリまたはサービス・ボリュームのパッチを含むzip。
ネストされたスキーマ: lastprePreCheckResult
タイプ:
object
最後の事前チェック操作に関する情報をグループ化します。
- endDate
-
型:
string
パッチ適用前チェック操作が停止した日時。 - href
-
型:
string
パッチ適用前チェック・ジョブのステータスを確認するためのURL。 - id
-
型:
integer
操作のID。 - inProgress
-
型:
boolean
パッチ適用前チェックがまだ進行中かどうかを示すフラグ。 - jobId
-
型:
string
パッチ適用前チェック操作のジョブID。 - jsonResult
-
型:
string
システム・メッセージ。 - patchId
-
型:
string
パッチID。 - performedBy
-
型:
string
パッチ事前チェックを実行するために使用されるユーザー・アカウントの名前。 - preCheckMessages
-
タイプ:
array
preCheckMessagesパッチ適用前チェック・メッセージのリスト。 事前チェックが正常に完了する場合、パッチ適用前チェック・メッセージは返されません。 - startDate
-
型:
string
パッチ適用前チェック操作が開始した日時。 - status
-
型:
string
パッチ適用前チェック操作のステータス。 有効な値は次のとおりです。PASSED_PRECHECK
- パッチ適用前チェックをパスしました。DIDNT_PASS_PRECHECK
- パッチ適用前チェックをパスしませんでした。 詳細は、preCheckMessages
属性を確認してください。DIDNT_FINISHED_PRECHECK
- 内部エラーが発生し、パッチ適用前チェックを実行できませんでした。
ネストされたスキーマ: patchCustomActions
ネストされたスキーマ: zipBundles
タイプ:
object
パッチ適用済のバイナリまたはサービス・ボリュームのパッチを含むzip。
- id
-
型:
integer
コンポーネント・パッチのID。 - md5sum
-
型:
string
パッチのバイナリを評価するためのチェックサム。 - provisioningObjectRef
-
型:
string
新しいサービス・インスタンスの作成時に使用するバイナリの場所。 - storageKey
-
型:
string
クラウド上のパッチzipの場所。 - zipVersion
-
型:
string
zipに含まれているソフトウェア・バージョン。
ネストされたスキーマ: preCheckMessages
例
次の例では、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/available
レスポンス・ヘッダーの例
次にレスポンス・ヘッダーの例を示します。
HTTP/1.1 200 OK Date: Mon, 06 Jun 2016 20:25:49 GMT Content-Type: application/json
レスポンス本文の例
WebLogic Serverで使用可能なパッチを示すJSON形式のレスポンス本文の例を次に示します。
[ { "availablePatchGuiMetadata":{"supportsPreCheck":true}, "lastprePreCheckResult": { "id":1905, "jobId":"4535918", "patchId":"Patch_12.1.3.0.6", "jsonResult":"{\"resultMessage\":\"Completed\",\"messages\":[]}", "startDate":"Jun 3, 2016 2:37:26 PM", "endDate":"Jun 3, 2016 2:40:19 PM", "performedBy":"username", "inProgress":false, "status":"PASSED_PRECHECK", "preCheckMessages":[] }, "patchId":"Patch_12.1.3.0.6", "patchNumber":"Patch_12.1.3.0.6", "patchCategory":"General", "patchSeverity":"Normal", "patchDescription":"WLS PATCH SET UPDATE 12.1.3.0.6", "patchReleaseUrl":"https://support.oracle.com/epmos/faces/PatchDetail?patchId\u003d21983457", "serviceType":"JaaS", "serviceVersion":"12cR3", "releaseDate":"Jan 15, 2016 1:40:00 AM", "entryDate":"Jun 4, 2016 2:43:25 AM", "entryUserId":"OCLOUD9_TAS_APPID", "componentPatches": { "WLS": { "id":711, "version":"12.1.3.0.6", "releaseVersion":"12.1.3.0.6", "expectedAppliedPatches":"opatch:21983457,20244872,21773981,18974665,21680406", "zipBundles": { "WLS": { "id":681, "md5sum":"0c48b61090a2970061c4367047a10dba", "provisioningObjectRef":"FMW/12.1.3.0.6/160202/fmiddleware.zip", "storageKey":"PATCH/WLS/Patch_12.1.3.0.6", "zipVersion":"12.1.3.0.6" } } } }, "patchType":"PSU", "requiresRestart":true, "serviceTypeVersions":"ANY", "isDeleted":false, "minToolsVersion":"15.1.3-0-1501230343", "displayName":"12.1.3.0.6", "releaseVersion":"12.1.3.0.6" } ]