Entity - Add Classification

Service:

Purview

API Version:

2023-09-01

Associate a classification to multiple entities in bulk.

POST {endpoint}/datamap/api/atlas/v2/entity/bulk/classification

URI Parameters

Name	In	Required	Type	Description
endpoint	path	True	string

Request Body

Name	Type	Description
classification	AtlasClassification	An instance of a classification; it doesn't have an identity, this object exists only when associated with an entity.
entityGuids	string[]	The GUID of the entity.

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

Entity_AddClassificationToEntityByGuids

Sample Request

HTTP

POST {endpoint}/datamap/api/atlas/v2/entity/bulk/classification

{
  "classification": {
    "typeName": "MICROSOFT.FINANCIAL.US.ABA_ROUTING_NUMBER",
    "attributes": {},
    "validityPeriods": []
  },
  "entityGuids": [
    "784c0f2f-afd2-e26b-f9cb-984f6c2c5021",
    "b4ebc8be-cef4-860a-bee9-28cc34cb5caa"
  ]
}

Sample Response

Status code:

204

Definitions

Name	Description
AtlasClassification	An instance of a classification; it doesn't have an identity, this object exists only when associated with an entity.
AtlasErrorResponse	An error response from the service
ClassificationAssociateOptions	The request payload for classification association.
EntityStatus	Status - can be active or deleted
TimeBoundary	Captures time-boundary details

AtlasClassification

An instance of a classification; it doesn't have an identity, this object exists only when associated with an entity.

Name	Type	Description
attributes		The attributes of the struct.
entityGuid	string	The GUID of the entity.
entityStatus	EntityStatus	Status of the entity - can be active or deleted. Deleted entities are not removed.
lastModifiedTS	string	ETag for concurrency control.
removePropagationsOnEntityDelete	boolean	Determines if propagations will be removed on entity deletion.
typeName	string	The name of the type.
validityPeriods	TimeBoundary[]	An array of time boundaries indicating validity periods.

AtlasErrorResponse

An error response from the service

Name	Type	Description
errorCode	string	The error code.
errorMessage	string	The error message.
requestId	string	The request ID.

ClassificationAssociateOptions

The request payload for classification association.

Name	Type	Description
classification	AtlasClassification	An instance of a classification; it doesn't have an identity, this object exists only when associated with an entity.
entityGuids	string[]	The GUID of the entity.

EntityStatus

Status - can be active or deleted

Name	Type	Description
ACTIVE	string	The status is active.
DELETED	string	The status is deleted.

TimeBoundary

Captures time-boundary details

Name	Type	Description
endTime	string	The end of the time boundary.
startTime	string	The start of the time boundary.
timeZone	string	The timezone of the time boundary.