Partilhar via

Excluir anexo

  • Artigo

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.

Elimine um anexo de um evento de calendário de utilizador, mensagem, tarefa do Outlook ou publicação.

Cuidado

As tarefas do Outlook foram preteridas e deixaram de devolver dados a 10 de agosto de 2022. Atualize as aplicações existentes que utilizam esta funcionalidade com tarefas do Outlook.

Esta API está disponível nas seguintes implementações de cloud nacionais.

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

Permissões

Dependendo do recurso (evento, mensagem, outlookTask ou mensagem) ao qual o anexo está anexado e do tipo de permissão (delegado ou aplicação) pedido, a permissão especificada na tabela seguinte é o menor privilégio necessário para chamar esta 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
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 utilizador.

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

Anexos de um evento num calendário que pertence ao calendarGroup predefinido do utilizador.

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

Anexos de um evento num calendário que pertence ao calendarGroup de um utilizador.

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 seguinte mostra um nível de aninhamento, mas uma mensagem pode estar localizada num subordinado de uma criança e assim sucessivamente.

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 tarefa do Outlook.

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

Anexos de uma publicação num tópico que pertence a uma conversação 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. Não devolve nada no corpo da resposta.

Exemplo

Solicitação

O exemplo seguinte mostra um pedido para eliminar um anexo num evento.

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