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

Entity - Partial Update Entity Attribute By Guid

部分更新实体 - 创建或更新由其 GUID 标识的实体属性。 仅支持基元属性类型和实体引用。 它不支持更新复杂类型,如数组和映射。 无法进行 Null 更新。

PUT {Endpoint}/catalog/api/atlas/v2/entity/guid/{guid}?name={name}

URI 参数

Name In Required Type Description
Endpoint
path True
  • string

Purview 帐户的目录终结点。 示例:https://{accountName}.purview.azure.com

guid
path True
  • string

实体的全局唯一标识符。

name
query True
  • string

属性名。

请求正文

Name Type Description
body
  • object

属性的值。

响应

Name Type Description
200 OK

使用 EntityMutationResponse 进行更新。

Other Status Codes

描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

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

Scopes

Name Description
user_impersonation 模拟用户帐户

示例

Entity_PartialUpdateEntityAttributeByGuid

Sample Request

PUT {Endpoint}/catalog/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"
    }
  ]
}

定义

AtlasClassification

AtlasClassification

AtlasEntityHeader

AtlasEntityHeader

AtlasTermAssignmentHeader

AtlasTermAssignmentHeader

AtlasTermAssignmentStatus

AtlasTermAssignmentStatus

Attributes

结构的属性。

EntityMutationResponse

EntityMutationResponse

ErrorResponse

来自服务的错误响应

SourceDetails

有关源信息的更多详细信息

Status

状态

TimeBoundary

TimeBoundary

AtlasClassification

AtlasClassification

Name Type Description
attributes

结构的属性。

entityGuid
  • string

实体的 GUID。

entityStatus

状态
实体的状态 - 可以处于活动状态或删除。 不会从 Atlas 存储中删除已删除的实体。

lastModifiedTS
  • string

lastModifiedTS
用于并发控制的 ETag。

removePropagationsOnEntityDelete
  • boolean

确定在实体删除时是否删除传播。

source
  • string

指示创建分类详细信息的源

sourceDetails

有关源信息的更多详细信息

typeName
  • string

类型的名称。

validityPeriods

一个时间边界数组,指示有效期。

AtlasEntityHeader

AtlasEntityHeader

Name Type Description
attributes

结构的属性。

classificationNames
  • string[]

分类名称数组。

classifications

分类数组。

displayText
  • string

显示文本。

guid
  • string

记录的 GUID。

isIncomplete
  • boolean

它是否为 shell 实体

labels
  • string[]

标签

lastModifiedTS
  • string

lastModifiedTS
用于并发控制的 ETag。

meaningNames
  • string[]

含义数组。

meanings

术语分配标头数组。

status

状态
实体的状态 - 可以处于活动状态或删除。 不会从 Atlas 存储中删除已删除的实体。

typeName
  • string

类型的名称。

AtlasTermAssignmentHeader

AtlasTermAssignmentHeader

Name Type Description
confidence
  • integer

术语分配的置信度。

createdBy
  • string

创建记录的用户。

description
  • string

术语分配的说明。

displayText
  • string

显示文本。

expression
  • string

术语赋值表达式。

relationGuid
  • string

关系的 GUID。

source
  • string

术语的源。

status

AtlasTermAssignmentStatus
术语分配的状态。

steward
  • string

术语的管家。

termGuid
  • string

术语的 GUID。

AtlasTermAssignmentStatus

AtlasTermAssignmentStatus

Name Type Description
DEPRECATED
  • string
DISCOVERED
  • string
IMPORTED
  • string
OBSOLETE
  • string
OTHER
  • string
PROPOSED
  • string
VALIDATED
  • string

Attributes

结构的属性。

Name Type Description

EntityMutationResponse

EntityMutationResponse

Name Type Description
guidAssignments
  • object

包含实体的 GUID 分配的映射。

mutatedEntities
  • object

可变实体的实体标头。

partialUpdatedEntities

部分更新的实体标头数组。

ErrorResponse

来自服务的错误响应

Name Type Description
errorCode
  • string

错误代码。

errorMessage
  • string

错误消息。

requestId
  • string

请求 ID。

SourceDetails

有关源信息的更多详细信息

Name Type Description

Status

状态

Name Type Description
ACTIVE
  • string
DELETED
  • string

TimeBoundary

TimeBoundary

Name Type Description
endTime
  • string

时间边界的结束。

startTime
  • string

时间边界的开始。

timeZone
  • string

时间边界的时区。