API et modèles de gestion des connexions des connecteurs Microsoft Graph
L’API et les modèles de gestion des connexions des contrats du KIT de développement logiciel (SDK) des connecteurs Microsoft Graph sont appelés pendant le processus de création d’une connexion de connecteur personnalisée sur le Centre d'administration Microsoft 365.
API de gestion des connexions
| Méthode | Paramètres | Type renvoyé | Description |
|---|---|---|---|
| ValidateAuthentication | ValidateAuthenticationRequest | ValidateAuthenticationResponse | Valide les informations d’identification et le chemin de la source de données fournis par l’administrateur à l’étape des paramètres de connexion. |
| ValidateCustomConfiguration | ValidateCustomConfigurationRequest | ValidateCustomConfigurationResponse | Valide la configuration facultative fournie par l’administrateur dans l’étape de configuration de la connexion. Si aucune configuration n’est requise pour le connecteur, cette API peut retourner une réponse de réussite. |
| GetDataSourceSchema | GetDataSourceSchemaRequest | GetDataSourceSchemaResponse | Obtient le schéma de source de données dans un format qui peut être compris par Microsoft Graph. |
Modèles d’API de gestion des connexions
Les sections suivantes décrivent les modèles d’API de gestion des connexions.
ValidateAuthenticationRequest
Modèle de demande pour valider la demande d’authentification auprès de la source de données.
| Propriété | Type | Description |
|---|---|---|
| authenticationData | AuthenticationData | Contient l’URL d’accès à la source de données et les informations d’identification pour y accéder. |
ValidateAuthenticationResponse
Modèle de réponse pour valider la réponse d’authentification auprès de la source de données.
| Propriété | Type | Description |
|---|---|---|
| status | OperationStatus | Affiche la status de l’opération et des détails tels que les messages d’erreur. |
| oAuth2ClientCredentialResponse | OAuth2ClientCredentialResponse | Informations d’identification à envoyer au connecteur pendant l’analyse si le flux OAuth est utilisé (jeton d’accès, jeton d’actualisation, etc., envoyé par le serveur d’authentification). |
ValidateCustomConfigurationRequest
Modèle de demande pour valider les informations de demande de configuration personnalisée.
| Propriété | Type | Description |
|---|---|---|
| customConfiguration | CustomConfiguration | Fournit des données de configuration pour le connecteur. |
| authenticationData | AuthenticationData | Contient l’URL d’accès à la source de données et les informations d’identification pour y accéder. |
ValidateCustomConfigurationResponse
Modèle de demande pour valider les informations de réponse de configuration personnalisée.
| Propriété | Type | Description |
|---|---|---|
| status | OperationStatus | Affiche la status de l’opération et des détails tels que les messages d’erreur. |
GetDataSourceSchemaRequest
Modèle de demande pour obtenir la demande de schéma de la source de données.
| Propriété | Type | Description |
|---|---|---|
| customConfiguration | CustomConfiguration | Fournit des données de configuration pour le connecteur. |
| authenticationData | AuthenticationData | Contient l’URL d’accès à la source de données et les informations d’identification pour y accéder. |
GetDataSourceSchemaResponse
Modèle de demande pour obtenir la réponse de schéma de la source de données.
| Propriété | Type | Description |
|---|---|---|
| status | OperationStatus | Affiche la status de l’opération et des détails tels que les messages d’erreur. |
| dataSourceSchema | DataSourceSchema | Affiche le schéma de la source de données. |