ブループリントのステータスを表示する (Jamf Pro API) - Jamf Pro ブループリント構成ガイド

Jamf Pro ブループリント構成ガイド

Solution
Application
Content Type
テクニカル資料
Utilities & Services
ft:locale
ja-JP
ベストプラクティス:

プラットフォーム API を使用したブループリントステータスの表示

フリート全体のステータスをすばやく確認するには、各デバイスを個別に照会するのではなく、プラットフォーム API を使用します。ブループリントステータスレポートから、ブループリントの成功および失敗の集計数を取得します。特定のブループリントに割り当て済みのデバイスを確認するには、宣言レポートを使用します。構造化された失敗理由を含め、単一のデバイスによって報告されたすべての宣言を確認するには、デバイスレポートを使用します。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

  1. Jamf Pro API で、declarative-device-management をクリックしてエンドポイントを表示し、GET /v1/declarative-device-management/{clientManagementId}/status-items をクリックします。
  2. Try It Out (試してみる)をクリックします。
  3. clientManagementId フィールドに、デバイスの Jamf Pro 管理 ID を入力します。
  4. 実行するをクリックします。

    展開したブループリントに複数のオブジェクトが含まれている場合、各コンポーネントには個別の宣言とステータスが関連付けられます。

    例:

    以下の例では、ブループリントには同じブループリント ID に関連付けられた3つの構成オブジェクトが含まれています。

    {
      "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"
    }