你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Entity - Partial Update Attribute By Guid
部分更新实体 - 创建或更新由其 GUID 标识的实体属性。 仅支持基元属性类型和实体引用。 它不支持更新数组和映射等复杂类型。 无法进行 Null 更新。
PUT {endpoint}/datamap/api/atlas/v2/entity/guid/{guid}?name={name}
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
endpoint
|
path | True |
string |
|
guid
|
path | True |
string |
实体的全局唯一标识符。 |
name
|
query | True |
string |
属性名。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
请求已成功。 |
|
Other Status Codes |
意外的错误响应。 |
安全性
OAuth2Auth
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名称 | 说明 |
---|---|
https://purview.azure.net/.default |
示例
Entity_PartialUpdateAttributeByGuid
Sample Request
PUT {endpoint}/datamap/api/atlas/v2/entity/guid/394d9a03-912e-483b-bbd2-bedee1a69798?name=ExampleName
"ExampleNewName"
Sample Response
{
"mutatedEntities": {
"CREATE": [
{
"typeName": "azure_storage_account",
"attributes": {
"qualifiedName": "https://exampleaccount.core.windows.net"
},
"lastModifiedTS": "1",
"guid": "394d9a03-912e-483b-bbd2-bedee1a69798",
"status": "ACTIVE"
}
]
},
"partialUpdatedEntities": [
{
"typeName": "azure_storage_account",
"attributes": {
"qualifiedName": "https://exampleaccount.core.windows.net"
},
"lastModifiedTS": "1",
"guid": "394d9a03-912e-483b-bbd2-bedee1a69798"
}
]
}
定义
名称 | 说明 |
---|---|
Atlas |
分类的实例;它没有标识,此对象仅在与实体关联时才存在。 |
Atlas |
实体的实例 - 如 hive_table、hive_database。 |
Atlas |
来自服务的错误响应 |
Atlas |
术语分配的标头。 |
Atlas |
术语分配的状态 |
Entity |
实体的突变响应结果。 |
Entity |
状态 - 可以是活动状态,也可以已删除 |
Time |
捕获时间边界详细信息 |
AtlasClassification
分类的实例;它没有标识,此对象仅在与实体关联时才存在。
名称 | 类型 | 说明 |
---|---|---|
attributes |
结构的属性。 |
|
entityGuid |
string |
实体的 GUID。 |
entityStatus |
实体的状态 - 可以是活动状态,也可以是已删除的。 不会删除已删除的实体。 |
|
lastModifiedTS |
string |
用于并发控制的 ETag。 |
removePropagationsOnEntityDelete |
boolean |
确定是否在删除实体时删除传播。 |
typeName |
string |
类型的名称。 |
validityPeriods |
指示有效期的时间边界数组。 |
AtlasEntityHeader
实体的实例 - 如 hive_table、hive_database。
名称 | 类型 | 说明 |
---|---|---|
attributes |
结构的属性。 |
|
classificationNames |
string[] |
分类名称数组。 |
classifications |
分类数组。 |
|
displayText |
string |
显示文本。 |
guid |
string |
记录的 GUID。 |
isIncomplete |
boolean |
它是否为 shell 实体 |
labels |
string[] |
标签 |
lastModifiedTS |
string |
用于并发控制的 ETag。 |
meaningNames |
string[] |
含义数组。 |
meanings |
术语赋值标头的数组。 |
|
status |
实体的状态 - 可以是活动状态,也可以是已删除的。 不会删除已删除的实体。 |
|
typeName |
string |
类型的名称。 |
AtlasErrorResponse
来自服务的错误响应
名称 | 类型 | 说明 |
---|---|---|
errorCode |
string |
错误代码。 |
errorMessage |
string |
错误消息。 |
requestId |
string |
请求 ID。 |
AtlasTermAssignmentHeader
术语分配的标头。
名称 | 类型 | 说明 |
---|---|---|
confidence |
integer |
术语赋值的置信度。 |
createdBy |
string |
创建记录的用户。 |
description |
string |
术语赋值的说明。 |
displayText |
string |
显示文本。 |
expression |
string |
术语赋值的表达式。 |
relationGuid |
string |
关系的 GUID。 |
status |
术语分配的状态。 |
|
steward |
string |
术语的管理员。 |
termGuid |
string |
术语的 GUID。 |
AtlasTermAssignmentStatus
术语分配的状态
名称 | 类型 | 说明 |
---|---|---|
DEPRECATED |
string |
状态已弃用。 |
DISCOVERED |
string |
已发现状态。 |
IMPORTED |
string |
状态已导入。 |
OBSOLETE |
string |
状态已过时。 |
OTHER |
string |
其他状态。 |
PROPOSED |
string |
建议状态。 |
VALIDATED |
string |
状态已验证。 |
EntityMutationResult
实体的突变响应结果。
名称 | 类型 | 说明 |
---|---|---|
guidAssignments |
object |
包含实体的 GUID 分配的映射。 |
mutatedEntities |
object |
可变实体的实体标头。 |
partialUpdatedEntities |
部分更新的实体标头数组。 |
EntityStatus
状态 - 可以是活动状态,也可以已删除
名称 | 类型 | 说明 |
---|---|---|
ACTIVE |
string |
状态为活动状态。 |
DELETED |
string |
状态已删除。 |
TimeBoundary
捕获时间边界详细信息
名称 | 类型 | 说明 |
---|---|---|
endTime |
string |
时间边界的结束时间。 |
startTime |
string |
时间边界的开始。 |
timeZone |
string |
时间边界的时区。 |