Oracle Enterprise ManagerのREST API

イメージ・バージョンのリスト

get

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

イメージ・バージョンをリストします

リクエスト

パス・パラメータ

goldImageId(必須): string

イメージのID

問合せパラメータ

limit: integer(int32)
レスポンス内のアイテム数を制限します
例:
```
10
```
nameMatches: string
イメージの名前のワイルドカード検索
例:
```
%DB19%
```
page: string
アイテムの次のセット(ページ)を示すマーカー
例:
```
b2Zmc2V0OjA
```
sort: string
フィールドとソート方向(オプション)のカンマ区切りリスト。ソートでサポートされている属性は'name'です。有効なソート方向は'asc'および'desc'です。ソート方向を指定しない場合、デフォルトで'asc'が使用されます。
例:
```
name:asc, name:desc, name
```
statusMatches: string
イメージ・バージョンのステータスのワイルドカード検索
例:
```
%CURRENT%
```

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

先頭に戻る

レスポンス

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

application/json

200レスポンス

OK。イメージ・バージョンが取得されました。

ルート・スキーマ: GoldImageVersionCollection

型: object

イメージ・バージョンのリスト

ソースの表示

items(必須): array items

イメージ・バージョンの配列

{
    "type":"object",
    "description":"List of the image versions",
    "required":[
        "items"
    ],
    "allOf":[
        {
            "$ref":"#/components/schemas/Pagination"
        }
    ],
    "properties":{
        "items":{
            "type":"array",
            "description":"Array of the image version",
            "items":{
                "$ref":"#/components/schemas/GoldImageVersionSummary"
            }
        }
    }
}

すべてに一致

ソースの表示

object Pagination

リンク付きのアイテムのコレクション

{
    "type":"object",
    "description":"List of the image versions",
    "required":[
        "items"
    ],
    "allOf":[
        {
            "$ref":"#/components/schemas/Pagination"
        }
    ],
    "properties":{
        "items":{
            "type":"array",
            "description":"Array of the image version",
            "items":{
                "$ref":"#/components/schemas/GoldImageVersionSummary"
            }
        }
    }
}

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

型: array

イメージ・バージョンの配列

ソースの表示

配列: object GoldImageVersionSummary

イメージ・バージョンのサマリー

{
    "type":"array",
    "description":"Array of the image version",
    "items":{
        "$ref":"#/components/schemas/GoldImageVersionSummary"
    }
}

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

型: object

リンク付きのアイテムのコレクション

ソースの表示

count: integer

このフェッチの数

例: 40
links: object Links

リンクの配列を表します
total: integer

合計数

例: 40

{
    "description":"Collection of items with links",
    "properties":{
        "total":{
            "type":"integer",
            "description":"total count",
            "example":"40"
        },
        "count":{
            "type":"integer",
            "description":"Count of this fetch",
            "example":"40"
        },
        "links":{
            "$ref":"#/components/schemas/Links"
        }
    }
}

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

型: object

イメージ・バージョンのサマリー

ソースの表示

externalId: string

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

例: oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_OracleDB:4BAFA861A7E96603E053057FB10A0588:0.1
hashCode: string

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

例: C1622270664:B<NO_PATCHES>
id: string

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

例: 4BAFA861A7ED6603E053057FB10A0588
imageId: string

イメージのID

例: 4B7738536B6E7888E053057FB10ACF8C
links: object links

ナビゲーション・リンク
name: string

イメージ・バージョンの名前

例: PSUNos
position: string

イメージ・バージョンの位置

例: 1
provisioningStatus: string

プロビジョニングのステータス

例: READY
releaseVersion: string

バージョンのRU詳細

例: 19.12.0.0.0
status: string

イメージ・バージョンのステータス

例: CURRENT
timeCreated: string (date-time)

イメージ・バージョンの作成時間

例: 2017-03-27 10:13:28.0

{
    "description":"Summary of the image version",
    "type":"object",
    "properties":{
        "name":{
            "description":"Name of the image version",
            "type":"string",
            "example":"PSUNos"
        },
        "id":{
            "description":"ID of the image version",
            "type":"string",
            "example":"4BAFA861A7ED6603E053057FB10A0588"
        },
        "imageId":{
            "description":"ID of the image",
            "type":"string",
            "example":"4B7738536B6E7888E053057FB10ACF8C"
        },
        "externalId":{
            "description":"External ID of the image version",
            "type":"string",
            "example":"oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_OracleDB:4BAFA861A7E96603E053057FB10A0588:0.1"
        },
        "status":{
            "description":"Status of the image version",
            "type":"string",
            "example":"CURRENT"
        },
        "position":{
            "description":"Position of a image version",
            "type":"string",
            "example":"1"
        },
        "hashCode":{
            "description":"HashCode of the image version",
            "type":"string",
            "example":"C1622270664:B<NO_PATCHES>"
        },
        "timeCreated":{
            "description":"Creation time of the image version",
            "type":"string",
            "format":"date-time",
            "example":"2017-03-27 10:13:28.0"
        },
        "provisioningStatus":{
            "description":"Status of the provisioning",
            "type":"string",
            "example":"READY"
        },
        "releaseVersion":{
            "description":"RU details of the version",
            "type":"string",
            "example":"19.12.0.0.0"
        },
        "links":{
            "type":"object",
            "description":"Navigation links",
            "properties":{
                "self":{
                    "$ref":"#/components/schemas/Link"
                }
            }
        }
    }
}

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

型: object

ナビゲーション・リンク

ソースの表示

self: object Link

リンクを表します(self、previous、nextのいずれか)

{
    "type":"object",
    "description":"Navigation links",
    "properties":{
        "self":{
            "$ref":"#/components/schemas/Link"
        }
    }
}

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

型: object

リンクを表します(self、previous、nextのいずれか)

ソースの表示

href: string

リンクのためのURL

例: /em/api/<resources>?page=b2Zmc2V0OjA&limit=0

{
    "type":"object",
    "description":"Represents a link(could be self, previous or next)",
    "properties":{
        "href":{
            "type":"string",
            "description":"URL for Link",
            "example":"/em/api/<resources>?page=b2Zmc2V0OjA&limit=0"
        }
    }
}

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

型: object

リンクの配列を表します

ソースの表示

next: object Link

リンクを表します(self、previous、nextのいずれか)
previous: object Link

リンクを表します(self、previous、nextのいずれか)
self: object Link

リンクを表します(self、previous、nextのいずれか)

{
    "description":"Represents the array of links",
    "type":"object",
    "properties":{
        "self":{
            "$ref":"#/components/schemas/Link"
        },
        "previous":{
            "$ref":"#/components/schemas/Link"
        },
        "next":{
            "$ref":"#/components/schemas/Link"
        }
    }
}

例

400レスポンス

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

ルート・スキーマ: ErrorResponse

型: object

エラー・レスポンス

ソースの表示

code(必須): string

プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
message(必須): string

判読可能なエラー文字列

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

401レスポンス

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

ルート・スキーマ: ErrorResponse

型: object

エラー・レスポンス

ソースの表示

code(必須): string

プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
message(必須): string

判読可能なエラー文字列

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

403レスポンス

禁止。ユーザーは、リクエストされた操作の実行を禁止されています

ルート・スキーマ: ErrorResponse

型: object

エラー・レスポンス

ソースの表示

code(必須): string

プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
message(必須): string

判読可能なエラー文字列

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

404レスポンス

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

ルート・スキーマ: ErrorResponse

型: object

エラー・レスポンス

ソースの表示

code(必須): string

プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
message(必須): string

判読可能なエラー文字列

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

500レスポンス

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

ルート・スキーマ: ErrorResponse

型: object

エラー・レスポンス

ソースの表示

code(必須): string

プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
message(必須): string

判読可能なエラー文字列

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

503レスポンス

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

ルート・スキーマ: ErrorResponse

型: object

エラー・レスポンス

ソースの表示

code(必須): string

プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
message(必須): string

判読可能なエラー文字列

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

先頭に戻る