Compartilhar via

externalConnection resource type (tipo de recurso externalConnection)

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.

Um contentor lógico para adicionar conteúdo de uma origem externa ao Microsoft Graph.

Métodos

Método Tipo de retorno Descrição
Criar externalConnection externalConnection Crie uma nova externalConnection ao publicar na coleção de ligações.
Listar externalConnections coleção externalConnection Obter uma coleção de objetos externalConnection .
Obter externalConnection externalConnection Ler propriedades e relações de um objeto externalConnection .
Atualizar externalConnection externalConnection Atualizar um objeto externalConnection .
Eliminar externalConnection Nenhum Eliminar um objeto externalConnection .
Criar esquema Nenhum ouesquema Registar o esquema de ligação.
Obter operação connectionOperation Obtenha a status de um pedido assíncrono para criar o esquema de ligação.
Criar externalItem externalItem Crie um novo externalItem ao publicar na coleção de itens.
Obter connectionQuota connectionQuota Obtenha as propriedades e relações de uma connectionQuota.

Propriedades

Propriedade Tipo Descrição
activitySettings microsoft.graph.externalConnectors.activitySettings Recolhe definições configuráveis relacionadas com atividades que envolvem conteúdo do conector.
configuração microsoft.graph.externalConnectors.configuration Especifica IDs de aplicação adicionais que têm permissão para gerir a ligação e indexar conteúdo na ligação. Opcional.
connectorId Cadeia de caracteres O ID da Aplicação teams. Opcional.
contentCategory microsoft.graph.externalConnectors.contentCategory Especifica a categoria de domínio do conteúdo associado à ligação externa. Esta propriedade ajuda o Microsoft Graph a otimizar a relevância, a classificação e a compreensão semântica ao sinalizar a natureza dos conteúdos ingeridos. Por exemplo, definir este valor corretamente garante uma melhor interpretação de consulta e melhora as experiências do Copilot. Os valores possíveis são: uncategorized, , knowledgeBase, fileRepositorywikis, qna, crm, dashboard, people, media, , email, messaging, , meetingTranscripts, , . learningManagementtaskManagement Opcional. O valor padrão é uncategorized.
description Cadeia de caracteres Descrição da ligação apresentada no Centro de administração do Microsoft 365. Opcional.
enabledContentExperiences microsoft.graph.externalConnectors.contentExperienceType collection A lista de experiências de conteúdo em que a ligação irá participar. Os valores possíveis são search.
id Cadeia de caracteres ID exclusivo fornecido pelo programador da ligação no inquilino Microsoft Entra. Tem de ter entre 3 e 32 carateres de comprimento. Só tem de conter carateres alfanuméricos. Não é possível começar com Microsoft ou ser um dos seguintes valores: None, Directory, Exchange, ExchangeArchive, LinkedIn, Mailbox, OneDriveBusiness, SharePoint, Teams, Yammer, , Connectors, , TaskFabric, PowerBI, , Assistant, , , TopicEngine. MSFT_All_Connectors Obrigatório.
ingestedItemsCount Int64 O número de itens ingeridos numa ligação. Este valor é atualizado a cada 15 minutos. Se o estado da ligação for draft, ingestedItemsCount será null.
nome Cadeia de caracteres O nome a apresentar da ligação a apresentar no Centro de administração do Microsoft 365. Comprimento máximo de 128 carateres. Obrigatório.
searchSettings microsoft.graph.externalConnectors.searchSettings As definições que configuram a experiência de pesquisa de conteúdos nesta ligação, como os modelos de apresentação dos resultados da pesquisa.
state microsoft.graph.externalConnectors.connectionState Indica o estado atual da ligaçã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 microsoft.graph.externalConnectors.connectionOperation collection 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 seguinte 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"
}
  • Last updated on