イメージ・リスト・エントリの管理

イメージ・リスト・エントリは、マシン・イメージをイメージ・リストに接続します。この項では、イメージ・リスト・エントリの管理に関連付けられる操作を示します。

トピック:

イメージ・リスト・エントリの追加

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

注意:

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

メソッド

POST

RESTリソース

/imagelist/name/entry/

URI

https://api_endpoint/imagelist/name/entry/

URIパラメータ

パラメータ	説明
name	イメージ・リスト・エントリの一意の階層名。たとえば、`/mytenant/public/myimagelistentry`ですオブジェクト名には、英数字、ハイフン、およびピリオドのみを使用できます。オブジェクト名は大文字と小文字が区別されます。

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

パラメータ	説明
machineimages	このイメージ・リストで使用するマシン・イメージのリスト
version	指定されたイメージ・リスト内のマシン・イメージのバージョン
attributes	(オプション)JSONオブジェクトとして指定され、起動時に、このマシン・イメージのインスタンスに渡されるユーザー定義済パラメータです。属性の詳細は、『Oracle Compute Cloud Serviceの使用』のオーケストレーション・テンプレートに関する項を参照してください。

URIの例

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

リクエスト本文の例

{
  "attributes": {"type": "Oracle Linux 6.6"}, 
  "version": 2, 
  "machineimages": ["/mytenant/public/ol66_40GB"], 
}

レスポンス本文の例

{
 "list": [
  {
   "attributes": {"type": "Oracle Linux 6.6"},
   "imagelist": {
    "default": 1,
    "description": null,
    "entries": null,
    "uri": "imagelist/mytenant/public/ol66_40GB",
    "name": "/mytenant/public/ol66_40GB"
   },
   "version": 2,
   "machineimages": ["/mytenant/public/ol66_40GB"],
   "uri": "https://api.oc.example.com/imagelist/mytenant/public/ol66_40GB/entry/2"
  }
 ]
}

イメージ・リスト・エントリの削除

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

注意:

削除できるのは、テナンシで作成されたイメージ・リスト・エントリのみです。

メソッド

DELETE

RESTリソース

/imagelist/name/entry/version

URI

https://api_endpoint/imagelist/name/entry/version

URIパラメータ

パラメータ	説明
name	イメージ・リスト・エントリの一意の階層名。たとえば、`/mytenant/public/myimagelistentry`です
version	指定されたイメージ・リストのマシン・イメージのバージョン。

URIの例

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

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

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

トピック:

イメージ・リスト・エントリの取得

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

メソッド

GET

RESTリソース

/imagelist/name

URI

https://api_endpoint/imagelist/name?version=versionValue

URIパラメータ

パラメータ	説明
name	イメージ・リスト・エントリの一意の階層名。 For example, `/mytenant/public/my-imagelist-1`
version=versionValue	(オプション)イメージ・リストのマシン・イメージのバージョン。

URIの例

https://api.oc.example.com/imagelist/oracle/public/linux6_16.1.2_64

レスポンス本文の例

{
 "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"
}

イメージ・リスト・エントリのリスト表示

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

メソッド

GET

RESTリソース

/imagelist/name

URI

https://api_endpoint/imagelist/name

URIパラメータ

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

URIの例

https://api.oc.example.com/imagelist/oracle/public/linux6_16.1.2_64

レスポンス本文の例

{
        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"
}