Compartilhar via


Entity - Set Labels By Unique Attribute

Defina rótulos para uma determinada entidade identificada por seu tipo e atributos exclusivos.

Se os rótulos forem nulos/vazios, todos os rótulos existentes serão removidos.

Além do parâmetro typeName path, o atributo key-value pair(s) pode ser fornecido no seguinte formato: attr:=.

OBSERVAÇÃO: o attrName e o attrValue devem ser exclusivos entre entidades, por exemplo. Qualifiedname.

A solicitação REST seria semelhante a esta: POST /v2/entity/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue.

POST {endpoint}/datamap/api/atlas/v2/entity/uniqueAttribute/type/{typeName}/labels
POST {endpoint}/datamap/api/atlas/v2/entity/uniqueAttribute/type/{typeName}/labels?attr:qualifiedName={attr:qualifiedName}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
endpoint
path True

string

typeName
path True

string

O nome do tipo.

attr:qualifiedName
query

string

O nome qualificado da entidade. (Este é apenas um exemplo. qualifiedName pode ser alterado para outros atributos exclusivos)

Corpo da solicitação

Nome Tipo Description
body

string[]

conjunto de rótulos a serem definidos

Respostas

Nome Tipo Description
204 No Content

Não há conteúdo a ser enviado para essa solicitação, mas os cabeçalhos podem ser úteis.

Other Status Codes

AtlasErrorResponse

Uma resposta de erro inesperada.

Segurança

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
https://purview.azure.net/.default

Exemplos

Entity_SetLabelsByUniqueAttribute

Solicitação de exemplo

POST {endpoint}/datamap/api/atlas/v2/entity/uniqueAttribute/type/Asset/labels?attr:qualifiedName=https://asset1

[
  "label1",
  "label2"
]

Resposta de exemplo

Definições

AtlasErrorResponse

Uma resposta de erro do serviço

Nome Tipo Description
errorCode

string

O código de erro.

errorMessage

string

A mensagem de erro.

requestId

string

A ID da solicitação.