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

インスタンスに関する詳細の取得

get

/instance/{name}

指定したインスタンスの詳細を取得します。

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

リクエスト

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

  • オブジェクトの、複数部分からなる名前。

ヘッダー・パラメータ
トップに戻る

レスポンス

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

200レスポンス

OK。 返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。
ヘッダー
本文 ()
ルート・スキーマ : 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/dev1/f653a677-b566-4f92-8e93-71d47b364119の詳細を取得する方法を示しています。 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/dev1/f653a677-b566-4f92-8e93-71d47b364119

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

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

  • acmeおよびjack.jones@example.comは値の例です。 acmeをCompute Classicアカウントのアイデンティティ・ドメインIDに置き換え、jack.jones@example.comをユーザー名で置き換えます。

レスポンス本文の例

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

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

{
 "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": []
  }
 ]
}
トップに戻る