Criar externalItem

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.

Crie um novo externalItem.

Essa API pode ser usada para criar um item personalizado. O externalConnection que contém deve ter um esquema registrado do tipo correspondente.

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}

Parâmetros do caminho

Parâmetro Tipo Descrição
connection-id string A id propriedade da externalConnection que contém
item-id string A propriedade fornecida pelo id desenvolvedor do externalItem. Se nenhum item já existir com isso id, um novo item será criado. Se um item já existir com this id, ele será 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 da solicitação, forneça uma representação JSON de um objeto externalItem . A carga útil é limitada a 30 MB.

Quando você cria um externalItem, as seguintes propriedades são necessárias: acl e propriedades. O objeto properties deve conter pelo menos uma propriedade. Você também pode usar a propriedade informationProtectionLabel para definir um rótulo de confidencialidade do Microsoft Purview em um externalItem.

Todas as DateTime propriedades de tipo devem estar no formato ISO 8601.

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

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": "Fix issues with Payment gateway",
    "priority": 1,
    "assignee": "john@contoso.com"
  },
  "content": {
    "value": "Payment gateway module has the following tasks to be completed...",
    "type": "text"
  },
  "informationProtectionLabel": { 
    "sensitivityLabelId": "b6a62c3c-d471-4a3e-9f5f-93c1f928b02d"
  } 
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 200 OK