使用可能なパッチの表示
get
/paas/api/v1.1/instancemgmt/{identityDomainId}/services/jaas/instances/{serviceId}/patches/available
Oracle Java Cloud Serviceインスタンスのすべての使用可能なパッチのリストを返します。
リクエスト
パス・パラメータ
- identityDomainId
-
型:
string必須:trueOracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。
- serviceId
型:string必須:trueOracle Java Cloud Serviceインスタンスの名前。
ヘッダー・パラメータ
- X-ID-TENANT-NAME
-
型:
string必須:trueOracle 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
-
タイプ:
objectavailablePatchGuiMetadataパッチに関するメタデータUIへの指示。 - componentPatches
-
タイプ:
objectcomponentPatchesパッチのコンポーネントの詳細をグループ化するマップ。 コンポーネントは、WLS、JDK、OTD_JDKまたはORACLE_TOOLSです。 - displayName
-
型:
stringパッチの表示名。 - entryDate
-
型:
stringパッチが作成される日時。 - entryUserId
-
型:
stringパッチを作成したユーザーの名前。 - includesConfigUpgrade
-
型:
booleanパッチの適用時に構成のアップグレードが含まれるかどうかを示すフラグ。 - induceDownTime
-
型:
booleanパッチの適用時にサービスの停止時間が含まれるかどうかを示すフラグ。 - isAutoApply
-
型:
booleanパッチを自動的に適用できるかどうかを示すフラグ。 - isCustomerVisible
-
型:
booleanパッチが顧客に表示できるかどうかを示すフラグ。 - isDeleted
-
型:
booleanこのパッチが削除されているかどうか、および現在は使用できないかどうかを示すフラグ。 すべてのパッチの履歴レコードを維持するために、パッチに関する情報は使用可能なパッチのリストから削除されません。 - lastprePreCheckResult
-
タイプ:
objectlastprePreCheckResult最後の事前チェック操作に関する情報をグループ化します。 - metaVersion
-
型:
stringメタデータ・サービス・マネージャのリリース・バージョン。 - minToolsVersion
-
型:
stringこのパッチで必要なOracle Cloud Toolsの最小バージョン。 - patchCategory
-
型:
stringパッチのカテゴリ。 例えば:ORACLE_TOOLS、General、JDK、Multiple、Security、VM_SCRIPTSなどが含まれる。 - patchCustomActions
-
タイプ:
arraypatchCustomActionsパッチ適用時の顧客によるアクションのリスト。 - 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
-
タイプ:
objectzipBundlesパッチ適用済のバイナリまたはサービス・ボリュームのパッチを含むzip。
ネストされたスキーマ: lastprePreCheckResult
タイプ:
object最後の事前チェック操作に関する情報をグループ化します。
- endDate
-
型:
stringパッチ適用前チェック操作が停止した日時。 - href
-
型:
stringパッチ適用前チェック・ジョブのステータスを確認するためのURL。 - id
-
型:
integer操作のID。 - inProgress
-
型:
booleanパッチ適用前チェックがまだ進行中かどうかを示すフラグ。 - jobId
-
型:
stringパッチ適用前チェック操作のジョブID。 - jsonResult
-
型:
stringシステム・メッセージ。 - patchId
-
型:
stringパッチID。 - performedBy
-
型:
stringパッチ事前チェックを実行するために使用されるユーザー・アカウントの名前。 - preCheckMessages
-
タイプ:
arraypreCheckMessagesパッチ適用前チェック・メッセージのリスト。 事前チェックが正常に完了する場合、パッチ適用前チェック・メッセージは返されません。 - 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
-
型:
stringzipに含まれているソフトウェア・バージョン。
ネストされたスキーマ: 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"
}
]