Quitar patrocinador

Espacio de nombres: microsoft.graph

Quite el patrocinador de un usuario.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores 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.

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

Importante

En escenarios delegados con cuentas profesionales o educativas, al usuario que ha iniciado sesión se le debe asignar un rol de Microsoft Entra compatible o un rol personalizado con el permiso de microsoft.directory/users/sponsors/update rol. Se admiten los siguientes roles con privilegios mínimos para esta operación:

• Escritores de directorios
• Administrador de usuarios

Solicitud HTTP

DELETE /users/{id}/sponsors/{id}/$ref

Precaución

Si /$ref no se anexa a la solicitud y la aplicación que realiza la llamada tiene permisos para administrar el tipo de objeto de patrocinador, el objeto de patrocinador también se elimina de Microsoft Entra ID; de lo contrario, se devuelve un 403 Forbidden error. Por ejemplo, una aplicación con User.ReadWrite.All permisos elimina un usuario que es patrocinador. Puede restaurar objetos específicos a través de la API Restaurar elementos eliminados.

Encabezados de solicitud

Nombre	Descripción
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la 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. No devuelve nada en el cuerpo de la respuesta.

Ejemplos

Solicitud

A continuación se muestra un ejemplo de una solicitud.

HTTP

DELETE https://graph.microsoft.com/v1.0/users/{user-id}/sponsors/{directory-object-id}/$ref

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/users/{user-id}/sponsors/{directory-object-id}/$ref')
	.delete();

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content