イメージ・リストの管理

バージョン管理されたインスタンス・テンプレートを作成するには、マシン・イメージをイメージ・リストに追加する必要があります。インスタンスを作成するためのオーケストレーションの起動プランを定義するときには、イメージ・リストを選択する必要があります。また、オプションで、起動用のメンバーのマシン・イメージのバージョンを選択することもできます。バージョンが選択されていない場合は、そのイメージ・リストに対して定義されたデフォルト・エントリが起動されます。たとえば、様々なOracle Linuxリリースの一連のマシン・イメージを含むイメージ・リストを設定できます。

トピック:

イメージ・リストの追加

このAPIを使用すると、イメージ・リストを追加できます。

注意:

システムに追加できるのは、秘密イメージ・リストのみです。公開イメージ・リストを追加するには、Oracle Cloud管理者に問い合せてください。

メソッド

POST

RESTリソース

/imagelist/

URI

https://api_endpoint/imagelist/

リクエスト本文のパラメータ

パラメータ	説明
name	イメージ・リストの一意の階層名。たとえば、`/mytenant/public/myimagelist`ですオブジェクト名には、英数字、ハイフン、およびピリオドのみを使用できます。オブジェクト名は大文字と小文字が区別されます。
description	このイメージ・リストの説明。
default	(オプション)これは、デフォルトとみなされるリスト内のイメージのバージョンです。特定のバージョンが指定されない場合、インスタンスの起動で、デフォルトが使用されます。

URIの例

https://api.oc.example.com/imagelist

リクエスト本文の例

{
 "default": 1, 
 "description": "ol 6", 
 "name": "/mytenant/public/ol6"
}

レスポンス本文の例

{
 "default": 1, 
 "description": "ol 6", 
 "entries": [], 
 "uri": "https://api.oc.example.com/imagelist/mytenant/public/ol6",
 "name": "/mytenant/public/ol6"
}

イメージ・リストの削除

このAPIを使用すると、特定のイメージ・リストを削除できます。

注意:

テナンシで削除できるのは、秘密イメージ・リストのみです。

メソッド

DELETE

RESTリソース

/imagelist/name

URI

https://api_endpoint/imagelist/name

URIパラメータ

パラメータ	説明
name	イメージ・リストの一意の階層名。たとえば、`/mytenant/public/myimagelist`です

URIの例

https://api.oc.example.com/imagelist/mytenant/public/oel59_20GB

イメージ・リストの更新

このAPIを使用すると、イメージ・リストの情報を更新できます。

注意:

自分が作成したプライベート・イメージ・リストのみを更新できます。

メソッド

PUT

RESTリソース

/imagelist/name

URI

https://api_endpoint/imagelist/name

URIパラメータ

パラメータ	説明
name	イメージ・リストの一意の階層名。たとえば、`/mytenant/public/myimagelist`です

リクエスト本文のパラメータ

パラメータ	説明
description	(オプション)このイメージ・リストの説明。
default	(オプション)これは、デフォルトとみなされるリスト内のイメージのバージョンです。特定のバージョンが指定されない場合、インスタンスの起動で、デフォルトが使用されます。

URIの例

https://api.oc.example.com/imagelist/mytenant/public/ol66_40GB

リクエスト本文の例

{
  "default": 2,
  "description": "OL 6.6 40 GB",
  "uri": "imagelist/mytenant/public/ol66_40GB",
  "name": "/mytenant/public/ol66_40GB"
}

レスポンス本文の例

{
  "default": 2,
  "description": "OL 6.6 40 GB",
  "entries": [],
  "uri": "https://api.oc.example.com/imagelist/mytenant/public/ol66_40GB",
  "name": "/mytenant/public/ol66_40GB"
}

イメージ・リストの詳細の取得

イメージ・リストの詳細を取得するには、REST APIを使用します。

トピック:

イメージ・リストの検出

このAPIを使用すると、特定のコンテナ内のイメージ・リスト名を検出できます。

注意:

検出APIコールは、指定されたコンテナ内のオブジェクトの名前を表示しますが、オブジェクトの詳細は表示しません。オブジェクトの名前をリストするには、Acceptヘッダーをapplication/oracle-compute-v3+directory+jsonに設定します。その他の目的では、Acceptヘッダーをapplication/oracle-compute-v3+jsonに設定する必要があります。

メソッド

GET

RESTリソース

/imagelist/container/

URI

https://api_endpoint/imagelist/container/

URIパラメータ

パラメータ	説明
container	イメージ・リストの階層名前空間。

URIの例

https://api.oc.example.com/imagelist/mytenant/public/

レスポンス本文の例

{"result": ["/mytenant/public/oel59_20G", "/mytenant/public/ol66_40GB"]}

イメージ・リストの取得

このAPIを使用すると、特定のイメージ・リストの詳細を取得できます。

メソッド

GET

RESTリソース

/imagelist/name

URI

https://api_endpoint/imagelist/name

URIパラメータ

パラメータ	説明
name	イメージ・リストの一意の階層名。たとえば、`/mytenant/public/myimagelist`です

URIの例

http://api/imagelist/oracle/public/linux5_16.1.2_64

レスポンス本文の例

{
"default": 1, 
"description": "A default public image.", 
"entries": [{"attributes": {}, 
"version": 1, "machineimages": ["/oracle/public/linux5_16.1.2_64"], 
"uri": "https://api/imagelist/oracle/public/linux5_16.1.2_64/entry/1"}], 
"uri": "https://api/imagelist/oracle/public/linux5_16.1.2_64", 
"name": "/oracle/public/linux5_16.1.2_64"
}

イメージ・リストのリスト

このAPIを使用すると、特定のコンテナ内に存在するすべてのイメージ・リストの情報を取得できます。

メソッド

GET

RESTリソース

/imagelist/container/

URI

https://api_endpoint/imagelist/container/

URIパラメータ

パラメータ	説明
container	イメージ・リストの階層名前空間。

URIの例

https://api.oc.example.com/imagelist/oracle/public/

レスポンス本文の例


{
{
        "default": 1, 
        "description": "A default public image.", 
        "entries": [{"attributes": {}, "version": 1, "machineimages": ["/oracle/public/linux6_16.1.2_64"], 
       "uri": "https://api/imagelist/oracle/public/linux6_16.1.2_64/entry/1"}], 
        "uri": "https://api/imagelist/oracle/public/linux6_16.1.2_64", 
        "name": "/oracle/public/linux6_16.1.2_64"
}, 
{
        "default": 1, 
        "description": "A default public image.", 
        "entries": [{"attributes": {}, "version": 1, "machineimages": ["/oracle/public/linux5_16.1.2_64"], 
       "uri": "https://api/imagelist/oracle/public/linux5_16.1.2_64/entry/1"}], 
        "uri": "https://api/imagelist/oracle/public/linux5_16.1.2_64", 
        "name": "/oracle/public/linux5_16.1.2_64"
}}