Obter 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 de versão.

Obter as propriedades e as relações de um objeto externalitem .

Essa API é fornecida apenas para fins de diagnóstico. Ele não se destina a ser usado para nenhuma outra finalidade. Solicitações repetidas para essa API podem resultar em 429 erros HTTP.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	ExternalItem.ReadWrite.OwnedBy, ExternalItem.Read.All, ExternalItem.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	ExternalItem.ReadWrite.OwnedBy, ExternalItem.Read.All, ExternalItem.ReadWrite.All

Solicitação HTTP

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

Parâmetros do caminho

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

Parâmetros de consulta opcionais

Esse método não dá suporte a parâmetros de consulta opcionais para personalizar a resposta.

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se bem-sucedido, este método retorna um código 200 OK de resposta e um objeto externalItem no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo de solicitação.

GET https://graph.microsoft.com/beta/external/connections/contosohr/items/TSP228082938

Resposta

Este é um exemplo de resposta.

HTTP/1.1 200 OK
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"
  }
}