tipo de recurso externalConnection

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.

Um contêiner lógico para adicionar conteúdo de uma fonte externa ao Microsoft Graph.

Métodos

Método Tipo de retorno Descrição
Criar externalConnection externalConnection Crie um novo externalConnection postando na coleção de conexões.
Listar externalConnections coleção externalConnection Obtenha uma coleção de objetos externalConnection .
Obter externalConnection externalConnection Leia propriedades e relações de um objeto externalConnection .
Atualizar externalConnection externalConnection Atualize um objeto externalConnection .
Excluir externalConnection Nenhum Exclua um objeto externalConnection .
Criar esquema Nenhum ouesquema Registrar esquema de conexão.
Obter operação connectionOperation Obtenha o status de uma solicitação assíncrona para criar o esquema de conexão.
Criar externalItem externalItem Crie um novo externalItem postando na coleção de itens.
Obter connectionQuota connectionQuota Recupere as propriedades e relações de um connectionQuota.

Propriedades

Propriedade Tipo Descrição
activitySettings microsoft.graph.externalConnectors.activitySettings Coleta configurações configuráveis relacionadas a atividades que envolvem conteúdo do conector.
configuração microsoft.graph.externalConnectors.configuration Especifica IDs de aplicativo adicionais que têm permissão para gerenciar a conexão e indexar o conteúdo na conexão. Opcional.
connectorId Cadeia de caracteres A ID do aplicativo Teams. Opcional.
contentCategory microsoft.graph.externalConnectors.contentCategory Especifica a categoria de domínio do conteúdo associado à conexão externa. Essa propriedade ajuda o Microsoft Graph a otimizar a relevância, a classificação e a compreensão semântica, sinalizando a natureza do conteúdo ingerido. Por exemplo, definir esse valor corretamente garante uma melhor interpretação da consulta e melhora as experiências do Copilot. Os valores possíveis são: uncategorized, knowledgeBase, wikis, fileRepositorytaskManagementqnameetingTranscriptsmessagingdashboardcrmpeoplemediaemail. learningManagement Opcional. O valor padrão é uncategorized.
description Cadeia de caracteres Descrição da conexão exibida no Centro de administração do Microsoft 365. Opcional.
enabledContentExperiences Coleção microsoft.graph.externalConnectors.contentExperienceType A lista de experiências de conteúdo das quais a conexão participará. Os valores possíveis são search.
id Cadeia de caracteres ID exclusiva fornecida pelo desenvolvedor da conexão dentro do locatário do Microsoft Entra. Deve ter entre 3 e 32 caracteres. Deve conter apenas caracteres alfanuméricos. Não pode começar com Microsoft ou ser um dos seguintes valores: None, Directory, Exchange, MSFT_All_ConnectorsTopicEngineAssistantPowerBITaskFabricConnectorsYammerSharePointMailboxTeamsExchangeArchiveLinkedInOneDriveBusiness. Obrigatório.
ingestedItemsCount Int64 O número de itens ingeridos em uma conexão. Esse valor é atualizado a cada 15 minutos. Se o estado de conexão for draft, ingestedItemsCount será null.
nome Cadeia de caracteres O nome de exibição da conexão a ser exibido no Centro de administração do Microsoft 365. Comprimento máximo de 128 caracteres. Obrigatório.
searchSettings microsoft.graph.externalConnectors.searchSettings As configurações que definem a experiência de pesquisa para conteúdo nesta conexão, como os modelos de exibição para resultados de pesquisa.
state microsoft.graph.externalConnectors.connectionState Indica o estado atual da conexão. Os valores possíveis são draft, ready, obsoletee limitExceeded. Obrigatório.

Relações

Relação Tipo Descrição
grupos Coleção microsoft.graph.externalConnectors.externalGroup Somente leitura. Anulável.
items Coleção microsoft.graph.externalConnectors.externalItem Somente leitura. Anulável.
operations Coleção microsoft.graph.externalConnectors.connectionOperation Somente leitura. Anulável.
quota microsoft.graph.externalConnectors.connectionQuota Somente leitura. Anulável.
esquema microsoft.graph.externalConnectors.schema Somente leitura. Anulável.

Representação JSON

A representação JSON a seguir mostra o tipo de recurso.

{
  "activitySettings": {"@odata.type": "microsoft.graph.externalConnectors.activitySettings"},
  "configuration": {"@odata.type": "microsoft.graph.externalConnectors.configuration"},
  "connectorId": "String",
  "description": "String",
  "enabledContentExperiences": "[String]",
  "id": "String (identifier)",
  "ingestedItemsCount": "Int64",
  "name": "String",
  "searchSettings": {"@odata.type": "microsoft.graph.externalConnectors.searchSettings"},
  "state": "String"
}
  • Última atualização em