Criar externalItem

Namespace: microsoft.graph.externalConnectors

Crie um novo objeto externalItem .

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

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

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos 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 com privilégios mais elevados
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}

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 uma representação JSON do objeto externalItem . A carga útil é limitada a 30 MB.

Você pode especificar as propriedades a seguir ao criar um externalItem.

Propriedade Tipo Descrição
id Cadeia de caracteres A ID do item. Obrigatório.
properties microsoft.graph.externalConnectors.properties As propriedades do item. O properties objeto deve conter pelo menos uma propriedade. Todas as DateTime propriedades de tipo devem estar no formato ISO 8601. Obrigatório.
conteúdo microsoft.graph.externalConnectors.externalItemContent O conteúdo do item externo. Opcional.
ACL Coleção Microsoft.Graph.externalConnectors.ACL A lista de controle de acesso. Obrigatório.

As propriedades em um externalItem devem usar especificadores de tipo no conteúdo nos seguintes cenários:

  • Para String propriedades de tipo, se o valor contiver caracteres não ASCII.

    "description@odata.type": "String",
    "description": "Kandierte Äpfel"
    
  • Para todos os tipos de coleção.

    "categories@odata.type": "Collection(String)"
    "categories": [
      "red",
      "blue"
    ]
    

    Importante

    Ao incluir uma propriedade de type Collection(DateTime), você deve usar o especificador Collection(DateTimeOffset)de tipo .

Resposta

Se bem sucedido, este método retorna um código de resposta 200 OK.

Exemplos

Exemplo: Criar um item personalizado

Solicitação

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

{
  "acl": [
    {
      "type": "user",
      "value": "e811976d-83df-4cbd-8b9b-5215b18aa874",
      "accessType": "grant"
    },
    {
      "type": "externalGroup",
      "value": "14m1b9c38qe647f6a",
      "accessType": "deny"
    }
  ],
  "properties": {
    "title": "Error in the payment gateway",
    "priority": 1,
    "assignee": "john@contoso.com"
  },
  "content": {
    "value": "Error in payment gateway...",
    "type": "text"
  }
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 200 OK