Entity - Remove Labels By Unique Attribute

Service:: Purview

API Version:: 2023-09-01

Delete given labels to a given entity identified by its type and unique attribute.

If labels is null/empty, no labels will be removed.

If any labels in labels set are non-existing labels, they will be ignored, only existing labels will be removed. In addition to the typeName path parameter, attribute key-value pair(s) can be provided in the following format: attr:<attrName>=<attrValue>. NOTE: The attrName and attrValue should be unique across entities, eg. qualifiedName. The REST request would look something like this: DELETE /v2/entity/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue.

DELETE {endpoint}/datamap/api/atlas/v2/entity/uniqueAttribute/type/{typeName}/labels

With optional parameters:

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

URI Parameters

Name	In	Required	Type	Description
endpoint	path	True	string (uri)
typeName	path	True	string	The name of the type.
attr:qualifiedName	query		string	The qualified name of the entity. (This is only an example. qualifiedName can be changed to other unique attributes)

Request Body

Name	Type	Description
body	string[]	set of labels to be deleted

Responses

Name	Type	Description
204 No Content		There is no content to send for this request, but the headers may be useful.
Other Status Codes	AtlasErrorResponse	An unexpected error response.

Security

OAuth2Auth

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

Scopes

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

Examples