IBM Cloud Docs
メタデータ・サービスから返されたデータの概要

メタデータ・サービスから返されたデータの概要

インスタンス、SSHキー、配置グループに関する情報にアクセスするには、メタデータ・サービスを使用します。 このトピックでは、URI パスとメタデータ・キーごとのこのデータの要約を示し、そのメタデータについて説明します。

各メタデータ・タイプのAPIレスポンスは、メタデータのキーと値のペアを含むJSON形式で提示される。

インスタンスのメタデータの要約

インスタンスについて返されるメタデータのタイプについては、表 1 の情報を参照して確認してください。 すべてのメタデータにアクセスするには、 インスタンスからメタデータを取得するを 参照してください。

インスタンスのメタデータ
インスタンスの URI パス メタデータ・キー メタデータの説明
/instance availability_policy この仮想サーバー・インスタンスの可用性ポリシー。
/instance bandwidth 仮想サーバー・インスタンスのネットワーク・インターフェースおよびブロック・ストレージ・ボリュームの間で共有される合計帯域幅 (メガビット/秒)。
/instance boot_volume_attachment ボリューム名、CRN、ID が含まれるブート・ボリューム接続。
/instance catalog_offering これは、仮想サーバー・インスタンスがプライベート・カタログ内のカスタム・イメージを使用してプロビジョンされた場合に表示されます。
/instance created_at 仮想サーバー・インスタンスが作成された日時。
/instance crn この仮想サーバー・インスタンスのクラウド・リソース名。
/instance dedicated_host CRN、削除されたホスト、ID、名前、resource_type を含む専用ホスト参照のコレクション。
/instance disks インスタンスのディスクのリスト。
/instance gpu 仮想サーバー・インスタンスの GPU 構成
/instance id この仮想サーバー・インスタンスの固有 ID。
/instance image 仮想サーバー・インスタンスのプロビジョン元のイメージ。 Debian Linux ストック・イメージなど。
/instance lifecycle_reasons 現在の lifecycle_state の理由。
/instance lifecycle_state 仮想サーバー・インスタンスのライフサイクル状態。
/instance memory メモリ容量。ギガバイト単位で切り捨てられる。
/instance metadata_service 仮想サーバー・インスタンスがメタデータ・サービス・エンドポイントを使用できるかどうかを示します。 (有効な状況は true または false です。)
/instance name この仮想サーバー・インスタンスのユーザー定義名 (およびデフォルト・システム・ホスト名)。
/instance network_interfaces 1 次ネットワーク・インターフェースを含む、仮想サーバー・インスタンスのネットワーク・インターフェースのリスト。
/instance placement_target 仮想サーバー・インスタンスの配置制限。
/instance primary_network_interface インスタンスの 1 次ネットワーク・インターフェース。
/instance profile この仮想サーバー・インスタンス・プロファイルのグローバルで固有の名前。 bx2-2x8 (平衡型プロファイル) など。
/instance startable 仮想サーバー・インスタンスの状態が開始要求を許可するかどうかを示します。
/instance status インスタンスの状況: 削除中、失敗、一時停止、一時停止中、保留中、再始動中、再開中、実行中、開始中、停止、または停止中。
/instance status_reasons 現在の状況の理由。
/instance total_network_bandwidth インスタンス・ネットワーク・インターフェースに排他的に割り振られる帯域幅の量 (メガビット/秒)。
/instance total_volume_bandwidth インスタンスのブロック・ストレージ・ボリュームに排他的に割り振られる帯域幅の量 (メガビット/秒)。 この値を増やすと、それに対応してtotal_network_bandwidthが減少する。
/instance vcpu カウントとアーキテクチャーのプロパティーが含まれる構造により割り当てられる VCPU の数。
/instance volume_attachments 仮想サーバー・インスタンスのボリューム接続のリスト。
/instance boot_volume_attachment インスタンスのブート・ボリューム接続。
/instance vpc 仮想サーバー・インスタンスがある VPC。
/instance zone ゾーンのグローバルで固有の名前。
/instance/initialization default_trusted_profile 仮想サーバーインスタンス作成時に指定されたデフォルトの信頼済みプロフ ァイル構成。
/instance/initialization keys インスタンス初期化時に使用された公開SSH鍵への参照のリスト。
/instance/initialization password encryption_key を使用して暗号化され、base64 エンコードで返される、初期設定時の管理者パスワード。
/instance/initialization user_data 新規仮想サーバー・インスタンスのセットアップ時に使用可能になるユーザー・データ。
/instance/network_interfaces network_interfaces ネットワーク・インターフェースのリスト。 詳しくは、/instance/network_interfaces/{id} を参照してください。
/instance/network_interfaces/{id} allow_ip_spoofing このインターフェースでソース IP スプーフィングを許可するかどうかを示します。 false の場合、このインターフェースではソース IP のスプーフィングが防止されます。 true の場合、このインターフェースでソース IP スプーフィングが許可されます。
/instance/network_interfaces/{id} created_at ネットワーク・インターフェースが作成された日時。
/instance/network_interfaces/{id} floating_ips ネットワークインターフェースに関連付けられたフローティングIPアドレスへの参照の配列。
/instance/network_interfaces/{id} id ネットワーク・インターフェースの固有 ID。
/instance/network_interfaces/{id} name ネットワーク・インターフェースのユーザー定義名。
/instance/network_interfaces/{id} port_speed ネットワーク・インターフェース・ポート速度 (Mbps)。
/instance/network_interfaces/{id} primary_ipv4_address 1 次 IPv4 アドレス。
/instance/network_interfaces/{id} resource_type リソース・タイプ。
/instance/network_interfaces/{id} security_groups セキュリティー・グループのリスト。
/instance/network_interfaces/{id} status ネットワーク・インターフェースの状況。
/instance/network_interfaces/{id} subnet インスタンスに関連付けられているサブネット。
/instance/network_interfaces/{id} type インスタンスに関係しているこのネットワーク・インターフェースのタイプ。
/instance/volume_attachments/{id} bandwidth このインスタンスに接続されているボリュームの最大帯域幅 (メガビット/秒)。 これは、インスタンスの構成によっては、ボリューム帯域幅より低くなる可能性がある。
/instance/volume_attachments/{id} created_at ボリュームが接続された日時。
/instance/volume_attachments/{id} delete_volume_on_instance_delete true に設定すると、インスタンスを削除したときにボリュームも削除されます。
/instance/volume_attachments/{id} device ボリュームがインスタンスのオペレーティング・システムに公開される方法に関する情報。
/instance/volume_attachments/{id} id ボリューム接続の固有 ID。
/instance/volume_attachments/{id} name ボリューム接続のユーザー定義名。
/instance/volume_attachments/{id} status ボリューム接続の状況 (接続済み、接続中、削除中、または切り離し中)。
/instance/volume_attachments/{id} type ボリューム接続、ブート、またはデータのタイプ。
/instance/volume_attachments/{id} volume CRN、ID、名前、および (ボリュームが削除されている場合は) deleted 値を含む、接続されているボリューム。

SSH 鍵のメタデータの要約

SSH 鍵について返されるメタデータのタイプについては、表 2 の情報を参照して確認してください。

SSH鍵のメタデータ
SSH 鍵の URI パス メタデータ・キー メタデータの説明
/keys keys 鍵のコレクション。 詳細は、keys/{id}を参照してください。
/keys/{id} created_at 鍵が作成された日時。
/keys/{id} crn キーのクラウドリソース名。
/keys/{id} fingerprint キーの指紋。 値は、base64 エンコードで、先頭にハッシュ・アルゴリズム (常に SHA256) を付けて返されます。
/keys/{id} id 鍵の固有 ID。
/keys/{id} length キーの長さ（ビット単位）。
/keys/{id} name キーの一意のユーザー定義名。 未指定の場合、名前はランダムに選ばれた単語のハイフン付きリストとなる（例えば、 elderly-mountain-troop-opponent.）
/keys/{id} public_key パブリック SSH 鍵。
/keys/{id} type 鍵が使用する暗号システム。

配置グループのメタデータの要約

配置グループについて返されるメタデータのタイプについては、表 3 の情報を参照して確認してください。

配置グループのメタデータ
配置グループの URI パス メタデータ・キー メタデータの説明
/placement_groups placement_groups 配置グループのコレクション。 詳細は、placement_groups/{id}を参照してください。
/placement_groups/{id} created_at 配置グループが作成された日時。
/placement_groups/{id} crn 配置グループのクラウドリソース名。
/placement_groups/{id} id 配置グループの一意な識別子。
/placement_groups/{id} lifecycle_state 配置グループのライフサイクル状態。
/placement_groups/{id} name 配置グループのユーザー定義名。
/placement_groups/{id} resource_type リソース・タイプ。
/placement_groups/{id} strategy 配置グループの戦略。

次のステップ

メタデータ・サービスを使用してデータを取得します。