agentIdentityBlueprint : removePassword

Espace de noms: microsoft.graph

Supprimez un mot de passe d’un agentIdentityBlueprint.

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) AgentIdentityBlueprint.AddRemoveCreds.All AgentIdentityBlueprint.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application AgentIdentityBlueprint.AddRemoveCreds.All AgentIdentityBlueprint.ReadWrite.All

Importante

  • Un principal qui crée un blueprint ou un principal de blueprint est affecté en tant que propriétaire. Les propriétaires peuvent créer des identités d’agent et modifier uniquement les ressources dont ils sont propriétaires, même s’ils ne disposent pas d’un rôle d’ID d’agent.
  • 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 les rôles intégrés suivants, qui fournissent uniquement le moindre privilège nécessaire :
    • Administrateur d’ID d’agent.
    • Développeur d’ID d’agent : créez des blueprints d’identité d’agent et des principaux de blueprint.

Requête HTTP

POST /applications/{id}/microsoft.graph.agentIdentityBlueprint/removePassword

En-têtes de demande

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

Corps de la demande

Propriété Type Description
keyId Guid Identificateur unique du mot de passe. Obligatoire.

Réponse

Si elle réussit, cette action renvoie un code de réponse 204 No Content.

Exemples

L’exemple suivant montre comment appeler cette API.

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/v1.0/applications/{id}/microsoft.graph.agentIdentityBlueprint/removePassword
Content-type: application/json

{
    "keyId": "f0b0b335-1d71-4883-8f98-567911bfdca6"
}

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 204 No Content