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 o estado 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.
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 do 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

Veja a seguir uma representação JSON do 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"
}