Verbindungsverwaltungs-API und -Modelle für Microsoft Graph-Connectors SDK

  • Artikel

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.

Verwandte Inhalte