Type - Get Classification Def By Name

Service:

Purview

API Version:

2023-09-01

Get the classification definition by its name (unique).

GET {endpoint}/datamap/api/atlas/v2/types/classificationdef/name/{name}

URI Parameters

Name	In	Required	Type	Description
endpoint	path	True	string (uri)
name	path	True	string	The name of the classification.

Responses

Name	Type	Description
200 OK	AtlasClassificationDef	The request has succeeded.
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

Type_GetClassificationDefByName

Sample request

HTTP

GET {endpoint}/datamap/api/atlas/v2/types/classificationdef/name/MICROSOFT.GOVERNMENT.CANADA.SOCIAL_INSURANCE_NUMBER

Sample response

Status code:

200

{
  "category": "CLASSIFICATION",
  "guid": "e79878fa-adba-4ee5-adc5-328d8841cd49",
  "createdBy": "ExampleCreator",
  "updatedBy": "ExampleUpdator",
  "createTime": 1553065966043,
  "updateTime": 1553065966043,
  "version": 1,
  "name": "MICROSOFT.GOVERNMENT.CANADA.SOCIAL_INSURANCE_NUMBER",
  "description": "Canada Social Insurance Number",
  "typeVersion": "1.0",
  "attributeDefs": [],
  "superTypes": [],
  "entityTypes": [],
  "subTypes": []
}

Definitions

Name	Description
AtlasAttributeDef	class that captures details of a struct-attribute.
AtlasClassificationDef	class that captures details of a classification-type.
AtlasConstraintDef	class that captures details of a constraint.
AtlasErrorResponse	An error response from the service
CardinalityValue	Cardinality
DateFormat	The date format.
NumberFormat	The number format.
RoundingMode	Rounding Mode
TimeZone	The timezone information.
TypeCategory	Type Category

AtlasAttributeDef

Object

class that captures details of a struct-attribute.

Name	Type	Description
cardinality	CardinalityValue	single-valued attribute or multi-valued attribute.
constraints	AtlasConstraintDef[]	An array of constraints.
defaultValue	string	The default value of the attribute.
description	string	The description of the attribute.
includeInNotification	boolean	Determines if it is included in notification.
isIndexable	boolean	Determines if it is indexable.
isOptional	boolean	Determines if it is optional.
isUnique	boolean	Determines if it unique.
name	string	The name of the attribute.
options	object	The options for the attribute.
typeName	string	The name of the type.
valuesMaxCount	integer (int32)	The maximum count of the values.
valuesMinCount	integer (int32)	The minimum count of the values.

AtlasClassificationDef

Object

class that captures details of a classification-type.

Name	Type	Description
attributeDefs	AtlasAttributeDef[]	An array of attribute definitions.
category	TypeCategory	The enum of type category.
createTime	integer (int64)	The created time of the record.
createdBy	string	The user who created the record.
dateFormatter	DateFormat	The date format.
description	string	The description of the type definition.
entityTypes	string[]	Specifying a list of entityType names in the classificationDef, ensures that classifications can only be applied to those entityTypes. Any subtypes of the entity types inherit the restriction. Any classificationDef subtypes inherit the parents entityTypes restrictions. Any classificationDef subtypes can further restrict the parents entityTypes restrictions by specifying a subset of the entityTypes. An empty entityTypes list when there are no parent restrictions means there are no restrictions. An empty entityTypes list when there are parent restrictions means that the subtype picks up the parents restrictions. If a list of entityTypes are supplied, where one inherits from another, this will be rejected. This should encourage cleaner classificationsDefs.
guid	string	The GUID of the type definition.
lastModifiedTS	string	ETag for concurrency control.
name	string	The name of the type definition.
options	object	The options for the type definition.
serviceType	string	The service type.
subTypes	string[]	An array of sub types.
superTypes	string[]	An array of super types.
typeVersion	string	The version of the type.
updateTime	integer (int64)	The update time of the record.
updatedBy	string	The user who updated the record.
version	integer (int64)	The version of the record.

AtlasConstraintDef

Object

class that captures details of a constraint.

Name	Type	Description
params		The parameters of the constraint definition.
type	string	The type of the constraint.

AtlasErrorResponse

Object

An error response from the service

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

CardinalityValue

Enumeration

Cardinality

Value	Description
SINGLE	single
LIST	list
SET	set

DateFormat

Object

The date format.

Name	Type	Description
availableLocales	string[]	An array of available locales.
calendar	number (float)	Calendar
dateInstance	DateFormat	The date format.
dateTimeInstance	DateFormat	The date format.
instance	DateFormat	The date format.
lenient	boolean	Determines the leniency of the date format.
numberFormat	NumberFormat	The number format.
timeInstance	DateFormat	The date format.
timeZone	TimeZone	The timezone information.

NumberFormat

Object

The number format.

Name	Type	Description
availableLocales	string[]	The number format.
currency	string	The currency.
currencyInstance	NumberFormat	The number format.
groupingUsed	boolean	Determines if grouping is used.
instance	NumberFormat	The number format.
integerInstance	NumberFormat	The number format.
maximumFractionDigits	integer (int32)	The maximum of fraction digits.
maximumIntegerDigits	integer (int32)	The maximum of integer digits.
minimumFractionDigits	integer (int32)	The minimum of fraction digits.
minimumIntegerDigits	integer (int32)	The minimum of integer digits.
numberInstance	NumberFormat	The number format.
parseIntegerOnly	boolean	Determines if only integer is parsed.
percentInstance	NumberFormat	The number format.
roundingMode	RoundingMode	The enum of rounding mode.

RoundingMode

Enumeration

Rounding Mode

Value	Description
UP	up
DOWN	down
CEILING	ceiling
FLOOR	floor
HALF_UP	half up
HALF_DOWN	half down
HALF_EVEN	half even
UNNECESSARY	unnecessary

TimeZone

Object

The timezone information.

Name	Type	Description
availableIds	string[]	An array of available IDs.
default	TimeZone	The timezone information.
displayName	string	The display name of the timezone.
dstSavings	integer (int32)	The value of the daylight saving time.
id	string	The ID of the timezone.
rawOffset	integer (int32)	The raw offset of the timezone.

TypeCategory

Enumeration

Type Category

Value	Description
PRIMITIVE	primitive
OBJECT_ID_TYPE	object id type
ENUM	enum
STRUCT	struct
CLASSIFICATION	classification
ENTITY	entity
ARRAY	array
MAP	map
RELATIONSHIP	relationship
TERM_TEMPLATE	term template