Atualizar o listItem

Namespace: microsoft.graph

Atualizar as propriedades em um listItem.

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global Governo dos EUA L4 GOVERNO DOS EUA L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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 privilegiadas mais altas
Delegado (conta corporativa ou de estudante) Sites.ReadWrite.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sites.ReadWrite.All Indisponível.

Solicitação HTTP

Atualizar as propriedades de um listItem.

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

Atualizar os valores de coluna de um listItem.

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

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.
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.

Resposta

Se bem-sucedido, esse método retornará um código de resposta 200 Ok e um fieldValueSet no corpo da resposta para o item de lista atualizado.

Exemplo

O exemplo a seguir atualiza os campos Cor e Quantidade do item de lista com novos valores. Todos os outros valores em listItem são deixados de lado.

Solicitação

PATCH https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/items/{item-id}/fields
Content-Type: application/json

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

Resposta

HTTP/1.1 200 Ok
Content-type: application/json

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