Excluir anexo

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Excluir um anexo de um evento de calendário, mensagem, anotação, tarefa do Outlook ou postagem do usuário.

Cuidado

As tarefas do Outlook foram preteridas e pararam de retornar dados em 10 de agosto de 2022. Atualize os aplicativos existentes que usam esse recurso com tarefas do Outlook.

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

Dependendo do recurso (evento, mensagem, anotação, outlookTask ou postagem) ao qual o anexo está anexado e o tipo de permissão (delegada ou aplicativo) solicitado, a permissão especificada na tabela a seguir é a menos privilegiada necessária para chamar essa API. Para saber mais, incluindo tomar cuidado antes de escolher as permissões mais privilegiadas, pesquise as seguintes permissões em Permissões.

Recurso com suporte Delegada (conta corporativa ou de estudante) Delegada (conta pessoal da Microsoft) Aplicativo
evento Calendars.ReadWrite Calendars.ReadWrite Calendars.ReadWrite
mensagem Mail.ReadWrite Mail.ReadWrite Mail.ReadWrite
Observação ShortNotes.ReadWrite ShortNotes.ReadWrite ShortNotes.ReadWrite.All
outlookTask Tasks.ReadWrite Tasks.ReadWrite Incompatível
postagem Group.ReadWrite.All Sem suporte Sem suporte

Solicitação HTTP

Anexos de um event no calendar padrão do usuário.

DELETE /me/events/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/events/{id}/attachments/{id}

DELETE /me/calendar/events/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/calendar/events/{id}/attachments/{id}

Anexos de um evento no calendário especificado que pertence ao usuário.

DELETE /me/calendars/{id}/events/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/calendars/{id}/events/{id}/attachments/{id}

Anexos de um evento em um calendário que pertence ao calendarGroup padrão do usuário.

DELETE /me/calendars/{id}/events/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/calendars/{id}/events/{id}/attachments/{id}

Anexos de um evento em um calendário que pertence ao calendarGroup de um usuário.

DELETE /me/calendarGroups/{id}/calendars/{id}/events/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{id}/attachments/{id}

Anexos de uma message em uma caixa de correio de usuário.

DELETE /me/messages/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/messages/{id}/attachments/{id}

Anexos de uma message contidos em uma mailFolder de nível superior na caixa de correio de um usuário.

DELETE /me/mailFolders/{id}/messages/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/attachments/{id}

Anexos de uma message contidos em uma pasta filha de uma mailFolder na caixa de correio de um usuário. O exemplo a seguir mostra um nível de aninhamento, mas uma mensagem pode ser localizada em um filho de um filho e assim por diante.

DELETE /me/mailFolders/{id}/childFolders/{id}/.../messages/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/mailFolders/{id}/childFolders/{id}/messages/{id}/attachments/{id}

Anexos para uma anotação na caixa de correio de um usuário.

DELETE /me/notes/{id}/attachments/{id}
DELETE /users/{id | userPrincipalName}/notes/{id}/attachments/{id}

Anexos de uma tarefa do Outlook.

DELETE /me/outlook/tasks/{id}/attachments/{id}
DELETE /users/{id}/outlook/tasks/{id}/attachments/{id}

Anexos de uma postagem em um thread que pertence a uma conversa de um grupo.

DELETE /groups/{id}/threads/{id}/posts/{id}/attachments/{id}
DELETE /groups/{id}/conversations/{id}/threads/{id}/posts/{id}/attachments/{id}

Cabeçalhos de solicitação

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

Corpo da solicitação

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

Resposta

Se tiver êxito, este método retornará um código de resposta 204 No Content. Ele não retorna nada no corpo da resposta.

Exemplos

Exemplo 1: Excluir um anexo de evento

O exemplo a seguir mostra como excluir um anexo em um evento.

Solicitação

O exemplo a seguir mostra uma solicitação.

DELETE https://graph.microsoft.com/beta/me/events/{id}/attachments/{id}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content

Exemplo 2: Excluir um anexo de anotação

O exemplo a seguir mostra como excluir um anexo em uma anotação.

Solicitação

O exemplo a seguir mostra uma solicitação.

DELETE https://graph.microsoft.com/beta/me/notes/AAMkAGI2THVSAAA=/attachments/AAMkAGI2attach2

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content
  • Last updated on