你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Relationship - Create

参考

服务:: Purview

API 版本:: 2023-09-01

在实体之间创建新关系。

POST {endpoint}/datamap/api/atlas/v2/relationship

URI 参数

名称	在	必需	类型	说明
endpoint	path	True	string

请求正文

名称	类型	说明
attributes		结构的属性。
createTime	integer	记录的创建时间。
createdBy	string	创建记录的用户。
end1	AtlasObjectId	对类型的对象实例的引用 - 类似于实体。
end2	AtlasObjectId	对类型的对象实例的引用 - 类似于实体。
guid	string	关系的 GUID。
homeId	string	关系的主 ID。
label	string	关系的标签。
lastModifiedTS	string	用于并发控制的 ETag。
provenanceType	integer	用于记录实体或关系的实例的来源
status	StatusAtlasRelationship	关系状态的枚举。
typeName	string	类型的名称。
updateTime	integer	记录的更新时间。
updatedBy	string	更新记录的用户。
version	integer	关系的版本。

响应

名称	类型	说明
200 OK	AtlasRelationship	请求已成功。
Other Status Codes	AtlasErrorResponse	意外的错误响应。

安全性

OAuth2Auth

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
https://purview.azure.net/.default

示例

Relationship_Create

示例请求

HTTP

POST {endpoint}/datamap/api/atlas/v2/relationship

{
  "typeName": "AtlasGlossarySynonym",
  "attributes": {
    "expression": "Example Expression",
    "steward": "Example Steward",
    "description": "Example Description",
    "source": null,
    "status": null
  },
  "end1": {
    "guid": "856d31e6-e342-a1ce-6273-22ddb77029c6",
    "typeName": "AtlasGlossaryTerm"
  },
  "end2": {
    "guid": "77481037-2874-9bdc-9b9e-76bb94ee71aa",
    "typeName": "AtlasGlossaryTerm"
  },
  "label": "r:AtlasGlossarySynonym",
  "status": "ACTIVE",
  "createdBy": "ExampleCreator",
  "updatedBy": "ExampleUpdator",
  "version": 0
}

示例响应

状态代码:: 200

{
  "typeName": "AtlasGlossarySynonym",
  "attributes": {
    "expression": "Example Expression",
    "steward": "Example Steward",
    "description": "Example Description",
    "source": null,
    "status": null
  },
  "guid": "63023d5b-c499-4360-a513-16bcbf73b039",
  "end1": {
    "guid": "856d31e6-e342-a1ce-6273-22ddb77029c6",
    "typeName": "AtlasGlossaryTerm"
  },
  "end2": {
    "guid": "77481037-2874-9bdc-9b9e-76bb94ee71aa",
    "typeName": "AtlasGlossaryTerm"
  },
  "label": "r:AtlasGlossarySynonym",
  "status": "ACTIVE",
  "createdBy": "ExampleCreator",
  "updatedBy": "ExampleUpdator",
  "createTime": 1553840134724,
  "updateTime": 1553840134724,
  "version": 0
}

定义

名称	说明
AtlasErrorResponse	来自服务的错误响应
AtlasObjectId	对类型的对象实例的引用 - 类似于实体。
AtlasRelationship	Atlas 关系实例。
StatusAtlasRelationship	atlas 关系的状态

AtlasErrorResponse

来自服务的错误响应

名称	类型	说明
errorCode	string	错误代码。
errorMessage	string	错误消息。
requestId	string	请求 ID。

AtlasObjectId

对类型的对象实例的引用 - 类似于实体。

名称	类型	说明
guid	string	对象的 GUID。
typeName	string	类型的名称。
uniqueAttributes		对象的唯一属性。

AtlasRelationship

Atlas 关系实例。

名称	类型	说明
attributes		结构的属性。
createTime	integer	记录的创建时间。
createdBy	string	创建记录的用户。
end1	AtlasObjectId	对类型的对象实例的引用 - 类似于实体。
end2	AtlasObjectId	对类型的对象实例的引用 - 类似于实体。
guid	string	关系的 GUID。
homeId	string	关系的主 ID。
label	string	关系的标签。
lastModifiedTS	string	用于并发控制的 ETag。
provenanceType	integer	用于记录实体或关系的实例的来源
status	StatusAtlasRelationship	关系状态的枚举。
typeName	string	类型的名称。
updateTime	integer	记录的更新时间。
updatedBy	string	更新记录的用户。
version	integer	关系的版本。

StatusAtlasRelationship

atlas 关系的状态

名称	类型	说明
ACTIVE	string	活动
DELETED	string	deleted

通过