Compartilhar via


Excluir um item de uma lista.

Remover um item de uma list.

Permissões

Para excluir um item, o usuário deve ter concedido o acesso de gravação do aplicativo para o item a ser excluído.

Uma das permissões a seguir é necessária para chamar essa API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) Sites.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Aplicativo Sites.ReadWrite.All

Solicitação HTTP

DELETE /sites/{site-id}/lists/{list-id}/items/{item-id}

Cabeçalhos de solicitação opcionais

Nome Valor Descrição
if-match etag Se este cabeçalho de solicitação estiver incluso e a eTag fornecida não corresponder à marca atual no item, uma resposta 412 Precondition Failed será exibida e o item não será excluído.

Corpo da solicitação

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

Exemplo

DELETE /sites/{site-id}/lists/{list-id}/items/{item-id}

Resposta

Se bem sucedida, esta chamada retorna uma resposta 204 No Content para indicar que o recurso foi excluído e que não havia nada a retornar.

HTTP/1.1 204 No Content