swagger: '2.0' info: title: Microsoft Azure Azure Analytics Purview Data Map version: '2023-09-01' description: >- Purview Data Map Service is a fully managed cloud service whose users can discover the data sources they need and understand the data sources they find. At the same time, Data Map helps organizations get more value from their existing investments. This spec defines REST API of Purview Data Map Service. x-typespec-generated: - emitter: '@azure-tools/typespec-autorest' schemes: - https x-ms-parameterized-host: hostTemplate: '{endpoint}/datamap/api' useSchemePrefix: false parameters: - name: endpoint in: path required: true type: string produces: - application/json consumes: - application/json security: - OAuth2Auth: - https://purview.azure.net/.default securityDefinitions: OAuth2Auth: type: oauth2 flow: implicit authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize scopes: https://purview.azure.net/.default: '' tags: - name: Atlas - name: Entity - name: Lineage - name: Search - name: Types paths: /atlas/v2/entity: post: operationId: microsoftAzureEntityCreateorupdate description: >- Create or update an entity.
Existing entity is matched using its unique guid if
supplied or by its unique attributes eg: qualifiedName.
Map and array of
collections are not well supported. E.g., array>, array>.
For each contact type, the maximum number of contacts is 20. parameters: - $ref: '#/parameters/AtlasApiVersionParameter' - name: businessAttributeUpdateBehavior in: query description: >- Used to define the update behavior for business attributes when updating entities. required: false type: string enum: - ignore - replace - merge x-ms-enum: name: BusinessAttributeUpdateBehavior modelAsString: true values: - name: Ignore value: ignore description: Ignore the business attribute payload for update. - name: Replace value: replace description: Replace all the business attributes using the payload. - name: Merge value: merge description: >- Merge the business attributes. Business attributes will not be updated if not provided. - name: collectionId in: query description: >- The collection where entities will be moved to. Only specify a value if you need to move an entity to another collection. required: false type: string - name: body in: body required: true schema: $ref: '#/definitions/AtlasEntityWithExtInfo' responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/EntityMutationResult' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_AddCustomAttribute: $ref: ./examples/Entity_AddCustomAttribute.json Entity_Create: $ref: ./examples/Entity_Create.json Entity_Update: $ref: ./examples/Entity_Update.json summary: Microsoft Azure Post Atlas Entity tags: - Atlas /atlas/v2/entity/bulk: get: operationId: microsoftAzureEntityListbyguids description: List entities in bulk identified by its GUIDs. parameters: - $ref: '#/parameters/AtlasApiVersionParameter' - name: guid in: query description: An array of GUIDs of entities to list. required: true type: array items: type: string collectionFormat: multi - name: minExtInfo in: query description: Whether to return minimal information for referred entities. required: false type: boolean - name: ignoreRelationships in: query description: Whether to ignore relationship attributes. required: false type: boolean responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasEntitiesWithExtInfo' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_ListByGuids: $ref: ./examples/Entity_ListByGuids.json summary: Microsoft Azure Get Atlas Entity Bulk tags: - Atlas post: operationId: microsoftAzureEntityBulkcreateorupdate description: >- Create or update entities in bulk.
Existing entity is matched using its unique
guid if supplied or by its unique attributes eg: qualifiedName.
Map and array
of collections are not well supported. E.g., array>,
array>.
For each contact type, the maximum number of contacts
is 20. parameters: - $ref: '#/parameters/AtlasApiVersionParameter' - name: collectionId in: query description: >- The collection where entities will be moved to. Only specify a value if you need to move an entity to another collection. required: false type: string - name: businessAttributeUpdateBehavior in: query description: >- Used to define the update behavior for business attributes when updating entities. required: false type: string enum: - ignore - replace - merge x-ms-enum: name: BusinessAttributeUpdateBehavior modelAsString: true values: - name: Ignore value: ignore description: Ignore the business attribute payload for update. - name: Replace value: replace description: Replace all the business attributes using the payload. - name: Merge value: merge description: >- Merge the business attributes. Business attributes will not be updated if not provided. - name: body in: body required: true schema: $ref: '#/definitions/AtlasEntitiesWithExtInfo' responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/EntityMutationResult' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_BulkCreateOrUpdate: $ref: ./examples/Entity_BulkCreateOrUpdate.json summary: Microsoft Azure Post Atlas Entity Bulk tags: - Atlas delete: operationId: microsoftAzureEntityBulkdelete description: >- Delete a list of entities in bulk identified by their GUIDs or unique
attributes. parameters: - name: guid in: query description: An array of GUIDs of entities to delete. required: true type: array items: type: string collectionFormat: multi responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/EntityMutationResult' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_BulkDelete: $ref: ./examples/Entity_BulkDelete.json summary: Microsoft Azure Delete Atlas Entity Bulk tags: - Atlas /atlas/v2/entity/bulk/classification: post: operationId: microsoftAzureEntityAddclassification description: Associate a classification to multiple entities in bulk. parameters: - name: body in: body required: true schema: $ref: '#/definitions/ClassificationAssociateOptions' responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_AddClassificationToEntityByGuids: $ref: ./examples/Entity_AddClassificationToEntityByGuids.json summary: Microsoft Azure Post Atlas Entity Bulk Classification tags: - Atlas /atlas/v2/entity/bulk/setClassifications: post: operationId: microsoftAzureEntityBulksetclassifications description: Set classifications on entities in bulk. parameters: - name: body in: body required: true schema: $ref: '#/definitions/AtlasEntityHeaders' responses: '200': description: The request has succeeded. schema: type: array items: type: string default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_BulkSetClassifications: $ref: ./examples/Entity_BulkSetClassifications.json summary: Microsoft Azure Post Atlas Entity Bulk Setclassifications tags: - Atlas /atlas/v2/entity/bulk/uniqueAttribute/type/{typeName}: get: operationId: microsoftAzureEntityListbyuniqueattributes description: >- Bulk API to retrieve list of entities identified by its unique attributes.
In
addition to the typeName path parameter, attribute key-value pair(s) can be
provided in the following
format

typeName=\&attr_1:\=\&attr_2:\=\&attr_3:\=\

NOTE:
The attrName should be an unique attribute for the given entity-type.
The REST
request would look something like this

GET
/v2/entity/bulk/uniqueAttribute/type/hive_db?attr_1:qualifiedName=db1@cl1&attr_2:qualifiedName=db2@cl1

Note:
at least one unique attribute must be provided. parameters: - name: typeName in: path description: The name of the type. required: true type: string - name: minExtInfo in: query description: Whether to return minimal information for referred entities. required: false type: boolean - name: ignoreRelationships in: query description: Whether to ignore relationship attributes. required: false type: boolean - name: attr_N:qualifiedName in: query description: >- Qualified name of an entity. E.g. to find 2 entities you can set attrs_1:qualifiedName=db1@cl1&attrs_2:qualifiedName=db2@cl1. (This is only an example. qualifiedName can be changed to other unique attributes) required: false type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasEntitiesWithExtInfo' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_ListByUniqueAttributes: $ref: ./examples/Entity_ListByUniqueAttributes.json summary: Microsoft Azure Get Atlas Entity Bulk Uniqueattribute Type Typename tags: - Atlas /atlas/v2/entity/businessmetadata/import: post: operationId: microsoftAzureEntityImportbusinessmetadata description: Upload the file for creating Business Metadata in BULK consumes: - multipart/form-data parameters: - $ref: '#/parameters/BusinessMetadataOptions' responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/BulkImportResult' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_ImportBusinessMetadata: $ref: ./examples/Entity_ImportBusinessMetadata.json summary: Microsoft Azure Post Atlas Entity Businessmetadata Import tags: - Atlas /atlas/v2/entity/businessmetadata/import/template: get: operationId: microsoftAzureEntityGetsamplebusinessmetadatatemplate description: Get the sample Template for uploading/creating bulk BusinessMetaData produces: - application/octet-stream - application/json parameters: [] responses: '200': description: The request has succeeded. schema: type: file default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_GetSampleBusinessMetadataTemplate: $ref: ./examples/Entity_GetSampleBusinessMetadataTemplate.json summary: Microsoft Azure Get Atlas Entity Businessmetadata Import Template tags: - Atlas /atlas/v2/entity/guid/{guid}: get: operationId: microsoftAzureEntityGet description: Get complete definition of an entity given its GUID. parameters: - name: guid in: path description: The globally unique identifier of the entity. required: true type: string - name: minExtInfo in: query description: Whether to return minimal information for referred entities. required: false type: boolean - name: ignoreRelationships in: query description: Whether to ignore relationship attributes. required: false type: boolean responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasEntityWithExtInfo' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_Get: $ref: ./examples/Entity_Get.json summary: Microsoft Azure Get Atlas Entity Guid Guid tags: - Atlas put: operationId: microsoftAzureEntityPartialupdateattributebyguid description: >- Update entity partially - create or update entity attribute identified by its
GUID.
Supports only primitive attribute type and entity references.
It does not support updating complex types like arrays, and maps.
Null updates are not possible. parameters: - name: guid in: path description: The globally unique identifier of the entity. required: true type: string - name: name in: query description: The name of the attribute. required: true type: string - name: body in: body description: The value of the attribute. required: true schema: {} responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/EntityMutationResult' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_PartialUpdateAttributeByGuid: $ref: ./examples/Entity_PartialUpdateAttributeByGuid.json summary: Microsoft Azure Put Atlas Entity Guid Guid tags: - Atlas delete: operationId: microsoftAzureEntityDelete description: Delete an entity identified by its GUID. parameters: - name: guid in: path description: The globally unique identifier of the entity. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/EntityMutationResult' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_Delete: $ref: ./examples/Entity_Delete.json summary: Microsoft Azure Delete Atlas Entity Guid Guid tags: - Atlas /atlas/v2/entity/guid/{guid}/businessmetadata: post: operationId: microsoftAzureEntityAddorupdatebusinessmetadata description: Add business metadata to an entity. parameters: - name: guid in: path description: The globally unique identifier of the entity. required: true type: string - name: isOverwrite in: query description: >- Whether to overwrite the existing business metadata on the entity or not, default is false. required: false type: boolean x-ms-client-name: overwrite - name: body in: body description: BusinessMetadata payload required: true schema: type: object additionalProperties: additionalProperties: {} type: object responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_AddOrUpdate_BusinessMetadata: $ref: ./examples/Entity_AddOrUpdate_BusinessMetadata.json summary: Microsoft Azure Post Atlas Entity Guid Guid Businessmetadata tags: - Atlas delete: operationId: microsoftAzureEntityRemovebusinessmetadata description: Remove business metadata from an entity. parameters: - name: guid in: path description: The globally unique identifier of the entity. required: true type: string - name: body in: body description: Business metadata payload required: true schema: type: object additionalProperties: additionalProperties: {} type: object responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_RemoveBusinessMetadata: $ref: ./examples/Entity_RemoveBusinessMetadata.json summary: Microsoft Azure Delete Atlas Entity Guid Guid Businessmetadata tags: - Atlas /atlas/v2/entity/guid/{guid}/businessmetadata/{businessMetadataName}: post: operationId: microsoftAzureEntityAddorupdatebusinessmetadataattributes description: Add or update business metadata attributes. parameters: - name: businessMetadataName in: path description: BusinessMetadata name required: true type: string - name: guid in: path description: The globally unique identifier of the entity. required: true type: string - name: body in: body description: Business metadata attribute payload required: true schema: type: object additionalProperties: {} responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_AddOrUpdate_BusinessAttribute: $ref: ./examples/Entity_AddOrUpdate_BusinessAttribute.json summary: Microsoft Azure Post Atlas Entity Guid Guid Businessmetadata Businessmetadataname tags: - Atlas delete: operationId: microsoftAzureEntityRemovebusinessmetadataattributes description: Delete business metadata attributes from an entity. parameters: - name: businessMetadataName in: path description: BusinessMetadata name required: true type: string - name: guid in: path description: The globally unique identifier of the entity. required: true type: string - name: body in: body description: Business metadata attribute payload required: true schema: type: object additionalProperties: {} responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_RemoveBusinessAttribute: $ref: ./examples/Entity_RemoveBusinessAttribute.json summary: Microsoft Azure Delete Atlas Entity Guid Guid Businessmetadata Businessmetadataname tags: - Atlas /atlas/v2/entity/guid/{guid}/classification/{classificationName}: get: operationId: microsoftAzureEntityGetclassification description: Get classification for a given entity represented by a GUID. parameters: - name: guid in: path description: The globally unique identifier of the entity. required: true type: string - name: classificationName in: path description: The name of the classification. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasClassification' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_GetClassification: $ref: ./examples/Entity_GetClassification.json summary: Microsoft Azure Get Atlas Entity Guid Guid Classification Classificationname tags: - Atlas delete: operationId: microsoftAzureEntityRemoveclassification description: >- Delete a given classification from an existing entity represented by a GUID. parameters: - name: guid in: path description: The globally unique identifier of the entity. required: true type: string - name: classificationName in: path description: The name of the classification. required: true type: string responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_RemoveClassification: $ref: ./examples/Entity_RemoveClassification.json summary: Microsoft Azure Delete Atlas Entity Guid Guid Classification Classificationname tags: - Atlas /atlas/v2/entity/guid/{guid}/classifications: get: operationId: microsoftAzureEntityGetclassifications description: List classifications for a given entity represented by a GUID. parameters: - name: guid in: path description: The globally unique identifier of the entity. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasClassifications' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_GetClassifications: $ref: ./examples/Entity_GetClassifications.json summary: Microsoft Azure Get Atlas Entity Guid Guid Classifications tags: - Atlas put: operationId: microsoftAzureEntityUpdateclassifications description: Update classifications to an existing entity represented by a guid. parameters: - name: guid in: path description: The globally unique identifier of the entity. required: true type: string - name: body in: body description: An array of classifications to be updated. required: true schema: type: array items: $ref: '#/definitions/AtlasClassification' x-ms-identifiers: [] responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_UpdateClassifications: $ref: ./examples/Entity_UpdateClassifications.json summary: Microsoft Azure Put Atlas Entity Guid Guid Classifications tags: - Atlas post: operationId: microsoftAzureEntityAddclassifications description: Add classifications to an existing entity represented by a GUID. parameters: - name: guid in: path description: The globally unique identifier of the entity. required: true type: string - name: body in: body description: An array of classifications to be added. required: true schema: type: array items: $ref: '#/definitions/AtlasClassification' x-ms-identifiers: [] responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_AddClassifications: $ref: ./examples/Entity_AddClassifications.json summary: Microsoft Azure Post Atlas Entity Guid Guid Classifications tags: - Atlas /atlas/v2/entity/guid/{guid}/header: get: operationId: microsoftAzureEntityGetheader description: Get entity header given its GUID. parameters: - name: guid in: path description: The globally unique identifier of the entity. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasEntityHeader' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_GetHeader: $ref: ./examples/Entity_GetHeader.json summary: Microsoft Azure Get Atlas Entity Guid Guid Header tags: - Atlas /atlas/v2/entity/guid/{guid}/labels: put: operationId: microsoftAzureEntityAddlabel description: Add given labels to a given entity. parameters: - name: guid in: path description: The globally unique identifier of the entity. required: true type: string - name: body in: body description: set of labels to be added required: false schema: type: array items: type: string responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_AddLabel: $ref: ./examples/Entity_AddLabel.json summary: Microsoft Azure Put Atlas Entity Guid Guid Labels tags: - Atlas post: operationId: microsoftAzureEntitySetlabels description: Set labels to a given entity. parameters: - name: guid in: path description: The globally unique identifier of the entity. required: true type: string - name: body in: body description: set of labels to be set to the entity required: false schema: type: array items: type: string responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_SetLabels: $ref: ./examples/Entity_SetLabels.json summary: Microsoft Azure Post Atlas Entity Guid Guid Labels tags: - Atlas delete: operationId: microsoftAzureEntityRemovelabels description: Delete given labels to a given entity. parameters: - name: guid in: path description: The globally unique identifier of the entity. required: true type: string - name: body in: body description: set of labels to be deleted required: false schema: type: array items: type: string responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_RemoveLabels: $ref: ./examples/Entity_RemoveLabels.json summary: Microsoft Azure Delete Atlas Entity Guid Guid Labels tags: - Atlas /atlas/v2/entity/uniqueAttribute/type/{typeName}: get: operationId: microsoftAzureEntityGetbyuniqueattributes description: >- Get complete definition of an entity given its type and unique attribute.

In
addition to the typeName path parameter, attribute key-value pair(s) can be
provided in the following format:
attr:\=.

NOTE: The
attrName and attrValue should be unique across entities, eg.
qualifiedName.

The REST request would look something like this:
GET
/v2/entity/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue. parameters: - name: typeName in: path description: The name of the type. required: true type: string - name: minExtInfo in: query description: Whether to return minimal information for referred entities. required: false type: boolean - name: ignoreRelationships in: query description: Whether to ignore relationship attributes. required: false type: boolean - name: attr:qualifiedName in: query description: >- The qualified name of the entity. (This is only an example. qualifiedName can be changed to other unique attributes) required: false type: string x-ms-client-name: attribute responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasEntityWithExtInfo' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_GetByUniqueAttributes: $ref: ./examples/Entity_GetByUniqueAttributes.json summary: Microsoft Azure Get Atlas Entity Uniqueattribute Type Typename tags: - Atlas put: operationId: microsoftAzureEntityPartialupdatebyuniqueattributes description: >- Update entity partially - Allow a subset of attributes to be updated on an
entity which is identified by its type and unique attribute eg:
Referenceable.qualifiedName. Null updates are not possible.

In addition to the
typeName path parameter, attribute key-value pair(s) can be provided in the
following format:

attr:=.
NOTE: The attrName and
attrValue should be unique across entities, eg. qualifiedName.

The REST
request would look something like this:
PUT
/v2/entity/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue. parameters: - name: typeName in: path description: The name of the type. required: true type: string - name: attr:qualifiedName in: query description: >- The qualified name of the entity. (This is only an example. qualifiedName can be changed to other unique attributes) required: false type: string x-ms-client-name: attribute - name: body in: body required: true schema: $ref: '#/definitions/AtlasEntityWithExtInfo' responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/EntityMutationResult' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_PartialUpdateByUniqueAttributes: $ref: ./examples/Entity_PartialUpdateByUniqueAttributes.json summary: Microsoft Azure Put Atlas Entity Uniqueattribute Type Typename tags: - Atlas delete: operationId: microsoftAzureEntityDeletebyuniqueattribute description: >- Delete an entity identified by its type and unique attributes.
In addition to
the typeName path parameter, attribute key-value pair(s) can be provided in the
following format:
attr:\=\.
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. parameters: - name: typeName in: path description: The name of the type. required: true type: string - name: attr:qualifiedName in: query description: >- The qualified name of the entity. (This is only an example. qualifiedName can be changed to other unique attributes) required: false type: string x-ms-client-name: attribute responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/EntityMutationResult' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_DeleteByUniqueAttribute: $ref: ./examples/Entity_DeleteByUniqueAttribute.json summary: Microsoft Azure Delete Atlas Entity Uniqueattribute Type Typename tags: - Atlas /atlas/v2/entity/uniqueAttribute/type/{typeName}/classification/{classificationName}: delete: operationId: microsoftAzureEntityRemoveclassificationbyuniqueattribute description: >- Delete a given classification from an entity identified by its type and unique
attributes. parameters: - name: typeName in: path description: The name of the type. required: true type: string - name: classificationName in: path description: The name of the classification. required: true type: string - name: attr:qualifiedName in: query description: >- The qualified name of the entity. (This is only an example. qualifiedName can be changed to other unique attributes) required: false type: string x-ms-client-name: attribute responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_RemoveClassificationByUniqueAttribute: $ref: ./examples/Entity_RemoveClassificationByUniqueAttribute.json summary: >- Microsoft Azure Delete Atlas Entity Uniqueattribute Type Typename Classification Classificationname tags: - Atlas /atlas/v2/entity/uniqueAttribute/type/{typeName}/classifications: put: operationId: microsoftAzureEntityUpdateclassificationsbyuniqueattribute description: >- Update classification on an entity identified by its type and unique attributes. parameters: - name: typeName in: path description: The name of the type. required: true type: string - name: attr:qualifiedName in: query description: >- The qualified name of the entity. (This is only an example. qualifiedName can be changed to other unique attributes) required: false type: string x-ms-client-name: attribute - name: body in: body description: An array of classification to be updated. required: true schema: type: array items: $ref: '#/definitions/AtlasClassification' x-ms-identifiers: [] responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_UpdateClassificationsByUniqueAttribute: $ref: ./examples/Entity_UpdateClassificationsByUniqueAttribute.json summary: Microsoft Azure Put Atlas Entity Uniqueattribute Type Typename Classifications tags: - Atlas post: operationId: microsoftAzureEntityAddclassificationsbyuniqueattribute description: >- Add classification to the entity identified by its type and unique attributes. parameters: - name: typeName in: path description: The name of the type. required: true type: string - name: attr:qualifiedName in: query description: >- The qualified name of the entity. (This is only an example. qualifiedName can be changed to other unique attributes) required: false type: string x-ms-client-name: attribute - name: body in: body description: An array of classification to be added. required: true schema: type: array items: $ref: '#/definitions/AtlasClassification' x-ms-identifiers: [] responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_AddClassificationsByUniqueAttribute: $ref: ./examples/Entity_AddClassificationsByUniqueAttribute.json summary: Microsoft Azure Post Atlas Entity Uniqueattribute Type Typename Classifications tags: - Atlas /atlas/v2/entity/uniqueAttribute/type/{typeName}/labels: put: operationId: microsoftAzureEntityAddlabelsbyuniqueattribute description: >- Add given labels to a given entity identified by its type and unique
attributes.

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

In addition to
the typeName path parameter, attribute key-value pair(s) can be provided in the
following format: attr:=.

NOTE: The attrName and
attrValue should be unique across entities, eg. qualifiedName.

The REST
request would look something like this: PUT
/v2/entity/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue. parameters: - name: typeName in: path description: The name of the type. required: true type: string - name: attr:qualifiedName in: query description: >- The qualified name of the entity. (This is only an example. qualifiedName can be changed to other unique attributes) required: false type: string x-ms-client-name: attribute - name: body in: body description: set of labels to be added required: false schema: type: array items: type: string responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_AddLabelsByUniqueAttribute: $ref: ./examples/Entity_AddLabelsByUniqueAttribute.json summary: Microsoft Azure Put Atlas Entity Uniqueattribute Type Typename Labels tags: - Atlas post: operationId: microsoftAzureEntitySetlabelsbyuniqueattribute description: >- Set labels to a given entity identified by its type and unique attributes.

If
labels is null/empty, existing labels will all be removed.

In addition to the
typeName path parameter, attribute key-value pair(s) can be provided in the
following format: attr:=.

NOTE: The attrName and
attrValue should be unique across entities, eg. qualifiedName.

The REST
request would look something like this: POST
/v2/entity/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue. parameters: - name: typeName in: path description: The name of the type. required: true type: string - name: attr:qualifiedName in: query description: >- The qualified name of the entity. (This is only an example. qualifiedName can be changed to other unique attributes) required: false type: string x-ms-client-name: attribute - name: body in: body description: set of labels to be set required: false schema: type: array items: type: string responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_SetLabelsByUniqueAttribute: $ref: ./examples/Entity_SetLabelsByUniqueAttribute.json summary: Microsoft Azure Post Atlas Entity Uniqueattribute Type Typename Labels tags: - Atlas delete: operationId: microsoftAzureEntityRemovelabelsbyuniqueattribute description: >- 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:=. 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. parameters: - name: typeName in: path description: The name of the type. required: true type: string - name: attr:qualifiedName in: query description: >- The qualified name of the entity. (This is only an example. qualifiedName can be changed to other unique attributes) required: false type: string x-ms-client-name: attribute - name: body in: body description: set of labels to be deleted required: false schema: type: array items: type: string responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_RemoveLabelsByUniqueAttribute: $ref: ./examples/Entity_RemoveLabelsByUniqueAttribute.json summary: Microsoft Azure Delete Atlas Entity Uniqueattribute Type Typename Labels tags: - Atlas /atlas/v2/glossary: get: operationId: microsoftAzureGlossaryList description: >- Get all glossaries. Recommend using limit/offset to get pagination result.
Recommend using 'ignoreTermsAndCategories=true' and fetch terms/categories
separately using

'GET /datamap/api/atlas/v2/glossary/{glossaryId}/terms'
and

'GET '/datamap/api/atlas/v2/glossary/{glossaryId}/categories'. parameters: - $ref: '#/parameters/AtlasApiVersionParameter' - name: limit in: query description: The page size - by default there is no paging. required: false type: integer format: int32 - name: offset in: query description: The offset for pagination purpose. required: false type: integer format: int32 - name: sort in: query description: The sort order, ASC (default) or DESC. required: false type: string - name: ignoreTermsAndCategories in: query description: Whether ignore terms and categories required: false type: boolean responses: '200': description: The request has succeeded. schema: type: array items: $ref: '#/definitions/AtlasGlossary' x-ms-identifiers: [] default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_List: $ref: ./examples/Glossary_List.json summary: Microsoft Azure Get Atlas Glossary tags: - Atlas post: operationId: microsoftAzureGlossaryCreate description: Create a glossary. parameters: - name: body in: body required: true schema: $ref: '#/definitions/AtlasGlossary' responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasGlossary' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_Create: $ref: ./examples/Glossary_Create.json summary: Microsoft Azure Post Atlas Glossary tags: - Atlas /atlas/v2/glossary/{glossaryId}: get: operationId: microsoftAzureGlossaryGet description: Get a specific Glossary by its GUID. parameters: - name: glossaryId in: path description: The globally unique identifier for glossary. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasGlossary' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_Get: $ref: ./examples/Glossary_Get.json summary: Microsoft Azure Get Atlas Glossary Glossaryid tags: - Atlas put: operationId: microsoftAzureGlossaryUpdate description: Update the given glossary. parameters: - $ref: '#/parameters/AtlasApiVersionParameter' - name: glossaryId in: path description: The globally unique identifier for glossary. required: true type: string - name: ignoreTermsAndCategories in: query description: Whether ignore terms and categories required: false type: boolean - name: body in: body required: true schema: $ref: '#/definitions/AtlasGlossary' responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasGlossary' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_Update: $ref: ./examples/Glossary_Update.json summary: Microsoft Azure Put Atlas Glossary Glossaryid tags: - Atlas delete: operationId: microsoftAzureGlossaryDelete description: >- Delete a glossary. Will delete underlying terms/categories together. Recommend
separate delete terms and categories. parameters: - name: glossaryId in: path description: The globally unique identifier for glossary. required: true type: string responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_Delete: $ref: ./examples/Glossary_Delete.json summary: Microsoft Azure Delete Atlas Glossary Glossaryid tags: - Atlas /atlas/v2/glossary/{glossaryId}/categories: get: operationId: microsoftAzureGlossaryListcategories description: >- Get the categories belonging to a specific glossary. Recommend using
limit/offset to get pagination result. parameters: - name: glossaryId in: path description: The globally unique identifier for glossary. required: true type: string - name: limit in: query description: The page size - by default there is no paging. required: false type: integer format: int32 - name: offset in: query description: The offset for pagination purpose. required: false type: integer format: int32 - name: sort in: query description: The sort order, ASC (default) or DESC. required: false type: string responses: '200': description: The request has succeeded. schema: type: array items: $ref: '#/definitions/AtlasGlossaryCategory' x-ms-identifiers: [] default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_ListCategories: $ref: ./examples/Glossary_ListCategories.json summary: Microsoft Azure Get Atlas Glossary Glossaryid Categories tags: - Atlas /atlas/v2/glossary/{glossaryId}/categories/headers: get: operationId: microsoftAzureGlossaryListcategoriesheaders description: >- Get the category headers belonging to a specific glossary. Recommend using
limit/offset to get pagination result. parameters: - name: glossaryId in: path description: The globally unique identifier for glossary. required: true type: string - name: limit in: query description: The page size - by default there is no paging. required: false type: integer format: int32 - name: offset in: query description: The offset for pagination purpose. required: false type: integer format: int32 - name: sort in: query description: The sort order, ASC (default) or DESC. required: false type: string responses: '200': description: The request has succeeded. schema: type: array items: $ref: '#/definitions/AtlasRelatedCategoryHeader' x-ms-identifiers: [] default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_ListCategoriesHeaders: $ref: ./examples/Glossary_ListCategoriesHeaders.json summary: Microsoft Azure Get Atlas Glossary Glossaryid Categories Headers tags: - Atlas /atlas/v2/glossary/{glossaryId}/detailed: get: operationId: microsoftAzureGlossaryGetdetailed description: >- Get a specific glossary with detailed information. This API is not
recommend.

Recommend to fetch terms/categories details separately using

GET /datamap/api/atlas/v2/glossary/{glossaryId}/terms and

GET /datamap/api/atlas/v2/glossary/{glossaryId}/categories. parameters: - $ref: '#/parameters/AtlasApiVersionParameter' - name: glossaryId in: path description: The globally unique identifier for glossary. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasGlossaryExtInfo' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_GetDetailed: $ref: ./examples/Glossary_GetDetailed.json summary: Microsoft Azure Get Atlas Glossary Glossaryid Detailed tags: - Atlas /atlas/v2/glossary/{glossaryId}/partial: put: operationId: microsoftAzureGlossaryPartialupdate description: >- 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. parameters: - $ref: '#/parameters/AtlasApiVersionParameter' - name: glossaryId in: path description: The globally unique identifier for glossary. required: true type: string - name: ignoreTermsAndCategories in: query description: Whether ignore terms and categories required: false type: boolean - name: body in: body description: >- A map containing keys as attribute names and values as corresponding attribute values. required: true schema: type: object additionalProperties: type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasGlossary' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_PartialUpdate: $ref: ./examples/Glossary_PartialUpdate.json summary: Microsoft Azure Put Atlas Glossary Glossaryid Partial tags: - Atlas /atlas/v2/glossary/{glossaryId}/terms: get: operationId: microsoftAzureGlossaryListterms description: >- Get terms belonging to a specific glossary. Recommend using limit/offset to get
pagination result. parameters: - $ref: '#/parameters/AtlasApiVersionParameter' - name: glossaryId in: path description: The globally unique identifier for glossary. required: true type: string - name: limit in: query description: The page size - by default there is no paging. required: false type: integer format: int32 - name: offset in: query description: The offset for pagination purpose. required: false type: integer format: int32 - name: sort in: query description: The sort order, ASC (default) or DESC. required: false type: string responses: '200': description: The request has succeeded. schema: type: array items: $ref: '#/definitions/AtlasGlossaryTerm' x-ms-identifiers: [] default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_ListTerms: $ref: ./examples/Glossary_ListTerms.json summary: Microsoft Azure Get Atlas Glossary Glossaryid Terms tags: - Atlas /atlas/v2/glossary/{glossaryId}/terms/headers: get: operationId: microsoftAzureGlossaryListtermheaders description: >- Get term headers belonging to a specific glossary. Recommend using limit/offset
to get pagination result. parameters: - name: glossaryId in: path description: The globally unique identifier for glossary. required: true type: string - name: limit in: query description: The page size - by default there is no paging. required: false type: integer format: int32 - name: offset in: query description: The offset for pagination purpose. required: false type: integer format: int32 - name: sort in: query description: The sort order, ASC (default) or DESC. required: false type: string responses: '200': description: The request has succeeded. schema: type: array items: $ref: '#/definitions/AtlasRelatedTermHeader' x-ms-identifiers: [] default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_ListTermHeaders: $ref: ./examples/Glossary_ListTermHeaders.json summary: Microsoft Azure Get Atlas Glossary Glossaryid Terms Headers tags: - Atlas /atlas/v2/glossary/categories: post: operationId: microsoftAzureGlossaryCreatecategories description: Create glossary category in bulk. parameters: - name: body in: body description: An array of glossary category definitions to be created. required: true schema: type: array items: $ref: '#/definitions/AtlasGlossaryCategory' x-ms-identifiers: [] responses: '200': description: The request has succeeded. schema: type: array items: $ref: '#/definitions/AtlasGlossaryCategory' x-ms-identifiers: [] default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_CreateCategories: $ref: ./examples/Glossary_CreateCategories.json summary: Microsoft Azure Post Atlas Glossary Categories tags: - Atlas /atlas/v2/glossary/category: post: operationId: microsoftAzureGlossaryCreatecategory description: Create a glossary category. parameters: - name: body in: body required: true schema: $ref: '#/definitions/AtlasGlossaryCategory' responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasGlossaryCategory' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_CreateCategory: $ref: ./examples/Glossary_CreateCategory.json summary: Microsoft Azure Post Atlas Glossary Category tags: - Atlas /atlas/v2/glossary/category/{categoryId}: get: operationId: microsoftAzureGlossaryGetcategory description: Get specific glossary category by its GUID. parameters: - name: categoryId in: path description: The globally unique identifier of the category. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasGlossaryCategory' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_GetCategory: $ref: ./examples/Glossary_GetCategory.json summary: Microsoft Azure Get Atlas Glossary Category Categoryid tags: - Atlas put: operationId: microsoftAzureGlossaryUpdatecategory description: Update the given glossary category by its GUID. parameters: - name: categoryId in: path description: The globally unique identifier of the category. required: true type: string - name: body in: body required: true schema: $ref: '#/definitions/AtlasGlossaryCategory' responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasGlossaryCategory' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_UpdateCategory: $ref: ./examples/Glossary_UpdateCategory.json summary: Microsoft Azure Put Atlas Glossary Category Categoryid tags: - Atlas delete: operationId: microsoftAzureGlossaryDeletecategory description: Delete a glossary category. parameters: - name: categoryId in: path description: The globally unique identifier of the category. required: true type: string responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_DeleteCategory: $ref: ./examples/Glossary_DeleteCategory.json summary: Microsoft Azure Delete Atlas Glossary Category Categoryid tags: - Atlas /atlas/v2/glossary/category/{categoryId}/partial: put: operationId: microsoftAzureGlossaryPartialupdatecategory description: >- Update the glossary category partially. So far we only supports partial
updating shortDescription and longDescription for category. parameters: - name: categoryId in: path description: The globally unique identifier of the category. required: true type: string - name: body in: body description: >- A map containing keys as attribute names and values as corresponding attribute values for partial update. required: true schema: type: object additionalProperties: type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasGlossaryCategory' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_PartialUpdateCategory: $ref: ./examples/Glossary_PartialUpdateCategory.json summary: Microsoft Azure Put Atlas Glossary Category Categoryid Partial tags: - Atlas /atlas/v2/glossary/category/{categoryId}/related: get: operationId: microsoftAzureGlossaryListrelatedcategories description: >- Get all related categories (parent and children). Limit, offset, and sort
parameters are currently not being enabled and won't work even they are passed. parameters: - name: categoryId in: path description: The globally unique identifier of the category. required: true type: string - name: limit in: query description: The page size - by default there is no paging. required: false type: integer format: int32 - name: offset in: query description: The offset for pagination purpose. required: false type: integer format: int32 - name: sort in: query description: The sort order, ASC (default) or DESC. required: false type: string responses: '200': description: The request has succeeded. schema: type: object additionalProperties: items: $ref: '#/definitions/AtlasRelatedCategoryHeader' type: array x-ms-identifiers: [] default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_ListRelatedCategories: $ref: ./examples/Glossary_ListRelatedCategories.json summary: Microsoft Azure Get Atlas Glossary Category Categoryid Related tags: - Atlas /atlas/v2/glossary/category/{categoryId}/terms: get: operationId: microsoftAzureGlossaryListcategoryterms description: Get all terms associated with the specific category. parameters: - name: categoryId in: path description: The globally unique identifier of the category. required: true type: string - name: limit in: query description: The page size - by default there is no paging. required: false type: integer format: int32 - name: offset in: query description: The offset for pagination purpose. required: false type: integer format: int32 - name: sort in: query description: The sort order, ASC (default) or DESC. required: false type: string responses: '200': description: The request has succeeded. schema: type: array items: $ref: '#/definitions/AtlasRelatedTermHeader' x-ms-identifiers: [] default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_ListCategoryTerms: $ref: ./examples/Glossary_ListCategoryTerms.json summary: Microsoft Azure Get Atlas Glossary Category Categoryid Terms tags: - Atlas /atlas/v2/glossary/term: post: operationId: microsoftAzureGlossaryCreateterm description: Create a glossary term. parameters: - name: includeTermHierarchy in: query description: Whether include term hierarchy required: false type: boolean - name: body in: body required: true schema: $ref: '#/definitions/AtlasGlossaryTerm' responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasGlossaryTerm' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_CreateTerm: $ref: ./examples/Glossary_CreateTerm.json Glossary_CreateTermWithTemplate: $ref: ./examples/Glossary_CreateTermWithTemplate.json summary: Microsoft Azure Post Atlas Glossary Term tags: - Atlas /atlas/v2/glossary/term/{termId}: get: operationId: microsoftAzureGlossaryGetterm description: 'Get a specific glossary term by its GUID. ' parameters: - $ref: '#/parameters/AtlasApiVersionParameter' - name: termId in: path description: The globally unique identifier for glossary term. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasGlossaryTerm' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_GetTerm: $ref: ./examples/Glossary_GetTerm.json Glossary_GetTermWithoutAssets: $ref: ./examples/Glossary_GetTermWithoutAssets.json summary: Microsoft Azure Get Atlas Glossary Term Termid tags: - Atlas put: operationId: microsoftAzureGlossaryUpdateterm description: Update the given glossary term by its GUID. parameters: - $ref: '#/parameters/AtlasApiVersionParameter' - name: termId in: path description: The globally unique identifier for glossary term. required: true type: string - name: includeTermHierarchy in: query description: Whether include term hierarchy required: false type: boolean - name: body in: body required: true schema: $ref: '#/definitions/AtlasGlossaryTerm' responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasGlossaryTerm' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_UpdateTerm: $ref: ./examples/Glossary_UpdateTerm.json summary: Microsoft Azure Put Atlas Glossary Term Termid tags: - Atlas delete: operationId: microsoftAzureGlossaryDeleteterm description: Delete a glossary term. parameters: - name: termId in: path description: The globally unique identifier for glossary term. required: true type: string responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_DeleteTerm: $ref: ./examples/Glossary_DeleteTerm.json summary: Microsoft Azure Delete Atlas Glossary Term Termid tags: - Atlas /atlas/v2/glossary/term/{termId}/partial: put: operationId: microsoftAzureGlossaryPartialupdateterm description: >- Update the glossary term partially. So far we only supports partial updating
shortDescription, longDescription, abbreviation, usage and status for term. parameters: - $ref: '#/parameters/AtlasApiVersionParameter' - name: termId in: path description: The globally unique identifier for glossary term. required: true type: string - name: includeTermHierarchy in: query description: Whether include term hierarchy required: false type: boolean - name: body in: body description: >- A map containing keys as attribute names and values as corresponding attribute values to be updated. required: true schema: type: object additionalProperties: type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasGlossaryTerm' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_PartialUpdateTerm: $ref: ./examples/Glossary_PartialUpdateTerm.json summary: Microsoft Azure Put Atlas Glossary Term Termid Partial tags: - Atlas /atlas/v2/glossary/terms: post: operationId: microsoftAzureGlossaryCreateterms description: Create glossary terms in bulk. parameters: - $ref: '#/parameters/AtlasApiVersionParameter' - name: includeTermHierarchy in: query description: Whether include term hierarchy required: false type: boolean - name: body in: body description: An array of glossary term definitions to be created in bulk. required: true schema: type: array items: $ref: '#/definitions/AtlasGlossaryTerm' x-ms-identifiers: [] responses: '200': description: The request has succeeded. schema: type: array items: $ref: '#/definitions/AtlasGlossaryTerm' x-ms-identifiers: [] default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_CreateTerms: $ref: ./examples/Glossary_CreateTerms.json summary: Microsoft Azure Post Atlas Glossary Terms tags: - Atlas /atlas/v2/glossary/terms/{termId}/assignedEntities: get: operationId: microsoftAzureGlossaryListentitiesassignedwithterm description: >- List all related objects assigned with the specified term. Recommend using
limit/offset to get pagination result. parameters: - name: termId in: path description: The globally unique identifier for glossary term. required: true type: string - name: limit in: query description: The page size - by default there is no paging. required: false type: integer format: int32 - name: offset in: query description: The offset for pagination purpose. required: false type: integer format: int32 - name: sort in: query description: The sort order, ASC (default) or DESC. required: false type: string responses: '200': description: The request has succeeded. schema: type: array items: $ref: '#/definitions/AtlasRelatedObjectId' x-ms-identifiers: [] default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_ListEntitiesAssignedWithTerm: $ref: ./examples/Glossary_ListEntitiesAssignedWithTerm.json summary: Microsoft Azure Get Atlas Glossary Terms Termid Assignedentities tags: - Atlas post: operationId: microsoftAzureGlossaryAssigntermtoentities description: >- Assign the given term to the provided list of related objects. Recommend using
small batches with multiple API calls.

[Entities Create Or Update
operation](https://learn.microsoft.com/en-us/rest/api/purview/datamapdataplane/entity/bulk-create-or-update?tabs=HTTP)
is an alternative to assign a term to multiple entities. parameters: - name: termId in: path description: The globally unique identifier for glossary term. required: true type: string - name: body in: body description: >- An array of related object IDs to which the term has to be associated. required: true schema: type: array items: $ref: '#/definitions/AtlasRelatedObjectId' x-ms-identifiers: [] responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_AssignTermToEntities: $ref: ./examples/Glossary_AssignTermToEntities.json summary: Microsoft Azure Post Atlas Glossary Terms Termid Assignedentities tags: - Atlas delete: operationId: microsoftAzureGlossaryDeletetermassignmentfromentities description: Delete the term assignment for the given list of related objects. parameters: - name: termId in: path description: The globally unique identifier for glossary term. required: true type: string - name: body in: body description: >- An array of related object IDs from which the term has to be dissociated. required: true schema: type: array items: $ref: '#/definitions/AtlasRelatedObjectId' x-ms-identifiers: [] responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_RemoveTermAssignmentFromEntities: $ref: ./examples/Glossary_RemoveTermAssignmentFromEntities.json summary: Microsoft Azure Delete Atlas Glossary Terms Termid Assignedentities tags: - Atlas /atlas/v2/glossary/terms/{termId}/related: get: operationId: microsoftAzureGlossaryListrelatedterms description: >- Get all related terms for a specific term by its GUID. Limit, offset, and sort
parameters are currently not being enabled and won't work even they are passed. parameters: - $ref: '#/parameters/AtlasApiVersionParameter' - name: termId in: path description: The globally unique identifier for glossary term. required: true type: string - name: limit in: query description: The page size - by default there is no paging. required: false type: integer format: int32 - name: offset in: query description: The offset for pagination purpose. required: false type: integer format: int32 - name: sort in: query description: The sort order, ASC (default) or DESC. required: false type: string responses: '200': description: The request has succeeded. schema: type: object additionalProperties: items: $ref: '#/definitions/AtlasRelatedTermHeader' type: array x-ms-identifiers: [] default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Glossary_ListRelatedTerms: $ref: ./examples/Glossary_ListRelatedTerms.json summary: Microsoft Azure Get Atlas Glossary Terms Termid Related tags: - Atlas /atlas/v2/lineage/{guid}: get: operationId: microsoftAzureLineageGet description: Get lineage info of the entity specified by GUID. parameters: - name: guid in: path description: The globally unique identifier of the entity. required: true type: string - name: depth in: query description: The number of hops for lineage. required: false type: integer format: int32 - name: direction in: query description: The direction of the lineage, which could be INPUT, OUTPUT or BOTH. required: true type: string enum: - INPUT - OUTPUT - BOTH x-ms-enum: name: LineageDirection modelAsString: true values: - name: Input value: INPUT description: input - name: Output value: OUTPUT description: output - name: Both value: BOTH description: both responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasLineageInfo' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Lineage_Get: $ref: ./examples/Lineage_Get.json summary: Microsoft Azure Get Atlas Lineage Guid tags: - Atlas /atlas/v2/lineage/uniqueAttribute/type/{typeName}: get: operationId: microsoftAzureLineageGetbyuniqueattribute description: >- Return lineage info about entity.

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:

GET
/v2/lineage/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue. parameters: - name: typeName in: path description: The name of the type. required: true type: string - name: depth in: query description: The number of hops for lineage. required: false type: integer format: int32 - name: direction in: query description: The direction of the lineage, which could be INPUT, OUTPUT or BOTH. required: true type: string enum: - INPUT - OUTPUT - BOTH x-ms-enum: name: LineageDirection modelAsString: true values: - name: Input value: INPUT description: input - name: Output value: OUTPUT description: output - name: Both value: BOTH description: both - name: attr:qualifiedName in: query description: >- The qualified name of the entity. (This is only an example. qualifiedName can be changed to other unique attributes) required: false type: string x-ms-client-name: attribute responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasLineageInfo' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Lineage_GetByUniqueAttribute: $ref: ./examples/Lineage_GetByUniqueAttribute.json summary: Microsoft Azure Get Atlas Lineage Uniqueattribute Type Typename tags: - Atlas /atlas/v2/relationship: put: operationId: microsoftAzureRelationshipUpdate description: Update an existing relationship between entities. parameters: - name: body in: body required: true schema: $ref: '#/definitions/AtlasRelationship' responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasRelationship' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Relationship_Update: $ref: ./examples/Relationship_Update.json summary: Microsoft Azure Put Atlas Relationship tags: - Atlas post: operationId: microsoftAzureRelationshipCreate description: Create a new relationship between entities. parameters: - name: body in: body required: true schema: $ref: '#/definitions/AtlasRelationship' responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasRelationship' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Relationship_Create: $ref: ./examples/Relationship_Create.json summary: Microsoft Azure Post Atlas Relationship tags: - Atlas /atlas/v2/relationship/guid/{guid}: get: operationId: microsoftAzureRelationshipGet description: Get relationship information between entities by its GUID. parameters: - name: guid in: path description: The globally unique identifier of the relationship. required: true type: string - name: extendedInfo in: query description: Limits whether includes extended information. required: false type: boolean responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasRelationshipWithExtInfo' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Relationship_Get: $ref: ./examples/Relationship_Get.json summary: Microsoft Azure Get Atlas Relationship Guid Guid tags: - Atlas delete: operationId: microsoftAzureRelationshipDelete description: Delete a relationship between entities by its GUID. parameters: - name: guid in: path description: The globally unique identifier of the relationship. required: true type: string responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Relationship_Delete: $ref: ./examples/Relationship_Delete.json summary: Microsoft Azure Delete Atlas Relationship Guid Guid tags: - Atlas /atlas/v2/types/businessmetadatadef/guid/{guid}: get: operationId: microsoftAzureTypeGetbusinessmetadatadefbyguid description: Get the businessMetadata definition for the given guid. parameters: - name: guid in: path description: businessMetadata guid required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasBusinessMetadataDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_GetBusinessMetadataDefByGuid: $ref: ./examples/Type_GetBusinessMetadataDefByGuid.json summary: Microsoft Azure Get Atlas Types Businessmetadatadef Guid Guid tags: - Atlas /atlas/v2/types/businessmetadatadef/name/{name}: get: operationId: microsoftAzureTypeGetbusinessmetadatadefbyname description: Get the businessMetadata definition by it's name (unique). parameters: - name: name in: path description: businessMetadata name required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasBusinessMetadataDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_GetBusinessMetadataDefByName: $ref: ./examples/Type_GetBusinessMetadataDefByName.json summary: Microsoft Azure Get Atlas Types Businessmetadatadef Name Name tags: - Atlas /atlas/v2/types/classificationdef/guid/{guid}: get: operationId: microsoftAzureTypeGetclassificationdefbyguid description: Get the classification definition for the given GUID. parameters: - name: guid in: path description: The globally unique identifier of the classification. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasClassificationDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_GetClassificationDefByGuid: $ref: ./examples/Type_GetClassificationDefByGuid.json summary: Microsoft Azure Get Atlas Types Classificationdef Guid Guid tags: - Atlas /atlas/v2/types/classificationdef/name/{name}: get: operationId: microsoftAzureTypeGetclassificationdefbyname description: Get the classification definition by its name (unique). parameters: - name: name in: path description: The name of the classification. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasClassificationDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_GetClassificationDefByName: $ref: ./examples/Type_GetClassificationDefByName.json summary: Microsoft Azure Get Atlas Types Classificationdef Name Name tags: - Atlas /atlas/v2/types/entitydef/guid/{guid}: get: operationId: microsoftAzureTypeGetentitydefbyguid description: Get the Entity definition for the given GUID. parameters: - name: guid in: path description: The globally unique identifier of the entity. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasEntityDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_GetEntityDefByGuid: $ref: ./examples/Type_GetEntityDefByGuid.json summary: Microsoft Azure Get Atlas Types Entitydef Guid Guid tags: - Atlas /atlas/v2/types/entitydef/name/{name}: get: operationId: microsoftAzureTypeGetentitydefbyname description: Get the entity definition by its name (unique). parameters: - name: name in: path description: The name of the entity. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasEntityDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_GetEntityDefByName: $ref: ./examples/Type_GetEntityDefByName.json summary: Microsoft Azure Get Atlas Types Entitydef Name Name tags: - Atlas /atlas/v2/types/enumdef/guid/{guid}: get: operationId: microsoftAzureTypeGetenumdefbyguid description: Get the enum definition for the given GUID. parameters: - name: guid in: path description: The globally unique identifier of the enum. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasEnumDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_GetEnumDefByGuid: $ref: ./examples/Type_GetEnumDefByGuid.json summary: Microsoft Azure Get Atlas Types Enumdef Guid Guid tags: - Atlas /atlas/v2/types/enumdef/name/{name}: get: operationId: microsoftAzureTypeGetenumdefbyname description: Get the enum definition by its name (unique). parameters: - name: name in: path description: The name of the enum. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasEnumDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_GetEnumDefByName: $ref: ./examples/Type_GetEnumDefByName.json summary: Microsoft Azure Get Atlas Types Enumdef Name Name tags: - Atlas /atlas/v2/types/relationshipdef/guid/{guid}: get: operationId: microsoftAzureTypeGetrelationshipdefbyguid description: Get the relationship definition for the given GUID. parameters: - name: guid in: path description: The globally unique identifier of the relationship. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasRelationshipDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_GetRelationshipDefByGuid: $ref: ./examples/Type_GetRelationshipDefByGuid.json summary: Microsoft Azure Get Atlas Types Relationshipdef Guid Guid tags: - Atlas /atlas/v2/types/relationshipdef/name/{name}: get: operationId: microsoftAzureTypeGetrelationshipdefbyname description: Get the relationship definition by its name (unique). parameters: - name: name in: path description: The name of the relationship. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasRelationshipDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_GetRelationshipDefByName: $ref: ./examples/Type_GetRelationshipDefByName.json summary: Microsoft Azure Get Atlas Types Relationshipdef Name Name tags: - Atlas /atlas/v2/types/structdef/guid/{guid}: get: operationId: microsoftAzureTypeGetstructdefbyguid description: Get the struct definition for the given GUID. parameters: - name: guid in: path description: The globally unique identifier of the struct. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasStructDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_GetStructDefByGuid: $ref: ./examples/Type_GetStructDefByGuid.json summary: Microsoft Azure Get Atlas Types Structdef Guid Guid tags: - Atlas /atlas/v2/types/structdef/name/{name}: get: operationId: microsoftAzureTypeGetstructdefbyname description: Get the struct definition by its name (unique). parameters: - name: name in: path description: The name of the struct. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasStructDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_GetStructDefByName: $ref: ./examples/Type_GetStructDefByName.json summary: Microsoft Azure Get Atlas Types Structdef Name Name tags: - Atlas /atlas/v2/types/typedef/guid/{guid}: get: operationId: microsoftAzureTypeGetbyguid description: Get the type definition for the given GUID. parameters: - name: guid in: path description: The globally unique identifier of the type. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasTypeDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_GetByGuid: $ref: ./examples/Type_GetByGuid.json summary: Microsoft Azure Get Atlas Types Typedef Guid Guid tags: - Atlas /atlas/v2/types/typedef/name/{name}: get: operationId: microsoftAzureTypeGetbyname description: Get the type definition by its name (unique). parameters: - name: name in: path description: The name of the type. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasTypeDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_GetByName: $ref: ./examples/Type_GetByName.json summary: Microsoft Azure Get Atlas Types Typedef Name Name tags: - Atlas delete: operationId: microsoftAzureTypeDelete description: Delete API for type identified by its name. parameters: - name: name in: path description: The name of the type. required: true type: string responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_Delete: $ref: ./examples/Type_Delete.json summary: Microsoft Azure Delete Atlas Types Typedef Name Name tags: - Atlas /atlas/v2/types/typedefs: get: operationId: microsoftAzureTypeList description: List all type definitions in bulk. parameters: - $ref: '#/parameters/AtlasApiVersionParameter' - name: includeTermTemplate in: query description: |- Whether include termtemplatedef when return all typedefs. This is always true when search filter type=term_template required: false type: boolean - name: type in: query description: Typedef name as search filter when get typedefs. required: false type: string enum: - PRIMITIVE - OBJECT_ID_TYPE - ENUM - STRUCT - CLASSIFICATION - ENTITY - ARRAY - MAP - RELATIONSHIP - TERM_TEMPLATE x-ms-enum: name: TypeCategory modelAsString: true values: - name: Primitive value: PRIMITIVE description: primitive - name: ObjectIdType value: OBJECT_ID_TYPE description: object id type - name: Enum value: ENUM description: enum - name: Struct value: STRUCT description: struct - name: Classification value: CLASSIFICATION description: classification - name: Entity value: ENTITY description: entity - name: Array value: ARRAY description: array - name: Map value: MAP description: map - name: Relationship value: RELATIONSHIP description: relationship - name: TermTemplate value: TERM_TEMPLATE description: term template responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasTypesDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_List: $ref: ./examples/Type_List.json Type_ListEnumDefs: $ref: ./examples/Type_ListEnumDefs.json Type_ListTermTemplateDefs: $ref: ./examples/Type_ListTermTemplateDefs.json summary: Microsoft Azure Get Atlas Types Typedefs tags: - Atlas put: operationId: microsoftAzureTypeBulkupdate description: >- Update all types in bulk, changes detected in the type definitions would be
persisted. parameters: - name: body in: body required: true schema: $ref: '#/definitions/AtlasTypesDef' responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasTypesDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_BulkUpdate: $ref: ./examples/Type_BulkUpdate.json summary: Microsoft Azure Put Atlas Types Typedefs tags: - Atlas post: operationId: microsoftAzureTypeBulkcreate description: >- Create all atlas type definitions in bulk, only new definitions will be
created.
Any changes to the existing definitions will be discarded. parameters: - name: body in: body required: true schema: $ref: '#/definitions/AtlasTypesDef' responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasTypesDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_BulkCreate: $ref: ./examples/Type_BulkCreate.json Type_BulkCreateBusinessMetadataDefs: $ref: ./examples/Type_BulkCreateBusinessMetadataDefs.json summary: Microsoft Azure Post Atlas Types Typedefs tags: - Atlas delete: operationId: microsoftAzureTypeBulkdelete description: Delete API for all types in bulk. parameters: - name: body in: body required: true schema: $ref: '#/definitions/AtlasTypesDef' responses: '204': description: >- There is no content to send for this request, but the headers may be useful. default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_BulkDelete: $ref: ./examples/Type_BulkDelete.json summary: Microsoft Azure Delete Atlas Types Typedefs tags: - Atlas /atlas/v2/types/typedefs/headers: get: operationId: microsoftAzureTypeListheaders description: >- List all type definitions returned as a list of minimal information header. parameters: - $ref: '#/parameters/AtlasApiVersionParameter' - name: includeTermTemplate in: query description: |- Whether include termtemplatedef when return all typedefs. This is always true when search filter type=term_template required: false type: boolean - name: type in: query description: Typedef name as search filter when get typedefs. required: false type: string enum: - PRIMITIVE - OBJECT_ID_TYPE - ENUM - STRUCT - CLASSIFICATION - ENTITY - ARRAY - MAP - RELATIONSHIP - TERM_TEMPLATE x-ms-enum: name: TypeCategory modelAsString: true values: - name: Primitive value: PRIMITIVE description: primitive - name: ObjectIdType value: OBJECT_ID_TYPE description: object id type - name: Enum value: ENUM description: enum - name: Struct value: STRUCT description: struct - name: Classification value: CLASSIFICATION description: classification - name: Entity value: ENTITY description: entity - name: Array value: ARRAY description: array - name: Map value: MAP description: map - name: Relationship value: RELATIONSHIP description: relationship - name: TermTemplate value: TERM_TEMPLATE description: term template responses: '200': description: The request has succeeded. schema: type: array items: $ref: '#/definitions/AtlasTypeDefHeader' x-ms-identifiers: [] default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_ListHeaders: $ref: ./examples/Type_ListHeaders.json summary: Microsoft Azure Get Atlas Types Typedefs Headers tags: - Atlas /entity/moveTo: post: operationId: microsoftAzureEntityMoveentitiestocollection description: Move existing entities to the target collection. parameters: - $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter' - name: collectionId in: query description: The collection where entities will be moved to. required: true type: string - name: body in: body required: true schema: $ref: '#/definitions/MoveEntitiesOptions' responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/EntityMutationResult' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Entity_MoveEntitiesToCollection: $ref: ./examples/Entity_MoveEntitiesToCollection.json summary: Microsoft Azure Post Entity Moveto tags: - Entity /lineage/{guid}/next: get: operationId: microsoftAzureLineageGetnextpage description: Return immediate next page lineage info about entity with pagination parameters: - $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter' - name: guid in: path description: The globally unique identifier of the entity. required: true type: string - name: direction in: query description: The direction of the lineage, which could be INPUT, OUTPUT or BOTH. required: true type: string enum: - INPUT - OUTPUT - BOTH x-ms-enum: name: LineageDirection modelAsString: true values: - name: Input value: INPUT description: input - name: Output value: OUTPUT description: output - name: Both value: BOTH description: both - name: offset in: query description: The offset for pagination purpose. required: false type: integer format: int32 - name: limit in: query description: The page size - by default there is no paging. required: false type: integer format: int32 responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AtlasLineageInfo' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Lineage_GetNextPage: $ref: ./examples/Lineage_GetNextPage.json summary: Microsoft Azure Get Lineage Guid Next tags: - Lineage /search/autocomplete: post: operationId: microsoftAzureDiscoveryAutocomplete description: Get auto complete options. parameters: - $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter' - name: body in: body required: true schema: $ref: '#/definitions/AutoCompleteOptions' responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/AutoCompleteResult' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Discovery_AutoComplete: $ref: ./examples/Discovery_AutoComplete.json summary: Microsoft Azure Post Search Autocomplete tags: - Search /search/query: post: operationId: microsoftAzureDiscoveryQuery description: Get data using search. parameters: - $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter' - name: body in: body required: true schema: $ref: '#/definitions/QueryOptions' responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/QueryResult' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Discovery_Query: $ref: ./examples/Discovery_Query.json Discovery_Query_And: $ref: ./examples/Discovery_Query_And.json Discovery_Query_AndOrNested: $ref: ./examples/Discovery_Query_AndOrNested.json Discovery_Query_AssetType: $ref: ./examples/Discovery_Query_AssetType.json Discovery_Query_Attribute: $ref: ./examples/Discovery_Query_Attribute.json Discovery_Query_BusinessMetadataAttribute: $ref: ./examples/Discovery_Query_BusinessMetadataAttribute.json Discovery_Query_Classification: $ref: ./examples/Discovery_Query_Classification.json Discovery_Query_Collection: $ref: ./examples/Discovery_Query_Collection.json Discovery_Query_Facet: $ref: ./examples/Discovery_Query_Facet.json Discovery_Query_FileExtension: $ref: ./examples/Discovery_Query_FileExtension.json Discovery_Query_GlossaryTerm: $ref: ./examples/Discovery_Query_GlossaryTerm.json Discovery_Query_Id: $ref: ./examples/Discovery_Query_Id.json Discovery_Query_Not: $ref: ./examples/Discovery_Query_Not.json Discovery_Query_ObjectType: $ref: ./examples/Discovery_Query_ObjectType.json Discovery_Query_PaginationContinuationPage: $ref: ./examples/Discovery_Query_PaginationContinuationPage.json Discovery_Query_PaginationFirstPage: $ref: ./examples/Discovery_Query_PaginationFirstPage.json Discovery_Query_PaginationLastPage: $ref: ./examples/Discovery_Query_PaginationLastPage.json Discovery_Query_SystemTime: $ref: ./examples/Discovery_Query_SystemTime.json Discovery_Query_Taxonomy: $ref: ./examples/Discovery_Query_Taxonomy.json Discovery_Query_TermAssignment: $ref: ./examples/Discovery_Query_TermAssignment.json Discovery_Query_Type: $ref: ./examples/Discovery_Query_Type.json summary: Microsoft Azure Post Search Query tags: - Search /search/suggest: post: operationId: microsoftAzureDiscoverySuggest description: Get search suggestions by query criteria. parameters: - $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter' - name: body in: body required: true schema: $ref: '#/definitions/SuggestOptions' responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/SuggestResult' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Discovery_Suggest: $ref: ./examples/Discovery_Suggest.json summary: Microsoft Azure Post Search Suggest tags: - Search /types/termtemplatedef/guid/{guid}: get: operationId: microsoftAzureTypeGettermtemplatedefbyguid description: Get the term template definition for the given GUID. parameters: - $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter' - name: guid in: path description: The globally unique identifier of the term template. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/TermTemplateDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_GetTermTemplateDefByGuid: $ref: ./examples/Type_GetTermTemplateDefByGuid.json summary: Microsoft Azure Get Types Termtemplatedef Guid Guid tags: - Types /types/termtemplatedef/name/{name}: get: operationId: microsoftAzureTypeGettermtemplatedefbyname description: Get the term template definition by its name (unique). parameters: - $ref: '#/parameters/Azure.Core.Foundations.ApiVersionParameter' - name: name in: path description: The unique name of the term template. required: true type: string responses: '200': description: The request has succeeded. schema: $ref: '#/definitions/TermTemplateDef' default: description: An unexpected error response. schema: $ref: '#/definitions/AtlasErrorResponse' x-ms-examples: Type_GetTermTemplateDefByName: $ref: ./examples/Type_GetTermTemplateDefByName.json summary: Microsoft Azure Get Types Termtemplatedef Name Name tags: - Types definitions: AtlasAttributeDef: type: object description: class that captures details of a struct-attribute. properties: cardinality: $ref: '#/definitions/CardinalityValue' description: single-valued attribute or multi-valued attribute. constraints: type: array description: An array of constraints. items: $ref: '#/definitions/AtlasConstraintDef' x-ms-identifiers: [] defaultValue: type: string description: The default value of the attribute. description: type: string description: The description of the attribute. includeInNotification: type: boolean description: Determines if it is included in notification. isIndexable: type: boolean description: Determines if it is indexable. isOptional: type: boolean description: Determines if it is optional. isUnique: type: boolean description: Determines if it unique. name: type: string description: The name of the attribute. options: type: object description: The options for the attribute. additionalProperties: type: string typeName: type: string description: The name of the type. valuesMaxCount: type: integer format: int32 description: The maximum count of the values. valuesMinCount: type: integer format: int32 description: The minimum count of the values. AtlasBusinessMetadataDef: type: object description: class that captures details of a struct-type. properties: category: $ref: '#/definitions/TypeCategory' description: The enum of type category. createTime: type: integer format: int64 description: The created time of the record. createdBy: type: string description: The user who created the record. dateFormatter: $ref: '#/definitions/DateFormat' description: The date format. description: type: string description: The description of the type definition. guid: type: string description: The GUID of the type definition. name: type: string description: The name of the type definition. options: type: object description: The options for the type definition. additionalProperties: type: string serviceType: type: string description: The service type. typeVersion: type: string description: The version of the type. updateTime: type: integer format: int64 description: The update time of the record. updatedBy: type: string description: The user who updated the record. version: type: integer format: int64 description: The version of the record. lastModifiedTS: type: string description: ETag for concurrency control. attributeDefs: type: array description: An array of attribute definitions. items: $ref: '#/definitions/AtlasAttributeDef' x-ms-identifiers: [] AtlasClassification: type: object description: |- An instance of a classification; it doesn't have an identity, this object exists only when associated with an entity. properties: attributes: type: object description: The attributes of the struct. additionalProperties: {} typeName: type: string description: The name of the type. lastModifiedTS: type: string description: ETag for concurrency control. entityGuid: type: string description: The GUID of the entity. entityStatus: $ref: '#/definitions/EntityStatus' description: >- Status of the entity - can be active or deleted. Deleted entities are not removed. removePropagationsOnEntityDelete: type: boolean description: Determines if propagations will be removed on entity deletion. validityPeriods: type: array description: An array of time boundaries indicating validity periods. items: $ref: '#/definitions/TimeBoundary' x-ms-identifiers: [] AtlasClassificationDef: type: object description: class that captures details of a classification-type. properties: category: $ref: '#/definitions/TypeCategory' description: The enum of type category. createTime: type: integer format: int64 description: The created time of the record. createdBy: type: string description: The user who created the record. dateFormatter: $ref: '#/definitions/DateFormat' description: The date format. description: type: string description: The description of the type definition. guid: type: string description: The GUID of the type definition. name: type: string description: The name of the type definition. options: type: object description: The options for the type definition. additionalProperties: type: string serviceType: type: string description: The service type. typeVersion: type: string description: The version of the type. updateTime: type: integer format: int64 description: The update time of the record. updatedBy: type: string description: The user who updated the record. version: type: integer format: int64 description: The version of the record. lastModifiedTS: type: string description: ETag for concurrency control. attributeDefs: type: array description: An array of attribute definitions. items: $ref: '#/definitions/AtlasAttributeDef' x-ms-identifiers: [] entityTypes: type: array description: > 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. items: type: string subTypes: type: array description: An array of sub types. items: type: string superTypes: type: array description: An array of super types. items: type: string AtlasClassifications: type: object description: REST serialization friendly list. properties: list: type: array description: An array of objects. items: {} pageSize: type: integer format: int32 description: The size of the page. sortBy: type: string description: The sorted by field. sortType: $ref: '#/definitions/SortType' description: >- to specify whether the result should be sorted? If yes, whether asc or desc. startIndex: type: integer format: int32 description: The start index of the page. totalCount: type: integer format: int32 description: The total count of items. AtlasConstraintDef: type: object description: class that captures details of a constraint. properties: params: type: object description: The parameters of the constraint definition. additionalProperties: {} type: type: string description: The type of the constraint. AtlasEntitiesWithExtInfo: type: object description: |- An instance of an entity along with extended info - like hive_table, hive_database. properties: referredEntities: type: object description: The referred entities. additionalProperties: $ref: '#/definitions/AtlasEntity' entities: type: array description: An array of entities. items: $ref: '#/definitions/AtlasEntity' x-ms-identifiers: [] AtlasEntity: type: object description: An instance of an entity - like hive_table, hive_database. properties: attributes: type: object description: The attributes of the struct. additionalProperties: {} typeName: type: string description: The name of the type. lastModifiedTS: type: string description: ETag for concurrency control. businessAttributes: type: object description: Business attributes additionalProperties: {} classifications: type: array description: An array of classifications. items: $ref: '#/definitions/AtlasClassification' x-ms-identifiers: [] createTime: type: integer format: int64 description: The created time of the record. createdBy: type: string description: The user who created the record. customAttributes: type: object description: Custom Attribute additionalProperties: type: string guid: type: string description: The GUID of the entity. homeId: type: string description: The home ID of the entity. collectionId: type: string description: The collection ID of the entity. readOnly: true isIncomplete: type: boolean description: Whether it is a shell entity labels: type: array description: labels items: type: string meanings: type: array description: >- An array of term assignment headers indicating the meanings of the entity. items: $ref: '#/definitions/AtlasTermAssignmentHeader' x-ms-identifiers: [] provenanceType: type: integer format: int32 description: >- Used to record the provenance of an instance of an entity or relationship. proxy: type: boolean description: Determines if there's a proxy. relationshipAttributes: type: object description: The attributes of relationship. additionalProperties: {} status: $ref: '#/definitions/EntityStatus' description: >- Status of the entity - can be active or deleted. Deleted entities are not removed. updateTime: type: integer format: int64 description: The update time of the record. updatedBy: type: string description: The user who updated the record. version: type: integer format: int64 description: The version of the entity. contacts: type: object description: The dictionary of contacts for entities. Key could be Expert or Owner. additionalProperties: items: $ref: '#/definitions/ContactInfo' type: array AtlasEntityDef: type: object description: class that captures details of a entity-type. properties: category: $ref: '#/definitions/TypeCategory' description: The enum of type category. createTime: type: integer format: int64 description: The created time of the record. createdBy: type: string description: The user who created the record. dateFormatter: $ref: '#/definitions/DateFormat' description: The date format. description: type: string description: The description of the type definition. guid: type: string description: The GUID of the type definition. name: type: string description: The name of the type definition. options: type: object description: The options for the type definition. additionalProperties: type: string serviceType: type: string description: The service type. typeVersion: type: string description: The version of the type. updateTime: type: integer format: int64 description: The update time of the record. updatedBy: type: string description: The user who updated the record. version: type: integer format: int64 description: The version of the record. lastModifiedTS: type: string description: ETag for concurrency control. attributeDefs: type: array description: An array of attribute definitions. items: $ref: '#/definitions/AtlasAttributeDef' x-ms-identifiers: [] subTypes: type: array description: An array of sub types. items: type: string superTypes: type: array description: An array of super types. items: type: string relationshipAttributeDefs: type: array description: An array of relationship attributes. items: $ref: '#/definitions/AtlasRelationshipAttributeDef' x-ms-identifiers: [] AtlasEntityHeader: type: object description: An instance of an entity - like hive_table, hive_database. properties: attributes: type: object description: The attributes of the struct. additionalProperties: {} typeName: type: string description: The name of the type. lastModifiedTS: type: string description: ETag for concurrency control. classificationNames: type: array description: An array of classification names. items: type: string classifications: type: array description: An array of classifications. items: $ref: '#/definitions/AtlasClassification' x-ms-identifiers: [] displayText: type: string description: The display text. guid: type: string description: The GUID of the record. isIncomplete: type: boolean description: Whether it is a shell entity labels: type: array description: labels items: type: string meaningNames: type: array description: An array of meanings. items: type: string meanings: type: array description: An array of term assignment headers. items: $ref: '#/definitions/AtlasTermAssignmentHeader' x-ms-identifiers: [] status: $ref: '#/definitions/EntityStatus' description: >- Status of the entity - can be active or deleted. Deleted entities are not removed. AtlasEntityHeaders: type: object description: An instance of an entity header map. properties: guidHeaderMap: type: object description: The description of the guid header map, additionalProperties: $ref: '#/definitions/AtlasEntityHeader' AtlasEntityWithExtInfo: type: object description: |- An instance of an entity along with extended info - like hive_table, hive_database. properties: referredEntities: type: object description: The referred entities. additionalProperties: $ref: '#/definitions/AtlasEntity' entity: $ref: '#/definitions/AtlasEntity' description: An instance of an entity - like hive_table, hive_database. AtlasEnumDef: type: object description: class that captures details of an enum-type. properties: category: $ref: '#/definitions/TypeCategory' description: The enum of type category. createTime: type: integer format: int64 description: The created time of the record. createdBy: type: string description: The user who created the record. dateFormatter: $ref: '#/definitions/DateFormat' description: The date format. description: type: string description: The description of the type definition. guid: type: string description: The GUID of the type definition. name: type: string description: The name of the type definition. options: type: object description: The options for the type definition. additionalProperties: type: string serviceType: type: string description: The service type. typeVersion: type: string description: The version of the type. updateTime: type: integer format: int64 description: The update time of the record. updatedBy: type: string description: The user who updated the record. version: type: integer format: int64 description: The version of the record. lastModifiedTS: type: string description: ETag for concurrency control. defaultValue: type: string description: The default value. elementDefs: type: array description: An array of enum element definitions. items: $ref: '#/definitions/AtlasEnumElementDef' x-ms-identifiers: [] AtlasEnumElementDef: type: object description: class that captures details of an enum-element. properties: description: type: string description: The description of the enum element definition. ordinal: type: integer format: int32 description: The ordinal of the enum element definition. value: type: string description: The value of the enum element definition. AtlasErrorResponse: type: object description: An error response from the service properties: requestId: $ref: '#/definitions/Azure.Core.uuid' description: The request ID. errorCode: type: string description: The error code. errorMessage: type: string description: The error message. AtlasGlossary: type: object description: The glossary object. properties: guid: type: string description: The GUID of the object. classifications: type: array description: An array of classifications. items: $ref: '#/definitions/AtlasClassification' x-ms-identifiers: [] longDescription: type: string description: The long version description. name: type: string description: The name of the glossary object. qualifiedName: type: string description: The qualified name of the glossary object. shortDescription: type: string description: The short version of description. lastModifiedTS: type: string description: ETag for concurrency control. createTime: type: integer format: int64 description: The created time of the record. createdBy: type: string description: The user who created the record. updateTime: type: integer format: int64 description: The update time of the record. updatedBy: type: string description: The user who updated the record. categories: type: array description: An array of categories. items: $ref: '#/definitions/AtlasRelatedCategoryHeader' x-ms-identifiers: [] language: type: string description: The language of the glossary. terms: type: array description: An array of related term headers. items: $ref: '#/definitions/AtlasRelatedTermHeader' x-ms-identifiers: [] usage: type: string description: The usage of the glossary. AtlasGlossaryCategory: type: object description: The glossary category. properties: guid: type: string description: The GUID of the object. classifications: type: array description: An array of classifications. items: $ref: '#/definitions/AtlasClassification' x-ms-identifiers: [] longDescription: type: string description: The long version description. name: type: string description: The name of the glossary object. qualifiedName: type: string description: The qualified name of the glossary object. shortDescription: type: string description: The short version of description. lastModifiedTS: type: string description: ETag for concurrency control. createTime: type: integer format: int64 description: The created time of the record. createdBy: type: string description: The user who created the record. updateTime: type: integer format: int64 description: The update time of the record. updatedBy: type: string description: The user who updated the record. anchor: $ref: '#/definitions/AtlasGlossaryHeader' description: The glossary header with basic information. childrenCategories: type: array description: An array of children categories. items: $ref: '#/definitions/AtlasRelatedCategoryHeader' x-ms-identifiers: [] parentCategory: $ref: '#/definitions/AtlasRelatedCategoryHeader' description: The header of the related category. terms: type: array description: An array of related term headers. items: $ref: '#/definitions/AtlasRelatedTermHeader' x-ms-identifiers: [] AtlasGlossaryExtInfo: type: object description: The extended information of glossary. properties: guid: type: string description: The GUID of the object. classifications: type: array description: An array of classifications. items: $ref: '#/definitions/AtlasClassification' x-ms-identifiers: [] longDescription: type: string description: The long version description. name: type: string description: The name of the glossary object. qualifiedName: type: string description: The qualified name of the glossary object. shortDescription: type: string description: The short version of description. lastModifiedTS: type: string description: ETag for concurrency control. createTime: type: integer format: int64 description: The created time of the record. createdBy: type: string description: The user who created the record. updateTime: type: integer format: int64 description: The update time of the record. updatedBy: type: string description: The user who updated the record. categories: type: array description: An array of categories. items: $ref: '#/definitions/AtlasRelatedCategoryHeader' x-ms-identifiers: [] language: type: string description: The language of the glossary. terms: type: array description: An array of related term headers. items: $ref: '#/definitions/AtlasRelatedTermHeader' x-ms-identifiers: [] usage: type: string description: The usage of the glossary. categoryInfo: type: object description: The glossary category information. additionalProperties: $ref: '#/definitions/AtlasGlossaryCategory' termInfo: type: object description: The glossary term information. additionalProperties: $ref: '#/definitions/AtlasGlossaryTerm' AtlasGlossaryHeader: type: object description: The glossary header with basic information. properties: displayText: type: string description: The display text. glossaryGuid: type: string description: The GUID of the glossary. relationGuid: type: string description: The GUID of the relationship. AtlasGlossaryTerm: type: object description: The glossary term. properties: guid: type: string description: The GUID of the object. classifications: type: array description: An array of classifications. items: $ref: '#/definitions/AtlasClassification' x-ms-identifiers: [] longDescription: type: string description: The long version description. name: type: string description: The name of the glossary object. qualifiedName: type: string description: The qualified name of the glossary object. shortDescription: type: string description: The short version of description. lastModifiedTS: type: string description: ETag for concurrency control. createTime: type: integer format: int64 description: The created time of the record. createdBy: type: string description: The user who created the record. updateTime: type: integer format: int64 description: The update time of the record. updatedBy: type: string description: The user who updated the record. abbreviation: type: string description: The abbreviation of the term. templateName: type: array description: The name of the template. items: {} anchor: $ref: '#/definitions/AtlasGlossaryHeader' description: The glossary header with basic information. antonyms: type: array description: An array of related term headers as antonyms. items: $ref: '#/definitions/AtlasRelatedTermHeader' x-ms-identifiers: [] status: $ref: '#/definitions/TermStatus' description: Status of the AtlasGlossaryTerm nickName: type: string description: The nick name of the term. hierarchyInfo: type: array description: The hierarchy information of the term. items: $ref: '#/definitions/PurviewObjectId' x-ms-identifiers: [] resources: type: array description: An array of resource link for term items: $ref: '#/definitions/ResourceLink' x-ms-identifiers: [] contacts: type: object description: The dictionary of contacts for terms. Key could be Expert or Steward. additionalProperties: items: $ref: '#/definitions/ContactInfo' type: array attributes: type: object description: >- The custom attributes of the term, which is map>. The key of the first layer map is term template name. additionalProperties: additionalProperties: {} type: object assignedEntities: type: array description: An array of related object IDs. items: $ref: '#/definitions/AtlasRelatedObjectId' x-ms-identifiers: [] categories: type: array description: An array of term categorization headers. items: $ref: '#/definitions/AtlasTermCategorizationHeader' x-ms-identifiers: [] classifies: type: array description: An array of related term headers. items: $ref: '#/definitions/AtlasRelatedTermHeader' x-ms-identifiers: [] examples: type: array description: An array of examples. items: type: string isA: type: array description: An array of related term headers indicating the is-a relationship. items: $ref: '#/definitions/AtlasRelatedTermHeader' x-ms-identifiers: [] preferredTerms: type: array description: An array of preferred related term headers. items: $ref: '#/definitions/AtlasRelatedTermHeader' x-ms-identifiers: [] preferredToTerms: type: array description: An array of related term headers that are preferred to. items: $ref: '#/definitions/AtlasRelatedTermHeader' x-ms-identifiers: [] replacedBy: type: array description: An array of related term headers that are replaced by. items: $ref: '#/definitions/AtlasRelatedTermHeader' x-ms-identifiers: [] replacementTerms: type: array description: An array of related term headers for replacement. items: $ref: '#/definitions/AtlasRelatedTermHeader' x-ms-identifiers: [] seeAlso: type: array description: An array of related term headers for see also. items: $ref: '#/definitions/AtlasRelatedTermHeader' x-ms-identifiers: [] synonyms: type: array description: An array of related term headers as synonyms. items: $ref: '#/definitions/AtlasRelatedTermHeader' x-ms-identifiers: [] translatedTerms: type: array description: An array of translated related term headers. items: $ref: '#/definitions/AtlasRelatedTermHeader' x-ms-identifiers: [] translationTerms: type: array description: An array of related term headers for translation. items: $ref: '#/definitions/AtlasRelatedTermHeader' x-ms-identifiers: [] usage: type: string description: The usage of the term. validValues: type: array description: An array of related term headers as valid values. items: $ref: '#/definitions/AtlasRelatedTermHeader' x-ms-identifiers: [] validValuesFor: type: array description: An array of related term headers as valid values for other records. items: $ref: '#/definitions/AtlasRelatedTermHeader' x-ms-identifiers: [] AtlasLineageInfo: type: object description: The lineage information. properties: baseEntityGuid: type: string description: The GUID of the base entity. guidEntityMap: type: object description: The GUID entity map. additionalProperties: $ref: '#/definitions/AtlasEntityHeader' widthCounts: type: object description: The entity count in specific direction. additionalProperties: additionalProperties: {} type: object lineageDepth: type: integer format: int32 description: The depth of lineage. lineageWidth: type: integer format: int32 description: The width of lineage. childrenCount: type: integer format: int32 description: The number of children node. lineageDirection: $ref: '#/definitions/LineageDirection' description: The enum of lineage direction. parentRelations: type: array description: An array of parentRelations relations. items: $ref: '#/definitions/ParentRelation' x-ms-identifiers: [] relations: type: array description: An array of lineage relations. items: $ref: '#/definitions/LineageRelation' x-ms-identifiers: [] AtlasObjectId: type: object description: Reference to an object-instance of a type - like entity. properties: guid: type: string description: The GUID of the object. typeName: type: string description: The name of the type. uniqueAttributes: type: object description: The unique attributes of the object. additionalProperties: {} AtlasRelatedCategoryHeader: type: object description: The header of the related category. properties: categoryGuid: type: string description: The GUID of the category. description: type: string description: The description of the category header. displayText: type: string description: The display text. parentCategoryGuid: type: string description: The GUID of the parent category. relationGuid: type: string description: The GUID of the relationship. AtlasRelatedObjectId: type: object description: |- Reference to an object-instance of AtlasEntity type used in relationship attribute values properties: guid: type: string description: The GUID of the object. typeName: type: string description: The name of the type. uniqueAttributes: type: object description: The unique attributes of the object. additionalProperties: {} displayText: type: string description: The display text. entityStatus: $ref: '#/definitions/EntityStatus' description: >- Status of the entity - can be active or deleted. Deleted entities are not removed. relationshipType: type: string description: Relationship type relationshipAttributes: $ref: '#/definitions/AtlasStruct' description: >- Captures details of struct contents. Not instantiated directly, used only via AtlasEntity, AtlasClassification. relationshipGuid: $ref: '#/definitions/Azure.Core.uuid' description: The GUID of the relationship. relationshipStatus: $ref: '#/definitions/StatusAtlasRelationship' description: The enum of relationship status. AtlasRelatedTermHeader: type: object description: The header of the related term. properties: description: type: string description: The description of the related term. displayText: type: string description: The display text. expression: type: string description: The expression of the term. relationGuid: type: string description: The GUID of the relationship. status: $ref: '#/definitions/AtlasTermRelationshipStatus' description: The status of term relationship. steward: type: string description: The steward of the term. termGuid: type: string description: The GUID of the term. AtlasRelationship: type: object description: Atlas relationship instance. properties: attributes: type: object description: The attributes of the struct. additionalProperties: {} typeName: type: string description: The name of the type. lastModifiedTS: type: string description: ETag for concurrency control. createTime: type: integer format: int64 description: The created time of the record. createdBy: type: string description: The user who created the record. end1: $ref: '#/definitions/AtlasObjectId' description: Reference to an object-instance of a type - like entity. end2: $ref: '#/definitions/AtlasObjectId' description: Reference to an object-instance of a type - like entity. guid: type: string description: The GUID of the relationship. homeId: type: string description: The home ID of the relationship. label: type: string description: The label of the relationship. provenanceType: type: integer format: int32 description: >- Used to record the provenance of an instance of an entity or relationship status: $ref: '#/definitions/StatusAtlasRelationship' description: The enum of relationship status. updateTime: type: integer format: int64 description: The update time of the record. updatedBy: type: string description: The user who updated the record. version: type: integer format: int64 description: The version of the relationship. AtlasRelationshipAttributeDef: type: object description: >- The relationshipEndDef represents an end of the relationship. The end of the relationship is defined by a type, an attribute name, cardinality and whether it is the container end of the relationship. properties: cardinality: $ref: '#/definitions/CardinalityValue' description: single-valued attribute or multi-valued attribute. constraints: type: array description: An array of constraints. items: $ref: '#/definitions/AtlasConstraintDef' x-ms-identifiers: [] defaultValue: type: string description: The default value of the attribute. description: type: string description: The description of the attribute. includeInNotification: type: boolean description: Determines if it is included in notification. isIndexable: type: boolean description: Determines if it is indexable. isOptional: type: boolean description: Determines if it is optional. isUnique: type: boolean description: Determines if it unique. name: type: string description: The name of the attribute. options: type: object description: The options for the attribute. additionalProperties: type: string typeName: type: string description: The name of the type. valuesMaxCount: type: integer format: int32 description: The maximum count of the values. valuesMinCount: type: integer format: int32 description: The minimum count of the values. isLegacyAttribute: type: boolean description: Determines if it is a legacy attribute. relationshipTypeName: type: string description: The name of the relationship type. AtlasRelationshipDef: type: object description: >- AtlasRelationshipDef is a TypeDef that defines a relationship. As with other typeDefs the AtlasRelationshipDef has a name. Once created the RelationshipDef has a guid. The name and the guid are the 2 ways that the RelationshipDef is identified. RelationshipDefs have 2 ends, each of which specify cardinality, an EntityDef type name and name and optionally whether the end is a container. RelationshipDefs can have AttributeDefs - though only primitive types are allowed. RelationshipDefs have a relationshipCategory specifying the UML type of relationship required The way EntityDefs and RelationshipDefs are intended to be used is that EntityDefs will define AttributeDefs these AttributeDefs will not specify an EntityDef type name as their types. RelationshipDefs introduce new attributes to the entity instances. For example EntityDef A might have attributes attr1,attr2,attr3 EntityDef B might have attributes attr4,attr5,attr6 RelationshipDef AtoB might define 2 ends end1: type A, name attr7 end2: type B, name attr8 When an instance of EntityDef A is created, it will have attributes attr1,attr2,attr3,attr7 When an instance of EntityDef B is created, it will have attributes attr4,attr5,attr6,attr8 In this way relationshipDefs can be authored separately from entityDefs and can inject relationship attributes into the entity instances properties: category: $ref: '#/definitions/TypeCategory' description: The enum of type category. createTime: type: integer format: int64 description: The created time of the record. createdBy: type: string description: The user who created the record. dateFormatter: $ref: '#/definitions/DateFormat' description: The date format. description: type: string description: The description of the type definition. guid: type: string description: The GUID of the type definition. name: type: string description: The name of the type definition. options: type: object description: The options for the type definition. additionalProperties: type: string serviceType: type: string description: The service type. typeVersion: type: string description: The version of the type. updateTime: type: integer format: int64 description: The update time of the record. updatedBy: type: string description: The user who updated the record. version: type: integer format: int64 description: The version of the record. lastModifiedTS: type: string description: ETag for concurrency control. attributeDefs: type: array description: An array of attribute definitions. items: $ref: '#/definitions/AtlasAttributeDef' x-ms-identifiers: [] endDef1: $ref: '#/definitions/AtlasRelationshipEndDef' description: >- The relationshipEndDef represents an end of the relationship. The end of the relationship is defined by a type, an attribute name, cardinality and whether it is the container end of the relationship. endDef2: $ref: '#/definitions/AtlasRelationshipEndDef' description: >- The relationshipEndDef represents an end of the relationship. The end of the relationship is defined by a type, an attribute name, cardinality and whether it is the container end of the relationship. relationshipCategory: $ref: '#/definitions/RelationshipCategory' description: >- The Relationship category determines the style of relationship around containment and lifecycle. UML terminology is used for the values. ASSOCIATION is a relationship with no containment. COMPOSITION and AGGREGATION are containment relationships. The difference being in the lifecycles of the container and its children. In the COMPOSITION case, the children cannot exist without the container. For AGGREGATION, the life cycles of the container and children are totally independent. relationshipLabel: type: string description: The label of the relationship. AtlasRelationshipEndDef: type: object description: >- The relationshipEndDef represents an end of the relationship. The end of the relationship is defined by a type, an attribute name, cardinality and whether it is the container end of the relationship. properties: cardinality: $ref: '#/definitions/CardinalityValue' description: single-valued attribute or multi-valued attribute. description: type: string description: The description of the relationship end definition. isContainer: type: boolean description: Determines if it is container. isLegacyAttribute: type: boolean description: Determines if it is a legacy attribute. name: type: string description: The name of the relationship end definition. type: type: string description: The type of the relationship end. AtlasRelationshipWithExtInfo: type: object description: The relationship with extended information. properties: referredEntities: type: object description: The referred entity header. additionalProperties: $ref: '#/definitions/AtlasEntityHeader' relationship: $ref: '#/definitions/AtlasRelationship' description: Atlas relationship instance. AtlasStruct: type: object description: >- Captures details of struct contents. Not instantiated directly, used only via AtlasEntity, AtlasClassification. properties: attributes: type: object description: The attributes of the struct. additionalProperties: {} typeName: type: string description: The name of the type. lastModifiedTS: type: string description: ETag for concurrency control. AtlasStructDef: type: object description: class that captures details of a struct-type. properties: category: $ref: '#/definitions/TypeCategory' description: The enum of type category. createTime: type: integer format: int64 description: The created time of the record. createdBy: type: string description: The user who created the record. dateFormatter: $ref: '#/definitions/DateFormat' description: The date format. description: type: string description: The description of the type definition. guid: type: string description: The GUID of the type definition. name: type: string description: The name of the type definition. options: type: object description: The options for the type definition. additionalProperties: type: string serviceType: type: string description: The service type. typeVersion: type: string description: The version of the type. updateTime: type: integer format: int64 description: The update time of the record. updatedBy: type: string description: The user who updated the record. version: type: integer format: int64 description: The version of the record. lastModifiedTS: type: string description: ETag for concurrency control. attributeDefs: type: array description: An array of attribute definitions. items: $ref: '#/definitions/AtlasAttributeDef' x-ms-identifiers: [] AtlasTermAssignmentHeader: type: object description: The header for term assignment. properties: confidence: type: integer format: int32 description: The confidence of the term assignment. createdBy: type: string description: The user who created the record. description: type: string description: The description of the term assignment. displayText: type: string description: The display text. expression: type: string description: The expression of the term assignment. relationGuid: $ref: '#/definitions/Azure.Core.uuid' description: The GUID of the relationship. status: $ref: '#/definitions/AtlasTermAssignmentStatus' description: The status of terms assignment. steward: type: string description: The steward of the term. termGuid: $ref: '#/definitions/Azure.Core.uuid' description: The GUID of the term. AtlasTermAssignmentStatus: type: string description: Status for term assignment enum: - DISCOVERED - PROPOSED - IMPORTED - VALIDATED - DEPRECATED - OBSOLETE - OTHER x-ms-enum: name: AtlasTermAssignmentStatus modelAsString: true values: - name: Discovered value: DISCOVERED description: The status is discovered. - name: Proposed value: PROPOSED description: The status is proposed. - name: Imported value: IMPORTED description: The status is imported. - name: Validated value: VALIDATED description: The status is validated. - name: Deprecated value: DEPRECATED description: The status is deprecated. - name: Obsolete value: OBSOLETE description: The status is obsolete. - name: Other value: OTHER description: Other status. AtlasTermCategorizationHeader: type: object description: The basic information for term categorization. properties: categoryGuid: $ref: '#/definitions/Azure.Core.uuid' description: The GUID of the category. description: type: string description: The description of the record. displayText: type: string description: The display text. relationGuid: $ref: '#/definitions/Azure.Core.uuid' description: The GUID of the relationship. status: $ref: '#/definitions/AtlasTermRelationshipStatus' description: The status of term relationship. AtlasTermRelationshipStatus: type: string description: Status for atlas term relationship enum: - DRAFT - ACTIVE - DEPRECATED - OBSOLETE - OTHER x-ms-enum: name: AtlasTermRelationshipStatus modelAsString: true values: - name: Draft value: DRAFT description: draft - name: Active value: ACTIVE description: active - name: Deprecated value: DEPRECATED description: deprecated - name: Obsolete value: OBSOLETE description: obsolete - name: Other value: OTHER description: other AtlasTypeDef: type: object description: The definitions of type. properties: category: $ref: '#/definitions/TypeCategory' description: The enum of type category. createTime: type: integer format: int64 description: The created time of the record. createdBy: type: string description: The user who created the record. dateFormatter: $ref: '#/definitions/DateFormat' description: The date format. description: type: string description: The description of the type definition. guid: type: string description: The GUID of the type definition. name: type: string description: The name of the type definition. options: type: object description: The options for the type definition. additionalProperties: type: string serviceType: type: string description: The service type. typeVersion: type: string description: The version of the type. updateTime: type: integer format: int64 description: The update time of the record. updatedBy: type: string description: The user who updated the record. version: type: integer format: int64 description: The version of the record. lastModifiedTS: type: string description: ETag for concurrency control. entityTypes: type: array description: > 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. items: type: string subTypes: type: array description: An array of sub types. items: type: string superTypes: type: array description: An array of super types. items: type: string relationshipAttributeDefs: type: array description: An array of relationship attributes. items: $ref: '#/definitions/AtlasRelationshipAttributeDef' x-ms-identifiers: [] defaultValue: type: string description: The default value. elementDefs: type: array description: An array of enum element definitions. items: $ref: '#/definitions/AtlasEnumElementDef' x-ms-identifiers: [] endDef1: $ref: '#/definitions/AtlasRelationshipEndDef' description: >- The relationshipEndDef represents an end of the relationship. The end of the relationship is defined by a type, an attribute name, cardinality and whether it is the container end of the relationship. endDef2: $ref: '#/definitions/AtlasRelationshipEndDef' description: >- The relationshipEndDef represents an end of the relationship. The end of the relationship is defined by a type, an attribute name, cardinality and whether it is the container end of the relationship. relationshipCategory: $ref: '#/definitions/RelationshipCategory' description: >- The Relationship category determines the style of relationship around containment and lifecycle. UML terminology is used for the values. ASSOCIATION is a relationship with no containment. COMPOSITION and AGGREGATION are containment relationships. The difference being in the lifecycles of the container and its children. In the COMPOSITION case, the children cannot exist without the container. For AGGREGATION, the life cycles of the container and children are totally independent. relationshipLabel: type: string description: The label of the relationship. attributeDefs: type: array description: An array of attribute definitions. items: $ref: '#/definitions/AtlasAttributeDef' x-ms-identifiers: [] AtlasTypeDefHeader: type: object description: The basic information of the type definition. properties: category: $ref: '#/definitions/TypeCategory' description: The enum of type category. guid: type: string description: The GUID of the type definition. name: type: string description: The name of the type definition. AtlasTypesDef: type: object description: The definitions of types. properties: businessMetadataDefs: type: array description: businessMetadataDefs items: $ref: '#/definitions/AtlasBusinessMetadataDef' x-ms-identifiers: [] classificationDefs: type: array description: An array of classification definitions. items: $ref: '#/definitions/AtlasClassificationDef' x-ms-identifiers: [] entityDefs: type: array description: An array of entity definitions. items: $ref: '#/definitions/AtlasEntityDef' x-ms-identifiers: [] enumDefs: type: array description: An array of enum definitions. items: $ref: '#/definitions/AtlasEnumDef' x-ms-identifiers: [] relationshipDefs: type: array description: An array of relationship definitions. items: $ref: '#/definitions/AtlasRelationshipDef' x-ms-identifiers: [] structDefs: type: array description: An array of struct definitions. items: $ref: '#/definitions/AtlasStructDef' x-ms-identifiers: [] termTemplateDefs: type: array description: An array of term template definitions. items: $ref: '#/definitions/TermTemplateDef' x-ms-identifiers: [] AutoCompleteOptions: type: object description: The payload of autocomplete request. properties: keywords: type: string description: >- The keywords applied to all fields that support autocomplete operation. It must be at least 1 character, and no more than 100 characters. limit: type: integer format: int32 description: >- The number of autocomplete results we hope to return. The default value is 50. The value must be a number between 1 and 100. filter: description: The filter for the autocomplete request. AutoCompleteResult: type: object description: The result of the autocomplete request. properties: value: type: array description: The result value items: $ref: '#/definitions/AutoCompleteResultValue' x-ms-identifiers: [] AutoCompleteResultValue: type: object description: The value item of the autocomplete suggest. properties: text: type: string description: The completed term or phrase. queryPlusText: type: string description: The completed search query text. Azure.Core.uuid: type: string format: uuid description: Universally Unique Identifier BulkImportResult: type: object description: Bulk import result properties: failedImportInfoList: type: array description: failed importInfoList items: $ref: '#/definitions/ImportInfo' x-ms-identifiers: [] successImportInfoList: type: array description: successful importInfoList items: $ref: '#/definitions/ImportInfo' x-ms-identifiers: [] BusinessMetadataOptions: type: object description: Business metadata to send to the service properties: file: type: string format: byte description: InputStream of file required: - file CardinalityValue: type: string description: Cardinality enum: - SINGLE - LIST - SET x-ms-enum: name: CardinalityValue modelAsString: true values: - name: Single value: SINGLE description: single - name: List value: LIST description: list - name: Set value: SET description: set ClassificationAssociateOptions: type: object description: The request payload for classification association. properties: classification: $ref: '#/definitions/AtlasClassification' description: >- An instance of a classification; it doesn't have an identity, this object exists only when associated with an entity. entityGuids: type: array description: The GUID of the entity. items: type: string ContactInfo: type: object description: ContactInfo properties: id: type: string description: Azure Active Directory object Id. info: type: string description: additional information to describe this contact. ContactSearchResultValue: type: object description: The contact in the search and suggest result. properties: id: type: string description: The GUID of the contact. info: type: string description: The description of the contact. contactType: type: string description: >- The type of the contact. It can be Expert or Owner for an entity. It can be Expert or Steward for a glossary term. DateFormat: type: object description: The date format. properties: availableLocales: type: array description: An array of available locales. items: type: string calendar: type: number format: float description: Calendar dateInstance: $ref: '#/definitions/DateFormat' description: The date format. dateTimeInstance: $ref: '#/definitions/DateFormat' description: The date format. instance: $ref: '#/definitions/DateFormat' description: The date format. lenient: type: boolean description: Determines the leniency of the date format. numberFormat: $ref: '#/definitions/NumberFormat' description: The number format. timeInstance: $ref: '#/definitions/DateFormat' description: The date format. timeZone: $ref: '#/definitions/TimeZone' description: The timezone information. EntityMutationResult: type: object description: The mutation response result of entity. properties: guidAssignments: type: object description: A map of GUID assignments with entities. additionalProperties: type: string mutatedEntities: type: object description: The entity headers of mutated entities. additionalProperties: items: $ref: '#/definitions/AtlasEntityHeader' type: array x-ms-identifiers: [] partialUpdatedEntities: type: array description: An array of entity headers that partially updated. items: $ref: '#/definitions/AtlasEntityHeader' x-ms-identifiers: [] EntityStatus: type: string description: Status - can be active or deleted enum: - ACTIVE - DELETED x-ms-enum: name: EntityStatus modelAsString: true values: - name: Active value: ACTIVE description: The status is active. - name: Deleted value: DELETED description: The status is deleted. ImportInfo: type: object description: ImportInfo properties: childObjectName: type: string description: childObjectName importStatus: $ref: '#/definitions/ImportStatus' description: importStatus parentObjectName: type: string description: parentObjectName remarks: type: string description: remarks ImportStatus: type: string description: Status for import enum: - SUCCESS - FAILED x-ms-enum: name: ImportStatus modelAsString: true values: - name: Success value: SUCCESS description: Success - name: Failed value: FAILED description: Failed LineageDirection: type: string description: Lineage direction enum: - INPUT - OUTPUT - BOTH x-ms-enum: name: LineageDirection modelAsString: true values: - name: Input value: INPUT description: input - name: Output value: OUTPUT description: output - name: Both value: BOTH description: both LineageRelation: type: object description: The lineage relation with GUID of the from and to entity. properties: fromEntityId: type: string description: The GUID of from-entity. relationshipId: type: string description: The GUID of relationship. toEntityId: type: string description: The GUID of to-entity. MoveEntitiesOptions: type: object description: MoveEntitiesOptions properties: entityGuids: type: array description: An array of entity guids to be moved to target collection. items: type: string NumberFormat: type: object description: The number format. properties: availableLocales: type: array description: The number format. items: type: string currency: type: string description: The currency. currencyInstance: $ref: '#/definitions/NumberFormat' description: The number format. groupingUsed: type: boolean description: Determines if grouping is used. instance: $ref: '#/definitions/NumberFormat' description: The number format. integerInstance: $ref: '#/definitions/NumberFormat' description: The number format. maximumFractionDigits: type: integer format: int32 description: The maximum of fraction digits. maximumIntegerDigits: type: integer format: int32 description: The maximum of integer digits. minimumFractionDigits: type: integer format: int32 description: The minimum of fraction digits. minimumIntegerDigits: type: integer format: int32 description: The minimum of integer digits. numberInstance: $ref: '#/definitions/NumberFormat' description: The number format. parseIntegerOnly: type: boolean description: Determines if only integer is parsed. percentInstance: $ref: '#/definitions/NumberFormat' description: The number format. roundingMode: $ref: '#/definitions/RoundingMode' description: The enum of rounding mode. ParentRelation: type: object description: >- The lineage parents relation with GUID of the parent entity and to child entity. properties: childEntityId: type: string description: The GUID of child entity. relationshipId: type: string description: The GUID of relationship. parentEntityId: type: string description: The GUID of parent entity. PurviewObjectId: type: object description: PurviewObjectId properties: guid: type: string description: The GUID of the object. typeName: type: string description: The name of the type. uniqueAttributes: type: object description: The unique attributes of the object. additionalProperties: {} name: type: string description: Name displayText: type: string description: Display text itemPath: type: string description: Item path resourceId: type: string description: Resource Id properties: type: object description: Dictionary of additionalProperties: {} QueryOptions: type: object description: The search query of advanced search request. properties: keywords: type: string description: The keywords applied to all searchable fields. limit: type: integer format: int32 description: >- The limit of the number of the search result. default value is 50; maximum value is 1000. continuationToken: type: string description: >- The token used to get next batch of data. Default 'Null' to get the first batch, and will return new token in each response unless there's no more data. orderby: type: array description: The sort order of search results, can specify multiple fields. items: {} filter: description: >- The filter for the search. See examples for the usage of supported filters. facets: type: array description: The facets for search. See examples for the usage of supported facets. items: $ref: '#/definitions/SearchFacetItem' x-ms-identifiers: [] taxonomySetting: $ref: '#/definitions/SearchTaxonomySetting' description: The taxonomy setting for search. QueryResult: type: object description: The result of the search result. properties: '@search.count': type: integer format: int32 description: >- The total number of search results (not the number of documents in a single page). x-ms-client-name: searchCount '@search.count.approximate': type: boolean description: '''True'' if the ''@search.count'' is an approximate value and vise versa.' x-ms-client-name: searchCountApproximate continuationToken: type: string description: >- The token used to get next batch of data. Absent if there's no more data. '@search.facets': $ref: '#/definitions/SearchFacetResultValue' description: >- A facet list that consists of index fields assetType ,classification, contactId, and label. When the facet is specified in the request, the value of the facet is returned as an element of @search.facets. x-ms-client-name: searchFacets value: type: array description: Search result value items: $ref: '#/definitions/SearchResultValue' RelationshipCategory: type: string description: Relationship Category enum: - ASSOCIATION - AGGREGATION - COMPOSITION x-ms-enum: name: RelationshipCategory modelAsString: true values: - name: Association value: ASSOCIATION description: association - name: Aggregation value: AGGREGATION description: aggregation - name: Composition value: COMPOSITION description: composition ResourceLink: type: object description: ResourceLink properties: displayName: type: string description: Display name for url. url: type: string description: web url. http or https RoundingMode: type: string description: Rounding Mode enum: - UP - DOWN - CEILING - FLOOR - HALF_UP - HALF_DOWN - HALF_EVEN - UNNECESSARY x-ms-enum: name: RoundingMode modelAsString: true values: - name: Up value: UP description: up - name: Down value: DOWN description: down - name: Ceiling value: CEILING description: ceiling - name: Floor value: FLOOR description: floor - name: HalfUp value: HALF_UP description: half up - name: HalfDown value: HALF_DOWN description: half down - name: HalfEven value: HALF_EVEN description: half even - name: Unnecessary value: UNNECESSARY description: unnecessary SearchFacetItem: type: object description: The content of a search facet result item. properties: count: type: integer format: int32 description: The count of the facet item. facet: type: string description: The name of the facet item. sort: $ref: '#/definitions/SearchFacetSort' description: Define the sorting criteria for items SearchFacetItemValue: type: object description: The content of a search facet result item. properties: count: type: integer format: int32 description: The count of the facet item. value: type: string description: The name of the facet item. SearchFacetResultValue: type: object description: >- A facet list that consists of index fields assetType ,classification, contactId, and label. When the facet is specified in the request, the value of the facet is returned as an element of @search.facets. properties: entityType: type: array description: Entity type items: $ref: '#/definitions/SearchFacetItemValue' x-ms-identifiers: [] assetType: type: array description: Asset type items: $ref: '#/definitions/SearchFacetItemValue' x-ms-identifiers: [] classification: type: array description: Classification items: $ref: '#/definitions/SearchFacetItemValue' x-ms-identifiers: [] term: type: array description: Term items: $ref: '#/definitions/SearchFacetItemValue' x-ms-identifiers: [] contactId: type: array description: Contact id items: $ref: '#/definitions/SearchFacetItemValue' x-ms-identifiers: [] contactType: type: array description: Contact type items: $ref: '#/definitions/SearchFacetItemValue' x-ms-identifiers: [] label: type: array description: Label items: $ref: '#/definitions/SearchFacetItemValue' x-ms-identifiers: [] glossaryType: type: array description: Glossary type items: $ref: '#/definitions/SearchFacetItemValue' x-ms-identifiers: [] termStatus: type: array description: Term status items: $ref: '#/definitions/SearchFacetItemValue' x-ms-identifiers: [] termTemplate: type: array description: Term template items: $ref: '#/definitions/SearchFacetItemValue' x-ms-identifiers: [] SearchFacetSort: type: object description: The sorting criteria properties: count: $ref: '#/definitions/SearchSortOrder' description: Order by count value: $ref: '#/definitions/SearchSortOrder' description: Order by value SearchHighlights: type: object description: >- A highlight list that consists of index fields id ,qualifiedName, name, description, entityType. When the keyword appears in those fields, the value of the field, attached with emphasis mark, is returned as an element of @search.highlights. properties: id: type: array description: Id items: type: string qualifiedName: type: array description: Qualified name items: type: string name: type: array description: Name items: type: string description: type: array description: Description items: type: string entityType: type: array description: Entity type items: type: string SearchResultValue: type: object description: The value item of the search result. properties: '@search.score': type: number format: float description: >- The search score calculated by the search engine. The results are ordered by search score by default. x-ms-client-name: searchScore '@search.highlights': $ref: '#/definitions/SearchHighlights' description: >- A highlight list that consists of index fields id ,qualifiedName, name, description, entityType. When the keyword appears in those fields, the value of the field, attached with emphasis mark, is returned as an element of @search.highlights. x-ms-client-name: searchHighlights objectType: type: string description: >- The object type of the record. Object type is the top-level property to distinguish whether a record is an asset or a term. createTime: type: integer format: int64 description: The create time of the record. The Unix epoch format. updateTime: type: integer format: int64 description: The last update time of the record. The Unix epoch format. id: type: string description: The GUID of the record. name: type: string description: The name of the record. qualifiedName: type: string description: The qualified name of the record. entityType: type: string description: The type name of the asset. description: type: string description: The description of the asset. endorsement: type: string description: The endorsement of the asset. owner: type: string description: The owner of the record. classification: type: array description: The classifications of the record. items: type: string label: type: array description: The labels of the asset. items: type: string term: type: array description: The terms assigned to the asset. items: $ref: '#/definitions/TermSearchResultValue' x-ms-identifiers: [] contact: type: array description: The contacts of the asset. items: $ref: '#/definitions/ContactSearchResultValue' assetType: type: array description: The asset types of the asset. items: type: string glossaryType: type: string description: >- The type name of the term. Could be AtlasGlossary, AtlasGlossaryTerm or AtlasGlossaryCategory. glossary: type: string description: The glossary name of the term. termStatus: type: string description: The status of the term. termTemplate: type: array description: The term template names used by the term. items: type: string longDescription: type: string description: The definition of the term. SearchSortOrder: type: string description: Search sort order enum: - asc - desc x-ms-enum: name: SearchSortOrder modelAsString: true values: - name: Ascend value: asc description: Use ascending order for sorting - name: Descend value: desc description: Use descending order for sorting SearchTaxonomySetting: type: object description: Taxonomy setting for search request properties: assetTypes: type: array description: Asset types items: type: string facet: $ref: '#/definitions/SearchFacetItem' description: The content of a search facet result item. SortType: type: string description: Type for sorting enum: - NONE - ASC - DESC x-ms-enum: name: SortType modelAsString: true values: - name: None value: NONE description: No sorting order - name: Ascend value: ASC description: Use ascending order for sorting - name: Descend value: DESC description: Use descending order for sorting StatusAtlasRelationship: type: string description: Status for atlas relationship enum: - ACTIVE - DELETED x-ms-enum: name: StatusAtlasRelationship modelAsString: true values: - name: Active value: ACTIVE description: active - name: Deleted value: DELETED description: deleted SuggestOptions: type: object description: The payload of suggest request. properties: keywords: type: string description: >- The keywords applied to all fields that support suggest operation. It must be at least 1 character, and no more than 100 characters. In the index schema we defined a default suggester which lists all the supported fields and specifies a search mode. limit: type: integer format: int32 description: >- The number of suggestions we hope to return. The default value is 5. The value must be a number between 1 and 100. filter: description: The filter for the search. SuggestResult: type: object description: The result item of the search suggest. properties: value: type: array description: The result value items: $ref: '#/definitions/SuggestResultValue' SuggestResultValue: type: object description: The value item of the search suggest. properties: '@search.score': type: number format: float description: >- The search score calculated by the search engine. The results are ordered by search score by default. x-ms-client-name: searchScore '@search.text': type: string description: >- The target text that contains the keyword as prefix. The keyword is wrapped with emphasis mark. x-ms-client-name: searchText objectType: type: string description: >- The object type of the record. Object type is the top-level property to distinguish whether a record is an asset or a term. createTime: type: integer format: int64 description: The create time of the record. The Unix epoch format. updateTime: type: integer format: int64 description: The last update time of the record. The Unix epoch format. id: type: string description: The GUID of the record. name: type: string description: The name of the record. qualifiedName: type: string description: The qualified name of the record. entityType: type: string description: The type name of the asset. description: type: string description: The description of the asset. endorsement: type: string description: The endorsement of the asset. owner: type: string description: The owner of the record. classification: type: array description: The classifications of the record. items: type: string label: type: array description: The labels of the asset. items: type: string term: type: array description: The terms assigned to the asset. items: $ref: '#/definitions/TermSearchResultValue' x-ms-identifiers: [] contact: type: array description: The contacts of the asset. items: $ref: '#/definitions/ContactSearchResultValue' assetType: type: array description: The asset types of the asset. items: type: string glossaryType: type: string description: >- The type name of the term. Could be AtlasGlossary, AtlasGlossaryTerm or AtlasGlossaryCategory. glossary: type: string description: The glossary name of the term. termStatus: type: string description: The status of the term. termTemplate: type: array description: The term template names used by the term. items: type: string longDescription: type: string description: The definition of the term. TermSearchResultValue: type: object description: The context. properties: name: type: string description: The name of the term. glossaryName: type: string description: The name of the glossary which contains the term. guid: type: string description: The GUID of the term. TermStatus: type: string description: Status for term enum: - Draft - Approved - Alert - Expired x-ms-enum: name: TermStatus modelAsString: true values: - name: Draft value: Draft description: draft - name: Approved value: Approved description: approved - name: Alert value: Alert description: alert - name: Expired value: Expired description: expired TermTemplateDef: type: object description: Term template definition for glossary term. properties: category: $ref: '#/definitions/TypeCategory' description: The enum of type category. createTime: type: integer format: int64 description: The created time of the record. createdBy: type: string description: The user who created the record. dateFormatter: $ref: '#/definitions/DateFormat' description: The date format. description: type: string description: The description of the type definition. guid: type: string description: The GUID of the type definition. name: type: string description: The name of the type definition. options: type: object description: The options for the type definition. additionalProperties: type: string serviceType: type: string description: The service type. typeVersion: type: string description: The version of the type. updateTime: type: integer format: int64 description: The update time of the record. updatedBy: type: string description: The user who updated the record. version: type: integer format: int64 description: The version of the record. lastModifiedTS: type: string description: ETag for concurrency control. attributeDefs: type: array description: An array of attribute definitions. items: $ref: '#/definitions/AtlasAttributeDef' x-ms-identifiers: [] TimeBoundary: type: object description: Captures time-boundary details properties: endTime: type: string description: The end of the time boundary. startTime: type: string description: The start of the time boundary. timeZone: type: string description: The timezone of the time boundary. TimeZone: type: object description: The timezone information. properties: dstSavings: type: integer format: int32 description: The value of the daylight saving time. id: type: string description: The ID of the timezone. availableIds: type: array description: An array of available IDs. items: type: string default: $ref: '#/definitions/TimeZone' description: The timezone information. displayName: type: string description: The display name of the timezone. rawOffset: type: integer format: int32 description: The raw offset of the timezone. TypeCategory: type: string description: Type Category enum: - PRIMITIVE - OBJECT_ID_TYPE - ENUM - STRUCT - CLASSIFICATION - ENTITY - ARRAY - MAP - RELATIONSHIP - TERM_TEMPLATE x-ms-enum: name: TypeCategory modelAsString: true values: - name: Primitive value: PRIMITIVE description: primitive - name: ObjectIdType value: OBJECT_ID_TYPE description: object id type - name: Enum value: ENUM description: enum - name: Struct value: STRUCT description: struct - name: Classification value: CLASSIFICATION description: classification - name: Entity value: ENTITY description: entity - name: Array value: ARRAY description: array - name: Map value: MAP description: map - name: Relationship value: RELATIONSHIP description: relationship - name: TermTemplate value: TERM_TEMPLATE description: term template parameters: AtlasApiVersionParameter: name: api-version in: query description: The API version to use for this operation. required: false type: string minLength: 1 x-ms-parameter-location: method x-ms-client-name: apiVersion Azure.Core.Foundations.ApiVersionParameter: name: api-version in: query description: The API version to use for this operation. required: true type: string minLength: 1 x-ms-parameter-location: method x-ms-client-name: apiVersion BusinessMetadataOptions: name: file in: formData description: InputStream of file required: true type: file x-ms-parameter-location: method