Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Espace de noms: microsoft.graph
Lisez les propriétés et les relations de l’objet agentIdentity .
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
| Type d’autorisation | Autorisation avec privilèges minimum | Autorisations privilégiées plus élevées |
|---|---|---|
| Déléguée (compte professionnel ou scolaire) | AgentIdentity.Read.All | Application.Read.All |
| Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
| Application | AgentIdentity.Read.All, AgentIdentity.CreateAsManager | Application.Read.All |
Importante
- Un principal qui crée un blueprint d’identité d’agent ou un principal de blueprint est automatiquement affecté en tant que propriétaire.
- Les propriétaires peuvent créer et modifier des identités d’agent associées à un blueprint dont ils sont propriétaires sans qu’un rôle d’ID d’agent ne leur soit attribué.
- Pour que les non-propriétaires appellent cette API dans des scénarios délégués à l’aide de comptes professionnels ou scolaires, un rôle Microsoft Entra pris en charge doit être attribué à l’administrateur. Cette opération prend en charge le rôle intégré le moins privilégié suivant :
Requête HTTP
GET /servicePrincipals/{id}/microsoft.graph.agentIdentity
Paramètres facultatifs de la requête
Cette méthode prend en charge les paramètres de requête $select et $expandOData pour aider à personnaliser la réponse.
En-têtes de demande
| Nom | Description |
|---|---|
| Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Corps de la demande
N’indiquez pas le corps de la demande pour cette méthode.
Réponse
Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet agentIdentity dans le corps de la réponse.
Exemples
Demande
L’exemple suivant illustre une demande.
GET https://graph.microsoft.com/v1.0/servicePrincipals/{id}/microsoft.graph.agentIdentity
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 200 OK
Content-Type: application/json
{
"id": "1b7313c4-05d0-4a08-88e3-7b76c003a0a2",
"displayName": "My Agent Identity",
"createdDateTime": "2019-09-17T19:10:35.2742618Z",
"createdByAppId": "00001111-aaaa-2222-bbbb-3333cccc4444",
"agentIdentityBlueprintId": "00001111-aaaa-2222-bbbb-3333cccc4444",
"accountEnabled": true,
"disabledByMicrosoftStatus": null,
"servicePrincipalType": "ServiceIdentity",
"tags": []
}