檢視藍圖的狀態（Jamf Pro API）

您可以使用Jamf Pro API來檢視宣告式裝置管理報告的原始資料，從而瞭解已部署藍圖的驗證和安裝狀態。

這對於追蹤自訂部署元件的託管或格式錯誤很有用，例如服務描述檔或服務背景任務，其中可以從 Jamf Pro 成功安裝宣告，但安裝物件的命令可能無法完成。

已安裝的宣告可以是資產或配置類型，具體取決於藍圖。例如：

具有服務描述檔元件的藍圖將包含來自託管 ZIP 檔的資產，以及定義如何使用資產的相關配置宣告物件。
包含服務背景任務元件的藍圖將包含資產和配置宣告的組合。任何已部署的ZIP或PLIST檔都被視為資產，以及定義如何使用資產的配置宣告物件。

需求條件

裝置的用戶端管理ID。這是電腦或裝置清單記錄中的「Jamf Pro管理ID」。
藍圖ID。這不是使用Jamf Pro API的必要條件，但藍圖ID有助於將狀態資訊與回應中的特定藍圖物件相關聯。
若要尋找藍圖ID，請前往您已部署的藍圖並檢視URL末端的辨識碼。例如：https://JAMF_PRO_URL.jamfcloud.com/view/mfe/blueprints/31e67fa3-45e6-413c-81f6-3c1e01856df6

在Jamf ProAPI中，按一下declarative-device-management以檢視其端點，然後按一下GET /v1/declarative-device-management/{clientManagementId}/status-items
按一下試用。
在clientManagementId欄位中，輸入裝置的Jamf Pro管理ID。

按一下執行。

如果您部署的藍圖包含多個物件，則每個元件都有與其關聯的單獨宣告和狀態。

範例：

在下列範例中，藍圖包含三個與相同藍圖ID關聯的配置物件。

{
  "key": "management.declarations.configurations",
  "value": "{active=true, identifier=Blueprint_5ceed44c-bed7-40b5-8c52-46e6bc7ea6e5_s1_c1_cfg1, valid=valid, server token=87906e1f60769c956e75719b84a64c21a7d6101b0874bb9c3f9b33deca99171e},{active=true, identifier=Blueprint_5ceed44c-bed7-40b5-8c52-46e6bc7ea6e5_s1_c2_cfg1, valid=valid, server-token=ba335e40f293939797707cf5df0e816a79a14f795bcee2577d1f7799a693ba86},{active=true, identifier=Blueprint_5ceed44c-bed7-40b5-8c52-46e6bc7ea6e5_s1_c3_cfg1, valid=unknown, server-token=756426d52a780363db6193e095b5845abfb903ecd4a1c9ae63c9f52caba8e58d}",
  "lastUpdateTime": "2025-03-05T01:36:38.489"
}