tencent cloud

PrevNext

フィードバック

キーワードで検索してください

Recent Pages

ドキュメント
Cloud Virtual Machine
    ドキュメント
    Download PDF

    インスタンスメタデータのクエリ

    最終更新日:2023-07-19 10:51:48
    PDFファイルをダウンロード
      インスタンスメタデータは、インスタンスに関連するデータを指します。実行中のインスタンスを構成または管理するために使用できます。
      説明：
      インスタンスのメタデータにはログイン後にのみアクセスできますが、データは暗号化されていません。インスタンスにアクセスできる人員はいずれもそのメタデータを表示できます。そのため、機密データを保護するために適切な予防措置を講じる必要があります。

      インスタンスメタデータの分類

      Tencent Cloudは現在、次のメタデータを提供しています。
      データ
      説明
      バージョン
      instance-id
      インスタンスID
      1.0
      instance-name
      インスタンス名
      1.0
      uuid
      インスタンスID
      1.0
      local-ipv4
      インスタンスのプライベートIP アドレス
      1.0
      public-ipv4
      インスタンスのパブリックIPアドレス
      1.0
      mac
      インスタンスのeth0デバイスの MAC アドレス
      1.0
      placement/region
      インスタンスのリージョン
      2017年9月19日更新
      placement/zone
      インスタンスのアベイラビリティーゾーン
      2017年9月19日更新
      network/interfaces/macs/${mac}/mac
      インスタンスネットワークインターフェースのデバイスアドレス
      1.0
      network/interfaces/macs/${mac}/primary-local-ipv4
      インスタンスネットワークインターフェースのプライマリプライベートIPアドレス
      1.0
      network/interfaces/macs/${mac}/public-ipv4s
      インスタンスネットワークインターフェースのパブリックIPアドレス
      1.0
      network/interfaces/macs/${mac}/vpc-id
      インスタンスネットワークインターフェースのVPC ID
      2017年9月19日更新
      network/interfaces/macs/${mac}/subnet-id
      インスタンスネットワークインターフェースのサブネットID
      2017年9月19日更新
      network/interfaces/macs/${mac}/local-ipv4s/${local-ipv4}/gateway
      インスタンスネットワークインターフェースのゲートウェイアドレス
      1.0
      network/interfaces/macs/${mac}/local-ipv4s/${local-ipv4}/local-ipv4
      インスタンスネットワークインターフェースのプライベートIPアドレス
      1.0
      network/interfaces/macs/${mac}/local-ipv4s/${local-ipv4}/public-ipv4
      インスタンスネットワークインターフェースのパブリックIPアドレス
      1.0
      network/interfaces/macs/${mac}/local-ipv4s/${local-ipv4}/public-ipv4-mode
      インスタンスネットワークインターフェースのパブリックネットワークモード
      1.0
      network/interfaces/macs/${mac}/local-ipv4s/${local-ipv4}/subnet-mask
      インスタンスネットワークインターフェースのサブネットマスク
      1.0
      payment/charge-type
      インスタンスの料金プラン
      2017年9月19日更新
      payment/create-time
      インスタンスの作成時間
      2017年9月19日更新
      payment/termination-time
      インスタンスの終了時間
      2017年9月19日更新
      app-id
      インスタンスが属するユーザーの AppId
      2017年9月19日更新
      as-group-id
      インスタンスのAuto ScalingグループID
      2017年9月19日更新
      spot/termination-time
      スポットインスタンスの終了時間
      2017年9月19日更新
      instance/instance-type
      インスタンス仕様
      2017年9月19日更新
      instance/image-id
      インスタンスのイメージ ID
      2017年9月19日更新
      instance/security-group
      インスタンスに関連付けられているセキュリティグループの情報
      2017年9月19日更新
      instance/bandwidth-limit-egress
      インスタンスのプライベートネットワークの送信帯域幅制限(Kbit/s)
      2019年9月29日更新
      instance/bandwidth-limit-ingress
      インスタンスのプライベートネットワークの受信帯域幅制限(Kbit/s)
      2019年9月29日更新
      cam/security-credentials/${role-name}
      CAMロールポリシーによって生成される一時的な認証情報。インスタンスがCAMロールに関連付けられている場合にのみ取得できます。 ${role-name} を実際のCAMロール名に変更する必要があります。それ以外の場合は、`404` が返されます。
      2019年12月11日更新
      volumes
      インスタンス ストレージ
      1.0
      説明：
      上記テーブルにおける ${mac} および ${local-ipv4}フィールドはそれぞれインスタンスに指定されたネットワークインターフェースのMACアドレスとプライベートIPアドレスを表します。
      リクエストの宛先URLアドレスは、大文字と小文字を区別する必要があります。返されたリクエストの結果に従って、新しいリクエストの宛先URLアドレスを作成する必要があります。
      返された配置データは、新しいバージョンで変更されています。以前のバージョンのデータを使用する必要がある場合、以前のバージョンのパスを指定するか、バージョンのパスを指定しないことによりバージョン1.0のデータにアクセスすることができます。返された配置データの詳細については、リージョンとアベイラビリティゾーン をご参照ください。

      インスタンスメタデータのクエリ

      インスタンスにログインすると、インスタンスのローカルIPアドレスやパブリックIPアドレスなどのメタデータにアクセスして、外部アプリケーションとの接続を管理できます。 実行中のインスタンス内部からすべてのカテゴリーのインスタンスメタデータを確認するには、次のURIを使用してください。
      http://metadata.tencentyun.com/latest/meta-data/
      cURLツールまたはHTTP GETリクエストを介してメタデータにアクセスできます。例：
      curl http://metadata.tencentyun.com/latest/meta-data/
      リソースが存在しない場合、HTTPエラーコード「404 Not Found」が返されます。
      メタデータ関連の操作はすべて、インスタンスにログインした後のみ実行できます。‍まずインスタンスにログインしてください。詳細については、 Windowsインスタンスへのログイン または[ Linuxインスタンスへのログイン]をご参照ください。

      メタデータクエリ例

      以下の例では、メタデータのバージョン情報を取得する方法を説明します。
      ご注意：
      Tencent Cloudがメタデータのアクセスパスまたは返されたデータを変更する時、新しいメタデータのバージョンをリリースします。お客様のアプリケーションプログラムまたはスクリプトが以前のバージョンの構造または返されたデータに依存している場合、指定された初期のバージョンを使用してメタデータにアクセスできます。バージョンを指定しない場合、デフォルトでバージョン1.0がアクセスされます。
      [qcloud-user]# curl http://metadata.tencentyun.com/
      1.0
      2017-09-19
      latest
      meta-data
      以下の例では、メタデータのバージョン情報を取得する方法を説明します。そのうち「/」で終わる単語はディレクトリを表し、「/」で終わらない単語はアクセスデータを表します。具体的なアクセスデータの意味は、前文のインスタンスメタデータの分類をご参照ください。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/
      instance-id
      instance-name
      local-ipv4
      mac
      network/
      placement/
      public-ipv4
      uuid
      以下の例では、インスタンスの物理的な位置情報を取得する方法を説明します。 返されるデータと物理的な位置情報の関係については、リージョンとアベイラビリティゾーンをご参照ください。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/placement/region
      ap-guangzhou
      
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/placement/zone
      ap-guangzhou-3
      以下の例では、インスタンスのプライベートIPアドレスを取得する方法を説明します。インスタンスに複数のENIがある場合、eth0デバイスのネットワークアドレスが返されます。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/local-ipv4
      10.104.13.59/
      以下の例では、インスタンスのパブリックIPアドレスを取得する方法を説明します。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/public-ipv4
      139.199.11.29
      以下の例では、インスタンス ID を取得する方法を説明します。インスタンスIDはインスタンスの一意の識別子です。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/instance-id
      ins-3g445roi
      以下の例では、インスタンスUUIDを取得する方法を説明します。インスタンスUUIDはインスタンスの一意の識別子とすることができますが、インスタンスIDを使用してインスタンスを識別することをお勧めします。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/uuid
      cfac763a-7094-446b-a8a9-b995e638471a
      以下の例では、インスタンスのeth0デバイスのMACアドレスを取得する方法を説明します。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/mac
      52:54:00:BF:B3:51
      以下の例では、インスタンスのENI情報を取得する方法を説明します。複数枚のENIは複数行のデータを戻し、各行のデータはENI1枚のデータディレクトリです。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/
      52:54:00:BF:B3:51/
      以下の例では、指定されたENIの情報を取得する方法を説明します。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/52:54:00:BF:B3:51/
      local-ipv4s/
      mac
      vpc-id
      subnet-id
      owner-id
      primary-local-ipv4
      public-ipv4s
      local-ipv4s/
      以下の例では、指定されたENIのVPC情報を取得する方法を説明します。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/52:54:00:BF:B3:51/vpc-id
      vpc-ja82n9op
      
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/52:54:00:BF:B3:51/subnet-id
      subnet-ja82n9op
      以下の例では、指定されたENIにバインドされたプライベートIPアドレスのリストを取得する方法を説明します。ENIが複数のプライベートIPアドレスにバインドされている場合、複数行のデータが返されます。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/52:54:00:BF:B3:51/local-ipv4s/
      10.104.13.59/
      以下の例では、プライベートIPアドレスの情報を取得する方法を説明します。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/52:54:00:BF:B3:51/local-ipv4s/10.104.13.59
      gateway
      local-ipv4
      public-ipv4
      public-ipv4-mode
      subnet-mask
      以下の例では、プライベートIPアドレスのゲートウェイを取得する方法を説明します。VPCモデルのみがこのデータをクエリできます。VPCモデルの詳細については、Virtual Private Cloud をご参照ください。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/52:54:00:BF:B3:51/local-ipv4s/10.104.13.59/gateway
      10.15.1.1
      以下の例では、プライベートIPアドレスがパブリックネットワークにアクセスするために使用するアクセスモードを取得する方法を説明します。VPCモデルのみがこのデータをクエリできます。クラシックネットワークタイプの CVMインスタンスは、パブリックネットワークゲートウェイを介してパブリックネットワークにアクセスします。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/52:54:00:BF:B3:51/local-ipv4s/10.104.13.59/public-ipv4-mode
      NAT
      以下の例では、プライベートIPアドレスにバインドされたパブリックIPアドレスを取得する方法を説明します。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/52:54:00:BF:B3:51/local-ipv4s/10.104.13.59/public-ipv4
      139.199.11.29
      以下の例では、プライベートIPアドレスのサブネットマスクを取得する方法を説明します。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/network/interfaces/macs/52:54:00:BF:B3:51/local-ipv4s/10.104.13.59/subnet-mask
      255.255.192.0
      以下の例では、インスタンスの課金方法を取得する方法を説明します。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/payment/charge-type
      POSTPAID_BY_HOUR
      以下の例では、インスタンスの作成時間を取得する方法を説明します。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/payment/create-time
      2018-09-18 11:27:33
      以下の例では、スポットインスタンスの終了時間を取得する方法を説明します。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/spot/termination-time
      2018-08-18 12:05:33
      以下の例では、CVMが属するアカウントAppIdを取得する方法を説明します。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/app-id
      123456789
      以下の例では、インスタンスが属する CAM ロールによって生成された一時的な認証情報を取得する方法を説明します。この例では、ロール名は「CVMas」です。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/cam/security-credentials/CVMas
      {
        "TmpSecretId": "************************************",
        "TmpSecretKey": "********************************",
        "ExpiredTime": 1615590047,
        "Expiration": "2021-03-12T23:00:47Z",
        "Token": "******",
        "Code": "Success"
      }
      以下の例では、インスタンスストレージをクエリする方法を説明します。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/meta-data/volumes
      disk-xxxxxxxx/

      インスタンスユーザーデータのクエリ

      インスタンスの作成時にインスタンスユーザーデータを指定できます。 cloud-initが設定されたCVMインスタンスはこのデータにアクセスできます。

      ユーザーデータの検索

      インスタンスにログイン後、以下の方法でユーザーデータにアクセスできます。
      [qcloud-user]# curl http://metadata.tencentyun.com/latest/user-data
      179, client, shanghai
      
      お問い合わせ

      カスタマーサービスをご提供できるため、ぜひお気軽にお問い合わせくださいませ。

      お問い合わせ
      テクニカルサポート

      さらにサポートが必要な場合は、サポートチケットを送信して弊社サポートチームにお問い合わせください。24時間365日のサポートをご提供します。

      チケットを送信
      電話サポート（24 時間365日対応）
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      個人情報保護方針利用規約クッキーポリシー