最新情報とお知らせ

製品情報

パブリックイメージの更新情報

OSの公式サポート終了計画

製品に関するお知らせ

製品概要

CVM概要

製品の強み

基本概念

リージョンとゾーン

初心者ガイド

Service Regions and Service Providers

製品の課金

課金概要

課金モデル

課金項目

課金モデルの変更

購入インスタンス

仕様変更の料金説明

料金未払いに関する説明

クイックスタート

カスタム設定によるLinuxインスタンスの購入

カスタム設定によるWindowsインスタンスの購入

ユーザーガイド

操作ガイド一覧

ご利用制限一覧

インスタンス

スポットインスタンス

リザーブドインスタンス

イメージ

ストレージ

バックアップと復元

ネットワーク

セキュリティ

パスワード/キー

監視とアラート

運用管理

便利な機能

サーバー移行

オンライン移行

オフライン移行

移行に関するご相談

トラブルシューティング

CVMインスタンスにログインできない原因や対処法

Windowsインスタンスのログインに関する障害

Linuxインスタンスのログインに関する障害

その他のインスタンスログインに関する障害

インスタンス実行時の障害

Linuxインスタンスのメモリに関する障害

ネットワーク障害

実践チュートリアル

CVMの選定ガイド

環境構築

ウェブサイトの構築

アプリケーションの構築

可視化ページの構築

ローカルファイルをCVMへアップロード

ネットワークパフォーマンステスト

その他の実践チュートリアル

API リファレンス

History

Introduction

API Category

Making API Requests

Region APIs

Instance APIs

Cloud Hosting Cluster APIs

Image APIs

Instance Launch Template APIs

Placement Group APIs

Key APIs

Security Group APIs

Network APIs

Data Types

Error Codes

セキュリティとコンプライアンス

Cloud Access Management（CAM）

ネットワーク

よくあるご質問

リージョンとアベイラビリティゾーンに関するご質問

課金クラス

インスタンスに関するご質問

ストレージに関するご質問

イメージに関するご質問

サーバー移行について

ネットワークに関するご質問

セキュリティに関するご質問

OSに関するご質問

運用と監視に関するご質問

CAMに関するご質問

NTPサービスに関するご質問

適用シナリオに関するご質問

Agreements

CVM Service Level Agreements

Red Hat Enterprise Linux Image Service Agreement

Public IP Service Level Agreement

用語集

インスタンスメタデータの表示

PDF

フォーカスモード

フォントサイズ

最終更新日: 2023-07-19 10:51:48

インスタンスメタデータは、インスタンスに関連するデータを指します。実行中のインスタンスを構成または管理するために使用できます。
説明：
インスタンスのメタデータにはログイン後にのみアクセスできますが、データは暗号化されていません。インスタンスにアクセスできる人員はいずれもそのメタデータを表示できます。そのため、機密データを保護するために適切な予防措置を講じる必要があります。
インスタンスメタデータの分類
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
﻿

ヘルプとサポート

この記事はお役に立ちましたか？

営業担当者にお問い合わせいただくかチケットを提出してサポートを求めることができます。

フィードバック

tencent cloud

Cloud Virtual Machine

インスタンスメタデータの表示

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

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

メタデータクエリ例

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

ユーザーデータの検索

ヘルプとサポート

データ	説明	バージョン
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