Type de ressource externalConnection

  • Article

Espace de noms : microsoft.graph.externalConnectors

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Conteneur logique pour ajouter du contenu à partir d’une source externe dans Microsoft Graph.

Méthodes

Méthode Type renvoyé Description
Créer externalConnection externalConnection Créez un externalConnection en publiant dans la collection connections.
Répertorier externalConnections collection externalConnection Obtient une collection d’objets externalConnection .
Obtenir externalConnection externalConnection Lit les propriétés et les relations d’un objet externalConnection .
Mettre à jour externalConnection externalConnection Mettez à jour un objet externalConnection .
Supprimer externalConnection Aucune Supprime un objet externalConnection .
Créer un schéma Aucun ouschéma Inscrire le schéma de connexion.
Opération d’obtention connectionOperation Obtient l’état d’une demande asynchrone pour créer le schéma de connexion.
Créer un élément externe externalItem Créez un élément externalItem en publiant dans la collection d’éléments.
Obtenir connectionQuota connectionQuota Récupérez les propriétés et les relations d’un connectionQuota.

Propriétés

Propriété Type Description
activitySettings microsoft.graph.externalConnectors.activitySettings Collecte les paramètres configurables liés aux activités impliquant le contenu du connecteur.
configuration microsoft.graph.externalConnectors.configuration Spécifie des ID d’application supplémentaires autorisés à gérer la connexion et à indexer le contenu de la connexion. Optional.
connectorId Chaîne ID d’application Teams. Optional.
description Chaîne Description de la connexion affichée dans le Centre d’administration Microsoft 365. Optional.
enabledContentExperiences collection microsoft.graph.externalConnectors.contentExperienceType Liste des expériences de contenu auxquelles la connexion participera. Les valeurs possibles sont search.
id Chaîne ID unique fourni par le développeur de la connexion au sein du locataire Microsoft Entra. La longueur doit être comprise entre 3 et 32 caractères. Doit contenir uniquement des caractères alphanumériques. Impossible de commencer par Microsoft ou d’être l’une des valeurs suivantes : None, Directory, ExchangeExchangeArchive, , TeamsYammerOneDriveBusinessMailboxLinkedInSharePoint, , ConnectorsTaskFabric, . PowerBIAssistantTopicEngineMSFT_All_Connectors Obligatoire.
ingestedItemsCount Int64 Nombre d’éléments ingérés dans une connexion. Cette valeur est actualisée toutes les 15 minutes. Si l’état de connexion est draft, ingestedItemsCount est null.
nom Chaîne Nom complet de la connexion à afficher dans le Centre d’administration Microsoft 365. Longueur maximale de 128 caractères. Obligatoire.
searchSettings microsoft.graph.externalConnectors.searchSettings Paramètres configurant l’expérience de recherche pour le contenu de cette connexion, tels que les modèles d’affichage pour les résultats de la recherche.
state microsoft.graph.externalConnectors.connectionState Indique l’état actuel de la connexion. Les valeurs possibles sont draft, ready, obsoleteet limitExceeded. Obligatoire.

Relations

Relation Type Description
groupes collection microsoft.graph.externalConnectors.externalGroup En lecture seule. Pouvant accepter la valeur Null.
éléments collection microsoft.graph.externalConnectors.externalItem En lecture seule. Peut avoir la valeur Null.
operations collection microsoft.graph.externalConnectors.connectionOperation En lecture seule. Pouvant accepter la valeur Null.
quota microsoft.graph.externalConnectors.connectionQuota En lecture seule. Pouvant accepter la valeur Null.
schéma microsoft.graph.externalConnectors.schema En lecture seule. Pouvant accepter la valeur Null.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "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"
}