Appareil : approvisionner

Espace de noms: microsoft.graph

Provisionner un appareil pour le compte d’un fournisseur VDI (Virtual Desktop Infrastructure) approuvé.

Cette action encapsule le protocole de déploiement sans contact (ZTD) pour créer un appareil dans un état d’attente dans le répertoire du client. L’appareil ne peut pas être utilisé pour l’authentification tant qu’il n’a pas terminé son inscription. L’appareil créé est marqué d’une étiquette système qui identifie le fournisseur VDI approuvé.

Seules les applications VDI figurant sur la liste approuvée des fournisseurs VDI de Microsoft peuvent appeler cette action. Les appels provenant d’autres applications sont bloqués même lorsque l’application dispose de l’autorisation requise.

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.

Type d’autorisation	Autorisations les moins privilégiées	Autorisations à privilèges plus élevés
Déléguée (compte professionnel ou scolaire)	Device.ProvisionForVDI	Non disponible.
Déléguée (compte Microsoft personnel)	Non prise en charge.	Non prise en charge.
Application	Non prise en charge.	Non prise en charge.

Importante

Pour l’accès délégué à l’aide de comptes professionnels ou scolaires, l’utilisateur connecté doit disposer d’un rôle Microsoft Entra pris en charge ou d’un rôle personnalisé qui accorde les autorisations requises pour cette opération. Administrateur d’appareil cloud est le rôle le moins privilégié pris en charge pour cette opération.

Outre l’autorisation, l’application appelante doit figurer sur la liste approuvée par Microsoft des fournisseurs de VDI.

Requête HTTP

POST /devices/provision

En-têtes de demande

Nom	Description
Autorisation	Porteur {token}. Obligatoire. En savoir plus sur l’authentification et les autorisations.
Content-Type	application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON des paramètres.

Le tableau suivant répertorie les paramètres que vous pouvez utiliser avec cette action.

Paramètre	Type	Description
provisioningBlob	String	Objet blob opaque, généré par la bibliothèque d’identité d’identité d’appareil Microsoft Entra et partagé avec les fournisseurs VDI approuvés, qui contient les informations requises pour configurer l’appareil. Obligatoire.

Réponse

En cas de succès, cette action retourne un code de réponse et une 201 CreatedprovisionResponse dans le corps de la réponse. La réponse inclut également un Location en-tête qui contient l’URI de l’objet appareil créé.

Exemples

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/v1.0/devices/provision
Content-Type: application/json

{
  "provisioningBlob": "eyJ2ZXIiOiIxLjAiLCJub25jZSI6IjJkZjg1ZTdmYTk0ZjQ3In0"
}

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.provisionResponse",
  "challenge": "Y2hhbGxlbmdlVmFsdWVFeGFtcGxl",
  "deviceId": "2ec25e3b-9243-4f3c-8c83-2e2a9b8a4f1a"
}