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

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

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

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

その他のプラットフォーム・イメージ、ほとんどのカスタム・イメージおよびほとんどのマーケットプレイス・イメージは、IMDSv2をサポートしていません。cloud-initがバージョン20.3以降に更新され、Oracle Cloud Agentがバージョン0.0.19以降に更新されている場合、カスタム Linuxイメージは IMDSv2をサポートする可能性があります。Oracle Cloudエージェントがバージョン 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
      }
    ]
  }
]

シェイプ構成のメタデータ・キー

このコマンドは、各コンピュート・シェイプで使用可能なOCPUを表示します。この情報は、アプリケーションがOCPUS、VNICまたは構成可能なシェイプの詳細について詳しく知る必要があるフレックス・シェイプに役立ちます。

インスタンスにアタッチされているコンピュート・シェイプに関する次のメタデータが使用可能です。パスはhttp://169.254.169.254/opc/v2/instance/shapeConfigを基準とした相対パスです。

次のcURLコマンドを使用して、関心があるインスタンス・シェイプ構成メタデータにGETリクエストを発行します。

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

Linuxインスタンスのシェイプ構成メタデータを示すレスポンスの例を次に示します。

{
  "ocpus" : 4.0,
  "memoryInGBs" : 60.0,
  "networkingBandwidthInGbps" : 4.0,
  "maxVnicAttachments" : 4
}