Glossary - Partial Update

Reference

Service:: Purview

API Version:: 2023-09-01

Update the glossary partially. Some properties such as qualifiedName are not allowed to be updated.

So far we only supports partial updating shortDescription, longDescription, language and usage for glossary.

Recommend using 'ignoreTermsAndCategories=true' to reduce response body size.

PUT {endpoint}/datamap/api/atlas/v2/glossary/{glossaryId}/partial

With optional parameters:

PUT {endpoint}/datamap/api/atlas/v2/glossary/{glossaryId}/partial?api-version=2023-09-01&ignoreTermsAndCategories={ignoreTermsAndCategories}

URI Parameters

Name	In	Required	Type	Description
endpoint	path	True	string
glossaryId	path	True	string	The globally unique identifier for glossary.
api-version	query		string	The API version to use for this operation.
ignoreTermsAndCategories	query		boolean	Whether ignore terms and categories

Responses

Name	Type	Description
200 OK	AtlasGlossary	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

Glossary_PartialUpdate

Sample request

HTTP

PUT {endpoint}/datamap/api/atlas/v2/glossary/c018ddaf-7c21-4b37-a838-dae5f110c3d8/partial?api-version=2023-09-01

{
  "longDescription": "Example Long Description"
}

Sample response

Status code:: 200

{
  "guid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8",
  "qualifiedName": "Glossary",
  "name": "Glossary",
  "shortDescription": "Example Short Description",
  "longDescription": "Example Long Description",
  "lastModifiedTS": "3",
  "language": "en",
  "usage": "Example Glossary",
  "createdBy": "ExampleCreator",
  "updatedBy": "ExampleUpdator",
  "createTime": 1672892675600,
  "updateTime": 1672892675688,
  "terms": [
    {
      "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea",
      "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0",
      "displayText": "ExampleTerm1"
    },
    {
      "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008",
      "relationGuid": "9385640b-e6be-437d-a6b9-62d11c14a189",
      "displayText": "ExampleTerm2"
    }
  ],
  "categories": [
    {
      "categoryGuid": "0d6766f6-f4b6-435b-bda2-d3edc358998e",
      "parentCategoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12",
      "relationGuid": "26a486a4-a8e2-483c-8a84-3b88e909f8d2",
      "displayText": "ExampleCategory3"
    },
    {
      "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12",
      "parentCategoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a",
      "relationGuid": "7bdcef93-a57a-4d1d-95ab-9d3036f394a0",
      "displayText": "ExampleCategory1"
    },
    {
      "categoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a",
      "relationGuid": "94071e56-fd3e-4441-93ff-1834f818482d",
      "displayText": "ExampleCategory2"
    }
  ]
}

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
AtlasGlossary	The glossary object.
AtlasRelatedCategoryHeader	The header of the related category.
AtlasRelatedTermHeader	The header of the related term.
AtlasTermRelationshipStatus	Status for atlas term relationship
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.

AtlasGlossary

The glossary object.

Name	Type	Description
categories	AtlasRelatedCategoryHeader[]	An array of categories.
classifications	AtlasClassification[]	An array of classifications.
createTime	integer	The created time of the record.
createdBy	string	The user who created the record.
guid	string	The GUID of the object.
language	string	The language of the glossary.
lastModifiedTS	string	ETag for concurrency control.
longDescription	string	The long version description.
name	string	The name of the glossary object.
qualifiedName	string	The qualified name of the glossary object.
shortDescription	string	The short version of description.
terms	AtlasRelatedTermHeader[]	An array of related term headers.
updateTime	integer	The update time of the record.
updatedBy	string	The user who updated the record.
usage	string	The usage of the glossary.

AtlasRelatedCategoryHeader

The header of the related category.

Name	Type	Description
categoryGuid	string	The GUID of the category.
description	string	The description of the category header.
displayText	string	The display text.
parentCategoryGuid	string	The GUID of the parent category.
relationGuid	string	The GUID of the relationship.

AtlasRelatedTermHeader

The header of the related term.

Name	Type	Description
description	string	The description of the related term.
displayText	string	The display text.
expression	string	The expression of the term.
relationGuid	string	The GUID of the relationship.
status	AtlasTermRelationshipStatus	The status of term relationship.
steward	string	The steward of the term.
termGuid	string	The GUID of the term.

AtlasTermRelationshipStatus

Status for atlas term relationship

Name	Type	Description
ACTIVE	string	active
DEPRECATED	string	deprecated
DRAFT	string	draft
OBSOLETE	string	obsolete
OTHER	string	other

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.

Share via