Atualizar um item em uma lista

Artigo
04/08/2023

Atualizar as propriedades em um listItem.

Permissões

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

PATCH /sites/{site-id}/lists/{list-id}/items/{item-id}/fields

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 à eTag atual no item, uma resposta `412 Precondition Failed` será exibida e o item não será atualizado.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON de fieldValueSet especificando os campos a atualizar.

Exemplo

Aqui está um exemplo que atualiza os campos de cor e quantidade do item de lista com novos valores. Todos os outros valores no listItem ficam inalterados.

PATCH /sites/{site-id}/lists/{list-id}/items/{item-id}/fields
Content-Type: application/json

{
    "Color": "Fuchsia",
    "Quantity": 934
}

Resposta

Se for bem-sucedido, esse método retornará um fieldValueSet no corpo da resposta do item de lista atualizada.

HTTP/1.1 201 Created
Content-type: application/json

{
  "Name": "Widget",
  "Color": "Fuchsia",
  "Quantity": 934
}

Compartilhar via