创建关系

命名空间：microsoft.graph.termStore

创建新的 relation 对象。 它们用于在术语之间或术语和集之间创建固定和重复使用的关系。 如果在术语和 set 之间创建固定/重复使用的术语，则必须在发布正文中将 fromTerm 设置为 null 。

权限

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	TermStore.ReadWrite.All
委派（个人 Microsoft 帐户）	不支持。
应用程序	不支持。

HTTP 请求

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

请求标头

名称	说明
Authorization	Bearer {token}。必需。
Content-Type	application/json. Required.

请求正文

在请求正文中，提供 relation 对象的 JSON 表示 形式。

下表显示创建 relation 对象 时所需的属性 。

属性	类型	说明
关系	microsoft.graph.termStore.relationType	要创建的关系类型。 可取值为：pin、reuse。
set	microsoft.graph.termStore.set	需要创建关系的集。
fromTerm	microsoft.graph.termStore.term	需要创建关系的术语。

响应

如果成功，此方法在响应 201 Created 正文中返回 响应代码和 microsoft.graph.termStore.relation 对象。

示例

请求

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"
  }
}

响应

注意： 为了提高可读性，可能缩短了此处显示的响应对象。

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"
  }
}