元資料服務傳回的資料摘要

使用元資料服務存取有關實體、SSH 金鑰和安置群組的資訊。 以下摘要包含URI路徑與元數據鍵，並說明元數據內容。

每一個 meta 資料類型的 API 回應以 JSON 格式呈現，其中包含 meta 資料鍵值組。

實例的 meta 資料摘要

使用表 1 中的資訊來瞭解針對實例傳回的 meta 資料類型。 若要存取所有元資料，請參閱 從實例擷取元資料。

實例的元數據
實例 URI 路徑 Meta 資料鍵 meta 資料的說明
/instance availability_policy 此虛擬伺服器執行個體的可用性政策。
/instance bandwidth 虛擬伺服器執行個體的網路介面與 Block Storage 磁碟區所共享的總頻寬（單位：百萬位元組每秒）。
/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 記憶體數量; 截斷為完整 GB。
/instance metadata_service 指出 meta 資料服務端點是否可供虛擬伺服器實例使用。 (已啟用狀態為 true 或 false。)
/instance name 此虛擬伺服器實例的使用者定義名稱 (以及預設系統主機名稱)。
/instance network_interfaces 虛擬伺服器實例的網路介面清單，包括主要網路介面。
/instance placement_target 虛擬伺服器執行個體的配置限制。
/instance primary_network_interface 實例的主要網路介面。
/instance profile 此虛擬伺服器實例設定檔的廣域唯一名稱。 例如，bx2-2x8平衡設定檔。
/instance software_attachments 虛擬伺服器執行個體的軟體附加元件清單。
/instance startable 指出虛擬伺服器實例的狀態是否允許啟動要求。
/instance status 實例的狀態: 刪除中、失敗、暫停、暫停中、擱置中、重新啟動中、回復中、執行中、啟動中、已停止或停止中。
/instance status_reasons 現行狀態的原因。
/instance total_network_bandwidth 專門分配給實例網路介面的頻寬量（單位：百萬位元/秒）。
/instance total_volume_bandwidth 專門分配給該執行個體的 Block Storage 儲存卷的頻寬量（單位：兆位元組/秒）。 增加此值會導致對應減少 total_network_bandwidth。
/instance vcpu 透過包含計數和架構屬性的結構所分配的虛擬處理器數量。
/instance volume_attachments 虛擬伺服器實例的磁區連接清單。
/instance boot_volume_attachment 實例的開機磁區連接。
/instance volume_bandwidth_qos_mode 此虛擬伺服器執行個體的卷帶寬 QoS 模式。 匯集或加權。
/instance vpc 虛擬伺服器實例所在的 VPC。
/instance zone 區域的廣域唯一名稱。
/instance/initialization default_trusted_profile 在建立虛擬伺服器實例時指定的預設授信設定檔配置。
/instance/initialization keys 實例起始設定時所使用公開 SSH 金鑰的參照清單。
/instance/initialization password 初始化時設定的管理員密碼，encryption_key 經加密後以 Base64-encoded 格式返回。
/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 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/software_attachments software_attachments 一個包含零個或多個軟體附件物件的陣列。
/instance/software_attachments/{id} id 此軟體附件的唯一識別碼（UUID）。
/instance/software_attachments/{id} name 此軟體附件的名稱。 此名稱在與該虛擬伺服器執行個體相關聯的軟體附加元件集合中是唯一的。
/instance/software_attachments/{id} href 此軟體附件的 URL。
/instance/software_attachments/{id} catalog_offering 一個包含目錄產品版本 CRN 及代表該軟體的相關軟體方案 CRN 的物件。
/instance/software_attachments/{id} offering_instance 一個代表從軟體方案實例化而來的軟體方案實例的物件。 包含該軟體產品實例的 CRN。
/instance/software_attachments/{id} entitlement 一個代表軟體產品實例授權權益的物件。 在成功呼叫「授權管理員」以取得授權後，此屬性會動態填入資料。
/instance/software_attachments/{id} entitlement.licensed_software 一個包含零個或多個物件的陣列，每個物件代表虛擬伺服器執行個體中已安裝且已取得授權的軟體程式或功能。
/instance/software_attachments/{id} entitlement.licensed_software[].sku 與軟體方案相關、並在虛擬伺服器執行個體上運行的某個可授權軟體程式或功能的 SKU（庫存單位）。
/instance/software_attachments/{id} entitlement.licensed_software[].key 該軟體授權的授權金鑰。 此屬性的值可能會隨時間而改變。
/instance/software_attachments/{id} lifecycle_state 軟體附件的生命週期狀態，用以表明該附件是否已完成且可供使用。
/instance/software_attachments/{id} lifecycle_reasons 造成當前 lifecycle_state 的各種原因。
/instance/software_attachments/{id} resource_type 資源類型。 請將其設定為 instance_software_attachment。
/instance/software_attachments/{id} created_at 此軟體附件的建立日期與時間。
/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 金鑰的 meta 資料摘要

使用表格 2 中的資訊，以瞭解針對 SSH 金鑰所傳回的 meta 資料類型。

SSH 金鑰的元數據
SSH 金鑰 URI 路徑 Meta 資料鍵 meta 資料的說明
/keys keys 金鑰的集合。 如需詳細資料，請參閱 keys/{id}。
/keys/{id} created_at 金鑰的建立日期與時間。
/keys/{id} crn 金鑰的雲端資源名稱。
/keys/{id} fingerprint 金鑰的指紋。 該值以 Base64-encoded 格式返回，並在前面附加雜湊演算法前綴（始終為 SHA256 ）。
/keys/{id} id 該金鑰的唯一識別碼。
/keys/{id} length 金鑰的長度 (以位元為單位)。
/keys/{id} name 金鑰的唯一使用者定義名稱。 如果未指定，則名稱是隨機選取單字的加連字號清單 (例如，elderly-mountain-troop-opponent。)
/keys/{id} public_key 公用 SSH 金鑰。
/keys/{id} type 該金鑰所使用的加密系統。

放置群組的 meta 資料摘要

使用表格 3 中的資訊來瞭解針對放置群組傳回的 meta 資料類型。

歸置組的元數據
放置群組 URI 路徑 Meta 資料鍵 meta 資料的說明
/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 該安置組的策略。

軟體附件的元資料摘要

請參考下表中的資訊，以了解軟體附件所回傳的元資料類型。

/metadata/v1/instance/software_attachments 端點會傳回一個包含零個或多個軟體附件物件的陣列。 每個物件代表一個由資源控制器註冊的軟體實例，該實例對應於某個軟體計畫。

軟體附件的元資料
軟體附件的 URI 路徑 Meta 資料鍵 meta 資料的說明
/instance/software_attachments/{id} id 該軟體附件的唯一 UUID。
/instance/software_attachments/{id} name 在與虛擬伺服器執行個體相關聯的軟體附件集合中，此為一個唯一的名稱。 此名稱預設為系統生成的隨機值，所有者日後若需變更，可自行更新。 請注意，更新虛擬伺服器執行個體軟體附件中的名稱，不會影響所附加的開機磁區名稱，也不會影響該磁區已建立的任何快照。
/instance/software_attachments/{id} href 此軟體附件的 URL。
/instance/software_attachments/{id} catalog_offering 一個其值與該實例中同名物件相同的物件，其中包含代表該軟體的目錄產品版本 CRN 及相關軟體方案 CRN。
/instance/software_attachments/{id} offering_instance 一個代表從軟體方案實例化而來的軟體方案實例的物件。
/instance/software_attachments/{id} offering_instance.crn 該軟體提供實例 CRN。
/instance/software_attachments/{id} entitlement（選用） 一個代表軟體產品實例授權權益的物件。 若未填寫，則表示該軟體方案未關聯任何授權。
/instance/software_attachments/{id} entitlement.licensed_software 一個包含零個或多個物件的陣列，每個物件代表虛擬伺服器執行個體中已安裝且已取得授權的軟體程式或功能。
/instance/software_attachments/{id} entitlement.licensed_software[].sku 與軟體方案相關、並在虛擬伺服器執行個體上運行的某個可授權軟體程式或功能的 SKU（庫存單位）。 這對軟體供應商而言具有重要意義。
/instance/software_attachments/{id} entitlement.licensed_software[].key（選用） 該軟體授權的授權金鑰。 若未顯示，表示尚未取得該許可證。
/instance/software_attachments/{id} lifecycle_state 軟體附件的生命週期狀態。 若顯示「穩定」，則表示該軟體執行個體已成功建立。
/instance/software_attachments/{id} lifecycle_reasons[] 現行 lifecycle_state 的原因。
/instance/software_attachments/{id} resource_type 資源類型設定為 instance_software_attachment。
/instance/software_attachments/{id} created_at 此軟體附件的建立日期與時間。

下一步

使用 meta 資料服務擷取資料。