Verbindungsverwaltungs-API und -Modelle für Microsoft Graph-Connectors SDK
Die Verbindungsverwaltungs-API und -Modelle des Microsoft Graph Connectors SDK-Verträge werden während der Erstellung einer benutzerdefinierten Connectorverbindung auf dem Microsoft 365 Admin Center aufgerufen.
Verbindungsverwaltungs-APIs
| Methode | Parameter | Rückgabetyp | Beschreibung |
|---|---|---|---|
| ValidateAuthentication | ValidateAuthenticationRequest | ValidateAuthenticationResponse | Überprüft die Anmeldeinformationen und den Datenquellenpfad, die vom Administrator im Schritt mit den Verbindungseinstellungen bereitgestellt werden. |
| ValidateCustomConfiguration | ValidateCustomConfigurationRequest | ValidateCustomConfigurationResponse | Überprüft die optionale Konfiguration, die vom Administrator im Verbindungskonfigurationsschritt bereitgestellt wird. Wenn keine Konfiguration für den Connector erforderlich ist, kann diese API eine Erfolgsantwort zurückgeben. |
| GetDataSourceSchema | GetDataSourceSchemaRequest | GetDataSourceSchemaResponse | Ruft das Datenquellenschema in einem Format ab, das von Microsoft Graph verstanden werden kann. |
API-Modelle für die Verbindungsverwaltung
In den folgenden Abschnitten werden die Api-Modelle für die Verbindungsverwaltung beschrieben.
ValidateAuthenticationRequest
Anforderungsmodell zum Überprüfen der Authentifizierungsanforderung an die Datenquelle.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| authenticationData | AuthenticationData | Enthält die Zugriffs-URL für die Datenquelle und die Anmeldeinformationen für den Zugriff darauf. |
ValidateAuthenticationResponse
Antwortmodell zum Überprüfen der Authentifizierungsantwort auf die Datenquelle.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| status | OperationStatus | Zeigt die status des Vorgangs und Details wie Fehlermeldungen an. |
| oAuth2ClientCredentialResponse | OAuth2ClientCredentialResponse | Anmeldeinformationen, die während der Durchforstung an den Connector gesendet werden sollen, wenn der OAuth-Fluss verwendet wird (Zugriffstoken, Aktualisierungstoken usw., gesendet vom Authentifizierungsserver). |
ValidateCustomConfigurationRequest
Anforderungsmodell zum Überprüfen benutzerdefinierter Konfigurationsanforderungsinformationen.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| customConfiguration | CustomConfiguration | Stellt Konfigurationsdaten für den Connector bereit. |
| authenticationData | AuthenticationData | Enthält die Zugriffs-URL für die Datenquelle und die Anmeldeinformationen für den Zugriff darauf. |
ValidateCustomConfigurationResponse
Anforderungsmodell zum Überprüfen benutzerdefinierter Konfigurationsantwortinformationen.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| status | OperationStatus | Zeigt die status des Vorgangs und Details wie Fehlermeldungen an. |
GetDataSourceSchemaRequest
Anforderungsmodell zum Abrufen der Schemaanforderung der Datenquelle.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| customConfiguration | CustomConfiguration | Stellt Konfigurationsdaten für den Connector bereit. |
| authenticationData | AuthenticationData | Enthält die Zugriffs-URL für die Datenquelle und die Anmeldeinformationen für den Zugriff darauf. |
GetDataSourceSchemaResponse
Fordern Sie das Modell an, um die Schemaantwort der Datenquelle abzurufen.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| status | OperationStatus | Zeigt die status des Vorgangs und Details wie Fehlermeldungen an. |
| dataSourceSchema | DataSourceSchema | Zeigt das Datenquellenschema an. |