機械翻訳について
  1. Oracle Cloud Infrastructure Compute ClassicのREST API
  2. タスク
  3. インスタンス

コンテナ内のすべてのインスタンスに関する詳細の取得

get

/instance/{container}/

指定したコンテナ内の、指定した問合せ基準に一致するインスタンスの詳細を取得します。 問合せ基準を指定しない場合は、コンテナ内のすべてのインスタンスの詳細が表示されます。 検索結果をフィルタリングするには、次の問合せパラメータの1つ以上を、次の構文のURIに追加することによって渡します。

?parameter1=value1&parameter2=value2&parameterN=valueN

必要なロール: このタスクを実行するには、Compute_MonitorまたはCompute_Operationsのロールが必要です。 このロールが割り当てられていない、または割当てが不明な場合は、システム管理者に連絡してロールがユーザーにOracle Cloud My Servicesで割り当てられるようにしてください。 Oracle Cloudの管理および監視のユーザー・ロールの変更に関する項を参照してください。

リクエスト

サポートされるメディア・タイプ
パス・パラメータ
問合せパラメータ
  • インスタンスが入っている可用性ドメイン
  • インスタンスのタグ付けに使用される文字列。 タグの指定時には、指定した値でタグ付けされたインスタンスのみが表示されます。
ヘッダー・パラメータ
トップに戻る

レスポンス

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

200レスポンス

OK。 返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。
ヘッダー
本文 ()
ルート・スキーマ : Instance-list-response
型: object
ソースの表示
ネストされたスキーマ : result
型: array
ソースの表示
ネストされたスキーマ : Instance-response
型: object
ソースの表示
ネストされたスキーマ : attributes
型: object
使用可能なその他のプロパティ
ソースの表示
インスタンスに対して使用可能にする属性のディクショナリ。 キー"userdata"を持つ値はEC2互換の使用方法で使用可能になります。
ネストされたスキーマ : boot_order
型: array
起動順序リスト。
ソースの表示
ネストされたスキーマ : hypervisor
型: object
使用可能なその他のプロパティ
ソースの表示
ハイパーバイザ固有属性のディクショナリ。
ネストされたスキーマ : networking
型: object
使用可能なその他のプロパティ
ソースの表示
「このインスタンスにアタッチされる仮想NICのネットワーク指定子」のマッピング。
ネストされたスキーマ : placement_requirements
型: array
配置場所に一致するノードに任意のタグを指定する文字列のリスト。
ソースの表示
ネストされたスキーマ : relationships
型: array
このインスタンスの配置場所で満たされる必要のある関係指定のリスト
ソースの表示
ネストされたスキーマ : resolvers
型: array
デフォルト・リゾルバのかわりに使用するリゾルバ。
ソースの表示
ネストされたスキーマ : sshkeys
型: array
インスタンスに公開されるSSHキー。
ソースの表示
ネストされたスキーマ : storage_attachments
型: array
ストレージ・アタッチメント情報が含まれるディクショナリのリスト。
ソースの表示
ネストされたスキーマ : tags
型: array
インスタンスのタグ付けに使用される文字列のカンマ区切りリスト。
ソースの表示
ネストされたスキーマ : additionalProperties
型: object
ネストされたスキーマ : additionalProperties
型: object
ネストされたスキーマ : additionalProperties
型: object
ネストされたスキーマ: items
型: object
使用可能なその他のプロパティ
ソースの表示
ネストされたスキーマ : additionalProperties
型: object
トップに戻る

例

cURLコマンド

次の例では、cURLを使用してRESTリソースに対するGETリクエストを発行することによって、/Compute-acme/jack.jones@example.com/コンテナ内のすべてのインスタンスの詳細を取得する方法を示しています。 cURLの詳細は、「cURLの使用」を参照してください。

コマンドを1行で入力します。 この例では、読みやすくするために改行が使用されています。 

curl -X GET 
     -H "Cookie: $COMPUTE_COOKIE"
     -H "Accept: application/oracle-compute-v3+json"
     https://api-z999.compute.us0.oraclecloud.com/instance/Compute-acme/jack.jones@example.com/

  • COMPUTE_COOKIEは、前の手順で認証cookieを格納した変数の名前です。 認証クッキーの取得および変数への格納の詳細は、認証を参照してください。

  • api-z999.compute.us0.oraclecloud.comはRESTエンドポイントURLの例です。 この値をCompute ClassicサイトのRESTエンドポイントURLに変更します。 サイトのRESTエンドポイントURLを見つける方法については、「リクエストの送信」を参照してください。

レスポンス本文の例

次の例では、インスタンスのJSON形式のレスポンス本文を示します。

レスポンスは、GET /instance/{name} (インスタンスの詳細の取得)の出力と似ていますが、コンテナ内のすべてのインスタンスが対象になります。

いくつかの行は、読みやすくするために省略記号(...)で切り捨てられます。

{
 "list": [
  {
   "domain": "acme...",
   "placement_requirements": [
    "/system/compute/placement/default",
    "/system/compute/allow_instances"
   ],
   "ip": "10...",
   "site": "",
   "shape": "oc5",
   "imagelist": "/oracle/public/oel_6.4_60GB",
   "attributes": {
    "network": {
     "nimbula_vcable-eth0": {
      "vethernet_id": "0",
      "vethernet": "/oracle/public/default",
      "address": [
       "c6:b0:09:f4:bc:c0",
       "0.0.0.0"
      ],
      "model": "",
      "vethernet_type": "vlan",
      "id": "/Compute-acme/jack.jones@example.com/016e75e7-e911-42d1-bfe1-6a7f1b3f7908",
      "dhcp_options": []
     }
    },
    "dns": {
     "domain": "acme...",
     "hostname": "d06886.compute-acme...",
     "nimbula_vcable-eth0": "d06886.acme..."
    },
    "sshkeys": [
     "ssh-rsa AAAAB3NzaC1yc2EAAA..."
    ]
   },
   "networking": {
    "eth0": {
     "model": "",
     "dns": [
      "d06886.acme..."
     ],
     "seclists": [
      "/Compute-acme/default/default",
      "/Compute-acme/jack.jones@example.com/prod-ng"
     ],
     "vethernet": "/oracle/public/default",
     "nat": "ipreservation:/Compute-acme/jack.jones@example.com/prod-vm1"
    }
   },
   "hostname": "d06886.acme...",
   "quota_reservation": "/Compute-acme/ffc8e6d4-8f93-41f3-a062-bdbb042c3191",
   "disk_attach": "",
   "label": "Production instance 1",
   "priority": "/oracle/public/default",
   "state": "running",
   "vnc": "10...",
   "storage_attachments": [
    {
     "index": 1,
     "storage_volume_name": "/Compute-acme/jack.jones@example.com/prod-vol1",
     "name": "/Compute-acme/admin/dev1/f653a677-b566-4f92-8e93-71d47b364119/f1a67244-9abc-45d5-af69-8..."
    }
   ],
   "start_time": "2014-06-24T17:51:35Z",
   "quota": "/acme",
   "fingerprint": "19:c4:3f:2d:dc:76:b1:06:e8:88:bd:7f:a3:3b:3c:93",
   "error_reason": "",
   "sshkeys": [
    "/Compute-acme/jack.jones@example.com/acme-prod-admin"
   ],
   "tags": [
    "prod2"
   ],
   "resolvers": null,
   "account": "/Compute-acme/default",
   "name": "/Compute-acme/jack.jones@example.com/dev1/f653a677-b566-4f92-8e93-71d47b364119",
   "vcable_id": "/Compute-acme/jack.jones@example.com/016e75e7-e911-42d1-bfe1-6a7f1b3f7908",
   "uri": "http://10....",
   "reverse_dns": true,
   "entry": 1,
   "boot_order": []
  }
 ]
}
トップに戻る