Beziehung erstellen

Namespace: microsoft.graph.termStore

Erstellt ein neues Relation-Objekt . Diese werden verwendet, um angeheftete und wiederverwendete Beziehungen zwischen Ausdrücken oder zwischen einem Ausdruck und einem Satz zu erstellen. Wenn Sie einen angehefteten/wiederverwendeten Begriff zwischen Ausdruck und Satz erstellen, muss fromTerm im Beitragstext auf NULL festgelegt werden.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	TermStore.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Nicht unterstützt

HTTP-Anforderung

POST sites/{site-id}/termStore/sets/{set-id}/terms/{term-id}/relations

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich.
Content-Type	application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des Relation-Objekts an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Relation-Objekt erstellen.

Eigenschaft	Typ	Beschreibung
Beziehung	microsoft.graph.termStore.relationType	Typ der zu erstellenden Beziehung. Mögliche Werte sind: pin und reuse.
set	microsoft.graph.termStore.set	Der Satz, an dem die Beziehung erstellt werden muss.
fromTerm	microsoft.graph.termStore.term	Der Begriff, mit dem die Beziehung erstellt werden muss.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein Objekt des Typ "microsoft.graph.termStore.relation" im Antworttext zurück.

Beispiele

Anforderung

POST https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/27fd2d26-60d3-485c-9420-0c71f74a0cfd/terms/8861b57a-c777-49e7-826f-47d6afecf80d/relations
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.termStore.relation",
  "relationship": "pin",
  "fromTerm" : {
    "id" : "b49f64b3-4722-4336-9a5c-56c326b344d4"
  },
  "set" : {
    "id": "95e553ae-a91a-4670-a139-67a6cea285b3"
  }
}

Antwort

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.termStore.relation",
  "id": "052c749c-749c-052c-9c74-2c059c742c05",
  "relationship": "pin",
  "fromTerm" : {
      "id" : "b49f64b3-4722-4336-9a5c-56c326b344d4"
  },
  "toTerm" : {
      "id" : "226e8ee3-f4b6-49d7-92d5-ec9d5475eec5"
  },
  "set" : {
      "id" : "95e553ae-a91a-4670-a139-67a6cea285b3"
  }
}