Compartilhar via


Atualizar externalItem

Namespace: microsoft.graph.externalConnectors

Atualize as propriedades de um objeto externalItem .

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) ExternalItem.ReadWrite.OwnedBy ExternalItem.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application ExternalItem.ReadWrite.OwnedBy ExternalItem.ReadWrite.All

Solicitação HTTP

PUT /external/connections/{connection-id}/items/{item-id}

Parâmetros do caminho

Parâmetro Tipo Descrição
connection-id string A id propriedade do que contém externalConnection
item-id string A propriedade fornecida pelo id desenvolvedor do externalItem.

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.

Corpo da solicitação

No corpo da solicitação, forneça os valores para os campos relevantes que devem ser atualizados. As propriedades existentes (excluindo propriedades dentro do properties objeto) que não estão incluídas no corpo da solicitação manterão seus valores anteriores ou serão recalculadas com base em alterações em outros valores de propriedade. Para alcançar o melhor desempenho, não inclua valores existentes que não foram alterados. As propriedades a seguir podem ser atualizadas.

Propriedade Tipo Descrição
Acl coleção microsoft.graph.externalConnectors.acl Uma matriz de entradas de controle de acesso. Cada entrada especifica o acesso concedido a um usuário ou grupo.
conteúdo microsoft.graph.externalConnectors.externalItemContent Uma representação de texto simples do conteúdo do item. O texto nesta propriedade é indexado em texto completo.
properties Objeto Um saco de propriedades com as propriedades do item. As propriedades DEVEM estar em conformidade com o esquema definido para o externalConnection.

Atualizando a coleção acl

Se a acl propriedade estiver incluída em uma solicitação de atualização, a coleção ACL existente será substituída com a coleção incluída na solicitação.

Atualizando o objeto properties

Se a properties propriedade estiver incluída em uma solicitação de atualização, o saco de propriedade existente será substituído com o valor incluído na solicitação.

Resposta

Se for bem-sucedido, esse método retornará um 200 OK código de resposta e um objeto externalItem atualizado no corpo da resposta.

Exemplos

Solicitação

PUT https://graph.microsoft.com/v1.0/external/connections/contosohr/items/TSP228082938
Content-Type: application/json

{
  "acl": [
    {
      "type": "everyone",
      "value": "67a141d8-cf4e-4528-ba07-bed21bfacd2d",
      "accessType": "grant"
    }
  ]
}

Resposta

O exemplo a seguir mostra a resposta.

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

{
  "id": "TSP228082938",
  "acl": [
    {
      "type": "everyone",
      "value": "67a141d8-cf4e-4528-ba07-bed21bfacd2d",
      "accessType": "grant"
    }
  ],
  "properties": {
    "title": "Error in the payment gateway",
    "priority": 1,
    "assignee": "john@contoso.com"
  },
  "content": {
    "@odata.type": "microsoft.graph.externalConnectors.externalItemContent",
    "value": "<h1>Error in payment gateway</h1><p>Error details...</p>",
    "type": "html"
  }
}