Oracle Enterprise ManagerのREST API

イメージ・バージョンの推奨パッチ

get

https://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/goldImages/{goldImageId}/versions/{versionId}/patchRecommendations

指定されたバージョンのイメージに含まれるパッチをOracleの推奨と比較し、次のバージョンに含めるパッチのリストを提示します。

リクエスト

パス・パラメータ

goldImageId(必須): string

イメージのID
versionId(必須): string

イメージ・バージョンのID

問合せパラメータ

include: string
修正されたバグ(入手可能な場合)のリストを提示します

指定可能な値: [ "bugs" ]
例:
```
bugs
```
patchId: string
パッチのID
例:
```
34086870
```

この操作にはリクエスト本文はありません。

先頭に戻る

レスポンス

サポートされているメディア・タイプ

application/json

200レスポンス

OK。イメージ・バージョンのパッチ推奨が取得されました。

ルート・スキーマ: VersionPatchRecommendationCollection

型: object

データベース・ゴールド・イメージ・バージョンのパッチ推奨のレスポンス

ソースの表示

messages: object messages

推奨パッチの取得方法および使用方法に関するメッセージの追加情報
oracleRecommendedPatches: object oracleRecommendedPatches

Oracle推奨パッチ詳細

{
    "description":"Response of Patch recommendation for Database Gold Image Version",
    "type":"object",
    "properties":{
        "messages":{
            "description":"Message additional information about how to get and to use the recommended patches",
            "type":"object",
            "properties":{
                "uploadPatches":{
                    "description":"Gives the information about how to get/upload the recommended patches in EM",
                    "type":"string",
                    "example":"To upload recommended patches in EM use the following command: emcli upload_patches -from_host=host_name -patch_files=metadata_file_path;ZIP_file_path [-cred_name=name -cred_owner=owner]. In online connection mode, the patches can be directly downloaded to EM as well."
                },
                "createNewVersion":{
                    "description":"Gives the information about how to create the new version of image from the recommended patches",
                    "type":"string",
                    "example":"To create a new version of the image with the recommended patches see: https://www.oracle.com/pls/topic/lookup?ctx=en/enterprise-manager&id=EMLCM-GUID-431C8AE4-774B-4DD8-89A5-A6A30B071740."
                }
            }
        },
        "oracleRecommendedPatches":{
            "description":"Oracle recommended patch details",
            "type":"object",
            "allOf":[
                {
                    "$ref":"#/components/schemas/PatchRecommendationDetail"
                }
            ]
        }
    }
}

ネストされたスキーマ: messages

型: object

推奨パッチの取得方法および使用方法に関するメッセージの追加情報

ソースの表示

createNewVersion: string

推奨パッチから新しいバージョンのイメージを作成する方法に関する情報を提示します

例: To create a new version of the image with the recommended patches see: https://www.oracle.com/pls/topic/lookup?ctx=en/enterprise-manager&id=EMLCM-GUID-431C8AE4-774B-4DD8-89A5-A6A30B071740.
uploadPatches: string

EMで推奨パッチを取得/アップロードする方法に関する情報を提供します

例: To upload recommended patches in EM use the following command: emcli upload_patches -from_host=host_name -patch_files=metadata_file_path;ZIP_file_path [-cred_name=name -cred_owner=owner]. In online connection mode, the patches can be directly downloaded to EM as well.

{
    "description":"Message additional information about how to get and to use the recommended patches",
    "type":"object",
    "properties":{
        "uploadPatches":{
            "description":"Gives the information about how to get/upload the recommended patches in EM",
            "type":"string",
            "example":"To upload recommended patches in EM use the following command: emcli upload_patches -from_host=host_name -patch_files=metadata_file_path;ZIP_file_path [-cred_name=name -cred_owner=owner]. In online connection mode, the patches can be directly downloaded to EM as well."
        },
        "createNewVersion":{
            "description":"Gives the information about how to create the new version of image from the recommended patches",
            "type":"string",
            "example":"To create a new version of the image with the recommended patches see: https://www.oracle.com/pls/topic/lookup?ctx=en/enterprise-manager&id=EMLCM-GUID-431C8AE4-774B-4DD8-89A5-A6A30B071740."
        }
    }
}

ネストされたスキーマ: oracleRecommendedPatches

型: object

Oracle推奨パッチ詳細

すべてに一致

Oracle推奨パッチ詳細

ソースの表示

object PatchRecommendationDetail

パッチ詳細

{
    "description":"Oracle recommended patch details",
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/PatchRecommendationDetail"
        }
    ]
}

ネストされたスキーマ: PatchRecommendationDetail

型: object

パッチ詳細

ソースの表示

items: array items

パッチの配列
total: number

パッチの合計数

例: 10

{
    "description":"Patch details",
    "type":"object",
    "properties":{
        "total":{
            "description":"Total number of patches",
            "type":"number",
            "example":"10"
        },
        "items":{
            "description":"Array of patches",
            "type":"array",
            "items":{
                "type":"object",
                "allOf":[
                    {
                        "$ref":"#/components/schemas/PatchRecommendationSummary"
                    }
                ]
            }
        }
    }
}

ネストされたスキーマ: items

型: array

パッチの配列

ソースの表示

配列: object items

{
    "description":"Array of patches",
    "type":"array",
    "items":{
        "type":"object",
        "allOf":[
            {
                "$ref":"#/components/schemas/PatchRecommendationSummary"
            }
        ]
    }
}

ネストされたスキーマ: items

型: object

すべてに一致

ソースの表示

object PatchRecommendationSummary

データベース・ゴールド・イメージ・バージョンの推奨パッチ

{
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/PatchRecommendationSummary"
        }
    ]
}

ネストされたスキーマ: PatchRecommendationSummary

型: object

データベース・ゴールド・イメージ・バージョンの推奨パッチ

ソースの表示

bugs: array bugs

バグのリスト
isSystemPatch: boolean

フラグは、パッチがシステム・パッチかどうかを示します

例: true
patchDescription: string

パッチの説明

例: OJVM RELEASE UPDATE 19.16.0.0.0
patchId: string

パッチのID

例: 34086870
patchName: string

パッチの名前

例: 34086870

{
    "description":"Recommended patches for Database Gold Image Version",
    "type":"object",
    "properties":{
        "patchId":{
            "description":"Id of the Patch",
            "type":"string",
            "example":"34086870"
        },
        "patchName":{
            "description":"Name of the Patch",
            "type":"string",
            "example":"34086870"
        },
        "patchDescription":{
            "description":"Description of the Patch",
            "type":"string",
            "example":"OJVM RELEASE UPDATE 19.16.0.0.0"
        },
        "isSystemPatch":{
            "description":"flag indicates if the patch is System patch or not",
            "type":"boolean",
            "example":"true"
        },
        "bugs":{
            "description":"List of bugs",
            "type":"array",
            "items":{
                "type":"string",
                "example":"26716835,28209601,28777073,29224710,29254623,29415774,29445548,29512125,29540327,29540831,29774362,29942275,30134746,30160625,30534662,30674373,30855101,30889443,30895577,31247838,31306261,31311732,31359215,31494420,31668872,31727233,31776121,31844357,32032733,32069696,32124570,32165759,32167592,32523206,32892883,33184467,33223248,33563137,33805155,33872610,34149263"
            }
        }
    }
}

ネストされたスキーマ: bugs

型: array

バグのリスト

ソースの表示

配列: string

例: 26716835,28209601,28777073,29224710,29254623,29415774,29445548,29512125,29540327,29540831,29774362,29942275,30134746,30160625,30534662,30674373,30855101,30889443,30895577,31247838,31306261,31311732,31359215,31494420,31668872,31727233,31776121,31844357,32032733,32069696,32124570,32165759,32167592,32523206,32892883,33184467,33223248,33563137,33805155,33872610,34149263

{
    "description":"List of bugs",
    "type":"array",
    "items":{
        "type":"string",
        "example":"26716835,28209601,28777073,29224710,29254623,29415774,29445548,29512125,29540327,29540831,29774362,29942275,30134746,30160625,30534662,30674373,30855101,30889443,30895577,31247838,31306261,31311732,31359215,31494420,31668872,31727233,31776121,31844357,32032733,32069696,32124570,32165759,32167592,32523206,32892883,33184467,33223248,33563137,33805155,33872610,34149263"
    }
}

例

400レスポンス

不正なリクエスト。ペイロードがnullであるか、一部のパラメータがありません

ルート・スキーマ: ErrorResponse

型: object

エラー発生時に返送されるレスポンス

ソースの表示

code: string

エラーのステータス・コード。

例: IllegalArgument
message: string

説明的なエラー・メッセージ

例: argument given is not supported

{
    "x-em-sdk-level":"emSDK",
    "description":"Response sent back in the case of an error.",
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Status code of the error.",
            "example":"IllegalArgument"
        },
        "message":{
            "type":"string",
            "description":"A descriptive error message.",
            "example":"argument given is not supported"
        }
    }
}

401レスポンス

未認可。ユーザーにはリクエストされた操作を実行する権限がありません

ルート・スキーマ: ErrorResponse

型: object

エラー発生時に返送されるレスポンス

ソースの表示

code: string

エラーのステータス・コード。

例: IllegalArgument
message: string

説明的なエラー・メッセージ

例: argument given is not supported

{
    "x-em-sdk-level":"emSDK",
    "description":"Response sent back in the case of an error.",
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Status code of the error.",
            "example":"IllegalArgument"
        },
        "message":{
            "type":"string",
            "description":"A descriptive error message.",
            "example":"argument given is not supported"
        }
    }
}

404レスポンス

見つかりません。リクエストされたREST API URLが見つかりません。

ルート・スキーマ: ErrorResponse

型: object

エラー発生時に返送されるレスポンス

ソースの表示

code: string

エラーのステータス・コード。

例: IllegalArgument
message: string

説明的なエラー・メッセージ

例: argument given is not supported

{
    "x-em-sdk-level":"emSDK",
    "description":"Response sent back in the case of an error.",
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Status code of the error.",
            "example":"IllegalArgument"
        },
        "message":{
            "type":"string",
            "description":"A descriptive error message.",
            "example":"argument given is not supported"
        }
    }
}

500レスポンス

内部サーバー・エラー。REST APIの実行中に例外が発生しました。

ルート・スキーマ: ErrorResponse

型: object

エラー発生時に返送されるレスポンス

ソースの表示

code: string

エラーのステータス・コード。

例: IllegalArgument
message: string

説明的なエラー・メッセージ

例: argument given is not supported

{
    "x-em-sdk-level":"emSDK",
    "description":"Response sent back in the case of an error.",
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Status code of the error.",
            "example":"IllegalArgument"
        },
        "message":{
            "type":"string",
            "description":"A descriptive error message.",
            "example":"argument given is not supported"
        }
    }
}

503レスポンス

サービスが使用できません。サーバーはリクエストを処理できません。

ルート・スキーマ: ErrorResponse

型: object

エラー発生時に返送されるレスポンス

ソースの表示

code: string

エラーのステータス・コード。

例: IllegalArgument
message: string

説明的なエラー・メッセージ

例: argument given is not supported

{
    "x-em-sdk-level":"emSDK",
    "description":"Response sent back in the case of an error.",
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Status code of the error.",
            "example":"IllegalArgument"
        },
        "message":{
            "type":"string",
            "description":"A descriptive error message.",
            "example":"argument given is not supported"
        }
    }
}

先頭に戻る