インスタンス・メタデータの取得

IMDSv2でサポートされているイメージ

IMDSv2は、次のプラットフォーム・イメージでサポートされています:

• Oracle Autonomous Linux 8.xイメージ
• 2020年6月以降にリリースされたOracle Autonomous Linux 7.xイメージ
• 2020年7月以降にリリースされたOracle Linux 8.x、Oracle Linux 7.xおよびOracle Linux 6.xイメージ

その他のプラットフォーム・イメージ、ほとんどのカスタム・イメージおよびほとんどのMarketplaceイメージは、IMDSv2をサポートしていません。cloud-initがバージョン20.3以降に更新され、Oracle Cloud Agentがバージョン0.0.19以降に更新されている場合、カスタム Linuxイメージは IMDSv2をサポートする可能性があります。Oracle Cloud Agentがバージョン1.0.0.0以降に更新されている場合、カスタムWindowsイメージはIMDSv2をサポートする可能性があります。cloudbase-initはIMDSv2をサポートしていません。

従来のIMDSv1エンドポイントへのリクエストの識別

リクエストが行われている特定のIMDSエンドポイントおよびリクエストを行っているエージェントを識別するには、InstanceMetadataRequestsメトリックを使用します。

インスタンスで有効になっているIMDSのバージョンを識別するには、次のいずれかを行います:

• コンソールの使用:
  1. ナビゲーション・メニューを開き、「コンピュート」をクリックします。「コンピュート」で、「インスタンス」をクリックします。
  2. 関心のあるインスタンスをクリックします。
  3. 「インスタンスの詳細」セクションで、「インスタンス・メタデータ・サービス」の横にあるバージョン番号を書き留めます。
• APIの使用: GetInstance操作またはListInstances操作を使用します。レスポンスでは、IMDSv1とIMDSv2の両方がインスタンスで有効になっている場合、InstanceOptionsオブジェクトのareLegacyImdsEndpointsDisabled属性はfalseを返します。IMDSv1が無効になっている場合、trueを返します。

従来のIMDSv1エンドポイントへのリクエストの無効化

次のいずれかを行います:

• コンソールの使用:
  1. ナビゲーション・メニューを開き、「コンピュート」をクリックします。「コンピュート」で、「インスタンス」をクリックします。
  2. 関心のあるインスタンスをクリックします。
  3. 「インスタンスの詳細」セクションで、「インスタンス・メタデータ・サービス」の横にある「編集」をクリックします。
  4. 「許可されるIMDSバージョン」で、「バージョン2のみ」オプションを選択します。
  5. 「変更の保存」をクリックします。
• APIの使用: UpdateInstance操作を使用します。リクエスト本文のInstanceOptionsオブジェクトで、areLegacyImdsEndpointsDisabled属性に値trueを渡します。

Linuxインスタンスのインスタンス・メタデータを取得するには

1. SSHを使用してLinuxインスタンスに接続します。

2. cURLを使用して、関心があるインスタンス・メタデータURLにGETリクエストを発行します。例:

   curl -H "Authorization: Bearer Oracle" -L http://169.254.169.254/opc/v2/instance/

Windowsインスタンスのインスタンス・メタデータを取得するには

Windowsインスタンスでメタデータを取得するステップは、メタデータのリクエスト元のインスタンス・メタデータ・サービスのバージョンによって異なります。

IMDSv2を使用してWindowsインスタンス・メタデータを取得するには:

1. リモート・デスクトップ接続を使用してWindowsインスタンスに接続します。

2. WindowsバージョンにcURLが含まれているかどうかに応じて、次のいずれかを行います:

   • WindowsバージョンにcURLが含まれている場合は、cURLを使用して、関心があるインスタンス・メタデータURLにGETリクエストを発行します。例:

     curl -H "Authorization: Bearer Oracle" -L http://169.254.169.254/opc/v2/instance/

   • WindowsバージョンにcURLが含まれていない場合は、インターネット・ブラウザでインスタンス・メタデータを取得できます。関心があるインスタンス・メタデータURLに移動し、認可ヘッダーを含むリクエストを渡します。リクエストにヘッダーを含める方法の詳細は、ブラウザの手順を参照してください。リクエスト・ヘッダーを含めることができるサードパーティのブラウザ拡張機能のインストールが必要になる場合があります。

IMDSv1を使用してWindowsインスタンス・メタデータを取得するには:

1. リモート・デスクトップ接続を使用してWindowsインスタンスに接続します。
2. インターネット・ブラウザを開き、関心のあるインスタンス・メタデータURLにアクセスします。

インスタンス・メタデータの再試行

インスタンス・メタデータ・サービスでは、メンテナンス用の短いダウンタイムが定期的に発生します。そのため、IMDSエンドポイントにアクセスしようとしても、使用できない場合があります。ベスト・プラクティスとして、IMDSエンドポイントにアクセスするときの再試行ロジックを実装してください。次の計画をお薦めします: 404、429または5xxレスポンスを受信した場合は、30秒のタイムアウトで最大3回再試行します。詳細および例は、SDK for Javaのドキュメントを参照してください。

インスタンスのメタデータ・キー

インスタンスに関する次のメタデータが使用可能です。パスはhttp://169.254.169.254/opc/v2/instance/を基準とした相対パスです。

インスタンスのすべての情報が表示されるレスポンスの例を次に示します:

{
  "availabilityDomain" : "EMIr:PHX-AD-1",
  "faultDomain" : "FAULT-DOMAIN-3",
  "compartmentId" : "ocid1.tenancy.oc1..exampleuniqueID",
  "displayName" : "my-example-instance",
  "hostname" : "my-hostname",
  "id" : "ocid1.instance.oc1.phx.exampleuniqueID",
  "image" : "ocid1.image.oc1.phx.exampleuniqueID",
  "metadata" : {
    "ssh_authorized_keys" : "example-ssh-key"
  },
  "region" : "phx",
  "canonicalRegionName" : "us-phoenix-1",
  "ociAdName" : "phx-ad-1",
  "regionInfo" : {
    "realmKey" : "oc1",
    "realmDomainComponent" : "oraclecloud.com",
    "regionKey" : "PHX",
    "regionIdentifier" : "us-phoenix-1"
  },
  "shape" : "VM.Standard.E3.Flex",
  "state" : "Running",
  "timeCreated" : 1600381928581,
  "agentConfig" : {
    "monitoringDisabled" : false,
    "managementDisabled" : false,
    "allPluginsDisabled" : false,
    "pluginsConfig" : [ {
      "name" : "OS Management Service Agent",
      "desiredState" : "ENABLED"
    }, {
      "name" : "Custom Logs Monitoring",
      "desiredState" : "ENABLED"
    }, {
      "name" : "Compute Instance Run Command",
      "desiredState" : "ENABLED"
    }, {
      "name" : "Compute Instance Monitoring",
      "desiredState" : "ENABLED"
    } ]
  },
  "freeformTags": {
    "Department": "Finance"
  },
  "definedTags": {
    "Operations": {
      "CostCenter": "42"
    }
  }
}

アタッチされたVNICのメタデータ・キー

インスタンスにアタッチされているVNICに関する次のメタデータが使用可能です。パスはhttp://169.254.169.254/opc/v2/vnics/を基準とした相対パスです。

[ {
    "vnicId" : "ocid1.vnic.oc1.phx.exampleuniqueID",
    "privateIp" : "10.0.3.6",
    "vlanTag" : 11,
    "macAddr" : "00:00:00:00:00:01",
    "virtualRouterIp" : "10.0.3.1",
    "subnetCidrBlock" : "10.0.3.0/24",
    "nicIndex" : 0
}, {
    "vnicId" : "ocid1.vnic.oc1.phx.exampleuniqueID",
    "privateIp" : "10.0.4.3",
    "vlanTag" : 12,
    "macAddr" : "00:00:00:00:00:02",
    "virtualRouterIp" : "10.0.4.1",
    "subnetCidrBlock" : "10.0.4.0/24",
    "nicIndex" : 0
} ]

マルチパス対応アタッチメントでアタッチされているボリュームのメタデータ・キー

インスタンスにアタッチされているマルチパス対応ボリューム・アタッチメントに関する次のメタデータが使用可能です。パスはhttp://169.254.169.254/opc/v2/volumeAttachments/を基準とした相対パスです。

インスタンスのマルチパス対応ボリューム・アタッチメントを示すレスポンスの例を次に示します:

[
  {
    "id": "ocid1.volumeattachment.oc1.phx.exampleuniqueID",
    "instanceId": "ocid1.instance.oc1.phx.exampleuniqueID",
    "volumeId": "ocid1.volume.oc1.phx.exampleuniqueID",
    "ipv4": "169.254.2.2",
    "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
    "port": 3260,
    "multipathDevices":
    [
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      },
      {
        "ipv4": "exampleIP",
        "iqn": "iqn.2015-12.com.oracleiaas:exampleuniqueID",
        "port": 3260
      }
    ]
  }
]