仮想サーバーインスタンスの IBM Cloud® Virtual Private Cloud (VPC) メタデータについて
VPCメタデータサービスは、仮想サーバーインスタンスに関する情報にアクセスするために使用できる無料のサービスです。 インスタンス内で REST API を介してサービスを呼び出して、そのインスタンスに関する情報を取得できます。 インスタンスの外部から API にアクセスすることはできません。 メタデータにアクセスする前に、IDアクセストークンを生成する必要があります。 ID トークンを使って、オプションで IAM トークンを取得することができます。この IAM トークンを使って、IAM 対応のすべてのサービスにアクセスすることができます。
メタデータ・サービスの概念
仮想サーバー・インスタンスに関するメタデータにプログラムでアクセスし、そのメタデータを使用して、新しいインスタンスを初期化できます。 APIサービスによって提供されるメタデータは、リクエストが行われたインスタンスにのみ関係する。 インスタンス内のメタデータ・サービスを使用して、別のインスタンスに関する情報を取得したり、インスタンスに現在関連付けられていないリソースに関する情報を取得したりすることはできません。
アクセスできるメタデータには、インスタンス名、CRN、リソース・グループ、ユーザー・データのほか、SSHキーや配置グループに関する情報も含まれます。 サービスから返されるすべてのメタデータについて詳しくは、 メタデータ・サービスによって返されるデータの要約 を参照してください。
メタデータ・サービスは、REST APIとインスタンスのホスト名を使用してメタデータを取得する。 メタデータ・サービスへのアクセスは、デフォルトでは無効になっている。 VPC API、CLI、またはコンソールから、すべてのインスタンスのメタデータサービスへのアクセスを有効にできます。
メタデータ・サービスには2つのコンポーネントがある:
-
Identity API :このサービスは、ID トークン、ID 証明書、および IAM アクセストークンを提供する。 メタデータ情報へのアクセスや取得には、IDトークンが必要です。 他の IBM Cloud IAM対応サービスにアクセスするには、IDトークンからIAMトークンを生成します。 たとえば、インスタンスを開始するには、 IBM Cloud Databaseを呼び出してデータベース・サーバーをセットアップする必要があるかもしれない。 最後に、ID証明書を使用して、仮想サーバーインスタンスとマウントされたファイル共有の間で転送中の暗号化を確立する。
-
Metadata APIはインスタンスのメタデータへのアクセスを提供する。 メタデータ・サービス API を呼び出すことで、インスタンス初期設定データ、ネットワーク・インターフェース、ボリューム接続、公開 SSH 鍵、配置グループの情報を取得できます。
アイデンティティAPI
ID APIを使えば、メタデータ・サービスにアクセスするためのIDアクセストークンを生成できる。 セキュアな通信が有効になっている場合は、 http://api.metadata.cloud.ibm.com/identity/v1/token、または https://api.metadata.cloud.ibm.com/identity/v1/token 、エンドポイントを呼び出してトークンを生成する。
このエンドポイントは、仮想サーバーインスタンス内で実行されているすべてのコマンド、プロセス、およびソフトウェアアプリケーションからアクセス可能です。 API エンドポイントへのアクセスは、仮想サーバーインスタンスの外部では利用できません。
メタデータ・サービスを呼び出すときは、ID アクセストークンを使用する。 トークンは、有効期限 (デフォルトでは 5 分) に達するまで有効です。 詳細については、「 ID アクセストークンの取得 」を参照してください。
IDアクセストークンからIAMトークンを生成することもできる。 この IAM トークンを使用して、インスタンスにリンクされている IAM トラステッド・プロファイルのアクセス権限およびポリシー設定に基づくすべての IAM 対応サービスにアクセスできます。 これは、IAMトークン・サービスのデフォルトに基づいて、独自の有効期限を持っています。 IDアクセストークンからIAMトークンを生成する。
現在 /instance_identity/v1/token 方式を使用しており、API リリースバージョン 2025-08-26 以降を採用する場合は、移 行ガイダンスに記載されている変更点を確認してください: VPC Identity API の 2025-08-26 バージョンへの更新。
メタデータ・サービス
既存および新規のインスタンスでメタデータサービスへのアクセスを有効にすると、インスタンスに関するデータを取得できます。 コンソール、CLI、または API を使用して メタデータ サービスへのアクセスを有効に できます。
メタデータは、インスタンス固有の情報を提供する REST API を呼び出すことで取得します。 実行中の仮想サーバー・インスタンス内でアクセス可能なエンドポイントに対して、 GET。 インスタンス、キー、配置グループに関するメタデータは、以下のエンドポイントを使用して取得できます:
https://api.metadata.cloud.ibm.com/metadata/v1/instancehttps://api.metadata.cloud.ibm.com/metadata/v1/keyshttps://api.metadata.cloud.ibm.com/metadata/v1/placement_groups
メタデータにアクセスするために使用できるすべてのエンドポイントの詳細については、 メタデータ・サービスから返されるデータの概要を 参照してください。
メタデータ・サービスは、サービスのIPへのすべてのリクエストをインターセプトし、リクエストを処理する特定のサービスにルーティングする。 メタデータ・サービスへのリクエストの一部として、IDアクセストークンを含める必要があります。
コンピュート・リソース ID
IBM Cloud におけるTrusted Profileとは、特定のアカウント内のIDのことで、APIキーを必要とせずに、そのアカウント内で連携したユーザーやコンピュートリソースが動作するためのゲートウェイとして機能する。 コンピュートリソースアイデンティティとは、コンピュートリソースで実行されるアプリケーションのきめ細かな認可のために、信頼されたプロファイルを使用する能力のことである。
信頼されたプロファイルは、IAMアクセスグループのメンバーになり、アクセス権限を割り当てられる。 これらの特権は、信頼されたプロファイルの一部として構成された一連のプロパティで識別される ID またはリソースに対して、特定の ID の下で与えられた一連の特権を使用して管理作業を行う場合に特に有用である。
信頼されたプロファイルは、 IBM Cloud Identity and Access Management (IAM)サービスを通じて作成される。 具体的には、[ 管理]>[アクセス(IAM)]と進み、 [信頼済みプロファイル]を選択して[ プロファイルの作成 ]をクリックする。 詳しくは、トラステッド・プロファイルの作成を参照してください。
信頼されたプロファイルを使用することで、コンピュートリソースのサービスIDやAPIキーを作成する必要がなくなる。 これにより、アプリケーションは、コンピュート・リソースごとに個別の認証を必要とせずに、 IBM Cloud サービスにアクセスできるようになる。
ユーザー・データ
インスタンスからアクセスするメタデータには、 _ユーザー・データも_含まれる。 ユーザーデータは、インスタンスのプロビジョニング時に指定したデータで、他のインスタンスのプロビジョニング時に利用可能です。 (これはVPCインスタンスのcloud-initから利用できるのと同じユーザーデータだ) 例えば、データベース・ソフトウェアをロードするための情報、ワーカー・ノードのカスタム・ソフトウェア、またはインスタンスの初期化方法に関する決定を行うための情報が、ユーザー・データで提供されます。 詳しくは、 ユーザー・データ に関するトピックを参照してください。
インスタンス内からアクセスするメタデータは、暗号化方式では保護されない。 インスタンスおよびメタデータ・サービスへのアクセス権限を持つすべてのユーザーが、メタデータを参照する可能性があります。 予防措置として、パスワードやお客様の暗号鍵などの機密データをユーザー・データとして保管しないでください。
データ・セキュリティー
IBM は、データを確実に保護するための予防措置を講じています。 メタデータは、ユーザーにアクセス権限があるインスタンスからのみ取得されます。 複数のインスタンスに共通するデータは取得されるが、他のインスタンスの特定のIPアドレスは公開されない。
メタデータ・サービスのデフォルト・プロトコルは HTTP です。 メタデータ・サービスへの呼び出しは、発信元のコンピュート・ホストを離れる前にセキュアに行われる。 データは、データが計算ホストから出る前に、セキュア・プロトコルを使用してラップされます。 メタデータ・サービスへの最初の呼び出しは、 HTTP。 この呼び出しの目的は、メタデータ・サービスにアクセスするためのIDトークンを取得することである。 これらのサービスはリンクローカル URL。 非セキュアな接続が表示されますが、VPCコンピュート・サービスはトークンとメタデータ・サービスをセキュアにするために特別なアクションを取ります。
メタデータ・サービスは、 HTTP Secure protocol ( HTTPS ) を使用するように設定することもできる。 詳しくは、 UI を使用したセキュア・アクセスの有効化 を参照してください。
メタデータ・サービスは機密データを扱うものではない。 サービス・エンドポイントは、インスタンス上のすべてのプロセスに開かれている。 このサービスを通じて公開される情報は、仮想サーバーインスタンス内で動作するすべてのアプリケーションの共有情報とみなされる。
追加のセキュリティ対策については、 メタデータ・サービスのセキュリティ・ベスト・プラクティスを 参照してください。
アクティビティー・トラッキング・イベント
メタデータ・サービスにAPIリクエストを行うと、監査に使用できるイベントがトリガーされる。 詳細は メタデータ・サービス・ イベントを参照。