Eliminar permanentemente un elemento (objeto de directorio)

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 permanentemente de elementos eliminados un objeto de directorio eliminado recientemente. Se admiten los siguientes tipos:

Después de eliminar un elemento permanentemente, no se puede restaurar.

Las unidades administrativas no se pueden eliminar permanentemente mediante la API deletedItems . Las unidades administrativas eliminadas de forma temporal se eliminarán permanentemente 30 días después de la eliminación inicial, a menos que se restauren.

Importante

La protección contra eliminación permanente bloquea la eliminación permanente de un usuario protegido (excluidos los usuarios sincronizados locales), un grupo solo en la nube, una aplicación o un entidad de servicio durante los primeros siete días después de la eliminación temporal. La protección se habilita estableciendo isHardDeleteProtectionEnabled en true un objeto existente y no se puede deshabilitar.

El objeto todavía se puede eliminar y restaurar temporalmente. Si se restaura un objeto protegido y, a continuación, se elimina de nuevo temporalmente, comienza un nuevo período de protección de siete días. Cuando el período de protección expire, el autor de la llamada autorizado puede eliminar permanentemente el objeto.

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

En la tabla siguiente se muestran los permisos con privilegios mínimos necesarios para llamar a esta API en cada tipo de recurso admitido. Siga las prácticas recomendadas para solicitar permisos con privilegios mínimos. 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.

Recurso admitido	Delegado (cuenta profesional o educativa)	Delegado (cuenta de Microsoft personal)	Aplicación
application	Application.ReadWrite.All	No admitida.	Application.ReadWrite.OwnedBy
agentIdentity	AgentIdentity.ReadWrite.All	No admitida.	AgentIdentity.ReadWrite.All
agentIdentityBlueprint	AgentIdentityBlueprint.ReadWrite.All	No admitida.	AgentIdentityBlueprint.ReadWrite.All
agentIdentityBlueprintPrincipal	AgentIdentityBlueprintPrincipal.ReadWrite.All	No admitida.	AgentIdentityBlueprintPrincipal.ReadWrite.All
agentUser	AgentIdUser.ReadWrite.IdentityParentedBy	No admitida.	AgentIdUser.ReadWrite.IdentityParentedBy
externalUserProfile	ExternalUserProfile.ReadWrite.All	No compatible	ExternalUserProfile.ReadWrite.All
certificateBasedAuthPki	PublicKeyInfrastructure.Read.All	No admitida.	PublicKeyInfrastructure.Read.All
certificateAuthorityDetail	PublicKeyInfrastructure.Read.All	No admitida.	PublicKeyInfrastructure.Read.All
dispositivo	Device.ReadWrite.All	No admitida.	Device.ReadWrite.All
grupo	Group.ReadWrite.All	No admitida.	No admitida.
pendingExternalUserProfile	PendingExternalUserProfile.ReadWrite.All	No se admite	PendingExternalUserProfile.ReadWrite.All
servicePrincipal	Application.ReadWrite.All	No admitida.	Application.ReadWrite.OwnedBy
user	User.DeleteRestore.All	No admitida.	User.DeleteRestore.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:

Identidades de agente, planos técnicos de identidad de agente y entidades del plano técnico de identidad de agente: Administrador de ID de agente
Unidades administrativas: Lectores de directorios (solo lectura), Lectores globales (solo lectura), Administrador de roles con privilegios
Aplicaciones: administrador de identidades híbridas, administrador de aplicaciones en la nube, administrador de aplicaciones
Dispositivos: Administrador de dispositivos en la nube, Administrador de Intune, Administrador de Windows 365
Perfiles de usuarios externos: Lector global (solo lectura), Administrador de Skype Empresarial, Administrador de Teams
Grupos: Administrador de grupos (excepto para grupos asignables a roles), Administrador de usuarios (excepto para grupos asignables a roles), Administrador de roles con privilegios (rol con privilegios mínimos para grupos asignables a roles)
Perfiles de usuario externos pendientes: Lector global (solo lectura), Administrador de Skype Empresarial, Administrador de Teams
Entidades de servicio: administrador de identidades híbridas, administrador de aplicaciones en la nube, administrador de aplicaciones
Usuarios: Administrador de autenticación, Administrador de autenticación con privilegios, Administrador de usuarios. Sin embargo, para restaurar a los usuarios con roles de administrador con privilegios:
- En escenarios delegados, se debe asignar a la aplicación el permiso delegado Directory.AccessAsUser.All y también se debe asignar al usuario que llama un rol de administrador con privilegios superiores, como se indica en ¿Quién puede realizar acciones confidenciales?.
- En escenarios de solo aplicación y además de recibir el permiso de aplicación User.ReadWrite.All , se debe asignar a la aplicación un rol de administrador con privilegios superiores, como se indica en ¿Quién puede realizar acciones confidenciales?.

Solicitud HTTP

DELETE /directory/deletedItems/{id}

Encabezados de solicitud

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

Cuerpo de la solicitud

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

Respuesta

Si se ejecuta correctamente, este método devuelve el código de respuesta 204 No Content. No devuelve nada en el cuerpo de la respuesta.

Si la protección contra eliminación permanente está habilitada y el objeto aún se encuentra dentro del período de protección de siete días, este método devuelve 409 Conflict el Request_ConflictingRequest código de error. Espere a que expire el período de protección antes de intentar eliminar permanentemente el objeto.

Ejemplos

Ejemplo 1: Eliminar un elemento de forma permanente

Solicitud

DELETE https://graph.microsoft.com/beta/directory/deletedItems/46cc6179-19d0-473e-97ad-6ff84347bbbb


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Directory.DeletedItems["{directoryObject-id}"].DeleteAsync();

Importante

Los SDK de Microsoft Graph usan la versión v1.0 de la API de manera predeterminada y no admiten todos los tipos, propiedades y API disponibles en la versión beta. Para obtener más información sobre cómo acceder a la API beta con el SDK, consulte Uso de los SDK de Microsoft Graph con la API beta.

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.



// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Directory().DeletedItems().ByDirectoryObjectId("directoryObject-id").Delete(context.Background(), nil)

Importante

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.


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.directory().deletedItems().byDirectoryObjectId("{directoryObject-id}").delete();

Importante

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.


const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/directory/deletedItems/46cc6179-19d0-473e-97ad-6ff84347bbbb')
	.version('beta')
	.delete();

Importante

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.


<?php
use Microsoft\Graph\Beta\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$graphServiceClient->directory()->deletedItems()->byDirectoryObjectId('directoryObject-id')->delete()->wait();

Importante

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.


Import-Module Microsoft.Graph.Beta.Identity.DirectoryManagement

Remove-MgBetaDirectoryDeletedItem -DirectoryObjectId $directoryObjectId

Importante

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.


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

await graph_client.directory.deleted_items.by_directory_object_id('directoryObject-id').delete()

Importante

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

HTTP/1.1 204 No Content

Ejemplo 2: Intentar eliminar permanentemente un elemento protegido

Solicitud

La siguiente solicitud intenta eliminar permanentemente un objeto con isHardDeleteProtectionEnabled establecido true antes de que expire su período de protección de siete días.

DELETE https://graph.microsoft.com/beta/directory/deletedItems/46cc6179-19d0-473e-97ad-6ff84347bbbb

Respuesta

HTTP/1.1 409 Conflict
Content-Type: application/json

{
  "error": {
    "code": "Request_ConflictingRequest",
    "message": "The object cannot be permanently deleted because isHardDeleteProtectionEnabled is set to true.",
    "innerError": {
      "date": "2026-10-30T12:00:00",
      "request-id": "a9ee5607-56bd-4ce1-bcf5-66a11c8358b0",
      "client-request-id": "7fc3fe7b-2070-4f3f-8b0c-949ae8c03509"
    }
  }
}

Comentarios

¿Le ha resultado útil esta página?

Se actualizó por última vez el 2026-11-07

Eliminar permanentemente un elemento (objeto de directorio)

Permissions

Solicitud HTTP

Encabezados de solicitud

Cuerpo de la solicitud

Respuesta

Ejemplos

Ejemplo 1: Eliminar un elemento de forma permanente

Solicitud

Respuesta

Ejemplo 2: Intentar eliminar permanentemente un elemento protegido

Solicitud

Respuesta

Comentarios

Recursos adicionales