Consultation du statut d’un blueprint (API Jamf Pro) - Guide de configuration des blueprints dans Jamf Pro

Vous pouvez utiliser l’API Jamf Pro pour voir les données brutes du rapport de gestion déclarative des appareils, ce qui vous permet de visualiser le statut de validation et d’installation d’un blueprint déployé.

Cela se révèle utile pour suivre les erreurs d’hébergement ou de formatage des composants déployés de manière personnalisée comme Fichiers de configuration des services ou Tâches d’arrière-plan des services dans lesquels une déclaration peut très bien être correctement installée à partir de Jamf Pro sans que les instructions pour installer un objet aboutissent.

Selon le blueprint, les déclarations installées peuvent être une ressource ou un type de configuration. Par exemple :

Un blueprint avec un composant Fichiers de configuration des services contiendra une ressource provenant d’un fichier ZIP hébergé et un objet de déclaration de configuration associé qui définit la façon d’utiliser la ressource.
Un blueprint avec un composant Tâches d’arrière-plan des services contiendra à la fois des ressources et des déclarations de configuration. Tout fichier ZIP ou PLIST déployé est considéré comme une ressource, ainsi qu’un objet de déclaration de configuration qui définit comment utiliser ces ressources.

Exigences

Identifiant de gestion de l’appareil du client. Il s’agit de l’identifiant de gestion Jamf Pro mentionné dans le rapport d’inventaire de l’ordinateur ou de l’appareil.
Identifiant du blueprint. Il n’est pas requis pour utiliser l’API Jamf Pro, mais il aide à établir une corrélation entre les informations de statut et des objets de blueprint spécifiques dans la réponse.
Pour rechercher l’identifiant du blueprint, accédez au blueprint que vous avez déployé, puis consultez l’identifiant situé à la fin de l’URL. Par exemple : https://JAMF_PRO_URL.jamfcloud.com/view/mfe/blueprints/31e67fa3-45e6-413c-81f6-3c1e01856df6

Dans l’API Jamf Pro, cliquez sur declarative-device-management pour voir ses points de terminaison, puis sur GET /v1/declarative-device-management/{clientManagementId}/status-items
Cliquez sur Tester.
Dans le champ clientManagementId, saisissez l’identifiant de gestion Jamf Pro de l’appareil.

Cliquez sur Exécuter.

Si le blueprint que vous avez déployé possède plusieurs objets, chaque composant possède une déclaration séparée et un statut qui lui est associé.

Exemple :

Dans l’exemple ci-dessous, le blueprint contient trois objets de configuration qui sont associés au même identifiant de blueprint.

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