Eliminar federatedIdentityCredential

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Eliminar un objeto federatedIdentityCredential de una aplicación o un agentIdentityBlueprint.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ✅

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Permisos para una aplicación

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Application.ReadWrite.All No disponible.
Delegado (cuenta personal de Microsoft) Application.ReadWrite.All No disponible.
Aplicación Application.ReadWrite.OwnedBy Application.ReadWrite.All

Importante

Para el acceso delegado con cuentas profesionales o educativas, el usuario que ha iniciado sesión debe tener asignado un rol compatible de Microsoft Entra o un rol personalizado que conceda los permisos necesarios para esta operación. Esta operación admite los siguientes roles integrados, que proporcionan solo el privilegio mínimo necesario:

  • Un usuario miembro no administrador con permisos de usuario predeterminados, para aplicaciones de su propiedad
  • Desarrolladores de aplicaciones: para las aplicaciones que poseen
  • Administrador de aplicaciones en la nube
  • Administrador de la aplicación

Permisos para un agentIdentityBlueprint

Tipo de permiso Permiso con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) AgentIdentityBlueprint.DeleteRestore.All AgentIdentityBlueprint.ReadWrite.All, Directory.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación AgentIdentityBlueprint.DeleteRestore.All AgentIdentityBlueprint.ReadWrite.All, Directory.ReadWrite.All

Importante

  • Una entidad de seguridad que crea una identidad de agente, un plano técnico o una entidad de seguridad de plano técnico se asigna automáticamente como propietario.
  • Los propietarios pueden crear y modificar identidades de agente asociadas a un plano técnico de su propiedad sin que se les asigne un rol de ID de agente.
  • Para que los usuarios que no son propietarios puedan llamar a esta API en escenarios delegados con cuentas profesionales o educativas, el administrador debe tener asignado un rol compatible de Microsoft Entra. Esta operación admite el siguiente rol integrado con privilegios mínimos:

Solicitud HTTP

Para una aplicación:

  • Puede dirigirse a la aplicación mediante su id o appId. id y appId se conocen como Id. de objeto e Id. de aplicación (cliente), respectivamente, en los registros de aplicaciones en el Centro de administración de Microsoft Entra.
  • También puede dirigirse a la credencial de identidad federada con su identificador o nombre.
DELETE /applications/{id}/federatedIdentityCredentials/{federatedIdentityCredentialId}

DELETE /applications/{id}/federatedIdentityCredentials/{federatedIdentityCredentialName}

DELETE /applications(appId='{appId}')/federatedIdentityCredentials/{federatedIdentityCredentialId}

DELETE /applications(appId='{appId}')/federatedIdentityCredentials/{federatedIdentityCredentialName}

Para un agentIdentityBlueprint:

  • Puede dirigirse a la credencial de identidad federada con su identificador o nombre.
DELETE /applications/{id}/microsoft.graph.agentIdentityBlueprint/federatedIdentityCredentials/{federatedIdentityCredentialId}

DELETE /applications/{id}/microsoft.graph.agentIdentityBlueprint/federatedIdentityCredentials/{federatedIdentityCredentialName}

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content.

Ejemplos

Ejemplo 1: Eliminación de una credencial de identidad federada de una aplicación

Solicitud

DELETE https://graph.microsoft.com/beta/applications/bcd7c908-1c4d-4d48-93ee-ff38349a75c8/federatedIdentityCredentials/d9b7bf1e-429e-4678-8132-9b00c9846cc4

Respuesta

HTTP/1.1 204 No Content

Ejemplo 2: Eliminar una credencial de identidad federada de un agentIdentityBlueprint

Solicitud

DELETE https://graph.microsoft.com/beta/applications/bcd7c908-1c4d-4d48-93ee-ff38349a75c8/microsoft.graph.agentIdentityBlueprint/federatedIdentityCredentials/d9b7bf1e-429e-4678-8132-9b00c9846cc4

Respuesta

HTTP/1.1 204 No Content
  • Last updated on