Compartilhar via


Criar externalItem

Espaço de nomes: 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.

Crie um novo externalItem.

Esta API pode ser utilizada para criar um item personalizado. A externalConnection que contém tem de ter um esquema registado do tipo correspondente.

Esta API está disponível nas seguintes implementações de cloud nacionais.

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

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
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 programador do externalItem. Se ainda não existir nenhum item com este id, será criado um novo item. Se já existir um item com este id, é substituído pelo objeto enviado no corpo.

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 do pedido, forneça uma representação JSON de um objeto externalItem . O payload está limitado a 4 MB.

Criar um externalItem

Ao criar um externalItem, são necessários os seguintes campos: acle properties. O properties objeto tem de conter, pelo menos, uma propriedade.

Todas as DateTime propriedades de tipo têm de estar no formato ISO 8601.

As propriedades de um externalItem devem utilizar especificadores de tipo no payload nos seguintes cenários:

  • Para String propriedades de tipo, se o valor contiver carateres 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 do tipo Collection(DateTime), tem de utilizar 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

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": "user",
      "value": "e811976d-83df-4cbd-8b9b-5215b18aa874",
      "accessType": "grant",
      "identitySource": "azureActiveDirectory"
    },
    {
      "type": "group",
      "value": "14m1b9c38qe647f6a",
      "accessType": "deny",
      "identitySource": "external"
    }
  ],
  "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