driveItem: permanentDelete

Namespace: microsoft.graph

Exclua permanentemente um driveItem usando sua ID. Se você excluir itens usando esse método, eles serão removidos permanentemente e não serão enviados para a lixeira, ao contrário da API Delete driveItem , que envia o item para a lixeira. Portanto, os itens de unidade excluídos permanentemente não podem ser restaurados posteriormente.

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

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. 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.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) Files.ReadWrite Files.ReadWrite.All, Sites.ReadWrite.All
Delegado (conta pessoal da Microsoft) Files.ReadWrite Files.ReadWrite.All
Aplicativo Files.ReadWrite.All Sites.ReadWrite.All

Observação

O SharePoint Embedded requer a FileStorageContainer.Selected permissão para acessar o conteúdo do contêiner. Essa permissão é diferente das mencionadas anteriormente. Além das permissões do Microsoft Graph, seu aplicativo deve ter as permissões de tipo de contêiner necessárias para chamar essa API. Para obter mais informações, consulte Autenticação e autorização do SharePoint Embedded.

Solicitação HTTP

POST /drives/{drive-id}/items/{item-id}/permanentDelete

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 204 No Content. Ele não retorna nada no corpo da resposta.

Exemplo

O exemplo a seguir mostra como chamar essa API.

Solicitação

POST https://graph.microsoft.com/v1.0/drives/{drive-id}/items/{item-id}/permanentDelete

Resposta

HTTP/1.1 204 No Content

Respostas de erros

Para obter detalhes sobre como os erros são retornados, consulte Respostas a erros.

  • Last updated on