Type de ressource externalConnection
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"
}