Obter item excluído (objeto de diretório)

Namespace: microsoft.graph

Recupere as propriedades de um objeto de diretório excluído recentemente de itens excluídos. Os seguintes tipos são suportados:

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

A tabela a seguir mostra a permissão ou permissões menos privilegiadas necessárias para chamar essa API em cada tipo de recurso com suporte. Siga as práticas recomendadas para solicitar permissões com privilégios mínimos. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Recurso com suporte Delegada (conta corporativa ou de estudante) Delegada (conta pessoal da Microsoft) Application
administrativeUnit AdministrativeUnit.Read.All Sem suporte. AdministrativeUnit.Read.All
application Application.Read.All Sem suporte. Application.Read.All
agentIdentity AgentIdentity.Read.All Sem suporte. AgentIdentity.Read.All
agentIdentityBlueprint AgentIdentityBlueprint.Read.All Sem suporte. AgentIdentityBlueprint.Read.All
agentIdentityBlueprintPrincipal AgentIdentityBlueprintPrincipal.Read.All Sem suporte. AgentIdentityBlueprintPrincipal.Read.All
agentUser User.ReadBasic.All Sem suporte. User.ReadBasic.All
grupo Group.Read.All Sem suporte. Group.Read.All
servicePrincipal Application.Read.All Sem suporte. Application.Read.All
user User.Read.All Sem suporte. User.Read.All
certificateBasedAuthPki PublicKeyInfrastructure.Read.All Sem suporte. PublicKeyInfrastructure.Read.All
certificateAuthorityDetail PublicKeyInfrastructure.Read.All Sem suporte. PublicKeyInfrastructure.Read.All

Solicitação HTTP

GET /directory/deletedItems/{object-id}

Importante

Para grupos de segurança excluídos temporariamente, a propriedade securityEnabled retorna false em vez de true devido a uma limitação conhecida.

Para identificar o tipo de grupo, use a propriedade groupTypes :

  • ["Unified"]indica um grupo do Microsoft 365.
  • Uma matriz vazia ([]) indica um grupo de segurança.

Parâmetros de consulta opcionais

Este método dá suporte a Parâmetros de consulta OData para ajudar a personalizar a resposta.

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Aceitar application/json

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se bem-sucedido, este método retorna um código de resposta 200 OK e um objeto directoryObject no corpo da resposta.

Exemplo

Solicitação

O exemplo a seguir mostra uma solicitação.

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

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#directoryObjects/$entity",
  "id":"46cc6179-19d0-473e-97ad-6ff84347bbbb",
  "displayName":"SampleGroup",
  "groupTypes":["Unified"],
  "mail":"example@contoso.com",
  "mailEnabled":true,
  "mailNickname":"Example",
  "securityEnabled":false,
  "visibility":"Public"
}