Atualizar externalItem

  • Artigo

Namespace: microsoft.graph.externalConnectors

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.

Atualize as propriedades de um 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.
Aplicativo 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 cadeia de caracteres 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

O exemplo a seguir mostra uma solicitação.

PUT https://graph.microsoft.com/beta/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": {
    "value": "<h1>Error in payment gateway</h1><p>Error details...</p>",
    "type": "html"
  }
}