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

Entity - Get Classification

Service:

Purview

API Version:

2023-09-01

获取由 GUID 表示的给定实体的分类。

GET {endpoint}/datamap/api/atlas/v2/entity/guid/{guid}/classification/{classificationName}

URI 参数

名称	在	必需	类型	说明
classificationName	path	True	string	分类的名称。
endpoint	path	True	string
guid	path	True	string	实体的全局唯一标识符。

响应

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

安全性

OAuth2Auth

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

示例

Entity_GetClassification

Sample Request

HTTP

GET {endpoint}/datamap/api/atlas/v2/entity/guid/9347abc5-7b86-4b82-a1e2-ad77c7c3cac3/classification/MICROSOFT.PERSONAL.DATE_OF_BIRTH

Sample Response

Status code:

200

{
  "typeName": "MICROSOFT.PERSONAL.DATE_OF_BIRTH",
  "lastModifiedTS": "1",
  "entityGuid": "9347abc5-7b86-4b82-a1e2-ad77c7c3cac3",
  "entityStatus": "ACTIVE"
}

定义

名称	说明
AtlasClassification	分类的实例;它没有标识，此对象仅在与实体关联时才存在。
AtlasErrorResponse	来自服务的错误响应
EntityStatus	状态 - 可以是活动状态，也可以已删除
TimeBoundary	捕获时间边界详细信息

AtlasClassification

分类的实例;它没有标识，此对象仅在与实体关联时才存在。

名称	类型	说明
attributes		结构的属性。
entityGuid	string	实体的 GUID。
entityStatus	EntityStatus	实体的状态 - 可以是活动状态，也可以是已删除的。 不会删除已删除的实体。
lastModifiedTS	string	用于并发控制的 ETag。
removePropagationsOnEntityDelete	boolean	确定是否在删除实体时删除传播。
typeName	string	类型的名称。
validityPeriods	TimeBoundary[]	指示有效期的时间边界数组。

AtlasErrorResponse

来自服务的错误响应

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

EntityStatus

状态 - 可以是活动状态，也可以已删除

名称	类型	说明
ACTIVE	string	状态为活动状态。
DELETED	string	状态已删除。

TimeBoundary

捕获时间边界详细信息

名称	类型	说明
endTime	string	时间边界的结束时间。
startTime	string	时间边界的开始。
timeZone	string	时间边界的时区。