Freigeben über


Schema erstellen

Namespace: microsoft.graph.externalConnectors

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Erstellen Sie ein neues Schema, oder aktualisieren Sie ein vorhandenes Schema für eine Microsoft Search-Verbindung.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) ExternalConnection.ReadWrite.OwnedBy ExternalConnection.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung ExternalConnection.ReadWrite.OwnedBy ExternalConnection.ReadWrite.All

HTTP-Anforderung

PATCH /external/connections/{id}/schema

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.
Prefer: respond-async Verwenden Sie dies, um die Anforderung asynchron auszuführen. Optional.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung eines Schemaobjekts an.

Wenn Sie ein benutzerdefiniertes Elementschema registrieren, muss für das Schemaobjekt die baseType-Eigenschaft auf microsoft.graph.externalItem festgelegt sein und dieeigenschaft properties enthalten. Das Properties-Objektmuss mindestens eine Eigenschaft enthalten, maximal 128.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 202 Accepted Antwortcode und eine URL im Antwortheader zurückgegeben, die Location zum Abrufen des Vorgangsstatus verwendet werden können.

Hinweis: Es kann zwischen 5 und 15 Minuten dauern, bis das Schema erstellt wurde. Es wird empfohlen, die URL im Location Antwortheader zu verwenden, um den Vorgangsstatus abzurufen.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anforderung, ein neues zu registrieren oder ein vorhandenes benutzerdefiniertes Schema asynchron zu aktualisieren.

PATCH https://graph.microsoft.com/beta/external/connections/contosohr/schema
Content-type: application/json

{
  "baseType": "microsoft.graph.externalItem",
  "properties": [
    {
      "name": "ticketTitle",
      "type": "string",
      "isSearchable": "true",
      "isRetrievable": "true",
      "labels": [
        "title"
      ]
    },
    {
      "name": "priority",
      "type": "string",
      "isQueryable": "true",
      "isRetrievable": "true",
      "isSearchable": "false"
    },
    {
      "name": "assignee",
      "type": "string",
      "isRetrievable": "true"
    }
  ]
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/external/connections/contosohr/operations/616bfeed-666f-4ce0-8cd9-058939010bfc