diff --git a/cSpell.json b/cSpell.json index 69c32e13e6d7..ea1ed23d0a21 100644 --- a/cSpell.json +++ b/cSpell.json @@ -1003,6 +1003,12 @@ "throughputpool" ] }, + { + "filename": "**/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/**/*.json", + "words": [ + "timerange" + ] + }, { "filename": "**/specification/search/data-plane/Azure.Search/**/*.json", "words": [ diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/client.tsp b/specification/purview/Azure.Analytics.Purview.DataMap/client.tsp new file mode 100644 index 000000000000..15a65848cd57 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/client.tsp @@ -0,0 +1,152 @@ +import "./main.tsp"; +import "@azure-tools/typespec-client-generator-core"; + +using Azure.ClientGenerator.Core; +using PurviewDataMap; + +@TypeSpec.Versioning.useDependency(PurviewDataMap.ApiVersions.v2023_09_01) +@client({ + name: "DataMapClient", + service: PurviewDataMap, +}) +namespace Customizations; + +@@projectedName(MoveEntitiesOptions, "csharp", "MoveEntitiesConfig"); +@@projectedName(DateFormat, "csharp", "AtlasDateFormat"); +@@projectedName(NumberFormat, "csharp", "AtlasNumberFormat"); +@@projectedName(TimeZone, "csharp", "AtlasTimeZone"); +@@projectedName(SortType, "csharp", "AtlasSortType"); +@@projectedName(ClassificationAssociateOptions, + "csharp", + "ClassificationAssociateConfig" +); +@@projectedName(QueryOptions, "csharp", "QueryConfig"); +@@projectedName(SuggestOptions, "csharp", "SuggestConfig"); +@@projectedName(AutoCompleteOptions, "csharp", "AutoCompleteConfig"); + +#suppress "@azure-tools/typespec-azure-core/use-standard-operations" +@operationGroup +interface Entity { + createOrUpdate is PurviewDataMap.Entity.createOrUpdate; + getByIds is PurviewDataMap.Entity.listByGuids; + batchCreateOrUpdate is PurviewDataMap.Entity.bulkCreateOrUpdate; + batchDelete is PurviewDataMap.Entity.bulkDelete; + addClassification is PurviewDataMap.Entity.addClassification; + get is PurviewDataMap.Entity.get; + updateAttributeById is PurviewDataMap.Entity.partialUpdateAttributeByGuid; + delete is PurviewDataMap.Entity.delete; + getClassification is PurviewDataMap.Entity.getClassification; + removeClassification is PurviewDataMap.Entity.removeClassification; + getClassifications is PurviewDataMap.Entity.getClassifications; + addClassifications is PurviewDataMap.Entity.addClassifications; + updateClassifications is PurviewDataMap.Entity.updateClassifications; + getByUniqueAttribute is PurviewDataMap.Entity.getByUniqueAttributes; + updateByUniqueAttribute is PurviewDataMap.Entity.partialUpdateByUniqueAttributes; + deleteByUniqueAttribute is PurviewDataMap.Entity.deleteByUniqueAttribute; + removeClassificationByUniqueAttribute is PurviewDataMap.Entity.removeClassificationByUniqueAttribute; + addClassificationsByUniqueAttribute is PurviewDataMap.Entity.addClassificationsByUniqueAttribute; + updateClassificationsUniqueByAttribute is PurviewDataMap.Entity.updateClassificationsByUniqueAttribute; + batchSetClassifications is PurviewDataMap.Entity.bulkSetClassifications; + batchGetByUniqueAttributes is PurviewDataMap.Entity.listByUniqueAttributes; + getHeader is PurviewDataMap.Entity.getHeader; + removeBusinessMetadata is PurviewDataMap.Entity.removeBusinessMetadata; + addOrUpdateBusinessMetadata is PurviewDataMap.Entity.addOrUpdateBusinessMetadata; + removeBusinessMetadataAttributes is PurviewDataMap.Entity.removeBusinessMetadataAttributes; + addOrUpdateBusinessMetadataAttributes is PurviewDataMap.Entity.addOrUpdateBusinessMetadataAttributes; + getBusinessMetadataTemplate is PurviewDataMap.Entity.getSampleBusinessMetadataTemplate; + #suppress "@azure-tools/typespec-azure-core/byos" "This is Atlas API" + importBusinessMetadata is PurviewDataMap.Entity.importBusinessMetadata; + removeLabels is PurviewDataMap.Entity.removeLabels; + setLabels is PurviewDataMap.Entity.setLabels; + addLabel is PurviewDataMap.Entity.addLabel; + removeLabelsByUniqueAttribute is PurviewDataMap.Entity.removeLabelsByUniqueAttribute; + setLabelsByUniqueAttribute is PurviewDataMap.Entity.setLabelsByUniqueAttribute; + addLabelsByUniqueAttribute is PurviewDataMap.Entity.addLabelsByUniqueAttribute; + moveEntitiesToCollection is PurviewDataMap.Entity.moveEntitiesToCollection; +} + +#suppress "@azure-tools/typespec-azure-core/use-standard-operations" +@operationGroup +interface Glossary { + batchGet is PurviewDataMap.Glossary.list; + create is PurviewDataMap.Glossary.create; + createCategories is PurviewDataMap.Glossary.createCategories; + createCategory is PurviewDataMap.Glossary.createCategory; + getCategory is PurviewDataMap.Glossary.getCategory; + updateCategory is PurviewDataMap.Glossary.updateCategory; + deleteCategory is PurviewDataMap.Glossary.deleteCategory; + partialUpdateCategory is PurviewDataMap.Glossary.partialUpdateCategory; + getRelatedCategories is PurviewDataMap.Glossary.listRelatedCategories; + getCategoryTerms is PurviewDataMap.Glossary.listCategoryTerms; + createTerm is PurviewDataMap.Glossary.createTerm; + getTerm is PurviewDataMap.Glossary.getTerm; + updateTerm is PurviewDataMap.Glossary.updateTerm; + deleteTerm is PurviewDataMap.Glossary.deleteTerm; + partialUpdateTerm is PurviewDataMap.Glossary.partialUpdateTerm; + createTerms is PurviewDataMap.Glossary.createTerms; + getEntitiesAssignedWithTerm is PurviewDataMap.Glossary.listEntitiesAssignedWithTerm; + assignTermToEntities is PurviewDataMap.Glossary.assignTermToEntities; + deleteTermAssignmentFromEntities is PurviewDataMap.Glossary.deleteTermAssignmentFromEntities; + getRelatedTerms is PurviewDataMap.Glossary.listRelatedTerms; + get is PurviewDataMap.Glossary.get; + update is PurviewDataMap.Glossary.update; + delete is PurviewDataMap.Glossary.delete; + getCategories is PurviewDataMap.Glossary.listCategories; + getCategoriesHeaders is PurviewDataMap.Glossary.listCategoriesHeaders; + getDetailed is PurviewDataMap.Glossary.getDetailed; + partialUpdate is PurviewDataMap.Glossary.partialUpdate; + getTerms is PurviewDataMap.Glossary.listTerms; + getTermHeaders is PurviewDataMap.Glossary.listTermHeaders; +} + +#suppress "@azure-tools/typespec-azure-core/use-standard-operations" +@operationGroup +interface Discovery { + query is PurviewDataMap.Discovery.query; + suggest is PurviewDataMap.Discovery.suggest; + autoComplete is PurviewDataMap.Discovery.autoComplete; +} + +#suppress "@azure-tools/typespec-azure-core/use-standard-operations" +@operationGroup +interface Lineage { + get is PurviewDataMap.Lineage.get; + getNextPage is PurviewDataMap.Lineage.getNextPage; + getByUniqueAttribute is PurviewDataMap.Lineage.getByUniqueAttribute; +} + +#suppress "@azure-tools/typespec-azure-core/use-standard-operations" +@operationGroup +interface Relationship { + create is PurviewDataMap.Relationship.create; + update is PurviewDataMap.Relationship.update; + get is PurviewDataMap.Relationship.get; + delete is PurviewDataMap.Relationship.delete; +} + +#suppress "@azure-tools/typespec-azure-core/use-standard-operations" +@operationGroup +interface TypeDefinition { + getBusinessMetadataById is PurviewDataMap.Type.getBusinessMetadataDefByGuid; + getBusinessMetadataByName is PurviewDataMap.Type.getBusinessMetadataDefByName; + getClassificationById is PurviewDataMap.Type.getClassificationDefByGuid; + getClassificationByName is PurviewDataMap.Type.getClassificationDefByName; + getEntityById is PurviewDataMap.Type.getEntityDefByGuid; + getEntityByName is PurviewDataMap.Type.getEntityDefByName; + getEnumById is PurviewDataMap.Type.getEnumDefByGuid; + getEnumByName is PurviewDataMap.Type.getEnumDefByName; + getRelationshipById is PurviewDataMap.Type.getRelationshipDefByGuid; + getRelationshipByName is PurviewDataMap.Type.getRelationshipDefByName; + getStructById is PurviewDataMap.Type.getStructDefByGuid; + getStructByName is PurviewDataMap.Type.getStructDefByName; + getById is PurviewDataMap.Type.getByGuid; + getByName is PurviewDataMap.Type.getByName; + delete is PurviewDataMap.Type.delete; + get is PurviewDataMap.Type.list; + batchCreate is PurviewDataMap.Type.bulkCreate; + batchUpdate is PurviewDataMap.Type.bulkUpdate; + batchDelete is PurviewDataMap.Type.bulkDelete; + getHeaders is PurviewDataMap.Type.listHeaders; + getTermTemplateById is PurviewDataMap.Type.getTermTemplateDefByGuid; + getTermTemplateByName is PurviewDataMap.Type.getTermTemplateDefByName; +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_AutoComplete.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_AutoComplete.json new file mode 100644 index 000000000000..b2f2665d5b36 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_AutoComplete.json @@ -0,0 +1,40 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": "exa", + "filter": { + "and": [ + { + "entityType": "azure_blob_path", + "includeSubTypes": false + } + ] + }, + "limit": 10 + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "text": "example", + "queryPlusText": "example" + }, + { + "text": "exampleconfiguration", + "queryPlusText": "exampleconfiguration" + }, + { + "text": "exampleresources", + "queryPlusText": "exampleresources" + } + ] + } + } + }, + "title": "Discovery_AutoComplete", + "operationId": "Discovery_AutoComplete" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query.json new file mode 100644 index 000000000000..a7cde65a400e --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query.json @@ -0,0 +1,109 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": "exampledata", + "filter": { + "and": [ + { + "objectType": "Files" + }, + { + "entityType": "azure_blob_path" + } + ] + }, + "limit": 10, + "orderby": [ + { + "name": "ASC" + }, + { + "updateTime": "DESC" + } + ], + "facets": [ + { + "facet": "assetType", + "count": 0, + "sort": { + "count": "desc" + } + }, + { + "facet": "classification", + "count": 10, + "sort": { + "count": "desc" + } + }, + { + "facet": "contactId", + "count": 10, + "sort": { + "count": "desc" + } + }, + { + "facet": "label", + "count": 10, + "sort": { + "count": "desc" + } + }, + { + "facet": "term", + "count": 10, + "sort": { + "count": "desc" + } + } + ] + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "@search.count": 2, + "@search.count.approximate": false, + "value": [ + { + "@search.score": 1.0, + "id": "bfecbcc3-1838-45fe-96d6-112de8a170f9", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/exampledata1.txt", + "name": "exampledata1.txt", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + }, + { + "@search.score": 1.0, + "id": "14d857b9-e2c1-4118-8bfa-12e53ae6ce7f", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/exampledata2.txt", + "name": "exampledata2.txt", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + } + ] + } + } + }, + "title": "Discovery_Query", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_And.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_And.json new file mode 100644 index 000000000000..a1f45773a687 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_And.json @@ -0,0 +1,80 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": null, + "limit": 10, + "filter": { + "and": [ + { + "entityType": "azure_blob_path" + }, + { + "attributeName": "qualifiedName", + "operator": "contains", + "attributeValue": ".csv" + } + ] + } + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "@search.count": 5, + "@search.count.approximate": false, + "value": [ + { + "@search.score": 1.0, + "@search.highlights": { + "qualifiedName": [ + "https://exampleaccount.blob.core.windows.net/examplepath/csv/exampledata.csv" + ] + }, + "id": "63b92968-c9ac-4af8-8cff-f61d147bbf88", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/csv/exampledata.csv", + "name": "exampledata.csv", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [ + "Example.Label" + ], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + }, + { + "@search.score": 1.0, + "@search.highlights": { + "qualifiedName": [ + "https://exampleaccount.blob.core.windows.net/examplepath/csv/AllTypes.csv" + ] + }, + "id": "2605db54-086d-4d6c-adb6-f0bbed6c6eab", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/csv/AllTypes.csv", + "name": "AllTypes.csv", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [ + "Example.Label" + ], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + } + ] + } + } + }, + "title": "Discovery_Query_And", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_AndOrNested.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_AndOrNested.json new file mode 100644 index 000000000000..7ec39b19f500 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_AndOrNested.json @@ -0,0 +1,97 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": null, + "limit": 10, + "filter": { + "and": [ + { + "entityType": "azure_blob_path" + }, + { + "attributeName": "qualifiedName", + "operator": "contains", + "attributeValue": ".csv" + }, + { + "or": [ + { + "attributeName": "name", + "operator": "eq", + "attributeValue": "exampledata.csv" + }, + { + "attributeName": "qualifiedName", + "operator": "prefix", + "attributeValue": "https://" + } + ] + } + ] + } + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "@search.count": 2, + "@search.count.approximate": false, + "value": [ + { + "@search.score": 1.0, + "@search.highlights": { + "qualifiedName": [ + "https://exampleaccount.blob.core.windows.net/examplepath/csv/exampledata.csv" + ] + }, + "id": "63b92968-c9ac-4af8-8cff-f61d147bbf88", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/csv/exampledata.csv", + "name": "exampledata.csv", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [ + "Example.Label" + ], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + }, + { + "@search.score": 1.0, + "@search.highlights": { + "qualifiedName": [ + "https://exampleaccount.blob.core.windows.net/examplepath/csv/AllTypes.csv" + ], + "name": [ + "AllTypes.csv" + ] + }, + "id": "2605db54-086d-4d6c-adb6-f0bbed6c6eab", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/csv/AllTypes.csv", + "name": "AllTypes.csv", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [ + "Example.Label" + ], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + } + ] + } + } + }, + "title": "Discovery_Query_AndOrNested", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_AssetType.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_AssetType.json new file mode 100644 index 000000000000..deb289d5ea22 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_AssetType.json @@ -0,0 +1,140 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": null, + "limit": 10, + "filter": { + "or": [ + { + "assetType": "SQL Server" + }, + { + "assetType": "Azure SQL Server" + }, + { + "assetType": "Azure SQL Database" + }, + { + "assetType": "Azure SQL Data Warehouse" + }, + { + "assetType": "Azure SQL Managed Instance" + }, + { + "assetType": "Azure Storage Account" + }, + { + "assetType": "Azure Blob Storage" + }, + { + "assetType": "Azure Files" + }, + { + "assetType": "Azure Table Storage" + }, + { + "assetType": "Azure Data Lake Storage Gen1" + }, + { + "assetType": "Azure Data Lake Storage Gen2" + }, + { + "assetType": "Azure Cosmos DB" + }, + { + "assetType": "Azure Data Factory" + }, + { + "assetType": "Azure Cognitive Search" + }, + { + "assetType": "Power BI" + }, + { + "assetType": "Azure Data Explorer" + }, + { + "assetType": "Amazon S3" + }, + { + "assetType": "Azure Data Share" + }, + { + "assetType": "Teradata" + }, + { + "assetType": "SAP S4HANA" + }, + { + "assetType": "SAP ECC" + }, + { + "assetType": "SQL Server Integration Services" + }, + { + "assetType": "hive" + }, + { + "assetType": "Azure Database for MySQL" + }, + { + "assetType": "Azure Database for MariaDB" + }, + { + "assetType": "Azure Database for PostgreSQL" + }, + { + "assetType": "Azure Synapse Analytics" + } + ] + } + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "continuationToken": "eyJzZXNzaW9uSWQiOiI5ZWRiYmEzNC0wYmM0LTQxNGEtOTY2NC01OGM2ZTBkMzI3ODYiLCJvZmZzZXQiOjI1LCJyZXF1ZXN0SGFzaCI6IjZiMmFjMTlmMGExZjlmMjY2Nzc0ZDdhZDczNTE3OWJmIn0=", + "@search.count": 5155, + "@search.count.approximate": true, + "value": [ + { + "@search.score": 1.0, + "id": "24c16e53-1bfd-4d6c-b4ce-b1f6f6f60000", + "qualifiedName": "mssql://exampleaccount.database.windows.net:3342/examplesqlmidb/dbo/exampledata1", + "name": "exampledata1", + "description": null, + "owner": null, + "entityType": "azure_sql_mi_table", + "classification": [], + "label": [], + "assetType": [ + "Azure SQL Managed Instance" + ], + "term": [], + "contact": [] + }, + { + "@search.score": 1.0, + "id": "d7b516fc-5d38-40f8-baeb-72f6f6f60000", + "qualifiedName": "mssql://exampleaccount.database.windows.net:3342/examplesqlmidb/dbo/exampledata2", + "name": "exampledata2", + "description": null, + "owner": null, + "entityType": "azure_sql_mi_table", + "classification": [], + "label": [], + "assetType": [ + "Azure SQL Managed Instance" + ], + "term": [], + "contact": [] + } + ] + } + } + }, + "title": "Discovery_Query_AssetType", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Attribute.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Attribute.json new file mode 100644 index 000000000000..6d2ccf524020 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Attribute.json @@ -0,0 +1,97 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": null, + "limit": 10, + "filter": { + "or": [ + { + "attributeName": "name", + "operator": "eq", + "attributeValue": "exampledata.csv" + }, + { + "attributeName": "createTime", + "operator": "ge", + "attributeValue": 1545580800000 + }, + { + "attributeName": "modifiedTime", + "operator": "timerange", + "attributeValue": "LAST_24H|LAST_7D|LAST_30D|LAST_365D|MORE_THAN_365D" + } + ] + } + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "@search.count": 4, + "@search.count.approximate": false, + "value": [ + { + "@search.score": 1.0, + "id": "63b92968-c9ac-4af8-8cff-f61d147bbf88", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/csv/exampledata.csv", + "name": "exampledata.csv", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [ + "Example.Label" + ], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + }, + { + "@search.score": 1.0, + "id": "55b2290d-e11d-4ed2-8c7a-0d8d35eb6254", + "qualifiedName": "https://examplegen2account.dfs.core.windows.net/examplepath/csv/exampledata.csv", + "name": "exampledata.csv", + "description": null, + "owner": "$superuser", + "entityType": "azure_datalake_gen2_path", + "classification": [], + "label": [ + "Example.Label" + ], + "assetType": [ + "Azure Data Lake Storage Gen2" + ], + "term": [], + "contact": [] + }, + { + "@search.score": 1.0, + "id": "55ceaddf-30ac-40f3-b656-71f6f6f60000", + "entityType": "azure_sql_mi_table", + "name": "exampleData_v1", + "qualifiedName": "mssql://exampleaccount.database.windows.net:3342/examplesqlmidb/dbo/exampleData_v1", + "assetType": [ + "Azure SQL Managed Instance" + ] + }, + { + "@search.score": 1.0, + "id": "89416661-5269-4f3d-ba35-e0f6f6f60000", + "entityType": "azure_sql_mi_table", + "name": "exampleData_v2", + "qualifiedName": "mssql://exampleaccount.database.windows.net:3342/examplesqlmidb/dbo/exampleData_v2", + "assetType": [ + "Azure SQL Managed Instance" + ] + } + ] + } + } + }, + "title": "Discovery_Query_Attribute", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_BusinessMetadataAttribute.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_BusinessMetadataAttribute.json new file mode 100644 index 000000000000..2ab33726a034 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_BusinessMetadataAttribute.json @@ -0,0 +1,54 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": null, + "limit": 10, + "filter": { + "or": [ + { + "attributeName": ".", + "operator": "eq|ne|contains|prefix", + "attributeValue": "string value" + }, + { + "attributeName": ".", + "operator": "eq|ne|gt|ge|lt|le", + "attributeValue": 123 + }, + { + "attributeName": ".", + "operator": "eq|ne", + "attributeValue": true + }, + { + "attributeName": ".", + "operator": "timerange", + "attributeValue": "LAST_24H|LAST_7D|LAST_30D|LAST_365D|MORE_THAN_365D" + } + ] + } + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "@search.count": 1, + "@search.count.approximate": false, + "value": [ + { + "@search.score": 1.0, + "id": "63b92968-c9ac-4af8-8cff-f61d147bbf88", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/csv/exampledata.csv", + "name": "exampledata.csv", + "entityType": "azure_blob_path", + "objectType": "Files" + } + ] + } + } + }, + "title": "Discovery_Query_BusinessMetadataAttribute", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Classification.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Classification.json new file mode 100644 index 000000000000..5150545e7d0f --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Classification.json @@ -0,0 +1,69 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": null, + "limit": 10, + "filter": { + "classification": "MICROSOFT.PERSONAL.EMAIL", + "includeSubClassifications": true + } + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "@search.count": 5, + "@search.count.approximate": false, + "value": [ + { + "@search.score": 1.0, + "id": "b9638b91-884f-4e5e-98b5-29f6f6f60000", + "qualifiedName": "mssql://exampleserver.database.windows.net/examplesqldb/examplepath/exampledata1", + "name": "exampledata1", + "description": null, + "owner": null, + "entityType": "azure_sql_table", + "classification": [ + "MICROSOFT.PERSONAL.NAME", + "MICROSOFT.PERSONAL.EU.PHONE_NUMBER", + "MICROSOFT.PERSONAL.US.PHONE_NUMBER", + "MICROSOFT.PERSONAL.EMAIL" + ], + "label": [], + "assetType": [ + "Azure SQL Database" + ], + "term": [], + "contact": [] + }, + { + "@search.score": 1.0, + "id": "01aefb9a-61cd-4a02-a572-70f6f6f60000", + "qualifiedName": "mssql://exampleserver.database.windows.net/exampledw/examplepath/exampledata2", + "name": "exampledata2", + "description": null, + "owner": null, + "entityType": "azure_sql_dw_table", + "classification": [ + "MICROSOFT.GOVERNMENT.CITY_NAME", + "MICROSOFT.GOVERNMENT.US.STATE", + "MICROSOFT.PERSONAL.NAME", + "MICROSOFT.PERSONAL.EU.PHONE_NUMBER", + "MICROSOFT.PERSONAL.EMAIL" + ], + "label": [], + "assetType": [ + "Azure SQL Data Warehouse" + ], + "term": [], + "contact": [] + } + ] + } + } + }, + "title": "Discovery_Query_Classification", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Collection.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Collection.json new file mode 100644 index 000000000000..3779d9d497fe --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Collection.json @@ -0,0 +1,68 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": null, + "limit": 10, + "filter": { + "collectionId": "collectionName" + } + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "@search.count": 5, + "@search.count.approximate": false, + "value": [ + { + "@search.score": 1.0, + "id": "b9638b91-884f-4e5e-98b5-29f6f6f60000", + "qualifiedName": "mssql://exampleserver.database.windows.net/examplesqldb/examplepath/exampledata1", + "name": "exampledata1", + "description": null, + "owner": null, + "entityType": "azure_sql_table", + "classification": [ + "MICROSOFT.PERSONAL.NAME", + "MICROSOFT.PERSONAL.EU.PHONE_NUMBER", + "MICROSOFT.PERSONAL.US.PHONE_NUMBER", + "MICROSOFT.PERSONAL.EMAIL" + ], + "label": [], + "assetType": [ + "Azure SQL Database" + ], + "term": [], + "contact": [] + }, + { + "@search.score": 1.0, + "id": "01aefb9a-61cd-4a02-a572-70f6f6f60000", + "qualifiedName": "mssql://exampleserver.database.windows.net/exampledw/examplepath/exampledata2", + "name": "exampledata2", + "description": null, + "owner": null, + "entityType": "azure_sql_dw_table", + "classification": [ + "MICROSOFT.GOVERNMENT.CITY_NAME", + "MICROSOFT.GOVERNMENT.US.STATE", + "MICROSOFT.PERSONAL.NAME", + "MICROSOFT.PERSONAL.EU.PHONE_NUMBER", + "MICROSOFT.PERSONAL.EMAIL" + ], + "label": [], + "assetType": [ + "Azure SQL Data Warehouse" + ], + "term": [], + "contact": [] + } + ] + } + } + }, + "title": "Discovery_Query_Collection", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Facet.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Facet.json new file mode 100644 index 000000000000..b417487bea7d --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Facet.json @@ -0,0 +1,150 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": null, + "filter": { + "objectType": "Tables" + }, + "limit": 10, + "facets": [ + { + "facet": "assetType", + "count": 10 + }, + { + "facet": "classification", + "count": 10 + }, + { + "facet": "term", + "count": 10 + }, + { + "facet": "label", + "count": 10 + } + ] + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "continuationToken": "eyJzZXNzaW9uSWQiOiI5ZWRiYmEzNC0wYmM0LTQxNGEtOTY2NC01OGM2ZTBkMzI3ODYiLCJvZmZzZXQiOjI1LCJyZXF1ZXN0SGFzaCI6IjZiMmFjMTlmMGExZjlmMjY2Nzc0ZDdhZDczNTE3OWJmIn0=", + "@search.count": 5156, + "@search.count.approximate": false, + "@search.facets": { + "classification": [ + { + "count": 8, + "value": "MICROSOFT.PERSONAL.NAME" + }, + { + "count": 6, + "value": "MICROSOFT.PERSONAL.EU.PHONE_NUMBER" + }, + { + "count": 5, + "value": "MICROSOFT.PERSONAL.EMAIL" + }, + { + "count": 5, + "value": "MICROSOFT.PERSONAL.US.PHONE_NUMBER" + }, + { + "count": 4, + "value": "MICROSOFT.GOVERNMENT.CITY_NAME" + }, + { + "count": 2, + "value": "MICROSOFT.GOVERNMENT.US.STATE" + } + ], + "assetType": [ + { + "count": 1476, + "value": "Azure SQL Database" + }, + { + "count": 1358, + "value": "Azure SQL Data Warehouse" + }, + { + "count": 1331, + "value": "Azure SQL Managed Instance" + }, + { + "count": 293, + "value": "Azure Data Lake Storage Gen1" + }, + { + "count": 261, + "value": "Azure Blob Storage" + }, + { + "count": 231, + "value": "Azure Data Lake Storage Gen2" + }, + { + "count": 194, + "value": "Azure Files" + }, + { + "count": 18, + "value": "Azure Cosmos DB" + } + ], + "label": [ + { + "count": 835, + "value": "Example.Label" + } + ], + "term": [ + { + "count": 1, + "value": "terma" + } + ] + }, + "value": [ + { + "@search.score": 1.0, + "id": "24c16e53-1bfd-4d6c-b4ce-b1f6f6f60000", + "qualifiedName": "mssql://exampleaccount.database.windows.net:3342/examplesqlmidb/dbo/exampledata", + "name": "exampledata", + "description": null, + "owner": null, + "entityType": "azure_sql_mi_table", + "classification": [], + "label": [], + "assetType": [ + "Azure SQL Managed Instance" + ], + "term": [], + "contact": [] + }, + { + "@search.score": 1.0, + "id": "d7b516fc-5d38-40f8-baeb-72f6f6f60000", + "qualifiedName": "mssql://exampleaccount.database.windows.net:3342/examplesqlmidb/dbo/exampledata2", + "name": "exampledata2", + "description": null, + "owner": null, + "entityType": "azure_sql_mi_table", + "classification": [], + "label": [], + "assetType": [ + "Azure SQL Managed Instance" + ], + "term": [], + "contact": [] + } + ] + } + } + }, + "title": "Discovery_Query_Facet", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_FileExtension.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_FileExtension.json new file mode 100644 index 000000000000..0b7fee10f958 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_FileExtension.json @@ -0,0 +1,62 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": null, + "limit": 10, + "filter": { + "and": [ + { + "fileExtension": "txt" + } + ] + } + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "continuationToken": "eyJzZXNzaW9uSWQiOiI5ZWRiYmEzNC0wYmM0LTQxNGEtOTY2NC01OGM2ZTBkMzI3ODYiLCJvZmZzZXQiOjI1LCJyZXF1ZXN0SGFzaCI6IjZiMmFjMTlmMGExZjlmMjY2Nzc0ZDdhZDczNTE3OWJmIn0=", + "@search.count": 49, + "@search.count.approximate": false, + "value": [ + { + "@search.score": 1.0, + "id": "bfecbcc3-1838-45fe-96d6-112de8a170f9", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/exampledata.txt", + "name": "exampledata.txt", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + }, + { + "@search.score": 1.0, + "id": "14d857b9-e2c1-4118-8bfa-12e53ae6ce7f", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/exampledata.txt", + "name": "exampledata.txt", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + } + ] + } + } + }, + "title": "Discovery_Query_FileExtension", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_GlossaryTerm.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_GlossaryTerm.json new file mode 100644 index 000000000000..1af1169192d0 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_GlossaryTerm.json @@ -0,0 +1,96 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": "", + "limit": 10, + "filter": { + "and": [ + { + "objectType": "Glossary terms" + }, + { + "or": [ + { + "glossaryType": "AtlasGlossary" + }, + { + "glossaryType": "AtlasGlossaryTerm" + } + ] + } + ] + }, + "facets": [ + { + "facet": "termStatus", + "count": 10, + "sort": { + "count": "desc" + } + }, + { + "facet": "termTemplate", + "count": 10, + "sort": { + "count": "desc" + } + } + ] + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "@search.count": 2, + "@search.count.approximate": false, + "value": [ + { + "@search.score": 1.0, + "objectType": "Glossary terms", + "glossaryType": "AtlasGlossaryTerm", + "id": "b1e51cc4-9249-4c81-bbc7-e2f3117706f3", + "name": "termSample1", + "glossary": "DefaultGlossary", + "longDescription": "it is the definition of the term", + "termStatus": "Approved", + "termTemplate": [ + "termTemplateSample" + ], + "createTime": 1625819659805, + "updateTime": 1625819659805, + "qualifiedName": "termSample1@DefaultGlossary" + }, + { + "@search.score": 1.0, + "objectType": "Glossary terms", + "glossaryType": "AtlasGlossary", + "id": "b28f35e4-fcd4-43ca-91a3-daf432c87156", + "name": "DefaultGlossary", + "longDescription": "it is the definition of the glossary", + "createTime": 1625819658745, + "updateTime": 1640656877302, + "qualifiedName": "DefaultGlossary" + } + ], + "@search.facets": { + "termTemplate": [ + { + "count": 1, + "value": "termTemplateSample" + } + ], + "termStatus": [ + { + "count": 1, + "value": "Approved" + } + ] + } + } + } + }, + "title": "Discovery_Query_GlossaryTerm", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Id.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Id.json new file mode 100644 index 000000000000..1a983534fbce --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Id.json @@ -0,0 +1,45 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": null, + "limit": 10, + "filter": { + "and": [ + { + "id": "bfecbcc3-1838-45fe-96d6-112de8a170f9" + } + ] + } + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "@search.count": 1, + "@search.count.approximate": false, + "value": [ + { + "@search.score": 1.0, + "id": "bfecbcc3-1838-45fe-96d6-112de8a170f9", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/exampledata.txt", + "name": "exampledata.txt", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + } + ] + } + } + }, + "title": "Discovery_Query_Id", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Not.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Not.json new file mode 100644 index 000000000000..4c6b90d682c4 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Not.json @@ -0,0 +1,60 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": null, + "limit": 10, + "filter": { + "not": { + "classification": "MICROSOFT.SYSTEM.TEMP_FILE" + } + } + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "continuationToken": "eyJzZXNzaW9uSWQiOiI5ZWRiYmEzNC0wYmM0LTQxNGEtOTY2NC01OGM2ZTBkMzI3ODYiLCJvZmZzZXQiOjI1LCJyZXF1ZXN0SGFzaCI6IjZiMmFjMTlmMGExZjlmMjY2Nzc0ZDdhZDczNTE3OWJmIn0=", + "@search.count": 5158, + "@search.count.approximate": false, + "value": [ + { + "@search.score": 1.0, + "id": "11fd6e94-2dc6-4ebd-822c-caf6f6f60000", + "qualifiedName": "mssql://exampleaccount.database.windows.net:3342/exampledb/dbo/exampledata", + "name": "exampledata", + "description": null, + "owner": null, + "entityType": "azure_sql_mi_table", + "classification": [], + "label": [], + "assetType": [ + "Azure SQL Managed Instance" + ], + "term": [], + "contact": [] + }, + { + "@search.score": 1.0, + "id": "1af82c87-798c-41a2-abab-93f6f6f60000", + "qualifiedName": "mssql://exampleaccount.database.windows.net:3342/exampledb/dbo/exampledata2", + "name": "exampledata2", + "description": null, + "owner": null, + "entityType": "azure_sql_mi_table", + "classification": [], + "label": [], + "assetType": [ + "Azure SQL Managed Instance" + ], + "term": [], + "contact": [] + } + ] + } + } + }, + "title": "Discovery_Query_Not", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_ObjectType.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_ObjectType.json new file mode 100644 index 000000000000..f332749b05ee --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_ObjectType.json @@ -0,0 +1,75 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": null, + "limit": 10, + "filter": { + "or": [ + { + "objectType": "Dashboards" + }, + { + "objectType": "Data pipelines" + }, + { + "objectType": "Files" + }, + { + "objectType": "Folders" + }, + { + "objectType": "Glossary terms" + }, + { + "objectType": "Reports" + }, + { + "objectType": "Stored procedures" + }, + { + "objectType": "Tables" + } + ] + } + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "@search.count": 2, + "@search.count.approximate": false, + "value": [ + { + "@search.score": 1.0, + "objectType": "Tables", + "id": "24c16e53-1bfd-4d6c-b4ce-b1f6f6f60000", + "entityType": "azure_sql_mi_table", + "name": "exampledata1", + "qualifiedName": "mssql://exampleaccount.database.windows.net:3342/examplesqlmidb/dbo/exampledata1", + "assetType": [ + "Azure SQL Managed Instance" + ] + }, + { + "@search.score": 1.0, + "objectType": "Glossary terms", + "id": "b1e51cc4-9249-4c81-bbc7-e2f3117706f3", + "glossaryType": "AtlasGlossaryTerm", + "name": "termSample1", + "glossary": "DefaultGlossary", + "longDescription": "it is the definition of the term", + "termStatus": "Approved", + "termTemplate": [ + "termTemplateSample" + ], + "qualifiedName": "termSample1@DefaultGlossary" + } + ] + } + } + }, + "title": "Discovery_Query_ObjectType", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_PaginationContinuationPage.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_PaginationContinuationPage.json new file mode 100644 index 000000000000..cbe86e93e8fa --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_PaginationContinuationPage.json @@ -0,0 +1,111 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": "exampledata", + "filter": { + "and": [ + { + "objectType": "Files" + }, + { + "entityType": "azure_blob_path" + } + ] + }, + "limit": 2, + "continuationToken": "eyJzZXNzaW9uSWQiOiI5ZWRiYmEzNC0wYmM0LTQxNGEtOTY2NC01OGM2ZTBkMzI3ODYiLCJvZmZzZXQiOjI1LCJyZXF1ZXN0SGFzaCI6IjZiMmFjMTlmMGExZjlmMjY2Nzc0ZDdhZDczNTE3OWJmIn0=", + "orderby": [ + { + "name": "ASC" + }, + { + "updateTime": "DESC" + } + ], + "facets": [ + { + "facet": "assetType", + "count": 0, + "sort": { + "count": "desc" + } + }, + { + "facet": "classification", + "count": 10, + "sort": { + "count": "desc" + } + }, + { + "facet": "contactId", + "count": 10, + "sort": { + "count": "desc" + } + }, + { + "facet": "label", + "count": 10, + "sort": { + "count": "desc" + } + }, + { + "facet": "term", + "count": 10, + "sort": { + "count": "desc" + } + } + ] + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "@search.count": 6, + "@search.count.approximate": false, + "continuationToken": "ZXlKelpYTnphVzl1U1dRaU9pSTVaV1JpWW1Fek5DMHdZbU0wTFRReE5HRXRPVFkyTkMwMU9HTTJaVEJrTXpJM09EWWlMQ0p2Wm1aelpYUWlPakkxTENKeVpYRjFaWE4wU0dGemFDSTZJalppTW1Gak1UbG1NR0V4WmpsbU1qWTJOemMwWkRkaFpEY3pOVEUzT1dKbUluMD0=", + "value": [ + { + "@search.score": 1.0, + "id": "bfecbcc3-1838-45fe-96d6-112de8a170f9", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/exampledata1.txt", + "name": "exampledata1.txt", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + }, + { + "@search.score": 1.0, + "id": "14d857b9-e2c1-4118-8bfa-12e53ae6ce7f", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/exampledata2.txt", + "name": "exampledata2.txt", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + } + ] + } + } + }, + "title": "Discovery_Query_PaginationContinuationPage", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_PaginationFirstPage.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_PaginationFirstPage.json new file mode 100644 index 000000000000..fe5522da8ebf --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_PaginationFirstPage.json @@ -0,0 +1,110 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": "exampledata", + "filter": { + "and": [ + { + "objectType": "Files" + }, + { + "entityType": "azure_blob_path" + } + ] + }, + "limit": 2, + "orderby": [ + { + "name": "ASC" + }, + { + "updateTime": "DESC" + } + ], + "facets": [ + { + "facet": "assetType", + "count": 0, + "sort": { + "count": "desc" + } + }, + { + "facet": "classification", + "count": 10, + "sort": { + "count": "desc" + } + }, + { + "facet": "contactId", + "count": 10, + "sort": { + "count": "desc" + } + }, + { + "facet": "label", + "count": 10, + "sort": { + "count": "desc" + } + }, + { + "facet": "term", + "count": 10, + "sort": { + "count": "desc" + } + } + ] + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "@search.count": 6, + "@search.count.approximate": false, + "continuationToken": "eyJzZXNzaW9uSWQiOiI5ZWRiYmEzNC0wYmM0LTQxNGEtOTY2NC01OGM2ZTBkMzI3ODYiLCJvZmZzZXQiOjI1LCJyZXF1ZXN0SGFzaCI6IjZiMmFjMTlmMGExZjlmMjY2Nzc0ZDdhZDczNTE3OWJmIn0=", + "value": [ + { + "@search.score": 1.0, + "id": "bfecbcc3-1838-45fe-96d6-112de8a170f9", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/exampledata1.txt", + "name": "exampledata1.txt", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + }, + { + "@search.score": 1.0, + "id": "14d857b9-e2c1-4118-8bfa-12e53ae6ce7f", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/exampledata2.txt", + "name": "exampledata2.txt", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + } + ] + } + } + }, + "title": "Discovery_Query_PaginationFirstPage", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_PaginationLastPage.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_PaginationLastPage.json new file mode 100644 index 000000000000..4e64dd33405e --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_PaginationLastPage.json @@ -0,0 +1,110 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": "exampledata", + "filter": { + "and": [ + { + "objectType": "Files" + }, + { + "entityType": "azure_blob_path" + } + ] + }, + "limit": 2, + "continuationToken": "ZXlKelpYTnphVzl1U1dRaU9pSTVaV1JpWW1Fek5DMHdZbU0wTFRReE5HRXRPVFkyTkMwMU9HTTJaVEJrTXpJM09EWWlMQ0p2Wm1aelpYUWlPakkxTENKeVpYRjFaWE4wU0dGemFDSTZJalppTW1Gak1UbG1NR0V4WmpsbU1qWTJOemMwWkRkaFpEY3pOVEUzT1dKbUluMD0=", + "orderby": [ + { + "name": "ASC" + }, + { + "updateTime": "DESC" + } + ], + "facets": [ + { + "facet": "assetType", + "count": 0, + "sort": { + "count": "desc" + } + }, + { + "facet": "classification", + "count": 10, + "sort": { + "count": "desc" + } + }, + { + "facet": "contactId", + "count": 10, + "sort": { + "count": "desc" + } + }, + { + "facet": "label", + "count": 10, + "sort": { + "count": "desc" + } + }, + { + "facet": "term", + "count": 10, + "sort": { + "count": "desc" + } + } + ] + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "@search.count": 6, + "@search.count.approximate": false, + "value": [ + { + "@search.score": 1.0, + "id": "bfecbcc3-1838-45fe-96d6-112de8a170f9", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/exampledata1.txt", + "name": "exampledata1.txt", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + }, + { + "@search.score": 1.0, + "id": "14d857b9-e2c1-4118-8bfa-12e53ae6ce7f", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/exampledata2.txt", + "name": "exampledata2.txt", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + } + ] + } + } + }, + "title": "Discovery_Query_PaginationLastPage", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_SystemTime.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_SystemTime.json new file mode 100644 index 000000000000..d2196fa7ea91 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_SystemTime.json @@ -0,0 +1,55 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": null, + "limit": 10, + "filter": { + "or": [ + { + "createTime": { + "operator": "lt", + "timeThreshold": 1545580800000 + } + }, + { + "updateTime": "LAST_24H|LAST_7D|LAST_30D|LAST_365D|MORE_THAN_365D" + } + ] + } + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "@search.count": 2, + "@search.count.approximate": false, + "value": [ + { + "@search.score": 1.0, + "id": "55ceaddf-30ac-40f3-b656-71f6f6f60000", + "entityType": "azure_sql_mi_table", + "name": "exampleData_v1", + "qualifiedName": "mssql://exampleaccount.database.windows.net:3342/examplesqlmidb/dbo/exampleData_v1", + "assetType": [ + "Azure SQL Managed Instance" + ] + }, + { + "@search.score": 1.0, + "id": "89416661-5269-4f3d-ba35-e0f6f6f60000", + "entityType": "azure_sql_mi_table", + "name": "exampleData_v2", + "qualifiedName": "mssql://exampleaccount.database.windows.net:3342/examplesqlmidb/dbo/exampleData_v2", + "assetType": [ + "Azure SQL Managed Instance" + ] + } + ] + } + } + }, + "title": "Discovery_Query_SystemTime", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Taxonomy.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Taxonomy.json new file mode 100644 index 000000000000..f2f278e5c48b --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Taxonomy.json @@ -0,0 +1,94 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": "exampledata", + "filter": { + "and": [ + { + "objectType": "Files" + }, + { + "not": { + "or": [ + { + "attributeName": "size", + "operator": "eq", + "attributeValue": 0 + }, + { + "attributeName": "fileSize", + "operator": "eq", + "attributeValue": 0 + } + ] + } + }, + { + "not": { + "classification": "MICROSOFT.SYSTEM.TEMP_FILE" + } + } + ] + }, + "limit": 10, + "taxonomySetting": { + "assetTypes": [ + "Azure Blob Storage" + ], + "facet": { + "count": 10, + "sort": { + "count": "desc" + } + } + } + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "continuationToken": "eyJzZXNzaW9uSWQiOiI5ZWRiYmEzNC0wYmM0LTQxNGEtOTY2NC01OGM2ZTBkMzI3ODYiLCJvZmZzZXQiOjI1LCJyZXF1ZXN0SGFzaCI6IjZiMmFjMTlmMGExZjlmMjY2Nzc0ZDdhZDczNTE3OWJmIn0=", + "@search.count": 339, + "@search.count.approximate": false, + "value": [ + { + "@search.score": 1.0, + "id": "bfecbcc3-1838-45fe-96d6-112de8a170f9", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/exampledata1.txt", + "name": "exampledata1.txt", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + }, + { + "@search.score": 1.0, + "id": "14d857b9-e2c1-4118-8bfa-12e53ae6ce7f", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/exampledata2.txt", + "name": "exampledata2.txt", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + } + ] + } + } + }, + "title": "Discovery_Query_Taxonomy", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_TermAssignment.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_TermAssignment.json new file mode 100644 index 000000000000..0c24709432b3 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_TermAssignment.json @@ -0,0 +1,59 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": "", + "limit": 3, + "filter": { + "or": [ + { + "term": "ExampleTerm" + }, + { + "term": "ExampleTerm", + "glossary": "GlossaryName" + }, + { + "termGuid": "" + } + ] + } + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "@search.count": 1, + "@search.count.approximate": false, + "value": [ + { + "@search.score": 1.0, + "id": "b20ac13a-7883-4376-b076-bac9f8f214a8", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplecontainer", + "name": "examplecontainer", + "description": null, + "owner": null, + "entityType": "azure_blob_container", + "classification": [], + "assetType": [ + "Azure Blob Storage" + ], + "term": [ + { + "name": "ExampleTerm", + "glossaryName": "Glossary" + } + ], + "contact": [], + "label": [ + "Example.Label" + ] + } + ] + } + } + }, + "title": "Discovery_Query_TermAssignment", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Type.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Type.json new file mode 100644 index 000000000000..48480e13fc17 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Query_Type.json @@ -0,0 +1,66 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": null, + "limit": 10, + "filter": { + "and": [ + { + "entityType": "azure_blob_path", + "includeSubTypes": false + } + ] + } + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "continuationToken": "eyJzZXNzaW9uSWQiOiI5ZWRiYmEzNC0wYmM0LTQxNGEtOTY2NC01OGM2ZTBkMzI3ODYiLCJvZmZzZXQiOjI1LCJyZXF1ZXN0SGFzaCI6IjZiMmFjMTlmMGExZjlmMjY2Nzc0ZDdhZDczNTE3OWJmIn0=", + "@search.count": 221, + "value": [ + { + "@search.score": 1.0, + "id": "1d797ddf-47bf-4151-8fe8-918590d62e70", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/exampledata.csv", + "name": "exampledata.csv", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [ + "Example.Label" + ], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + }, + { + "@search.score": 1.0, + "id": "d3e83b17-c730-4898-94c8-58579cda04f6", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/exampledata2.csv", + "name": "exampledata2.csv", + "description": null, + "owner": null, + "entityType": "azure_blob_path", + "classification": [], + "label": [ + "Example.Label" + ], + "assetType": [ + "Azure Blob Storage" + ], + "term": [], + "contact": [] + } + ] + } + } + }, + "title": "Discovery_Query_Type", + "operationId": "Discovery_Query" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Suggest.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Suggest.json new file mode 100644 index 000000000000..3ff80bee52ec --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Discovery_Suggest.json @@ -0,0 +1,60 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "keywords": "exampledata", + "filter": { + "and": [ + { + "entityType": "azure_blob_path", + "includeSubTypes": false + } + ] + }, + "limit": 10 + }, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "@search.text": "exampledata.csv", + "@search.score": 9.81402, + "description": "Example Description", + "id": "af7a01b0-1b14-4ab6-83a5-12cb11a717ed", + "name": "exampledata.csv", + "owner": "$superuser", + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplepath/exampledata.csv", + "entityType": "azure_blob_path", + "assetType": [ + "Azure Blob Storage" + ], + "classification": [ + "MICROSOFT.GOVERNMENT.US.PASSPORT_NUMBER" + ], + "contact": [ + { + "id": "8a597ffc-6993-4772-ac25-86b7251e1234", + "info": "Example Info", + "contactType": "Expert" + } + ], + "label": [ + "Example.Label" + ], + "term": [ + { + "name": "Example Term", + "glossaryName": "Glossary" + } + ] + } + ] + } + } + }, + "title": "Discovery_Suggest", + "operationId": "Discovery_Suggest" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddClassificationToEntityByGuids.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddClassificationToEntityByGuids.json new file mode 100644 index 000000000000..b94ab95331ec --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddClassificationToEntityByGuids.json @@ -0,0 +1,21 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "classification": { + "typeName": "MICROSOFT.FINANCIAL.US.ABA_ROUTING_NUMBER", + "attributes": {}, + "validityPeriods": [] + }, + "entityGuids": [ + "784c0f2f-afd2-e26b-f9cb-984f6c2c5021", + "b4ebc8be-cef4-860a-bee9-28cc34cb5caa" + ] + } + }, + "responses": { + "204": {} + }, + "title": "Entity_AddClassificationToEntityByGuids", + "operationId": "Entity_AddClassification" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddClassifications.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddClassifications.json new file mode 100644 index 000000000000..5ab64b05faac --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddClassifications.json @@ -0,0 +1,21 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "cc0730ba-9b30-41f0-6953-559d17626d2b", + "body": [ + { + "typeName": "MICROSOFT.FINANCIAL.US.ABA_ROUTING_NUMBER", + "entityGuid": "cc0730ba-9b30-41f0-6953-559d17626d2b" + }, + { + "typeName": "MICROSOFT.FINANCIAL.CREDIT_CARD_NUMBER", + "entityGuid": "cc0730ba-9b30-41f0-6953-559d17626d2b" + } + ] + }, + "responses": { + "204": {} + }, + "title": "Entity_AddClassifications", + "operationId": "Entity_AddClassifications" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddClassificationsByUniqueAttribute.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddClassificationsByUniqueAttribute.json new file mode 100644 index 000000000000..0a724e78e134 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddClassificationsByUniqueAttribute.json @@ -0,0 +1,20 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "typeName": "azure_storage_account", + "attr:qualifiedName": "https://exampleaccount.core.windows.net", + "body": [ + { + "typeName": "MICROSOFT.FINANCIAL.US.ABA_ROUTING_NUMBER" + }, + { + "typeName": "MICROSOFT.FINANCIAL.CREDIT_CARD_NUMBER" + } + ] + }, + "responses": { + "204": {} + }, + "title": "Entity_AddClassificationsByUniqueAttribute", + "operationId": "Entity_AddClassificationsByUniqueAttribute" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddCustomAttribute.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddCustomAttribute.json new file mode 100644 index 000000000000..5e50da3bc1c7 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddCustomAttribute.json @@ -0,0 +1,58 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "api-version": "2023-09-01", + "body": { + "referredEntities": {}, + "entity": { + "typeName": "azure_storage_account", + "attributes": { + "owner": "ExampleOwner", + "modifiedTime": 0, + "createTime": 0, + "qualifiedName": "https://exampleaccount.core.windows.net", + "name": "ExampleStorageAccount", + "description": null, + "publicAccessLevel": null + }, + "customAttributes": { + "custAttr1": "attr1", + "custAttr2": "attr2" + } + } + } + }, + "responses": { + "200": { + "body": { + "mutatedEntities": { + "CREATE": [ + { + "typeName": "azure_storage_account", + "attributes": { + "owner": "ExampleOwner", + "createTime": 0, + "qualifiedName": "https://exampleaccount.core.windows.net", + "name": "ExampleStorageAccount" + }, + "lastModifiedTS": "1", + "guid": "c696b935-2c76-4208-bc0d-8864553a67f1", + "displayText": "ExampleStorageAccount", + "classificationNames": [], + "classifications": [], + "meaningNames": [], + "meanings": [], + "isIncomplete": false, + "labels": [] + } + ] + }, + "guidAssignments": { + "-16806536444330": "c696b935-2c76-4208-bc0d-8864553a67f1" + } + } + } + }, + "title": "Entity_AddCustomAttribute", + "operationId": "Entity_CreateOrUpdate" +} diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Label.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddLabel.json similarity index 73% rename from specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Label.json rename to specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddLabel.json index 62668d54234d..6c8c8ccf153d 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Label.json +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddLabel.json @@ -9,5 +9,7 @@ }, "responses": { "204": {} - } + }, + "title": "Entity_AddLabel", + "operationId": "Entity_AddLabel" } diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddLabelsByUniqueAttribute.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddLabelsByUniqueAttribute.json new file mode 100644 index 000000000000..3a2bc5a3f537 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddLabelsByUniqueAttribute.json @@ -0,0 +1,15 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "typeName": "Asset", + "attr:qualifiedName": "https://asset1", + "body": [ + "label3" + ] + }, + "responses": { + "204": {} + }, + "title": "Entity_AddLabelsByUniqueAttribute", + "operationId": "Entity_AddLabelsByUniqueAttribute" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddOrUpdate_BusinessAttribute.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddOrUpdate_BusinessAttribute.json new file mode 100644 index 000000000000..f91a2897c1e2 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddOrUpdate_BusinessAttribute.json @@ -0,0 +1,15 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "02c373fe-2823-4be3-97fa-55180a9faa06", + "businessMetadataName": "myBizMetaData1", + "body": { + "bizAttr1": "bizAttr1" + } + }, + "responses": { + "204": {} + }, + "title": "Entity_AddOrUpdate_BusinessAttribute", + "operationId": "Entity_AddOrUpdateBusinessMetadataAttributes" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddOrUpdate_BusinessMetadata.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddOrUpdate_BusinessMetadata.json new file mode 100644 index 000000000000..4141a16cc255 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_AddOrUpdate_BusinessMetadata.json @@ -0,0 +1,16 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "02c373fe-2823-4be3-97fa-55180a9faa06", + "body": { + "myBizMetadata1": { + "bizAttr1": "myBizMetaData1.bizAttr1" + } + } + }, + "responses": { + "204": {} + }, + "title": "Entity_AddOrUpdate_BusinessMetadata", + "operationId": "Entity_AddOrUpdateBusinessMetadata" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_BulkCreateOrUpdate.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_BulkCreateOrUpdate.json new file mode 100644 index 000000000000..81eb02f76d2e --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_BulkCreateOrUpdate.json @@ -0,0 +1,106 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "referredEntities": {}, + "entities": [ + { + "typeName": "azure_storage_account", + "attributes": { + "owner": "ExampleOwner", + "modifiedTime": 0, + "createTime": 0, + "qualifiedName": "exampleaccount1", + "name": "ExampleStorageAccount1", + "description": null, + "publicAccessLevel": null + }, + "contacts": { + "Expert": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Expert Info" + } + ], + "Owner": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Owner Info" + } + ] + }, + "status": "ACTIVE", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "version": 0 + }, + { + "typeName": "azure_storage_account", + "attributes": { + "owner": "ExampleOwner", + "modifiedTime": 0, + "createTime": 0, + "qualifiedName": "exampleaccount2", + "name": "ExampleStorageAccount2", + "description": "Example Description", + "publicAccessLevel": null + }, + "contacts": { + "Expert": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Expert Info" + } + ], + "Owner": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Owner Info" + } + ] + }, + "status": "ACTIVE", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "version": 0 + } + ] + } + }, + "responses": { + "200": { + "body": { + "mutatedEntities": { + "UPDATE": [ + { + "typeName": "azure_storage_account", + "attributes": { + "qualifiedName": "exampleaccount2" + }, + "lastModifiedTS": "2", + "guid": "b2f9c306-cf65-4bb0-878e-cfaafde156b1", + "status": "ACTIVE" + } + ], + "CREATE": [ + { + "typeName": "azure_storage_account", + "attributes": { + "qualifiedName": "exampleaccount1" + }, + "lastModifiedTS": "1", + "guid": "321493e3-3fb7-4b3e-9df7-3b69154174c2", + "status": "ACTIVE" + } + ] + }, + "guidAssignments": { + "-9514774903018192": "321493e3-3fb7-4b3e-9df7-3b69154174c2", + "-9514774903018193": "b2f9c306-cf65-4bb0-878e-cfaafde156b1" + } + } + } + }, + "title": "Entity_BulkCreateOrUpdate", + "operationId": "Entity_BulkCreateOrUpdate" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_BulkDelete.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_BulkDelete.json new file mode 100644 index 000000000000..3b8c27b9b5fc --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_BulkDelete.json @@ -0,0 +1,37 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": [ + "18e06957-e265-967a-07f1-e14e2ab8940f", + "cc0730ba-9b30-41f0-6953-559d17626d2b" + ] + }, + "responses": { + "200": { + "body": { + "mutatedEntities": { + "DELETE": [ + { + "typeName": "azure_blob_container", + "attributes": { + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplecontainer" + }, + "guid": "18e06957-e265-967a-07f1-e14e2ab8940f", + "status": "ACTIVE" + }, + { + "typeName": "azure_blob_container", + "attributes": { + "qualifiedName": "https://exampleaccount.blob.core.windows.net/examplecontainer2" + }, + "guid": "cc0730ba-9b30-41f0-6953-559d17626d2b", + "status": "ACTIVE" + } + ] + } + } + } + }, + "title": "Entity_BulkDelete", + "operationId": "Entity_BulkDelete" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_BulkSetClassifications.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_BulkSetClassifications.json new file mode 100644 index 000000000000..ceac402f49a7 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_BulkSetClassifications.json @@ -0,0 +1,41 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "guidHeaderMap": { + "9fb74c11-ac48-4650-95bc-760665c5bd92": { + "attributes": { + "qualifiedName": "https://exampleaccount1.core.windows.net" + }, + "typeName": "azure_storage_account", + "classifications": [ + { + "typeName": "MICROSOFT.PERSONAL.EMAIL" + } + ] + }, + "7fcc43ab-55ea-45d4-9971-ce0443cb10bb": { + "attributes": { + "qualifiedName": "https://exampleaccount2.core.windows.net" + }, + "typeName": "azure_storage_account", + "classifications": [ + { + "typeName": "MICROSOFT.PERSONAL.IPADDRESS" + } + ] + } + } + } + }, + "responses": { + "200": { + "body": [ + "Add:9fb74c11-ac48-4650-95bc-760665c5bd92:azure_storage_account:qualifiedName -> MICROSOFT.PERSONAL.EMAIL:(Done)", + "Update:7fcc43ab-55ea-45d4-9971-ce0443cb10bb:azure_storage_account:qualifiedName -> MICROSOFT.PERSONAL.IPADDRESS:(Done)" + ] + } + }, + "title": "Entity_BulkSetClassifications", + "operationId": "Entity_BulkSetClassifications" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_Create.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_Create.json new file mode 100644 index 000000000000..cf8647830754 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_Create.json @@ -0,0 +1,63 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "api-version": "2023-09-01", + "body": { + "referredEntities": {}, + "entity": { + "typeName": "azure_storage_account", + "attributes": { + "owner": "ExampleOwner", + "modifiedTime": 0, + "createTime": 0, + "qualifiedName": "https://exampleaccount.core.windows.net", + "name": "ExampleStorageAccount", + "description": null, + "publicAccessLevel": null + }, + "contacts": { + "Expert": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Expert Info" + } + ], + "Owner": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Owner Info" + } + ] + }, + "status": "ACTIVE", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "version": 0 + } + } + }, + "responses": { + "200": { + "body": { + "mutatedEntities": { + "CREATE": [ + { + "typeName": "azure_storage_account", + "attributes": { + "qualifiedName": "https://exampleaccount.core.windows.net" + }, + "lastModifiedTS": "1", + "guid": "38d3c41f-300c-434e-8dad-0b1a7cb5efd6", + "status": "ACTIVE" + } + ] + }, + "guidAssignments": { + "-9514774903018162": "38d3c41f-300c-434e-8dad-0b1a7cb5efd6" + } + } + } + }, + "title": "Entity_Create", + "operationId": "Entity_CreateOrUpdate" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_Delete.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_Delete.json new file mode 100644 index 000000000000..9e6ab2104d44 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_Delete.json @@ -0,0 +1,29 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "fd279eb4-f6c3-1b0b-ad67-e4f8abd2972f" + }, + "responses": { + "200": { + "body": { + "mutatedEntities": { + "DELETE": [ + { + "guid": "fd279eb4-f6c3-1b0b-ad67-e4f8abd2972f", + "status": "ACTIVE", + "lastModifiedTS": "2", + "attributes": { + "owner": "ExampleOwner", + "qualifiedName": "https://exampleaccount.core.windows.net", + "name": "ExampleStorageAaccount" + }, + "typeName": "azure_storage_account" + } + ] + } + } + } + }, + "title": "Entity_Delete", + "operationId": "Entity_Delete" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_DeleteByUniqueAttribute.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_DeleteByUniqueAttribute.json new file mode 100644 index 000000000000..3df1ba7cee96 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_DeleteByUniqueAttribute.json @@ -0,0 +1,35 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "typeName": "azure_storage_account", + "attr:qualifiedName": "https://exampleaccount.core.windows.net" + }, + "responses": { + "200": { + "body": { + "mutatedEntities": { + "DELETE": [ + { + "classificationNames": [], + "displayText": "Example Name", + "guid": "e0ba3f20-f3b5-4d52-b769-ed35a02df60a", + "meaningNames": [], + "meanings": [], + "status": "ACTIVE", + "lastModifiedTS": "1", + "attributes": { + "owner": "ExampleOwner", + "createTime": 0, + "qualifiedName": "https://exampleaccount.core.windows.net", + "name": "ExampleName" + }, + "typeName": "azure_storage_account" + } + ] + } + } + } + }, + "title": "Entity_DeleteByUniqueAttribute", + "operationId": "Entity_DeleteByUniqueAttribute" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_Get.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_Get.json new file mode 100644 index 000000000000..4c89ab5c8872 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_Get.json @@ -0,0 +1,64 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "5cf8a9e5-c9fd-abe0-2e8c-d40024263dcb", + "minExtInfo": true + }, + "responses": { + "200": { + "body": { + "referredEntities": {}, + "entity": { + "typeName": "column", + "attributes": { + "owner": null, + "qualifiedName": "adl://exampleaccount.azuredatalakestore.net/123/1/DP_TFS/CBT/Extensions/DTTP.targets#:xml/Project/Target/XmlPeek/@XmlInputPath", + "name": "~XmlInputPath", + "description": null, + "type": "string" + }, + "guid": "5cf8a9e5-c9fd-abe0-2e8c-d40024263dcb", + "status": "ACTIVE", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1553072455110, + "updateTime": 1553072455110, + "version": 0, + "relationshipAttributes": { + "schema": [], + "inputToProcesses": [], + "composeSchema": { + "guid": "cc6652ae-dc6d-90c9-1899-252eabc0e929", + "typeName": "tabular_schema", + "displayText": "tabular_schema", + "relationshipGuid": "5a4510d4-57d0-467c-888f-4b61df42702b", + "relationshipStatus": "ACTIVE", + "relationshipAttributes": { + "typeName": "tabular_schema_columns" + } + }, + "meanings": [], + "outputFromProcesses": [], + "tabular_schema": null + }, + "contacts": { + "Expert": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Expert Info" + } + ], + "Owner": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Owner Info" + } + ] + } + } + } + } + }, + "title": "Entity_Get", + "operationId": "Entity_Get" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_GetByUniqueAttributes.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_GetByUniqueAttributes.json new file mode 100644 index 000000000000..f7ebf7d7d013 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_GetByUniqueAttributes.json @@ -0,0 +1,38 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "typeName": "azure_storage_account", + "attr:qualifiedName": "https://exampleaccount.core.windows.net", + "minExtInfo": true + }, + "responses": { + "200": { + "body": { + "entity": { + "createTime": 1605703532110, + "createdBy": "8c062c84-5d25-449f-a990-9d8ab70b8ec7", + "guid": "e0ba3f20-f3b5-4d52-b769-ed35a02df60a", + "relationshipAttributes": { + "services": [], + "meanings": [] + }, + "status": "ACTIVE", + "updateTime": 1605703532110, + "updatedBy": "8c062c84-5d25-449f-a990-9d8ab70b8ec7", + "lastModifiedTS": "2", + "version": 0.0, + "attributes": { + "owner": "ExampleOwner", + "qualifiedName": "https://exampleaccount.core.windows.net", + "createTime": 0, + "name": "ExampleNewName" + }, + "typeName": "azure_storage_account" + }, + "referredEntities": {} + } + } + }, + "title": "Entity_GetByUniqueAttributes", + "operationId": "Entity_GetByUniqueAttributes" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_GetClassification.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_GetClassification.json new file mode 100644 index 000000000000..968a4d7e0fcc --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_GetClassification.json @@ -0,0 +1,19 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "9347abc5-7b86-4b82-a1e2-ad77c7c3cac3", + "classificationName": "MICROSOFT.PERSONAL.DATE_OF_BIRTH" + }, + "responses": { + "200": { + "body": { + "typeName": "MICROSOFT.PERSONAL.DATE_OF_BIRTH", + "lastModifiedTS": "1", + "entityGuid": "9347abc5-7b86-4b82-a1e2-ad77c7c3cac3", + "entityStatus": "ACTIVE" + } + } + }, + "title": "Entity_GetClassification", + "operationId": "Entity_GetClassification" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_GetClassifications.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_GetClassifications.json new file mode 100644 index 000000000000..ae0d81292c04 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_GetClassifications.json @@ -0,0 +1,24 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "67d26de6-771d-1a2d-cb2b-dec4dbd2a9bd" + }, + "responses": { + "200": { + "body": { + "list": [ + { + "typeName": "MICROSOFT.FINANCIAL.US.ABA_ROUTING_NUMBER", + "entityGuid": "67d26de6-771d-1a2d-cb2b-dec4dbd2a9bd" + } + ], + "startIndex": 0, + "pageSize": 1, + "totalCount": 1, + "sortType": "NONE" + } + } + }, + "title": "Entity_GetClassifications", + "operationId": "Entity_GetClassifications" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_GetHeader.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_GetHeader.json new file mode 100644 index 000000000000..029a55bbbb96 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_GetHeader.json @@ -0,0 +1,30 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "9fb74c11-ac48-4650-95bc-760665c5bd92" + }, + "responses": { + "200": { + "body": { + "classificationNames": [ + "MICROSOFT.PERSONAL.EMAIL" + ], + "displayText": "Example Storage Account", + "guid": "9fb74c11-ac48-4650-95bc-760665c5bd92", + "meaningNames": [], + "meanings": [], + "status": "ACTIVE", + "lastModifiedTS": "3", + "attributes": { + "owner": "ExampleOwner", + "createTime": 0, + "qualifiedName": "https://exampleaccount.core.windows.net", + "name": "ExampleStorageAccount" + }, + "typeName": "azure_storage_account" + } + } + }, + "title": "Entity_GetHeader", + "operationId": "Entity_GetHeader" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_GetSampleBusinessMetadataTemplate.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_GetSampleBusinessMetadataTemplate.json new file mode 100644 index 000000000000..34f5b284ae4b --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_GetSampleBusinessMetadataTemplate.json @@ -0,0 +1,13 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": "EntityType,EntityUniqueAttributeValue,BusinessAttributeName,BusinessAttributeValue,EntityUniqueAttributeName[optional]" + } + }, + "title": "Entity_GetSampleBusinessMetadataTemplate", + "operationId": "Entity_GetSampleBusinessMetadataTemplate" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_ImportBusinessMetadata.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_ImportBusinessMetadata.json new file mode 100644 index 000000000000..5717a38aa7c8 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_ImportBusinessMetadata.json @@ -0,0 +1,22 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "file": "---multipart-boundary\nContent-Disposition: form-data; name=\"file\"\nContent-Type: application/octet-stream\n\n---multipart-boundary--" + }, + "responses": { + "200": { + "body": { + "successImportInfoList": [ + { + "parentObjectName": "24a77100-1b3a-4c37-884e-7d4f591f5a64", + "childObjectName": "{myBizType1={bizAttr1=Awesome Attribute 1}}", + "importStatus": "SUCCESS", + "remarks": "" + } + ] + } + } + }, + "title": "Entity_ImportBusinessMetadata", + "operationId": "Entity_ImportBusinessMetadata" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_ListByGuids.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_ListByGuids.json new file mode 100644 index 000000000000..4f48451cdbbe --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_ListByGuids.json @@ -0,0 +1,117 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": [ + "784c0f2f-afd2-e26b-f9cb-984f6c2c5021", + "b4ebc8be-cef4-860a-bee9-28cc34cb5caa" + ], + "minExtInfo": true + }, + "responses": { + "200": { + "body": { + "referredEntities": {}, + "entities": [ + { + "typeName": "column", + "attributes": { + "owner": null, + "qualifiedName": "adl://exampleaccount.azuredatalakestore.net/123/1/DP_TFS/CBT/Extensions/DTTP.targets#:xml/Project/PropertyGroup/ExampleName1", + "name": "ExampleName1", + "description": null, + "type": "string" + }, + "guid": "784c0f2f-afd2-e26b-f9cb-984f6c2c5021", + "status": "ACTIVE", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1553072455110, + "updateTime": 1553072455110, + "version": 0, + "relationshipAttributes": { + "schema": [], + "inputToProcesses": [], + "composeSchema": { + "guid": "cc6652ae-dc6d-90c9-1899-252eabc0e929", + "typeName": "tabular_schema", + "displayText": "tabular_schema", + "relationshipGuid": "400fd8e4-97bd-45eb-a21c-880b4094ce5b", + "relationshipStatus": "ACTIVE", + "relationshipAttributes": { + "typeName": "tabular_schema_columns" + } + }, + "meanings": [], + "outputFromProcesses": [], + "tabular_schema": null + }, + "contacts": { + "Expert": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Expert Info" + } + ], + "Owner": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Owner Info" + } + ] + } + }, + { + "typeName": "column", + "attributes": { + "owner": null, + "qualifiedName": "adl://exampleaccount.azuredatalakestore.net/123/1/Experience/CBT/Extensions/CodeAnalysis.targets#:xml/Project/PropertyGroup/ExampleName2", + "name": "ExampleName2", + "description": null, + "type": "string" + }, + "guid": "b4ebc8be-cef4-860a-bee9-28cc34cb5caa", + "status": "ACTIVE", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1553072455110, + "updateTime": 1553072455110, + "version": 0, + "relationshipAttributes": { + "schema": [], + "inputToProcesses": [], + "composeSchema": { + "guid": "381dd3e6-dad5-7409-c21d-ea55b666e420", + "typeName": "tabular_schema", + "displayText": "tabular_schema", + "relationshipGuid": "0b652860-ab79-48cd-a0cf-0867fbba31a3", + "relationshipStatus": "ACTIVE", + "relationshipAttributes": { + "typeName": "tabular_schema_columns" + } + }, + "meanings": [], + "outputFromProcesses": [], + "tabular_schema": null + }, + "contacts": { + "Expert": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Expert Info" + } + ], + "Owner": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Owner Info" + } + ] + } + } + ] + } + } + }, + "title": "Entity_ListByGuids", + "operationId": "Entity_ListByGuids" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_ListByUniqueAttributes.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_ListByUniqueAttributes.json new file mode 100644 index 000000000000..176e6972162b --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_ListByUniqueAttributes.json @@ -0,0 +1,53 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "typeName": "azure_storage_account", + "attr_N:qualifiedName": "adl://exampleaccount.azuredatalakestore.net/123/1/DP_TFS/CBT/Extensions/DTTP.targets#:xml/Project/PropertyGroup/ExampleName1", + "minExtInfo": true + }, + "responses": { + "200": { + "body": { + "referredEntities": {}, + "entities": [ + { + "typeName": "column", + "attributes": { + "owner": null, + "qualifiedName": "adl://exampleaccount.azuredatalakestore.net/123/1/DP_TFS/CBT/Extensions/DTTP.targets#:xml/Project/PropertyGroup/ExampleName1", + "name": "ExampleName1", + "description": null, + "type": "string" + }, + "guid": "784c0f2f-afd2-e26b-f9cb-984f6c2c5021", + "status": "ACTIVE", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1553072455110, + "updateTime": 1553072455110, + "version": 0, + "relationshipAttributes": { + "schema": [], + "inputToProcesses": [], + "composeSchema": { + "guid": "cc6652ae-dc6d-90c9-1899-252eabc0e929", + "typeName": "tabular_schema", + "displayText": "tabular_schema", + "relationshipGuid": "400fd8e4-97bd-45eb-a21c-880b4094ce5b", + "relationshipStatus": "ACTIVE", + "relationshipAttributes": { + "typeName": "tabular_schema_columns" + } + }, + "meanings": [], + "outputFromProcesses": [], + "tabular_schema": null + } + } + ] + } + } + }, + "title": "Entity_ListByUniqueAttributes", + "operationId": "Entity_ListByUniqueAttributes" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_MoveEntitiesToCollection.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_MoveEntitiesToCollection.json new file mode 100644 index 000000000000..a9d546dacff1 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_MoveEntitiesToCollection.json @@ -0,0 +1,47 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "collectionId": "ExampleNewCollection", + "api-version": "2023-09-01", + "body": { + "entityGuids": [ + "321493e3-3fb7-4b3e-9df7-3b69154174c2", + "b2f9c306-cf65-4bb0-878e-cfaafde156b1" + ] + } + }, + "responses": { + "200": { + "body": { + "mutatedEntities": { + "UPDATE": [ + { + "typeName": "azure_storage_account", + "attributes": { + "qualifiedName": "exampleaccount" + }, + "lastModifiedTS": "3", + "guid": "b2f9c306-cf65-4bb0-878e-cfaafde156b1", + "status": "ACTIVE" + }, + { + "typeName": "azure_storage_account", + "attributes": { + "qualifiedName": "exampleaccount2" + }, + "lastModifiedTS": "2", + "guid": "321493e3-3fb7-4b3e-9df7-3b69154174c2", + "status": "ACTIVE" + } + ] + }, + "guidAssignments": { + "-9514774903018192": "321493e3-3fb7-4b3e-9df7-3b69154174c2", + "-9514774903018193": "b2f9c306-cf65-4bb0-878e-cfaafde156b1" + } + } + } + }, + "title": "Entity_MoveEntitiesToCollection", + "operationId": "Entity_MoveEntitiesToCollection" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_PartialUpdateAttributeByGuid.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_PartialUpdateAttributeByGuid.json new file mode 100644 index 000000000000..4320bdb7e9a7 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_PartialUpdateAttributeByGuid.json @@ -0,0 +1,39 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "394d9a03-912e-483b-bbd2-bedee1a69798", + "name": "ExampleName", + "body": "ExampleNewName" + }, + "responses": { + "200": { + "body": { + "mutatedEntities": { + "CREATE": [ + { + "typeName": "azure_storage_account", + "attributes": { + "qualifiedName": "https://exampleaccount.core.windows.net" + }, + "lastModifiedTS": "1", + "guid": "394d9a03-912e-483b-bbd2-bedee1a69798", + "status": "ACTIVE" + } + ] + }, + "partialUpdatedEntities": [ + { + "typeName": "azure_storage_account", + "attributes": { + "qualifiedName": "https://exampleaccount.core.windows.net" + }, + "lastModifiedTS": "1", + "guid": "394d9a03-912e-483b-bbd2-bedee1a69798" + } + ] + } + } + }, + "title": "Entity_PartialUpdateAttributeByGuid", + "operationId": "Entity_PartialUpdateAttributeByGuid" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_PartialUpdateByUniqueAttributes.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_PartialUpdateByUniqueAttributes.json new file mode 100644 index 000000000000..40609617bfa7 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_PartialUpdateByUniqueAttributes.json @@ -0,0 +1,62 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "typeName": "azure_storage_account", + "attr:qualifiedName": "https://exampleaccount.core.windows.net", + "body": { + "entity": { + "createTime": 1605766397985.0, + "createdBy": "8c062c84-5d25-449f-a990-9d8ab70b8ec7", + "guid": "dc507ccf-0c57-4165-9327-f37b0d13fda0", + "relationshipAttributes": { + "services": [], + "meanings": [] + }, + "status": "ACTIVE", + "updateTime": 1605766397985.0, + "updatedBy": "8c062c84-5d25-449f-a990-9d8ab70b8ec7", + "lastModifiedTS": "1", + "version": 0.0, + "attributes": { + "owner": "ExampleOwner", + "qualifiedName": "https://exampleaccount.core.windows.net", + "createTime": 0, + "name": "ExampleNewName" + }, + "typeName": "azure_storage_account" + }, + "referredEntities": {} + } + }, + "responses": { + "200": { + "body": { + "guidAssignments": {}, + "mutatedEntities": { + "PARTIAL_UPDATE": [ + { + "guid": "dc507ccf-0c57-4165-9327-f37b0d13fda0", + "lastModifiedTS": "2", + "attributes": { + "qualifiedName": "https://exampleaccount.core.windows.net" + }, + "typeName": "azure_storage_account" + } + ] + }, + "partialUpdatedEntities": [ + { + "guid": "dc507ccf-0c57-4165-9327-f37b0d13fda0", + "lastModifiedTS": "2", + "attributes": { + "qualifiedName": "https://exampleaccount.core.windows.net" + }, + "typeName": "azure_storage_account" + } + ] + } + } + }, + "title": "Entity_PartialUpdateByUniqueAttributes", + "operationId": "Entity_PartialUpdateByUniqueAttributes" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_RemoveBusinessAttribute.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_RemoveBusinessAttribute.json new file mode 100644 index 000000000000..717225e30454 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_RemoveBusinessAttribute.json @@ -0,0 +1,15 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "02c373fe-2823-4be3-97fa-55180a9faa06", + "businessMetadataName": "myBizMetaData1", + "body": { + "bizAttr1": "bizAttr1" + } + }, + "responses": { + "204": {} + }, + "title": "Entity_RemoveBusinessAttribute", + "operationId": "Entity_RemoveBusinessMetadataAttributes" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_RemoveBusinessMetadata.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_RemoveBusinessMetadata.json new file mode 100644 index 000000000000..9e2de7361e36 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_RemoveBusinessMetadata.json @@ -0,0 +1,16 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "02c373fe-2823-4be3-97fa-55180a9faa06", + "body": { + "myBizMetadata1": { + "bizAttr1": "myBizMetaData1.bizAttr1" + } + } + }, + "responses": { + "204": {} + }, + "title": "Entity_RemoveBusinessMetadata", + "operationId": "Entity_RemoveBusinessMetadata" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_RemoveClassification.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_RemoveClassification.json new file mode 100644 index 000000000000..408744950b01 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_RemoveClassification.json @@ -0,0 +1,12 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "cc0730ba-9b30-41f0-6953-559d17626d2b", + "classificationName": "MICROSOFT.FINANCIAL.US.ABA_ROUTING_NUMBER" + }, + "responses": { + "204": {} + }, + "title": "Entity_RemoveClassification", + "operationId": "Entity_RemoveClassification" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_RemoveClassificationByUniqueAttribute.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_RemoveClassificationByUniqueAttribute.json new file mode 100644 index 000000000000..75717c4f59ad --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_RemoveClassificationByUniqueAttribute.json @@ -0,0 +1,13 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "typeName": "column", + "classificationName": "MICROSOFT.FINANCIAL.US.ABA_ROUTING_NUMBER", + "attr:qualifiedName": "https://exampleaccount.blob.core.windows.net/examplecontainer/exampledata.csv" + }, + "responses": { + "204": {} + }, + "title": "Entity_RemoveClassificationByUniqueAttribute", + "operationId": "Entity_RemoveClassificationByUniqueAttribute" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_RemoveLabels.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_RemoveLabels.json new file mode 100644 index 000000000000..743f676c786b --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_RemoveLabels.json @@ -0,0 +1,15 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "02c373fe-2823-4be3-97fa-55180a9faa06", + "body": [ + "label1", + "label2" + ] + }, + "responses": { + "204": {} + }, + "title": "Entity_RemoveLabels", + "operationId": "Entity_RemoveLabels" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_RemoveLabelsByUniqueAttribute.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_RemoveLabelsByUniqueAttribute.json new file mode 100644 index 000000000000..3ae4c0b565f8 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_RemoveLabelsByUniqueAttribute.json @@ -0,0 +1,15 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "typeName": "Asset", + "attr:qualifiedName": "https://asset1", + "body": [ + "label1" + ] + }, + "responses": { + "204": {} + }, + "title": "Entity_RemoveLabelsByUniqueAttribute", + "operationId": "Entity_RemoveLabelsByUniqueAttribute" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_SetLabels.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_SetLabels.json new file mode 100644 index 000000000000..e2b2c2eb6344 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_SetLabels.json @@ -0,0 +1,15 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "02c373fe-2823-4be3-97fa-55180a9faa06", + "body": [ + "label1", + "label2" + ] + }, + "responses": { + "204": {} + }, + "title": "Entity_SetLabels", + "operationId": "Entity_SetLabels" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_SetLabelsByUniqueAttribute.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_SetLabelsByUniqueAttribute.json new file mode 100644 index 000000000000..9ffba096b022 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_SetLabelsByUniqueAttribute.json @@ -0,0 +1,16 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "typeName": "Asset", + "attr:qualifiedName": "https://asset1", + "body": [ + "label1", + "label2" + ] + }, + "responses": { + "204": {} + }, + "title": "Entity_SetLabelsByUniqueAttribute", + "operationId": "Entity_SetLabelsByUniqueAttribute" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_Update.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_Update.json new file mode 100644 index 000000000000..40e2350403a5 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_Update.json @@ -0,0 +1,62 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "api-version": "2023-09-01", + "body": { + "referredEntities": {}, + "entity": { + "typeName": "azure_storage_account", + "attributes": { + "owner": "ExampleOwner", + "modifiedTime": 0, + "createTime": 0, + "qualifiedName": "exampleaccount", + "name": "ExampleStorageAccount", + "description": null, + "publicAccessLevel": null + }, + "contacts": { + "Expert": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Expert Info" + } + ], + "Owner": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Owner Info" + } + ] + }, + "status": "ACTIVE", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "version": 0 + } + } + }, + "responses": { + "200": { + "body": { + "mutatedEntities": { + "UPDATE": [ + { + "typeName": "azure_storage_account", + "attributes": { + "qualifiedName": "exampleaccount" + }, + "lastModifiedTS": "2", + "guid": "029d5668-a36c-40a9-bc11-6f352bafdc3b" + } + ] + }, + "guidAssignments": { + "-9514774903018167": "029d5668-a36c-40a9-bc11-6f352bafdc3b" + } + } + } + }, + "title": "Entity_Update", + "operationId": "Entity_CreateOrUpdate" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_UpdateClassifications.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_UpdateClassifications.json new file mode 100644 index 000000000000..274b565b8f81 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_UpdateClassifications.json @@ -0,0 +1,21 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "45dd4404-e897-b7e2-ca3c-f6e6b11b4f24", + "body": [ + { + "typeName": "MICROSOFT.FINANCIAL.CREDIT_CARD_NUMBER", + "entityGuid": "45dd4404-e897-b7e2-ca3c-f6e6b11b4f24" + }, + { + "typeName": "MICROSOFT.FINANCIAL.US_BANK_ACCOUNT_NUMBER", + "entityGuid": "45dd4404-e897-b7e2-ca3c-f6e6b11b4f24" + } + ] + }, + "responses": { + "204": {} + }, + "title": "Entity_UpdateClassifications", + "operationId": "Entity_UpdateClassifications" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_UpdateClassificationsByUniqueAttribute.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_UpdateClassificationsByUniqueAttribute.json new file mode 100644 index 000000000000..f3b1777a8e75 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Entity_UpdateClassificationsByUniqueAttribute.json @@ -0,0 +1,20 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "typeName": "azure_storage_account", + "attr:qualifiedName": "https://exampleaccount.core.windows.net", + "body": [ + { + "typeName": "MICROSOFT.FINANCIAL.US.ABA_ROUTING_NUMBER" + }, + { + "typeName": "MICROSOFT.FINANCIAL.CREDIT_CARD_NUMBER" + } + ] + }, + "responses": { + "204": {} + }, + "title": "Entity_UpdateClassificationsByUniqueAttribute", + "operationId": "Entity_UpdateClassificationsByUniqueAttribute" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_AssignTermToEntities.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_AssignTermToEntities.json new file mode 100644 index 000000000000..82aae3a1b087 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_AssignTermToEntities.json @@ -0,0 +1,24 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "termId": "8a7f65ec-6429-0b9b-3734-ec57bf1e34c2", + "body": [ + { + "guid": "ab9f1920-0b94-436d-aeb4-11a32c270fc0", + "relationshipAttributes": { + "attributes": { + "expression": "Example Expression", + "confidence": 100, + "description": "Example Description", + "source": "ExampleSource" + } + } + } + ] + }, + "responses": { + "204": {} + }, + "title": "Glossary_AssignTermToEntities", + "operationId": "Glossary_AssignTermToEntities" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_Create.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_Create.json new file mode 100644 index 000000000000..01289fd09ee1 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_Create.json @@ -0,0 +1,32 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "name": "Glossary", + "shortDescription": "Example Short Description", + "longDescription": "Example Long Description", + "language": "en", + "usage": "Example Glossary" + } + }, + "responses": { + "200": { + "body": { + "guid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "qualifiedName": "Glossary", + "name": "Glossary", + "shortDescription": "Example Short Description", + "longDescription": "Example Long Description", + "lastModifiedTS": "1", + "language": "en", + "usage": "Example Glossary", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1672892675688, + "updateTime": 1672892675688 + } + } + }, + "title": "Glossary_Create", + "operationId": "Glossary_Create" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_CreateCategories.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_CreateCategories.json new file mode 100644 index 000000000000..7dfb49f4e1ae --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_CreateCategories.json @@ -0,0 +1,47 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": [ + { + "name": "ExampleCategory2", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8" + } + }, + { + "name": "ExampleCategory3", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8" + } + } + ] + }, + "responses": { + "200": { + "body": [ + { + "guid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "qualifiedName": "ExampleCategory2@Glossary", + "name": "ExampleCategory2", + "lastModifiedTS": "1", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "94071e56-fd3e-4441-93ff-1834f818482d" + } + }, + { + "guid": "0d6766f6-f4b6-435b-bda2-d3edc358998e", + "qualifiedName": "ExampleCategory3@Glossary", + "name": "ExampleCategory3", + "lastModifiedTS": "1", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "26a486a4-a8e2-483c-8a84-3b88e909f8d2" + } + } + ] + } + }, + "title": "Glossary_CreateCategories", + "operationId": "Glossary_CreateCategories" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_CreateCategory.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_CreateCategory.json new file mode 100644 index 000000000000..912e40a4e7ef --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_CreateCategory.json @@ -0,0 +1,39 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8" + }, + "name": "ExampleCategory1", + "terms": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea" + } + ] + } + }, + "responses": { + "200": { + "body": { + "guid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "qualifiedName": "ExampleCategory1@Glossary", + "name": "ExampleCategory1", + "lastModifiedTS": "1", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "7bdcef93-a57a-4d1d-95ab-9d3036f394a0" + }, + "terms": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "relationGuid": "6aebf5ac-0c83-40c0-98bf-958fe9c99007", + "displayText": "ExampleTerm1" + } + ] + } + } + }, + "title": "Glossary_CreateCategory", + "operationId": "Glossary_CreateCategory" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_CreateTerm.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_CreateTerm.json new file mode 100644 index 000000000000..bd988ea6973b --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_CreateTerm.json @@ -0,0 +1,78 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "name": "ExampleTerm1", + "shortDescription": "Example Short Description", + "longDescription": "Example Long Description", + "abbreviation": "T1", + "status": "Approved", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8" + }, + "resources": [ + { + "displayName": "Example Display Name", + "url": "Example Url" + } + ], + "contacts": { + "Expert": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Expert Info" + } + ], + "Steward": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Steward info" + } + ] + } + } + }, + "responses": { + "200": { + "body": { + "guid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "qualifiedName": "ExampleTerm1@Glossary", + "name": "ExampleTerm1", + "shortDescription": "Example Short Description", + "longDescription": "Example Long Description", + "abbreviation": "T1", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0" + }, + "createdBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "updatedBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "createTime": 1606287247276, + "updateTime": 1606287247276, + "status": "Approved", + "resources": [ + { + "displayName": "Example Display Name", + "url": "Example Url" + } + ], + "contacts": { + "Expert": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Expert Info" + } + ], + "Steward": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Steward Info" + } + ] + } + } + } + }, + "title": "Glossary_CreateTerm", + "operationId": "Glossary_CreateTerm" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_CreateTermWithTemplate.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_CreateTermWithTemplate.json new file mode 100644 index 000000000000..677877660bc8 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_CreateTermWithTemplate.json @@ -0,0 +1,53 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "name": "ExampleTerm", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8" + }, + "attributes": { + "ExampleTermTemplateAttribute": { + "plain string": "Example String", + "date": 1606233600000, + "single choice": "Example Single Choice A", + "multi choice": [ + "Example Multi Choice A", + "Example Multi Choice B" + ] + } + } + } + }, + "responses": { + "200": { + "body": { + "guid": "9390cc82-1077-403e-a4d2-b6a69834707b", + "qualifiedName": "ExampleTerm@Glossary", + "name": "ExampleTerm", + "lastModifiedTS": "1", + "createdBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "updatedBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "createTime": 1606287247276, + "updateTime": 1606287247276, + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0" + }, + "attributes": { + "ExampleTermTemplateAttribute": { + "plain string": "Example String", + "date": 1606233600000, + "single choice": "Example Single Choice A", + "multi choice": [ + "Example Multi Choice A", + "Example Multi Choice B" + ] + } + } + } + } + }, + "title": "Glossary_CreateTermWithTemplate", + "operationId": "Glossary_CreateTerm" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_CreateTerms.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_CreateTerms.json new file mode 100644 index 000000000000..18fcddae9a04 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_CreateTerms.json @@ -0,0 +1,93 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": [ + { + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8" + }, + "name": "ExampleTerm2", + "status": "Approved", + "shortDescription": "Example Short Description", + "longDescription": "Example Long Description", + "abbreviation": "T2", + "resources": [ + { + "displayName": "Example Display Name", + "url": "Example Url" + } + ] + }, + { + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8" + }, + "name": "ExampleTerm3", + "status": "Approved", + "shortDescription": "Example Short Description", + "longDescription": "Example Long Description", + "abbreviation": "T3", + "resources": [ + { + "displayName": "Example Display Name", + "url": "Example Url" + } + ] + } + ] + }, + "responses": { + "200": { + "body": [ + { + "guid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "qualifiedName": "ExampleTerm2@Glossary", + "name": "ExampleTerm2", + "shortDescription": "Example Short Description", + "lastModifiedTS": "1", + "abbreviation": "T2", + "createdBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "updatedBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "createTime": 1606287312495, + "updateTime": 1606287312495, + "status": "Approved", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "9385640b-e6be-437d-a6b9-62d11c14a189" + }, + "resources": [ + { + "displayName": "Example Display Name", + "url": "Example Url" + } + ] + }, + { + "guid": "821beef0-ced9-47ba-8f7f-c4f3459f4d18", + "qualifiedName": "ExampleTerm3@Glossary", + "name": "ExampleTerm3", + "shortDescription": "Example Short Description", + "lastModifiedTS": "1", + "abbreviation": "T3", + "createdBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "updatedBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "createTime": 1606287312495, + "updateTime": 1606287312495, + "status": "Approved", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "f4de4878-3e43-4f8b-b090-07a233bb0ce6" + }, + "resources": [ + { + "displayName": "Example Display Name", + "url": "Example Url" + } + ] + } + ] + } + }, + "title": "Glossary_CreateTerms", + "operationId": "Glossary_CreateTerms" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_Delete.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_Delete.json new file mode 100644 index 000000000000..88b82510fb9f --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_Delete.json @@ -0,0 +1,11 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "glossaryId": "c0c54153-13d1-1608-13af-43457cdffe75" + }, + "responses": { + "204": {} + }, + "title": "Glossary_Delete", + "operationId": "Glossary_Delete" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_DeleteCategory.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_DeleteCategory.json new file mode 100644 index 000000000000..c281cd4c2450 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_DeleteCategory.json @@ -0,0 +1,11 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "categoryId": "0e391355-252a-e5f3-ac18-5a3602df7616" + }, + "responses": { + "204": {} + }, + "title": "Glossary_DeleteCategory", + "operationId": "Glossary_DeleteCategory" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_DeleteTerm.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_DeleteTerm.json new file mode 100644 index 000000000000..7fa8e97b845a --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_DeleteTerm.json @@ -0,0 +1,11 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "termId": "b0942506-2d7d-1f45-d286-c29ca9e7f2ef" + }, + "responses": { + "204": {} + }, + "title": "Glossary_DeleteTerm", + "operationId": "Glossary_DeleteTerm" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_Get.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_Get.json new file mode 100644 index 000000000000..6e1aaeaa5786 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_Get.json @@ -0,0 +1,43 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "glossaryId": "47029611-67a1-42d5-8766-90eb904f7f22" + }, + "responses": { + "200": { + "body": { + "guid": "47029611-67a1-42d5-8766-90eb904f7f22", + "qualifiedName": "Glossary", + "name": "Glossary", + "shortDescription": "Example Short Description", + "longDescription": "Example Long Description", + "lastModifiedTS": "1", + "language": "en", + "usage": "Example Glossary", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1672892675688, + "updateTime": 1672892675688, + "terms": [ + { + "termGuid": "29d88363-9677-4ce6-aeee-5fdf45f84e9b", + "relationGuid": "fb3d4ac4-27e0-45a2-bb13-105214e0ef7e", + "displayText": "ExampleTerm3" + }, + { + "termGuid": "e5136a91-bc02-49da-81f4-f075bd54b8f5", + "relationGuid": "741186cd-1d62-4798-8e58-6cbe35105baa", + "displayText": "ExampleTerm1" + }, + { + "termGuid": "68347d87-ae38-43b4-a62c-0fdc25b54cb1", + "relationGuid": "2f2b1fe6-d2b6-4aef-81cd-bea7a510312e", + "displayText": "ExampleTerm2" + } + ] + } + } + }, + "title": "Glossary_Get", + "operationId": "Glossary_Get" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_GetCategory.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_GetCategory.json new file mode 100644 index 000000000000..1de42a99f57e --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_GetCategory.json @@ -0,0 +1,41 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "categoryId": "ed7458f0-9463-48a5-b5c6-4f785fb34e12" + }, + "responses": { + "200": { + "body": { + "guid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "qualifiedName": "ExampleCategory1.ExampleCategory2@Glossary", + "name": "ExampleCategory1", + "lastModifiedTS": "2", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "7bdcef93-a57a-4d1d-95ab-9d3036f394a0" + }, + "parentCategory": { + "categoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "relationGuid": "82d569cd-2273-4ef9-9f67-c6f2ed637c20" + }, + "childrenCategories": [ + { + "categoryGuid": "0d6766f6-f4b6-435b-bda2-d3edc358998e", + "parentCategoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "relationGuid": "e50be8c5-7905-4c92-b676-4278866c2c2f", + "displayText": "ExampleCategory3" + } + ], + "terms": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "relationGuid": "6aebf5ac-0c83-40c0-98bf-958fe9c99007", + "displayText": "ExampleTerm1" + } + ] + } + } + }, + "title": "Glossary_GetCategory", + "operationId": "Glossary_GetCategory" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_GetDetailed.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_GetDetailed.json new file mode 100644 index 000000000000..0345a931a976 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_GetDetailed.json @@ -0,0 +1,231 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "glossaryId": "c018ddaf-7c21-4b37-a838-dae5f110c3d8" + }, + "responses": { + "200": { + "body": { + "guid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "qualifiedName": "Glossary", + "name": "Glossary", + "shortDescription": "Example Short Description", + "longDescription": "Example Long Description", + "language": "en", + "usage": "Example Glossary", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1672892675688, + "updateTime": 1672892675688, + "terms": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0", + "displayText": "ExampleTerm1" + }, + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "9385640b-e6be-437d-a6b9-62d11c14a189", + "displayText": "ExampleTerm2" + } + ], + "categories": [ + { + "categoryGuid": "0d6766f6-f4b6-435b-bda2-d3edc358998e", + "relationGuid": "26a486a4-a8e2-483c-8a84-3b88e909f8d2" + }, + { + "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "relationGuid": "7bdcef93-a57a-4d1d-95ab-9d3036f394a0" + }, + { + "categoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "relationGuid": "94071e56-fd3e-4441-93ff-1834f818482d" + } + ], + "termInfo": { + "54688d39-b298-4104-9e80-f2a16f44aaea": { + "guid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "qualifiedName": "ExampleTerm1@Glossary", + "name": "ExampleTerm1", + "shortDescription": "Example Short Description", + "longDescription": "Example Long Description", + "lastModifiedTS": "2", + "abbreviation": "T1", + "createdBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "updatedBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "createTime": 1606287247276, + "updateTime": 1606290587593, + "status": "Approved", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0" + }, + "assignedEntities": [ + { + "guid": "ab9f1920-0b94-436d-aeb4-11a32c270fc0", + "typeName": "hdfs_path", + "entityStatus": "ACTIVE", + "displayText": "1", + "relationshipType": "AtlasGlossarySemanticAssignment", + "relationshipGuid": "cf2e959c-05e6-4a9f-b106-b6475741c2ba", + "relationshipStatus": "ACTIVE", + "relationshipAttributes": { + "typeName": "AtlasGlossarySemanticAssignment", + "attributes": { + "expression": "Example Expression", + "createdBy": "ExampleCreator", + "steward": "ExampleSteward", + "confidence": 100, + "description": "Example Description", + "source": "Azure", + "status": null + } + } + } + ], + "categories": [ + { + "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "relationGuid": "6aebf5ac-0c83-40c0-98bf-958fe9c99007" + } + ], + "seeAlso": [ + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "dfa44030-bd14-4111-a0f1-3d01c964eb01", + "displayText": "ExampleTerm2" + } + ], + "synonyms": [ + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "15bcbd12-eb48-4b63-8ff5-74f7ec3a562c", + "displayText": "ExampleTerm2" + } + ], + "contacts": { + "Expert": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Expert Info" + } + ], + "Steward": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Steward Info" + } + ] + }, + "resources": [ + { + "displayName": "Example Display Name", + "url": "Example Url" + } + ] + }, + "952c7ba4-4c89-42d8-a05a-7d2161be7008": { + "guid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "qualifiedName": "ExampleTerm2@Glossary", + "name": "ExampleTerm2", + "shortDescription": "Example Short Description", + "lastModifiedTS": "1", + "abbreviation": "T2", + "createdBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "updatedBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "createTime": 1606287312495, + "updateTime": 1606287312495, + "status": "Approved", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "9385640b-e6be-437d-a6b9-62d11c14a189" + }, + "seeAlso": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "relationGuid": "dfa44030-bd14-4111-a0f1-3d01c964eb01", + "displayText": "ExampleTerm1" + } + ], + "synonyms": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "relationGuid": "15bcbd12-eb48-4b63-8ff5-74f7ec3a562c", + "displayText": "ExampleTerm1" + } + ], + "resources": [ + { + "displayName": "Example Display Name", + "url": "Example Url" + } + ] + } + }, + "categoryInfo": { + "ed7458f0-9463-48a5-b5c6-4f785fb34e12": { + "guid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "qualifiedName": "ExampleCategory1.ExampleCategory2@Glossary", + "name": "ExampleCategory1", + "longDescription": "Example Long Description", + "lastModifiedTS": "3", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "7bdcef93-a57a-4d1d-95ab-9d3036f394a0" + }, + "parentCategory": { + "categoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "relationGuid": "82d569cd-2273-4ef9-9f67-c6f2ed637c20" + }, + "childrenCategories": [ + { + "categoryGuid": "0d6766f6-f4b6-435b-bda2-d3edc358998e", + "relationGuid": "e50be8c5-7905-4c92-b676-4278866c2c2f" + } + ], + "terms": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "relationGuid": "6aebf5ac-0c83-40c0-98bf-958fe9c99007", + "displayText": "ExampleTerm1" + } + ] + }, + "e47c4584-daca-4f9e-9092-194e04692c9a": { + "guid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "qualifiedName": "ExampleCategory2@Glossary", + "name": "ExampleCategory2", + "lastModifiedTS": "1", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "94071e56-fd3e-4441-93ff-1834f818482d" + }, + "childrenCategories": [ + { + "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "relationGuid": "82d569cd-2273-4ef9-9f67-c6f2ed637c20" + } + ] + }, + "0d6766f6-f4b6-435b-bda2-d3edc358998e": { + "guid": "0d6766f6-f4b6-435b-bda2-d3edc358998e", + "qualifiedName": "ExampleCategory3.ExampleCategory1.ExampleCategory2@Glossary", + "name": "ExampleCategory3", + "lastModifiedTS": "2", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "26a486a4-a8e2-483c-8a84-3b88e909f8d2" + }, + "parentCategory": { + "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "relationGuid": "e50be8c5-7905-4c92-b676-4278866c2c2f" + } + } + } + } + } + }, + "title": "Glossary_GetDetailed", + "operationId": "Glossary_GetDetailed" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_GetTerm.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_GetTerm.json new file mode 100644 index 000000000000..3b574ac3e20f --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_GetTerm.json @@ -0,0 +1,86 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "termId": "54688d39-b298-4104-9e80-f2a16f44aaea" + }, + "responses": { + "200": { + "body": { + "guid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "qualifiedName": "ExampleTerm1@Glossary", + "name": "ExampleTerm1", + "shortDescription": "Example Short Description", + "lastModifiedTS": "1", + "abbreviation": "T1", + "createdBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "updatedBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "createTime": 1606287247276, + "updateTime": 1606287247276, + "status": "Approved", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0" + }, + "seeAlso": [ + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "dfa44030-bd14-4111-a0f1-3d01c964eb01", + "displayText": "ExampleTerm2" + } + ], + "synonyms": [ + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "15bcbd12-eb48-4b63-8ff5-74f7ec3a562c", + "displayText": "ExampleTerm2" + } + ], + "contacts": { + "Expert": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Expert Info" + } + ], + "Steward": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Steward Info" + } + ] + }, + "resources": [ + { + "displayName": "Example Display Name", + "url": "Example Url" + } + ], + "assignedEntities": [ + { + "guid": "7e255139-b654-4c8d-a4bd-fbb5a243e83f", + "typeName": "azure_datalake_gen2_path", + "entityStatus": "ACTIVE", + "displayText": "moviesDB.csv", + "relationshipType": "AtlasGlossarySemanticAssignment", + "relationshipGuid": "ace36560-6259-4e7f-9214-3850b2af0a86", + "relationshipStatus": "ACTIVE", + "relationshipAttributes": { + "typeName": "AtlasGlossarySemanticAssignment", + "attributes": { + "expression": null, + "createdBy": null, + "steward": null, + "confidence": null, + "description": null, + "source": null, + "status": null + } + } + } + ] + } + } + }, + "title": "Glossary_GetTerm", + "operationId": "Glossary_GetTerm" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_GetTermWithoutAssets.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_GetTermWithoutAssets.json new file mode 100644 index 000000000000..3bedbf11a9a4 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_GetTermWithoutAssets.json @@ -0,0 +1,66 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "termId": "54688d39-b298-4104-9e80-f2a16f44aaea", + "excludeRelationshipTypes": [ + "AtlasGlossarySemanticAssignment" + ] + }, + "responses": { + "200": { + "body": { + "guid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "qualifiedName": "ExampleTerm1@Glossary", + "name": "ExampleTerm1", + "shortDescription": "Example Short Description", + "lastModifiedTS": "1", + "abbreviation": "T1", + "createdBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "updatedBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "createTime": 1606287247276, + "updateTime": 1606287247276, + "status": "Approved", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0" + }, + "seeAlso": [ + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "dfa44030-bd14-4111-a0f1-3d01c964eb01", + "displayText": "ExampleTerm2" + } + ], + "synonyms": [ + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "15bcbd12-eb48-4b63-8ff5-74f7ec3a562c", + "displayText": "ExampleTerm2" + } + ], + "contacts": { + "Expert": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Expert Info" + } + ], + "Steward": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Steward Info" + } + ] + }, + "resources": [ + { + "displayName": "Example Display Name", + "url": "Example Url" + } + ] + } + } + }, + "title": "Glossary_GetTermWithoutAssets", + "operationId": "Glossary_GetTerm" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_List.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_List.json new file mode 100644 index 000000000000..c454ce6b68f7 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_List.json @@ -0,0 +1,61 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "limit": "1", + "offset": "0", + "sort": "ASC" + }, + "responses": { + "200": { + "body": [ + { + "guid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "qualifiedName": "Glossary", + "name": "Glossary", + "shortDescription": "Example Short Description", + "longDescription": "Example Long Description", + "lastModifiedTS": "1", + "language": "en", + "usage": "Example Glossary", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1672892675688, + "updateTime": 1672892675688, + "terms": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0", + "displayText": "ExampleTerm1" + }, + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "9385640b-e6be-437d-a6b9-62d11c14a189", + "displayText": "ExampleTerm2" + } + ], + "categories": [ + { + "categoryGuid": "0d6766f6-f4b6-435b-bda2-d3edc358998e", + "parentCategoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "relationGuid": "26a486a4-a8e2-483c-8a84-3b88e909f8d2", + "displayText": "ExampleCategory3" + }, + { + "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "parentCategoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "relationGuid": "7bdcef93-a57a-4d1d-95ab-9d3036f394a0", + "displayText": "ExampleCategory1" + }, + { + "categoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "relationGuid": "94071e56-fd3e-4441-93ff-1834f818482d", + "displayText": "ExampleCategory2" + } + ] + } + ] + } + }, + "title": "Glossary_List", + "operationId": "Glossary_List" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListCategories.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListCategories.json new file mode 100644 index 000000000000..30e8cf73dbfd --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListCategories.json @@ -0,0 +1,74 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "glossaryId": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "limit": "-1", + "offset": "0", + "sort": "ASC" + }, + "responses": { + "200": { + "body": [ + { + "guid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "qualifiedName": "ExampleCategory1.ExampleCategory2@Glossary", + "name": "ExampleCategory1", + "lastModifiedTS": "2", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "7bdcef93-a57a-4d1d-95ab-9d3036f394a0" + }, + "parentCategory": { + "categoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "relationGuid": "82d569cd-2273-4ef9-9f67-c6f2ed637c20" + }, + "childrenCategories": [ + { + "categoryGuid": "0d6766f6-f4b6-435b-bda2-d3edc358998e", + "relationGuid": "e50be8c5-7905-4c92-b676-4278866c2c2f" + } + ], + "terms": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "relationGuid": "6aebf5ac-0c83-40c0-98bf-958fe9c99007", + "displayText": "ExampleTerm1" + } + ] + }, + { + "guid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "qualifiedName": "ExampleCategory2@Glossary", + "name": "ExampleCategory2", + "lastModifiedTS": "1", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "94071e56-fd3e-4441-93ff-1834f818482d" + }, + "childrenCategories": [ + { + "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "relationGuid": "82d569cd-2273-4ef9-9f67-c6f2ed637c20" + } + ] + }, + { + "guid": "0d6766f6-f4b6-435b-bda2-d3edc358998e", + "qualifiedName": "ExampleCategory3.ExampleCategory1.ExampleCategory2@Glossary", + "name": "ExampleCategory3", + "lastModifiedTS": "2", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "26a486a4-a8e2-483c-8a84-3b88e909f8d2" + }, + "parentCategory": { + "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "relationGuid": "e50be8c5-7905-4c92-b676-4278866c2c2f" + } + } + ] + } + }, + "title": "Glossary_ListCategories", + "operationId": "Glossary_ListCategories" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListCategoriesHeaders.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListCategoriesHeaders.json new file mode 100644 index 000000000000..a04eb3cba127 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListCategoriesHeaders.json @@ -0,0 +1,34 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "glossaryId": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "limit": "-1", + "offset": "0", + "sort": "ASC" + }, + "responses": { + "200": { + "body": [ + { + "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "parentCategoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "relationGuid": "7bdcef93-a57a-4d1d-95ab-9d3036f394a0", + "displayText": "ExampleCategory1" + }, + { + "categoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "relationGuid": "94071e56-fd3e-4441-93ff-1834f818482d", + "displayText": "ExampleCategory2" + }, + { + "categoryGuid": "0d6766f6-f4b6-435b-bda2-d3edc358998e", + "parentCategoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "relationGuid": "26a486a4-a8e2-483c-8a84-3b88e909f8d2", + "displayText": "ExampleCategory3" + } + ] + } + }, + "title": "Glossary_ListCategoriesHeaders", + "operationId": "Glossary_ListCategoriesHeaders" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListCategoryTerms.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListCategoryTerms.json new file mode 100644 index 000000000000..e1a99139221b --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListCategoryTerms.json @@ -0,0 +1,22 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "categoryId": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "limit": "-1", + "offset": "0", + "sort": "ASC" + }, + "responses": { + "200": { + "body": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "relationGuid": "6aebf5ac-0c83-40c0-98bf-958fe9c99007", + "displayText": "ExampleTerm1" + } + ] + } + }, + "title": "Glossary_ListCategoryTerms", + "operationId": "Glossary_ListCategoryTerms" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListEntitiesAssignedWithTerm.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListEntitiesAssignedWithTerm.json new file mode 100644 index 000000000000..99c872e87c99 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListEntitiesAssignedWithTerm.json @@ -0,0 +1,59 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "termId": "daf0ba4d-bc9a-4536-8a88-4b58e39dd3d4", + "limit": "-1", + "offset": "0", + "sort": "ASC" + }, + "responses": { + "200": { + "body": [ + { + "guid": "ea116881-222e-41c8-8acb-9af6f6f60009", + "typeName": "column", + "entityStatus": "ACTIVE", + "displayText": "ExampleColumnName", + "relationshipType": "AtlasGlossarySemanticAssignment", + "relationshipGuid": "ff9023a5-8495-49d6-bf04-a22c3634151e", + "relationshipStatus": "ACTIVE", + "relationshipAttributes": { + "typeName": "AtlasGlossarySemanticAssignment", + "attributes": { + "expression": null, + "createdBy": null, + "steward": null, + "confidence": null, + "description": null, + "source": null, + "status": null + } + } + }, + { + "guid": "fbf0a84d-7080-456b-b889-b5ba42186c2e", + "typeName": "azure_blob_path", + "entityStatus": "ACTIVE", + "displayText": "exampledata.csv", + "relationshipType": "AtlasGlossarySemanticAssignment", + "relationshipGuid": "dedc1294-a893-4e52-ba27-6be9b8694748", + "relationshipStatus": "ACTIVE", + "relationshipAttributes": { + "typeName": "AtlasGlossarySemanticAssignment", + "attributes": { + "expression": null, + "createdBy": null, + "steward": null, + "confidence": null, + "description": null, + "source": null, + "status": null + } + } + } + ] + } + }, + "title": "Glossary_ListEntitiesAssignedWithTerm", + "operationId": "Glossary_ListEntitiesAssignedWithTerm" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListRelatedCategories.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListRelatedCategories.json new file mode 100644 index 000000000000..2e845fcb0944 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListRelatedCategories.json @@ -0,0 +1,31 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "categoryId": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "limit": "-1", + "offset": "0", + "sort": "ASC" + }, + "responses": { + "200": { + "body": { + "parent": [ + { + "categoryGuid": "6c8233cd-f6dc-6ef7-5597-b18ab590f2fc", + "relationGuid": "25cf5e46-c551-4ed4-8919-505c29ae311d" + } + ], + "children": [ + { + "categoryGuid": "abc6ac1b-5700-9c70-3f5a-60a519150035", + "parentCategoryGuid": "3243ea0a-9492-47e1-392e-a84e64980af9", + "relationGuid": "12d41563-2fd9-4be5-9eb9-9908f811a8f2", + "displayText": "ExampleCategory4" + } + ] + } + } + }, + "title": "Glossary_ListRelatedCategories", + "operationId": "Glossary_ListRelatedCategories" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListRelatedTerms.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListRelatedTerms.json new file mode 100644 index 000000000000..56999a9dd79a --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListRelatedTerms.json @@ -0,0 +1,31 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "termId": "54688d39-b298-4104-9e80-f2a16f44aaea", + "limit": "-1", + "offset": "0", + "sort": "ASC" + }, + "responses": { + "200": { + "body": { + "seeAlso": [ + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "dfa44030-bd14-4111-a0f1-3d01c964eb01", + "displayText": "ExampleTerm2" + } + ], + "synonyms": [ + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "15bcbd12-eb48-4b63-8ff5-74f7ec3a562c", + "displayText": "ExampleTerm2" + } + ] + } + } + }, + "title": "Glossary_ListRelatedTerms", + "operationId": "Glossary_ListRelatedTerms" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListTermHeaders.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListTermHeaders.json new file mode 100644 index 000000000000..6bcfbe8c9fc9 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListTermHeaders.json @@ -0,0 +1,27 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "glossaryId": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "limit": "-1", + "offset": "0", + "sort": "ASC" + }, + "responses": { + "200": { + "body": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0", + "displayText": "ExampleTerm1" + }, + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "9385640b-e6be-437d-a6b9-62d11c14a189", + "displayText": "ExampleTerm2" + } + ] + } + }, + "title": "Glossary_ListTermHeaders", + "operationId": "Glossary_ListTermHeaders" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListTerms.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListTerms.json new file mode 100644 index 000000000000..583aa635b462 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_ListTerms.json @@ -0,0 +1,105 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "glossaryId": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "limit": "-1", + "offset": "0", + "sort": "ASC" + }, + "responses": { + "200": { + "body": [ + { + "guid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "qualifiedName": "ExampleTerm1@Glossary", + "name": "ExampleTerm1", + "shortDescription": "Example Short Description", + "lastModifiedTS": "1", + "abbreviation": "T1", + "createdBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "updatedBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "createTime": 1606287247276, + "updateTime": 1606287247276, + "status": "Approved", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0" + }, + "seeAlso": [ + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "dfa44030-bd14-4111-a0f1-3d01c964eb01", + "displayText": "ExampleTerm2" + } + ], + "synonyms": [ + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "15bcbd12-eb48-4b63-8ff5-74f7ec3a562c", + "displayText": "ExampleTerm2" + } + ], + "contacts": { + "Expert": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Expert Info" + } + ], + "Steward": [ + { + "id": "30435ff9-9b96-44af-a5a9-e05c8b1ae2df", + "info": "Example Steward Info" + } + ] + }, + "resources": [ + { + "displayName": "Example Display Name", + "url": "Example Url" + } + ] + }, + { + "guid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "qualifiedName": "ExampleTerm2@Glossary", + "name": "ExampleTerm2", + "shortDescription": "Example Short Description", + "lastModifiedTS": "1", + "abbreviation": "T2", + "createdBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "updatedBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "createTime": 1606287312495, + "updateTime": 1606287312495, + "status": "Approved", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "9385640b-e6be-437d-a6b9-62d11c14a189" + }, + "seeAlso": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "relationGuid": "dfa44030-bd14-4111-a0f1-3d01c964eb01", + "displayText": "ExampleTerm1" + } + ], + "synonyms": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "relationGuid": "15bcbd12-eb48-4b63-8ff5-74f7ec3a562c", + "displayText": "ExampleTerm1" + } + ], + "resources": [ + { + "displayName": "Example Display Name", + "url": "Example Url" + } + ] + } + ] + } + }, + "title": "Glossary_ListTerms", + "operationId": "Glossary_ListTerms" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_PartialUpdate.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_PartialUpdate.json new file mode 100644 index 000000000000..c06db55d9e38 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_PartialUpdate.json @@ -0,0 +1,60 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "glossaryId": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "body": { + "longDescription": "Example Long Description" + } + }, + "responses": { + "200": { + "body": { + "guid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "qualifiedName": "Glossary", + "name": "Glossary", + "shortDescription": "Example Short Description", + "longDescription": "Example Long Description", + "lastModifiedTS": "3", + "language": "en", + "usage": "Example Glossary", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1672892675600, + "updateTime": 1672892675688, + "terms": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0", + "displayText": "ExampleTerm1" + }, + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "9385640b-e6be-437d-a6b9-62d11c14a189", + "displayText": "ExampleTerm2" + } + ], + "categories": [ + { + "categoryGuid": "0d6766f6-f4b6-435b-bda2-d3edc358998e", + "parentCategoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "relationGuid": "26a486a4-a8e2-483c-8a84-3b88e909f8d2", + "displayText": "ExampleCategory3" + }, + { + "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "parentCategoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "relationGuid": "7bdcef93-a57a-4d1d-95ab-9d3036f394a0", + "displayText": "ExampleCategory1" + }, + { + "categoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "relationGuid": "94071e56-fd3e-4441-93ff-1834f818482d", + "displayText": "ExampleCategory2" + } + ] + } + } + }, + "title": "Glossary_PartialUpdate", + "operationId": "Glossary_PartialUpdate" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_PartialUpdateCategory.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_PartialUpdateCategory.json new file mode 100644 index 000000000000..15be08095e73 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_PartialUpdateCategory.json @@ -0,0 +1,45 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "categoryId": "3243ea0a-9492-47e1-392e-a84e64980af9", + "body": { + "longDescription": "Example Long Description" + } + }, + "responses": { + "200": { + "body": { + "guid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "qualifiedName": "ExampleCategory1.ExampleCategory2@Glossary", + "name": "ExampleCategory1", + "longDescription": "Example Long Description", + "lastModifiedTS": "3", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "7bdcef93-a57a-4d1d-95ab-9d3036f394a0" + }, + "parentCategory": { + "categoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "relationGuid": "82d569cd-2273-4ef9-9f67-c6f2ed637c20" + }, + "childrenCategories": [ + { + "categoryGuid": "0d6766f6-f4b6-435b-bda2-d3edc358998e", + "parentCategoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "relationGuid": "e50be8c5-7905-4c92-b676-4278866c2c2f", + "displayText": "ExampleCategory3" + } + ], + "terms": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "relationGuid": "6aebf5ac-0c83-40c0-98bf-958fe9c99007", + "displayText": "ExampleTerm1" + } + ] + } + } + }, + "title": "Glossary_PartialUpdateCategory", + "operationId": "Glossary_PartialUpdateCategory" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_PartialUpdateTerm.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_PartialUpdateTerm.json new file mode 100644 index 000000000000..356a70cf4da3 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_PartialUpdateTerm.json @@ -0,0 +1,60 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "termId": "54688d39-b298-4104-9e80-f2a16f44aaea", + "body": { + "longDescription": "Example Long Description" + } + }, + "responses": { + "200": { + "body": { + "guid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "qualifiedName": "ExampleTerm1@Glossary", + "name": "ExampleTerm1", + "shortDescription": "Example Short Description", + "longDescription": "Example Long Descrition", + "lastModifiedTS": "2", + "abbreviation": "T1", + "createdBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "updatedBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "createTime": 1606287247276, + "updateTime": 1606290587593, + "status": "Approved", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0" + }, + "categories": [ + { + "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "relationGuid": "6aebf5ac-0c83-40c0-98bf-958fe9c99007", + "displayText": "ExampleCategory1" + } + ], + "seeAlso": [ + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "dfa44030-bd14-4111-a0f1-3d01c964eb01", + "displayText": "ExampleTerm2" + } + ], + "synonyms": [ + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "15bcbd12-eb48-4b63-8ff5-74f7ec3a562c", + "displayText": "ExampleTerm2" + } + ], + "resources": [ + { + "displayName": "Example Display Name", + "url": "Example Url" + } + ] + } + } + }, + "title": "Glossary_PartialUpdateTerm", + "operationId": "Glossary_PartialUpdateTerm" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_RemoveTermAssignmentFromEntities.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_RemoveTermAssignmentFromEntities.json new file mode 100644 index 000000000000..2238f2443727 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_RemoveTermAssignmentFromEntities.json @@ -0,0 +1,17 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "termId": "8a7f65ec-6429-0b9b-3734-ec57bf1e34c2", + "body": [ + { + "guid": "16feb2a1-2c79-ade1-338d-fb24fcb8b8bd", + "relationshipGuid": "624f08bb-3c93-4f03-9ce1-ed2ce2c7c8d5" + } + ] + }, + "responses": { + "204": {} + }, + "title": "Glossary_RemoveTermAssignmentFromEntities", + "operationId": "Glossary_DeleteTermAssignmentFromEntities" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_Update.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_Update.json new file mode 100644 index 000000000000..faca8b5cb2a2 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_Update.json @@ -0,0 +1,98 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "glossaryId": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "body": { + "guid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "qualifiedName": "Glossary", + "name": "Glossary", + "shortDescription": "Example Short Description", + "longDescription": "Example Long Description", + "lastModifiedTS": "1", + "language": "en", + "usage": "Example Glossary", + "terms": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0", + "displayText": "ExampleTerm1" + }, + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "9385640b-e6be-437d-a6b9-62d11c14a189", + "displayText": "ExampleTerm2" + } + ], + "categories": [ + { + "categoryGuid": "0d6766f6-f4b6-435b-bda2-d3edc358998e", + "parentCategoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "relationGuid": "26a486a4-a8e2-483c-8a84-3b88e909f8d2", + "displayText": "ExampleCategory3" + }, + { + "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "parentCategoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "relationGuid": "7bdcef93-a57a-4d1d-95ab-9d3036f394a0", + "displayText": "ExampleCategory1" + }, + { + "categoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "relationGuid": "94071e56-fd3e-4441-93ff-1834f818482d", + "displayText": "ExampleCategory2" + } + ] + } + }, + "responses": { + "200": { + "body": { + "guid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "qualifiedName": "Glossary", + "name": "Glossary", + "shortDescription": "Example Short Description", + "longDescription": "Example Long Description", + "lastModifiedTS": "2", + "language": "en", + "usage": "Example Glossary", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1672892675600, + "updateTime": 1672892675688, + "terms": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0", + "displayText": "ExampleTerm1" + }, + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "9385640b-e6be-437d-a6b9-62d11c14a189", + "displayText": "ExampleTerm2" + } + ], + "categories": [ + { + "categoryGuid": "0d6766f6-f4b6-435b-bda2-d3edc358998e", + "parentCategoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "relationGuid": "26a486a4-a8e2-483c-8a84-3b88e909f8d2", + "displayText": "ExampleCategory3" + }, + { + "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "parentCategoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "relationGuid": "7bdcef93-a57a-4d1d-95ab-9d3036f394a0", + "displayText": "ExampleCategory1" + }, + { + "categoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "relationGuid": "94071e56-fd3e-4441-93ff-1834f818482d", + "displayText": "ExampleCategory2" + } + ] + } + } + }, + "title": "Glossary_Update", + "operationId": "Glossary_Update" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_UpdateCategory.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_UpdateCategory.json new file mode 100644 index 000000000000..7c145590a59b --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_UpdateCategory.json @@ -0,0 +1,65 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "categoryId": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "body": { + "guid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "qualifiedName": "ExampleCategory1@Glossary", + "name": "ExampleCategory1", + "lastModifiedTS": "1", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "7bdcef93-a57a-4d1d-95ab-9d3036f394a0" + }, + "terms": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "relationGuid": "6aebf5ac-0c83-40c0-98bf-958fe9c99007" + } + ], + "childrenCategories": [ + { + "categoryGuid": "0d6766f6-f4b6-435b-bda2-d3edc358998e" + } + ], + "parentCategory": { + "categoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a" + } + } + }, + "responses": { + "200": { + "body": { + "guid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "qualifiedName": "ExampleCategory1.Category2@Glossary", + "name": "ExampleCategory1", + "lastModifiedTS": "2", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "7bdcef93-a57a-4d1d-95ab-9d3036f394a0" + }, + "parentCategory": { + "categoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a", + "relationGuid": "82d569cd-2273-4ef9-9f67-c6f2ed637c20" + }, + "childrenCategories": [ + { + "categoryGuid": "0d6766f6-f4b6-435b-bda2-d3edc358998e", + "parentCategoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "relationGuid": "e50be8c5-7905-4c92-b676-4278866c2c2f", + "displayText": "ExampleCategory3" + } + ], + "terms": [ + { + "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "relationGuid": "6aebf5ac-0c83-40c0-98bf-958fe9c99007", + "displayText": "ExampleTerm1" + } + ] + } + } + }, + "title": "Glossary_UpdateCategory", + "operationId": "Glossary_UpdateCategory" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_UpdateTerm.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_UpdateTerm.json new file mode 100644 index 000000000000..9ed4cb3964b7 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Glossary_UpdateTerm.json @@ -0,0 +1,94 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "termId": "54688d39-b298-4104-9e80-f2a16f44aaea", + "body": { + "guid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "qualifiedName": "ExampleTerm1@Glossary", + "name": "ExampleTerm1", + "shortDescription": "Example Short Description", + "lastModifiedTS": "1", + "abbreviation": "T1", + "status": "Approved", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0" + }, + "resources": [ + { + "displayName": "Example Display Name", + "url": "Example Url" + } + ], + "seeAlso": [ + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008" + }, + { + "termGuid": "821beef0-ced9-47ba-8f7f-c4f3459f4d18" + } + ], + "synonyms": [ + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008" + }, + { + "termGuid": "821beef0-ced9-47ba-8f7f-c4f3459f4d18" + } + ] + } + }, + "responses": { + "200": { + "body": { + "guid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "qualifiedName": "ExampleTerm1@Glossary", + "name": "ExampleTerm1", + "shortDescription": "Example Short Description", + "lastModifiedTS": "1", + "abbreviation": "T1", + "createdBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "updatedBy": "23863cef-a2e9-40a3-a427-44dc0d201f61", + "createTime": 1606287247276, + "updateTime": 1606287247276, + "status": "Approved", + "anchor": { + "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0" + }, + "seeAlso": [ + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "dfa44030-bd14-4111-a0f1-3d01c964eb01", + "displayText": "ExampleTerm2" + }, + { + "termGuid": "821beef0-ced9-47ba-8f7f-c4f3459f4d18", + "relationGuid": "4d802ada-65f3-45a8-969f-aba47d9c6200", + "displayText": "ExampleTerm3" + } + ], + "synonyms": [ + { + "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008", + "relationGuid": "15bcbd12-eb48-4b63-8ff5-74f7ec3a562c", + "displayText": "ExampleTerm2" + }, + { + "termGuid": "821beef0-ced9-47ba-8f7f-c4f3459f4d18", + "relationGuid": "bb26fe7c-6e26-46ad-b936-50a5f7ffbbaf", + "displayText": "ExampleTerm3" + } + ], + "resources": [ + { + "displayName": "Example Display Name", + "url": "Example Url" + } + ] + } + } + }, + "title": "Glossary_UpdateTerm", + "operationId": "Glossary_UpdateTerm" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Lineage_Get.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Lineage_Get.json new file mode 100644 index 000000000000..a08de217b1c0 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Lineage_Get.json @@ -0,0 +1,26 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "a6894eb3-81f3-829b-2adc-52f3e603411a", + "depth": "1", + "width": "5", + "direction": "INPUT" + }, + "responses": { + "200": { + "body": { + "baseEntityGuid": "a6894eb3-81f3-829b-2adc-52f3e603411a", + "lineageDirection": "INPUT", + "lineageDepth": 1, + "lineageWidth": 1, + "childrenCount": 1, + "guidEntityMap": {}, + "widthCounts": {}, + "relations": [], + "parentRelations": [] + } + } + }, + "title": "Lineage_Get", + "operationId": "Lineage_Get" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Lineage_GetByUniqueAttribute.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Lineage_GetByUniqueAttribute.json new file mode 100644 index 000000000000..ab738e50995b --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Lineage_GetByUniqueAttribute.json @@ -0,0 +1,65 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "typeName": "azure_blob_path", + "depth": "2", + "width": "2", + "direction": "BOTH", + "attr:qualifiedName": "https://02cab97b-ba87-4675-972d-150b6cb522d3/entity.json/" + }, + "responses": { + "200": { + "body": { + "baseEntityGuid": "9b2751f1-2633-4f06-a578-e14fab4c52fd", + "lineageDirection": "BOTH", + "lineageDepth": 2, + "lineageWidth": 2, + "childrenCount": -1, + "guidEntityMap": { + "9b2751f1-2633-4f06-a578-e14fab4c52fd": { + "typeName": "azure_blob_path", + "attributes": { + "owner": "testOwner", + "modifiedTime": 0, + "qualifiedName": "https://02cab97b-ba87-4675-972d-150b6cb522d3/entity.json/", + "isBlob": false, + "accessTierInferred": false, + "description": "testDesc", + "committedBlockCount": 0, + "path": "/test/AzureBlobPath.json", + "size": 731, + "createTime": 0, + "name": "populate_azure_blob_path_02cab97b-ba87-4675-972d-150b6cb522d3", + "blobType": "BlockBlob", + "serverEncrypted": true + }, + "lastModifiedTS": "1", + "guid": "9b2751f1-2633-4f06-a578-e14fab4c52fd", + "status": "ACTIVE", + "displayText": "populate_azure_blob_path_02cab97b-ba87-4675-972d-150b6cb522d3", + "classificationNames": [ + "MICROSOFT.PERSONAL.EMAIL", + "MICROSOFT.PERSONAL.NAME" + ], + "meaningNames": [], + "meanings": [], + "isIncomplete": false, + "labels": [] + } + }, + "relations": [], + "parentRelations": [], + "widthCounts": { + "INPUT": { + "9b2751f1-2633-4f06-a578-e14fab4c52fd": 0 + }, + "OUTPUT": { + "9b2751f1-2633-4f06-a578-e14fab4c52fd": 0 + } + } + } + } + }, + "title": "Lineage_GetByUniqueAttribute", + "operationId": "Lineage_GetByUniqueAttribute" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Lineage_GetNextPage.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Lineage_GetNextPage.json new file mode 100644 index 000000000000..778a391f5b59 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Lineage_GetNextPage.json @@ -0,0 +1,27 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "a6894eb3-81f3-829b-2adc-52f3e603411a", + "offset": "0", + "limit": "5", + "direction": "INPUT", + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "baseEntityGuid": "a6894eb3-81f3-829b-2adc-52f3e603411a", + "lineageDirection": "INPUT", + "lineageDepth": 1, + "lineageWidth": 1, + "childrenCount": 1, + "guidEntityMap": {}, + "widthCounts": {}, + "relations": [], + "parentRelations": [] + } + } + }, + "title": "Lineage_GetNextPage", + "operationId": "Lineage_GetNextPage" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Relationship_Create.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Relationship_Create.json new file mode 100644 index 000000000000..89d3b4e5afec --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Relationship_Create.json @@ -0,0 +1,60 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "typeName": "AtlasGlossarySynonym", + "attributes": { + "expression": "Example Expression", + "steward": "Example Steward", + "description": "Example Description", + "source": null, + "status": null + }, + "end1": { + "guid": "856d31e6-e342-a1ce-6273-22ddb77029c6", + "typeName": "AtlasGlossaryTerm" + }, + "end2": { + "guid": "77481037-2874-9bdc-9b9e-76bb94ee71aa", + "typeName": "AtlasGlossaryTerm" + }, + "label": "r:AtlasGlossarySynonym", + "status": "ACTIVE", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "version": 0 + } + }, + "responses": { + "200": { + "body": { + "typeName": "AtlasGlossarySynonym", + "attributes": { + "expression": "Example Expression", + "steward": "Example Steward", + "description": "Example Description", + "source": null, + "status": null + }, + "guid": "63023d5b-c499-4360-a513-16bcbf73b039", + "end1": { + "guid": "856d31e6-e342-a1ce-6273-22ddb77029c6", + "typeName": "AtlasGlossaryTerm" + }, + "end2": { + "guid": "77481037-2874-9bdc-9b9e-76bb94ee71aa", + "typeName": "AtlasGlossaryTerm" + }, + "label": "r:AtlasGlossarySynonym", + "status": "ACTIVE", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1553840134724, + "updateTime": 1553840134724, + "version": 0 + } + } + }, + "title": "Relationship_Create", + "operationId": "Relationship_Create" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Relationship_Delete.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Relationship_Delete.json new file mode 100644 index 000000000000..c6e4848b9952 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Relationship_Delete.json @@ -0,0 +1,11 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "5cf8a9e5-c9fd-abe0-2e8c-d40024263dcb" + }, + "responses": { + "204": {} + }, + "title": "Relationship_Delete", + "operationId": "Relationship_Delete" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Relationship_Get.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Relationship_Get.json new file mode 100644 index 000000000000..182684f354bd --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Relationship_Get.json @@ -0,0 +1,41 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "5cf8a9e5-c9fd-abe0-2e8c-d40024263dcb", + "extendedInfo": "false" + }, + "responses": { + "200": { + "body": { + "relationship": { + "typeName": "AtlasGlossarySynonym", + "attributes": { + "expression": null, + "steward": null, + "description": null, + "source": null, + "status": null + }, + "guid": "de23cd5a-021c-413d-98a5-98752a1f7a3b", + "end1": { + "guid": "856d31e6-e342-a1ce-6273-22ddb77029c6", + "typeName": "AtlasGlossaryTerm" + }, + "end2": { + "guid": "b0942506-2d7d-1f45-d286-c29ca9e7f2ef", + "typeName": "AtlasGlossaryTerm" + }, + "label": "r:AtlasGlossarySynonym", + "status": "ACTIVE", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1553838993803, + "updateTime": 1553838993803, + "version": 0 + } + } + } + }, + "title": "Relationship_Get", + "operationId": "Relationship_Get" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Relationship_Update.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Relationship_Update.json new file mode 100644 index 000000000000..0cd955fe3154 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Relationship_Update.json @@ -0,0 +1,61 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "typeName": "AtlasGlossarySynonym", + "attributes": { + "expression": "Example Expression", + "steward": "Example Steward", + "description": "Example Description", + "source": null, + "status": null + }, + "guid": "b2810301-293f-493f-88f1-7ac8784fb1fd", + "end1": { + "guid": "77481037-2874-9bdc-9b9e-76bb94ee71aa", + "typeName": "AtlasGlossaryTerm" + }, + "end2": { + "guid": "b0942506-2d7d-1f45-d286-c29ca9e7f2ef", + "typeName": "AtlasGlossaryTerm" + }, + "label": "r:AtlasGlossarySynonym", + "status": "ACTIVE", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "version": 0 + } + }, + "responses": { + "200": { + "body": { + "typeName": "AtlasGlossarySynonym", + "attributes": { + "expression": "Example Expression", + "steward": "Example Steward", + "description": "Example Description", + "source": null, + "status": null + }, + "guid": "b2810301-293f-493f-88f1-7ac8784fb1fd", + "end1": { + "guid": "77481037-2874-9bdc-9b9e-76bb94ee71aa", + "typeName": "AtlasGlossaryTerm" + }, + "end2": { + "guid": "b0942506-2d7d-1f45-d286-c29ca9e7f2ef", + "typeName": "AtlasGlossaryTerm" + }, + "label": "r:AtlasGlossarySynonym", + "status": "ACTIVE", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1553839805039, + "updateTime": 1553839805039, + "version": 0 + } + } + }, + "title": "Relationship_Update", + "operationId": "Relationship_Update" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_BulkCreate.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_BulkCreate.json new file mode 100644 index 000000000000..d91723b6e888 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_BulkCreate.json @@ -0,0 +1,73 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "enumDefs": [], + "structDefs": [], + "classificationDefs": [], + "entityDefs": [ + { + "name": "azure_sql_server_example", + "superTypes": [ + "azure_resource" + ], + "typeVersion": "1.0", + "attributeDefs": [ + { + "name": "databases", + "typeName": "array", + "cardinality": "SET", + "isIndexable": false, + "isOptional": true, + "isUnique": false + } + ] + } + ], + "relationshipDefs": [] + } + }, + "responses": { + "200": { + "body": { + "enumDefs": [], + "structDefs": [], + "classificationDefs": [], + "entityDefs": [ + { + "category": "ENTITY", + "guid": "a47fd902-a564-45f1-aa51-ce9224955881", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1553672211954, + "updateTime": 1553672211954, + "version": 1, + "name": "azure_sql_server_example", + "description": "azure_sql_server_example", + "typeVersion": "1.0", + "attributeDefs": [ + { + "name": "databases", + "typeName": "array", + "isOptional": true, + "cardinality": "SET", + "valuesMinCount": 0, + "valuesMaxCount": 2147483647, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false + } + ], + "superTypes": [ + "azure_resource" + ], + "subTypes": [] + } + ], + "relationshipDefs": [] + } + } + }, + "title": "Type_BulkCreate", + "operationId": "Type_BulkCreate" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_BulkCreateBusinessMetadataDefs.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_BulkCreateBusinessMetadataDefs.json new file mode 100644 index 000000000000..433ff8867948 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_BulkCreateBusinessMetadataDefs.json @@ -0,0 +1,77 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "enumDefs": [], + "structDefs": [], + "classificationDefs": [], + "entityDefs": [], + "relationshipDefs": [], + "businessMetadataDefs": [ + { + "name": "myBizMetadata1", + "description": "", + "attributeDefs": [ + { + "name": "bizAttr1", + "typeName": "string", + "isOptional": true, + "cardinality": "SINGLE", + "isUnique": false, + "isIndexable": true, + "options": { + "maxStrLength": "50", + "applicableEntityTypes": "[\"Path\"]" + } + } + ] + } + ] + } + }, + "responses": { + "200": { + "body": { + "enumDefs": [], + "structDefs": [], + "classificationDefs": [], + "entityDefs": [], + "relationshipDefs": [], + "businessMetadataDefs": [ + { + "category": "BUSINESS_METADATA", + "guid": "f26dc6d1-be9c-a0ce-a274-b6388ff6e2eb", + "createdBy": "ServiceAdmin", + "updatedBy": "ServiceAdmin", + "createTime": 1646994112241, + "updateTime": 1646994112241, + "version": 1, + "name": "myBizMetadata1", + "description": "This is my businessMetadata1", + "typeVersion": "1.0", + "lastModifiedTS": "1", + "attributeDefs": [ + { + "name": "bizAttr1", + "typeName": "string", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": true, + "includeInNotification": false, + "options": { + "applicableEntityTypes": "[\"Path\"]", + "maxStrLength": "50" + } + } + ] + } + ] + } + } + }, + "title": "Type_BulkCreateBusinessMetadataDefs", + "operationId": "Type_BulkCreate" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_BulkDelete.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_BulkDelete.json new file mode 100644 index 000000000000..60ba8acc3b75 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_BulkDelete.json @@ -0,0 +1,35 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "enumDefs": [], + "structDefs": [], + "classificationDefs": [], + "entityDefs": [ + { + "name": "azure_sql_server_example", + "superTypes": [ + "azure_resource" + ], + "typeVersion": "1.0", + "attributeDefs": [ + { + "name": "databases", + "typeName": "array", + "cardinality": "SET", + "isIndexable": false, + "isOptional": true, + "isUnique": false + } + ] + } + ], + "relationshipDefs": [] + } + }, + "responses": { + "204": {} + }, + "title": "Type_BulkDelete", + "operationId": "Type_BulkDelete" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_BulkUpdate.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_BulkUpdate.json new file mode 100644 index 000000000000..7905abbea1af --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_BulkUpdate.json @@ -0,0 +1,290 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "body": { + "enumDefs": [], + "structDefs": [], + "classificationDefs": [], + "entityDefs": [ + { + "name": "azure_sql_server", + "superTypes": [ + "azure_resource" + ], + "typeVersion": "1.0", + "attributeDefs": [ + { + "name": "databases", + "typeName": "array", + "cardinality": "SET", + "isIndexable": false, + "isOptional": true, + "isUnique": false + } + ] + }, + { + "name": "azure_sql_db", + "superTypes": [ + "azure_resource" + ], + "typeVersion": "1.0", + "attributeDefs": [ + { + "name": "server", + "typeName": "azure_sql_server", + "cardinality": "SINGLE", + "constraints": [ + { + "type": "inverseRef", + "params": { + "attribute": "databases" + } + } + ], + "isIndexable": false, + "isOptional": false, + "isUnique": false + }, + { + "name": "schemas", + "typeName": "array", + "cardinality": "SET", + "isIndexable": false, + "isOptional": true, + "isUnique": false + }, + { + "name": "collation", + "typeName": "string", + "cardinality": "SINGLE", + "isIndexable": false, + "isOptional": true, + "isUnique": false + }, + { + "name": "compatibilityLevel", + "typeName": "int", + "cardinality": "SINGLE", + "isIndexable": false, + "isOptional": true, + "isUnique": false + } + ] + } + ], + "relationshipDefs": [ + { + "name": "azure_sql_server_databases", + "typeVersion": "1.0", + "relationshipCategory": "COMPOSITION", + "endDef1": { + "type": "azure_sql_server", + "name": "databases", + "isContainer": true, + "cardinality": "SET", + "isLegacyAttribute": true + }, + "endDef2": { + "type": "azure_sql_db", + "name": "server", + "isContainer": false, + "cardinality": "SINGLE", + "isLegacyAttribute": true + } + }, + { + "name": "azure_sql_db_schemas", + "typeVersion": "1.0", + "relationshipCategory": "COMPOSITION", + "endDef1": { + "type": "azure_sql_db", + "name": "schemas", + "isContainer": true, + "cardinality": "SET", + "isLegacyAttribute": true + }, + "endDef2": { + "type": "azure_sql_schema", + "name": "db", + "isContainer": false, + "cardinality": "SINGLE", + "isLegacyAttribute": true + } + } + ] + } + }, + "responses": { + "200": { + "body": { + "enumDefs": [], + "structDefs": [], + "classificationDefs": [], + "entityDefs": [ + { + "category": "ENTITY", + "guid": "a59fe369-2b1d-4bba-bb74-c273f3d74eb1", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1548841689501, + "updateTime": 1553671448662, + "version": 3, + "name": "azure_sql_server", + "description": "azure_sql_server", + "typeVersion": "1.0", + "attributeDefs": [ + { + "name": "databases", + "typeName": "array", + "isOptional": true, + "cardinality": "SET", + "valuesMinCount": 0, + "valuesMaxCount": 2147483647, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false + } + ], + "superTypes": [ + "azure_resource" + ], + "subTypes": [] + }, + { + "category": "ENTITY", + "guid": "cc33ec5a-205a-4853-91dd-c0ebd0049ffb", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1548841689575, + "updateTime": 1553671448783, + "version": 3, + "name": "azure_sql_db", + "description": "azure_sql_db", + "typeVersion": "1.0", + "attributeDefs": [ + { + "name": "server", + "typeName": "azure_sql_server", + "isOptional": false, + "cardinality": "SINGLE", + "valuesMinCount": 1, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "constraints": [ + { + "type": "inverseRef", + "params": { + "attribute": "databases" + } + } + ] + }, + { + "name": "schemas", + "typeName": "array", + "isOptional": true, + "cardinality": "SET", + "valuesMinCount": 0, + "valuesMaxCount": 2147483647, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false + }, + { + "name": "collation", + "typeName": "string", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false + }, + { + "name": "compatibilityLevel", + "typeName": "int", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false + } + ], + "superTypes": [ + "azure_resource" + ], + "subTypes": [] + } + ], + "relationshipDefs": [ + { + "category": "RELATIONSHIP", + "guid": "1e0584a8-2587-4e1d-a772-db1e879469af", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1548841689879, + "updateTime": 1553671449536, + "version": 3, + "name": "azure_sql_server_databases", + "description": "azure_sql_server_databases", + "typeVersion": "1.0", + "attributeDefs": [], + "relationshipCategory": "COMPOSITION", + "endDef1": { + "type": "azure_sql_server", + "name": "databases", + "isContainer": true, + "cardinality": "SET", + "isLegacyAttribute": true + }, + "endDef2": { + "type": "azure_sql_db", + "name": "server", + "isContainer": false, + "cardinality": "SINGLE", + "isLegacyAttribute": true + }, + "relationshipLabel": "r:azure_sql_server_databases" + }, + { + "category": "RELATIONSHIP", + "guid": "77ee34f6-ea48-4fe3-86bf-7e2e722f4596", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1548841690094, + "updateTime": 1553671449545, + "version": 3, + "name": "azure_sql_db_schemas", + "description": "azure_sql_db_schemas", + "typeVersion": "1.0", + "attributeDefs": [], + "relationshipCategory": "COMPOSITION", + "endDef1": { + "type": "azure_sql_db", + "name": "schemas", + "isContainer": true, + "cardinality": "SET", + "isLegacyAttribute": true + }, + "endDef2": { + "type": "azure_sql_schema", + "name": "db", + "isContainer": false, + "cardinality": "SINGLE", + "isLegacyAttribute": true + }, + "relationshipLabel": "r:azure_sql_db_schemas" + } + ] + } + } + }, + "title": "Type_BulkUpdate", + "operationId": "Type_BulkUpdate" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_Delete.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_Delete.json new file mode 100644 index 000000000000..8a364027401e --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_Delete.json @@ -0,0 +1,11 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "name": "hive_order" + }, + "responses": { + "204": {} + }, + "title": "Type_Delete", + "operationId": "Type_Delete" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetBusinessMetadataDefByGuid.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetBusinessMetadataDefByGuid.json new file mode 100644 index 000000000000..34921a8239b7 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetBusinessMetadataDefByGuid.json @@ -0,0 +1,43 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "d8757510-c866-61ba-486f-1afca09f43b8" + }, + "responses": { + "200": { + "body": { + "category": "BUSINESS_METADATA", + "guid": "d8757510-c866-61ba-486f-1afca09f43b8", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1671545620780, + "updateTime": 1671545620780, + "version": 1, + "name": "Business_Metadata_Type_Name", + "description": "Business_Metadata_Type_Name", + "typeVersion": "1.0", + "lastModifiedTS": "1", + "attributeDefs": [ + { + "name": "customAttribute", + "typeName": "string", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "options": { + "maxStrLength": "5000", + "isDisabled": "false", + "applicableEntityTypes": "[\"DataSet\"]" + } + } + ] + } + } + }, + "title": "Type_GetBusinessMetadataDefByGuid", + "operationId": "Type_GetBusinessMetadataDefByGuid" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetBusinessMetadataDefByName.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetBusinessMetadataDefByName.json new file mode 100644 index 000000000000..64d92fefd723 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetBusinessMetadataDefByName.json @@ -0,0 +1,43 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "name": "Business_Metadata_Type_Name" + }, + "responses": { + "200": { + "body": { + "category": "BUSINESS_METADATA", + "guid": "d8757510-c866-61ba-486f-1afca09f43b8", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1671545620780, + "updateTime": 1671545620780, + "version": 1, + "name": "Business_Metadata_Type_Name", + "description": "Business_Metadata_Type_Name", + "typeVersion": "1.0", + "lastModifiedTS": "1", + "attributeDefs": [ + { + "name": "customAttribute", + "typeName": "string", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "options": { + "maxStrLength": "5000", + "isDisabled": "false", + "applicableEntityTypes": "[\"DataSet\"]" + } + } + ] + } + } + }, + "title": "Type_GetBusinessMetadataDefByName", + "operationId": "Type_GetBusinessMetadataDefByName" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetByGuid.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetByGuid.json new file mode 100644 index 000000000000..e94b5ad8b518 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetByGuid.json @@ -0,0 +1,43 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "0ddc2fcf-ad17-4d06-984a-ffb2ffb2a941" + }, + "responses": { + "200": { + "body": { + "category": "ENUM", + "guid": "0ddc2fcf-ad17-4d06-984a-ffb2ffb2a941", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1604728877305, + "updateTime": 1604728877305, + "version": 1, + "name": "glossary_term_status_value", + "description": "glossary_term_status_value", + "typeVersion": "1.0", + "lastModifiedTS": "1", + "elementDefs": [ + { + "value": "Approved", + "ordinal": 0 + }, + { + "value": "Alert", + "ordinal": 1 + }, + { + "value": "Expired", + "ordinal": 2 + }, + { + "value": "Draft", + "ordinal": 3 + } + ] + } + } + }, + "title": "Type_GetByGuid", + "operationId": "Type_GetByGuid" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetByName.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetByName.json new file mode 100644 index 000000000000..804029d070e1 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetByName.json @@ -0,0 +1,43 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "name": "glossary_term_status_value" + }, + "responses": { + "200": { + "body": { + "category": "ENUM", + "guid": "0ddc2fcf-ad17-4d06-984a-ffb2ffb2a941", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1604728877305, + "updateTime": 1604728877305, + "version": 1, + "name": "glossary_term_status_value", + "description": "glossary_term_status_value", + "typeVersion": "1.0", + "lastModifiedTS": "1", + "elementDefs": [ + { + "value": "Approved", + "ordinal": 0 + }, + { + "value": "Alert", + "ordinal": 1 + }, + { + "value": "Expired", + "ordinal": 2 + }, + { + "value": "Draft", + "ordinal": 3 + } + ] + } + } + }, + "title": "Type_GetByName", + "operationId": "Type_GetByName" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetClassificationDefByGuid.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetClassificationDefByGuid.json new file mode 100644 index 000000000000..bf27840af6aa --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetClassificationDefByGuid.json @@ -0,0 +1,28 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "e79878fa-adba-4ee5-adc5-328d8841cd49" + }, + "responses": { + "200": { + "body": { + "category": "CLASSIFICATION", + "guid": "e79878fa-adba-4ee5-adc5-328d8841cd49", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1553065966043, + "updateTime": 1553065966043, + "version": 1, + "name": "MICROSOFT.GOVERNMENT.CANADA.SOCIAL_INSURANCE_NUMBER", + "description": "Canada Social Insurance Number", + "typeVersion": "1.0", + "attributeDefs": [], + "superTypes": [], + "entityTypes": [], + "subTypes": [] + } + } + }, + "title": "Type_GetClassificationDefByGuid", + "operationId": "Type_GetClassificationDefByGuid" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetClassificationDefByName.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetClassificationDefByName.json new file mode 100644 index 000000000000..e7a58bf32bfb --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetClassificationDefByName.json @@ -0,0 +1,28 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "name": "MICROSOFT.GOVERNMENT.CANADA.SOCIAL_INSURANCE_NUMBER" + }, + "responses": { + "200": { + "body": { + "category": "CLASSIFICATION", + "guid": "e79878fa-adba-4ee5-adc5-328d8841cd49", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1553065966043, + "updateTime": 1553065966043, + "version": 1, + "name": "MICROSOFT.GOVERNMENT.CANADA.SOCIAL_INSURANCE_NUMBER", + "description": "Canada Social Insurance Number", + "typeVersion": "1.0", + "attributeDefs": [], + "superTypes": [], + "entityTypes": [], + "subTypes": [] + } + } + }, + "title": "Type_GetClassificationDefByName", + "operationId": "Type_GetClassificationDefByName" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetEntityDefByGuid.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetEntityDefByGuid.json new file mode 100644 index 000000000000..9c0d6ce53cb7 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetEntityDefByGuid.json @@ -0,0 +1,58 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "4bc54c37-98a8-4de8-9ee8-182610859d43" + }, + "responses": { + "200": { + "body": { + "category": "ENTITY", + "guid": "4bc54c37-98a8-4de8-9ee8-182610859d43", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1553065960959, + "updateTime": 1553065960959, + "version": 1, + "name": "DataSet", + "description": "DataSet", + "typeVersion": "1.1", + "attributeDefs": [], + "superTypes": [ + "Asset" + ], + "subTypes": [ + "rdbms_foreign_key", + "azure_datalake_gen1_path", + "hive_table", + "mssql_column", + "sqoop_dbdatastore", + "hbase_column", + "azure_sql_table", + "rdbms_instance", + "azure_datalake_gen2_path", + "jms_topic", + "falcon_feed", + "hbase_table", + "rdbms_table", + "rdbms_column", + "hbase_column_family", + "hive_column", + "azure_blob_container", + "rdbms_db", + "column", + "azure_blob_path", + "kafka_topic", + "tabular_schema", + "azure_datalake_gen2_filesystem", + "rdbms_index", + "azure_sql_column", + "mssql_table", + "avro_type", + "fs_path" + ] + } + } + }, + "title": "Type_GetEntityDefByGuid", + "operationId": "Type_GetEntityDefByGuid" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetEntityDefByName.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetEntityDefByName.json new file mode 100644 index 000000000000..140ba1a5b309 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetEntityDefByName.json @@ -0,0 +1,58 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "name": "DataSet" + }, + "responses": { + "200": { + "body": { + "category": "ENTITY", + "guid": "4bc54c37-98a8-4de8-9ee8-182610859d43", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1553065960959, + "updateTime": 1553065960959, + "version": 1, + "name": "DataSet", + "description": "DataSet", + "typeVersion": "1.1", + "attributeDefs": [], + "superTypes": [ + "Asset" + ], + "subTypes": [ + "rdbms_foreign_key", + "azure_datalake_gen1_path", + "hive_table", + "mssql_column", + "sqoop_dbdatastore", + "hbase_column", + "azure_sql_table", + "rdbms_instance", + "azure_datalake_gen2_path", + "jms_topic", + "falcon_feed", + "hbase_table", + "rdbms_table", + "rdbms_column", + "hbase_column_family", + "hive_column", + "azure_blob_container", + "rdbms_db", + "column", + "azure_blob_path", + "kafka_topic", + "tabular_schema", + "azure_datalake_gen2_filesystem", + "rdbms_index", + "azure_sql_column", + "mssql_table", + "avro_type", + "fs_path" + ] + } + } + }, + "title": "Type_GetEntityDefByName", + "operationId": "Type_GetEntityDefByName" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetEnumDefByGuid.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetEnumDefByGuid.json new file mode 100644 index 000000000000..ab9e4048b0d2 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetEnumDefByGuid.json @@ -0,0 +1,38 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "644ab9c7-893a-4a4d-8e0a-591a6556d1a0" + }, + "responses": { + "200": { + "body": { + "category": "ENUM", + "guid": "644ab9c7-893a-4a4d-8e0a-591a6556d1a0", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1553065968102, + "updateTime": 1553065968102, + "version": 1, + "name": "hive_principal_type", + "description": "hive_principal_type", + "typeVersion": "1.0", + "elementDefs": [ + { + "value": "USER", + "ordinal": 1 + }, + { + "value": "ROLE", + "ordinal": 2 + }, + { + "value": "GROUP", + "ordinal": 3 + } + ] + } + } + }, + "title": "Type_GetEnumDefByGuid", + "operationId": "Type_GetEnumDefByGuid" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetEnumDefByName.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetEnumDefByName.json new file mode 100644 index 000000000000..62907f8f6a69 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetEnumDefByName.json @@ -0,0 +1,38 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "name": "hive_principal_type" + }, + "responses": { + "200": { + "body": { + "category": "ENUM", + "guid": "644ab9c7-893a-4a4d-8e0a-591a6556d1a0", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1553065968102, + "updateTime": 1553065968102, + "version": 1, + "name": "hive_principal_type", + "description": "hive_principal_type", + "typeVersion": "1.0", + "elementDefs": [ + { + "value": "USER", + "ordinal": 1 + }, + { + "value": "ROLE", + "ordinal": 2 + }, + { + "value": "GROUP", + "ordinal": 3 + } + ] + } + } + }, + "title": "Type_GetEnumDefByName", + "operationId": "Type_GetEnumDefByName" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetRelationshipDefByGuid.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetRelationshipDefByGuid.json new file mode 100644 index 000000000000..71c9a03a65d9 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetRelationshipDefByGuid.json @@ -0,0 +1,41 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "695edde1-2782-4a3c-841b-0b3aba25fe45" + }, + "responses": { + "200": { + "body": { + "category": "RELATIONSHIP", + "guid": "695edde1-2782-4a3c-841b-0b3aba25fe45", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1553065976797, + "updateTime": 1553065976797, + "version": 1, + "name": "storm_topology_nodes", + "description": "storm_topology_nodes", + "typeVersion": "1.0", + "attributeDefs": [], + "relationshipCategory": "ASSOCIATION", + "endDef1": { + "type": "storm_topology", + "name": "nodes", + "isContainer": false, + "cardinality": "SET", + "isLegacyAttribute": true + }, + "endDef2": { + "type": "storm_node", + "name": "topolgies", + "isContainer": false, + "cardinality": "SET", + "isLegacyAttribute": false + }, + "relationshipLabel": "r:storm_topology_nodes" + } + } + }, + "title": "Type_GetRelationshipDefByGuid", + "operationId": "Type_GetRelationshipDefByGuid" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetRelationshipDefByName.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetRelationshipDefByName.json new file mode 100644 index 000000000000..ecdafc07a934 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetRelationshipDefByName.json @@ -0,0 +1,41 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "name": "storm_topology_nodes" + }, + "responses": { + "200": { + "body": { + "category": "RELATIONSHIP", + "guid": "695edde1-2782-4a3c-841b-0b3aba25fe45", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1553065976797, + "updateTime": 1553065976797, + "version": 1, + "name": "storm_topology_nodes", + "description": "storm_topology_nodes", + "typeVersion": "1.0", + "attributeDefs": [], + "relationshipCategory": "ASSOCIATION", + "endDef1": { + "type": "storm_topology", + "name": "nodes", + "isContainer": false, + "cardinality": "SET", + "isLegacyAttribute": true + }, + "endDef2": { + "type": "storm_node", + "name": "topolgies", + "isContainer": false, + "cardinality": "SET", + "isLegacyAttribute": false + }, + "relationshipLabel": "r:storm_topology_nodes" + } + } + }, + "title": "Type_GetRelationshipDefByName", + "operationId": "Type_GetRelationshipDefByName" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetStructDefByGuid.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetStructDefByGuid.json new file mode 100644 index 000000000000..c31ae06aeeb6 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetStructDefByGuid.json @@ -0,0 +1,48 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "f1571b6e-ad08-4040-a9a7-c30ed935d437" + }, + "responses": { + "200": { + "body": { + "category": "STRUCT", + "guid": "f1571b6e-ad08-4040-a9a7-c30ed935d437", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1553065968145, + "updateTime": 1553065968145, + "version": 1, + "name": "hive_order", + "description": "hive_order", + "typeVersion": "1.0", + "attributeDefs": [ + { + "name": "order", + "typeName": "int", + "isOptional": false, + "cardinality": "SINGLE", + "valuesMinCount": 1, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false + }, + { + "name": "col", + "typeName": "string", + "isOptional": false, + "cardinality": "SINGLE", + "valuesMinCount": 1, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false + } + ] + } + } + }, + "title": "Type_GetStructDefByGuid", + "operationId": "Type_GetStructDefByGuid" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetStructDefByName.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetStructDefByName.json new file mode 100644 index 000000000000..26f8e843a6d6 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetStructDefByName.json @@ -0,0 +1,48 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "name": "hive_order" + }, + "responses": { + "200": { + "body": { + "category": "STRUCT", + "guid": "f1571b6e-ad08-4040-a9a7-c30ed935d437", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1553065968145, + "updateTime": 1553065968145, + "version": 1, + "name": "hive_order", + "description": "hive_order", + "typeVersion": "1.0", + "attributeDefs": [ + { + "name": "order", + "typeName": "int", + "isOptional": false, + "cardinality": "SINGLE", + "valuesMinCount": 1, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false + }, + { + "name": "col", + "typeName": "string", + "isOptional": false, + "cardinality": "SINGLE", + "valuesMinCount": 1, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false + } + ] + } + } + }, + "title": "Type_GetStructDefByName", + "operationId": "Type_GetStructDefByName" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetTermTemplateDefByGuid.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetTermTemplateDefByGuid.json new file mode 100644 index 000000000000..e6c263c691e5 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetTermTemplateDefByGuid.json @@ -0,0 +1,85 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "d776af9c-985c-4168-abb2-477523dbfc70", + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "category": "TERM_TEMPLATE", + "guid": "d776af9c-985c-4168-abb2-477523dbfc70", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1606300465443, + "updateTime": 1606300465443, + "version": 1, + "name": "MS KPI", + "description": "This is the description", + "typeVersion": "1.0", + "lastModifiedTS": "1", + "attributeDefs": [ + { + "name": "date", + "typeName": "date", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "options": { + "isDisabled": "false" + } + }, + { + "name": "single choice", + "typeName": "TERM_TEMPLATE_ENUM_EXAMPLE_1", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "options": { + "isDisabled": "false" + } + }, + { + "name": "multi choice", + "typeName": "array", + "isOptional": true, + "cardinality": "SET", + "valuesMinCount": 0, + "valuesMaxCount": 2147483647, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "options": { + "isDisabled": "false" + } + }, + { + "name": "plain string", + "typeName": "string", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "defaultValue": "this is a default value", + "options": { + "isDisabled": "false" + } + } + ] + } + } + }, + "title": "Type_GetTermTemplateDefByGuid", + "operationId": "Type_GetTermTemplateDefByGuid" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetTermTemplateDefByName.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetTermTemplateDefByName.json new file mode 100644 index 000000000000..d8b28d19db05 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_GetTermTemplateDefByName.json @@ -0,0 +1,85 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "name": "MS KPI", + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "category": "TERM_TEMPLATE", + "guid": "d776af9c-985c-4168-abb2-477523dbfc70", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1606300465443, + "updateTime": 1606300465443, + "version": 1, + "name": "MS KPI", + "description": "This is the description", + "typeVersion": "1.0", + "lastModifiedTS": "1", + "attributeDefs": [ + { + "name": "date", + "typeName": "date", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "options": { + "isDisabled": "false" + } + }, + { + "name": "single choice", + "typeName": "TERM_TEMPLATE_ENUM_EXAMPLE_1", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "options": { + "isDisabled": "false" + } + }, + { + "name": "multi choice", + "typeName": "array", + "isOptional": true, + "cardinality": "SET", + "valuesMinCount": 0, + "valuesMaxCount": 2147483647, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "options": { + "isDisabled": "false" + } + }, + { + "name": "plain string", + "typeName": "string", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "defaultValue": "this is a default value", + "options": { + "isDisabled": "false" + } + } + ] + } + } + }, + "title": "Type_GetTermTemplateDefByName", + "operationId": "Type_GetTermTemplateDefByName" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_List.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_List.json new file mode 100644 index 000000000000..1dd18ffe0898 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_List.json @@ -0,0 +1,272 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "includeTermTemplate": true, + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "enumDefs": [ + { + "category": "ENUM", + "guid": "0ddc2fcf-ad17-4d06-984a-ffb2ffb2a941", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1604728877305, + "updateTime": 1604728877305, + "version": 1, + "name": "glossary_term_status_value", + "description": "glossary_term_status_value", + "typeVersion": "1.0", + "lastModifiedTS": "1", + "elementDefs": [ + { + "value": "Approved", + "ordinal": 0 + }, + { + "value": "Alert", + "ordinal": 1 + }, + { + "value": "Expired", + "ordinal": 2 + }, + { + "value": "Draft", + "ordinal": 3 + } + ] + } + ], + "structDefs": [ + { + "category": "STRUCT", + "guid": "a8892bd7-59d6-47d8-b80d-ba4c7631098f", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1604729507664, + "updateTime": 1604729507664, + "version": 1, + "name": "blob_soft_deleted_state", + "description": "blob_soft_deleted_state", + "typeVersion": "1.0", + "serviceType": "Azure Blob Storage", + "lastModifiedTS": "1", + "attributeDefs": [ + { + "name": "deleted", + "typeName": "boolean", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false + }, + { + "name": "deletedTime", + "typeName": "date", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false + }, + { + "name": "remainingRetentionDays", + "typeName": "long", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false + } + ] + } + ], + "classificationDefs": [ + { + "category": "CLASSIFICATION", + "guid": "bd97460e-e5db-4701-8158-5b4062cf8a10", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1604730971448, + "updateTime": 1604730971448, + "version": 1, + "name": "MICROSOFT.GOVERNMENT.CHILE.CDI_NUMBER", + "description": "Chile Identity Card Number", + "typeVersion": "1.0", + "options": { + "displayName": "Chile Identity Card Number" + }, + "attributeDefs": [], + "superTypes": [], + "entityTypes": [], + "subTypes": [] + } + ], + "entityDefs": [ + { + "category": "ENTITY", + "guid": "7c53da5d-2797-4e8a-9b89-dd9b3b26ffa8", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1604730605047, + "updateTime": 1604730605047, + "version": 1, + "name": "sap_ecc_data_element", + "description": "sap_ecc_data_element", + "typeVersion": "1.0", + "serviceType": "SAP ECC", + "lastModifiedTS": "1", + "attributeDefs": [ + { + "name": "dataType", + "typeName": "string", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false + }, + { + "name": "length", + "typeName": "int", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false + }, + { + "name": "decimalPlaces", + "typeName": "int", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false + }, + { + "name": "documentation", + "typeName": "string", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false + } + ], + "superTypes": [ + "Asset" + ], + "subTypes": [], + "relationshipAttributeDefs": [ + { + "name": "package", + "typeName": "sap_ecc_package", + "isOptional": false, + "cardinality": "SINGLE", + "valuesMinCount": -1, + "valuesMaxCount": -1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "relationshipTypeName": "sap_ecc_package_data_elements", + "isLegacyAttribute": false + }, + { + "name": "table_fields", + "typeName": "array", + "isOptional": true, + "cardinality": "SET", + "valuesMinCount": -1, + "valuesMaxCount": -1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "relationshipTypeName": "sap_ecc_table_field_data_element", + "isLegacyAttribute": false + }, + { + "name": "domain", + "typeName": "sap_ecc_domain", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": -1, + "valuesMaxCount": -1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "relationshipTypeName": "sap_ecc_data_element_domain", + "isLegacyAttribute": false + }, + { + "name": "meanings", + "typeName": "array", + "isOptional": true, + "cardinality": "SET", + "valuesMinCount": -1, + "valuesMaxCount": -1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "relationshipTypeName": "AtlasGlossarySemanticAssignment", + "isLegacyAttribute": false + } + ] + } + ], + "relationshipDefs": [ + { + "category": "RELATIONSHIP", + "guid": "6284b865-cbb3-4236-83ed-059a407f06fb", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1604729078159, + "updateTime": 1604729323080, + "version": 2, + "name": "storm_topology_nodes", + "description": "storm_topology_nodes", + "typeVersion": "1.1", + "serviceType": "storm", + "lastModifiedTS": "2", + "attributeDefs": [], + "relationshipCategory": "ASSOCIATION", + "endDef1": { + "type": "storm_topology", + "name": "nodes", + "isContainer": false, + "cardinality": "SET", + "isLegacyAttribute": true + }, + "endDef2": { + "type": "storm_node", + "name": "topolgies", + "isContainer": false, + "cardinality": "SET", + "isLegacyAttribute": false + } + } + ] + } + } + }, + "title": "Type_List", + "operationId": "Type_List" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_ListEnumDefs.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_ListEnumDefs.json new file mode 100644 index 000000000000..99b6f55910b0 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_ListEnumDefs.json @@ -0,0 +1,93 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "type": "ENUM", + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "enumDefs": [ + { + "category": "ENUM", + "guid": "0ddc2fcf-ad17-4d06-984a-ffb2ffb2a941", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1604728877305, + "updateTime": 1604728877305, + "version": 1, + "name": "glossary_term_status_value", + "description": "glossary_term_status_value", + "typeVersion": "1.0", + "lastModifiedTS": "1", + "elementDefs": [ + { + "value": "Approved", + "ordinal": 0 + }, + { + "value": "Alert", + "ordinal": 1 + }, + { + "value": "Expired", + "ordinal": 2 + }, + { + "value": "Draft", + "ordinal": 3 + } + ] + }, + { + "category": "ENUM", + "guid": "c694edf1-6f9e-4b60-b832-23e8d6187675", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1604728832692, + "updateTime": 1604728905525, + "version": 2, + "name": "AtlasGlossaryTermRelationshipStatus", + "description": "TermRelationshipStatus defines how reliable the relationship is between two glossary terms", + "typeVersion": "1.1", + "serviceType": "atlas_core", + "lastModifiedTS": "2", + "elementDefs": [ + { + "value": "DRAFT", + "description": "DRAFT means the relationship is under development.", + "ordinal": 0 + }, + { + "value": "ACTIVE", + "description": "ACTIVE means the relationship is validated and in use.", + "ordinal": 1 + }, + { + "value": "DEPRECATED", + "description": "DEPRECATED means the the relationship is being phased out.", + "ordinal": 2 + }, + { + "value": "OBSOLETE", + "description": "OBSOLETE means that the relationship should not be used anymore.", + "ordinal": 3 + }, + { + "value": "OTHER", + "description": "OTHER means that there is another status.", + "ordinal": 99 + } + ] + } + ], + "structDefs": [], + "classificationDefs": [], + "entityDefs": [], + "relationshipDefs": [] + } + } + }, + "title": "Type_ListEnumDefs", + "operationId": "Type_List" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_ListHeaders.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_ListHeaders.json new file mode 100644 index 000000000000..288c815d8a88 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_ListHeaders.json @@ -0,0 +1,29 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "includeTermTemplate": true + }, + "responses": { + "200": { + "body": [ + { + "guid": "644ab9c7-893a-4a4d-8e0a-591a6556d1a0", + "name": "hive_principal_type", + "category": "ENUM" + }, + { + "guid": "e5030e81-da05-4571-84f1-265ce20fa6d9", + "name": "AtlasGlossaryTermRelationshipStatus", + "category": "ENUM" + }, + { + "guid": "d776af9c-985c-4168-abb2-477523dbfc70", + "name": "MS KPI", + "category": "TERM_TEMPLATE" + } + ] + } + }, + "title": "Type_ListHeaders", + "operationId": "Type_ListHeaders" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_ListTermTemplateDefs.json b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_ListTermTemplateDefs.json new file mode 100644 index 000000000000..c5336e63031c --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/examples/2023-09-01/Type_ListTermTemplateDefs.json @@ -0,0 +1,94 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "type": "TERM_TEMPLATE", + "api-version": "2023-09-01" + }, + "responses": { + "200": { + "body": { + "enumDefs": [], + "structDefs": [], + "classificationDefs": [], + "entityDefs": [], + "relationshipDefs": [], + "termTemplateDefs": [ + { + "category": "TERM_TEMPLATE", + "guid": "d776af9c-985c-4168-abb2-477523dbfc70", + "createdBy": "ExampleCreator", + "updatedBy": "ExampleUpdator", + "createTime": 1606300465443, + "updateTime": 1606300465443, + "version": 1, + "name": "MS KPI", + "description": "This is the description", + "typeVersion": "1.0", + "lastModifiedTS": "1", + "attributeDefs": [ + { + "name": "date", + "typeName": "date", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "options": { + "isDisabled": "false" + } + }, + { + "name": "single choice", + "typeName": "TERM_TEMPLATE_ENUM_EXAMPLE_1", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "options": { + "isDisabled": "false" + } + }, + { + "name": "multi choice", + "typeName": "array", + "isOptional": true, + "cardinality": "SET", + "valuesMinCount": 0, + "valuesMaxCount": 2147483647, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "options": { + "isDisabled": "false" + } + }, + { + "name": "plain string", + "typeName": "string", + "isOptional": true, + "cardinality": "SINGLE", + "valuesMinCount": 0, + "valuesMaxCount": 1, + "isUnique": false, + "isIndexable": false, + "includeInNotification": false, + "defaultValue": "this is a default value", + "options": { + "isDisabled": "false" + } + } + ] + } + ] + } + } + }, + "title": "Type_ListTermTemplateDefs", + "operationId": "Type_List" +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/main.tsp b/specification/purview/Azure.Analytics.Purview.DataMap/main.tsp new file mode 100644 index 000000000000..67657574ea86 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/main.tsp @@ -0,0 +1,42 @@ +import "@typespec/rest"; +import "@typespec/http"; +import "./routes.tsp"; + +using TypeSpec.Rest; +using TypeSpec.Http; +using TypeSpec.Versioning; + +@service({ + title: "Azure Analytics Purview Data Map", +}) +@server( + "{endpoint}/datamap/api", + "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.", + { + endpoint: string, + } +) +@doc(""" +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. +""") +@useAuth(AuthToken) +@versioned(ApiVersions) +namespace PurviewDataMap; + +@doc("Service API versions") +enum ApiVersions { + @doc("2023-09-01 service API version") + @useDependency(Azure.Core.Versions.v1_0_Preview_2) + v2023_09_01: "2023-09-01", +} + +alias AuthToken = OAuth2Auth<[ + { + type: OAuth2FlowType.implicit; + authorizationUrl: "https://login.microsoftonline.com/common/oauth2/authorize"; + scopes: ["https://purview.azure.net/.default"]; + } +]>; diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/models.tsp b/specification/purview/Azure.Analytics.Purview.DataMap/models.tsp new file mode 100644 index 000000000000..30de3c98afe2 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/models.tsp @@ -0,0 +1,1949 @@ +import "@typespec/http"; +import "@typespec/rest"; + +using TypeSpec.Rest; +using TypeSpec.Http; + +namespace PurviewDataMap; + +@doc("Enum for business attribute update behavior") +enum BusinessAttributeUpdateBehavior { + @doc("Ignore the business attribute payload for update.") + Ignore: "ignore", + + @doc("Replace all the business attributes using the payload.") + Replace: "replace", + + @doc("Merge the business attributes. Business attributes will not be updated if not provided.") + Merge: "merge", +} + +@doc("Status - can be active or deleted") +enum EntityStatus { + @doc("The status is active.") + Active: "ACTIVE", + + @doc("The status is deleted.") + Deleted: "DELETED", +} + +@doc("Status for term assignment") +enum AtlasTermAssignmentStatus { + @doc("The status is discovered.") + Discovered: "DISCOVERED", + + @doc("The status is proposed.") + Proposed: "PROPOSED", + + @doc("The status is imported.") + Imported: "IMPORTED", + + @doc("The status is validated.") + Validated: "VALIDATED", + + @doc("The status is deprecated.") + Deprecated: "DEPRECATED", + + @doc("The status is obsolete.") + Obsolete: "OBSOLETE", + + @doc("Other status.") + Other: "OTHER", +} + +@doc("Type for sorting") +enum SortType { + @doc("No sorting order") + None: "NONE", + + @doc("Use ascending order for sorting") + Ascend: "ASC", + + @doc("Use descending order for sorting") + Descend: "DESC", +} + +@doc("Status for import") +enum ImportStatus { + @doc("Success") + Success: "SUCCESS", + + @doc("Failed") + Failed: "FAILED", +} + +@doc("Status for atlas term relationship") +enum AtlasTermRelationshipStatus { + @doc("draft") + Draft: "DRAFT", + + @doc("active") + Active: "ACTIVE", + + @doc("deprecated") + Deprecated: "DEPRECATED", + + @doc("obsolete") + Obsolete: "OBSOLETE", + + @doc("other") + Other: "OTHER", +} + +@doc("Status for term") +enum TermStatus { + @doc("draft") + Draft, + + @doc("approved") + Approved, + + @doc("alert") + Alert, + + @doc("expired") + Expired, +} + +@doc("Status for atlas relationship") +enum StatusAtlasRelationship { + @doc("active") + Active: "ACTIVE", + + @doc("deleted") + Deleted: "DELETED", +} + +@doc("Lineage direction") +enum LineageDirection { + @doc("input") + Input: "INPUT", + + @doc("output") + Output: "OUTPUT", + + @doc("both") + Both: "BOTH", +} + +@doc("Cardinality") +enum CardinalityValue { + @doc("single") + Single: "SINGLE", + + @doc("list") + List: "LIST", + + @doc("set") + Set: "SET", +} + +@doc("Type Category") +enum TypeCategory { + @doc("primitive") + Primitive: "PRIMITIVE", + + @doc("object id type") + ObjectIdType: "OBJECT_ID_TYPE", + + @doc("enum") + Enum: "ENUM", + + @doc("struct") + Struct: "STRUCT", + + @doc("classification") + Classification: "CLASSIFICATION", + + @doc("entity") + Entity: "ENTITY", + + @doc("array") + Array: "ARRAY", + + @doc("map") + Map: "MAP", + + @doc("relationship") + Relationship: "RELATIONSHIP", + + @doc("term template") + TermTemplate: "TERM_TEMPLATE", +} + +@doc("Rounding Mode") +enum RoundingMode { + @doc("up") + Up: "UP", + + @doc("down") + Down: "DOWN", + + @doc("ceiling") + Ceiling: "CEILING", + + @doc("floor") + Floor: "FLOOR", + + @doc("half up") + HalfUp: "HALF_UP", + + @doc("half down") + HalfDown: "HALF_DOWN", + + @doc("half even") + HalfEven: "HALF_EVEN", + + @doc("unnecessary") + Unnecessary: "UNNECESSARY", +} + +@doc("Relationship Category") +enum RelationshipCategory { + @doc("association") + Association: "ASSOCIATION", + + @doc("aggregation") + Aggregation: "AGGREGATION", + + @doc("composition") + Composition: "COMPOSITION", +} + +@doc("Search Filter Operator") +enum FilterOperator { + @doc("equal") + eq, + + @doc("not equal") + ne, + + @doc("greater than") + gt, + + @doc("less than") + lt, + + @doc("greater than or equal to") + ge, + + @doc("less than or equal to") + le, + + @doc("contains") + contains, + + @doc("start with") + startswith, + + @doc("prefix") + prefix, + + @doc("time range") + timerange, + + @doc("exists") + exists, +} + +@doc(""" +An instance of an entity along with extended info - like hive_table, +hive_database. +""") +model AtlasEntityWithExtInfo { + ...AtlasEntityExtInfo; + + @doc("An instance of an entity - like hive_table, hive_database.") + entity?: AtlasEntity; +} + +@doc("An instance of an entity - like hive_table, hive_database.") +model AtlasEntity { + ...AtlasStruct; + + #suppress "@azure-tools/typespec-azure-core/bad-record-type" "Should use Record to model Map" + @doc("Business attributes") + businessAttributes?: Record; + + @doc("An array of classifications.") + classifications?: AtlasClassification[]; + + @doc("The created time of the record.") + createTime?: safeint; + + @doc("The user who created the record.") + createdBy?: string; + + @doc("Custom Attribute") + customAttributes?: Record; + + @doc("The GUID of the entity.") + guid?: string; + + @doc("The home ID of the entity.") + homeId?: string; + + @doc("The collection ID of the entity.") + @visibility("read") + collectionId?: string; + + @doc("Whether it is a shell entity") + isIncomplete?: boolean; + + @doc("labels") + labels?: string[]; + + @doc("An array of term assignment headers indicating the meanings of the entity.") + meanings?: AtlasTermAssignmentHeader[]; + + @doc("Used to record the provenance of an instance of an entity or relationship.") + provenanceType?: int32; + + @doc("Determines if there's a proxy.") + proxy?: boolean; + + #suppress "@azure-tools/typespec-azure-core/bad-record-type" "Should use Record to model Map" + @doc("The attributes of relationship.") + relationshipAttributes?: Record; + + @doc(""" +Status of the entity - can be active or deleted. Deleted entities are not +removed. +""") + status?: EntityStatus; + + @doc("The update time of the record.") + updateTime?: safeint; + + @doc("The user who updated the record.") + updatedBy?: string; + + @doc("The version of the entity.") + version?: int64; + + @doc("The dictionary of contacts for entities. Key could be Expert or Owner.") + contacts?: Record; +} + +@doc(""" +An instance of a classification; it doesn't have an identity, this object +exists only when associated with an entity. +""") +model AtlasClassification { + ...AtlasStruct; + + @doc("The GUID of the entity.") + entityGuid?: string; + + @doc(""" +Status of the entity - can be active or deleted. Deleted entities are not +removed. +""") + entityStatus?: EntityStatus; + + @doc("Determines if propagations will be removed on entity deletion.") + removePropagationsOnEntityDelete?: boolean; + + @doc("An array of time boundaries indicating validity periods.") + validityPeriods?: TimeBoundary[]; +} + +@doc("Captures time-boundary details") +model TimeBoundary { + @doc("The end of the time boundary.") + endTime?: string; + + @doc("The start of the time boundary.") + startTime?: string; + + @doc("The timezone of the time boundary.") + timeZone?: string; +} + +@doc(""" +Captures details of struct contents. Not instantiated directly, used only via +AtlasEntity, AtlasClassification. +""") +model AtlasStruct { + #suppress "@azure-tools/typespec-azure-core/bad-record-type" "Should use Record to model Map" + @doc("The attributes of the struct.") + attributes?: Record; + + @doc("The name of the type.") + typeName?: string; + + #suppress "@azure-tools/typespec-azure-core/casing-style" "It is an Atlas model" + @doc("ETag for concurrency control.") + lastModifiedTS?: string; +} + +@doc("The header for term assignment.") +model AtlasTermAssignmentHeader { + @doc("The confidence of the term assignment.") + confidence?: int32; + + @doc("The user who created the record.") + createdBy?: string; + + @doc("The description of the term assignment.") + description?: string; + + @doc("The display text.") + displayText?: string; + + @doc("The expression of the term assignment.") + expression?: string; + + @doc("The GUID of the relationship.") + relationGuid?: Azure.Core.uuid; + + @doc("The status of terms assignment.") + status?: AtlasTermAssignmentStatus; + + @doc("The steward of the term.") + steward?: string; + + @doc("The GUID of the term.") + termGuid?: Azure.Core.uuid; +} + +@doc("ContactInfo") +model ContactInfo { + @doc("Azure Active Directory object Id.") + id?: string; + + @doc("additional information to describe this contact.") + info?: string; +} + +@doc(""" +An instance of an entity along with extended info - like hive_table, +hive_database. +""") +model AtlasEntityExtInfo { + @doc("The referred entities.") + referredEntities?: Record; +} + +@doc("The mutation response result of entity.") +model EntityMutationResult { + @doc("A map of GUID assignments with entities.") + guidAssignments?: Record; + + @doc("The entity headers of mutated entities.") + mutatedEntities?: Record; + + @doc("An array of entity headers that partially updated.") + partialUpdatedEntities?: AtlasEntityHeader[]; +} + +@doc("An instance of an entity - like hive_table, hive_database.") +model AtlasEntityHeader { + ...AtlasStruct; + + @doc("An array of classification names.") + classificationNames?: string[]; + + @doc("An array of classifications.") + classifications?: AtlasClassification[]; + + @doc("The display text.") + displayText?: string; + + @doc("The GUID of the record.") + guid?: string; + + @doc("Whether it is a shell entity") + isIncomplete?: boolean; + + @doc("labels") + labels?: string[]; + + @doc("An array of meanings.") + meaningNames?: string[]; + + @doc("An array of term assignment headers.") + meanings?: AtlasTermAssignmentHeader[]; + + @doc(""" +Status of the entity - can be active or deleted. Deleted entities are not +removed. +""") + status?: EntityStatus; +} + +@doc("An error response from the service") +@error +model AtlasErrorResponse { + @doc("The request ID.") + requestId?: Azure.Core.uuid; + + @doc("The error code.") + errorCode?: string; + + @doc("The error message.") + errorMessage?: string; +} + +@doc(""" +An instance of an entity along with extended info - like hive_table, +hive_database. +""") +model AtlasEntitiesWithExtInfo { + ...AtlasEntityExtInfo; + + @doc("An array of entities.") + entities?: AtlasEntity[]; +} + +@doc("The request payload for classification association.") +model ClassificationAssociateOptions { + @doc(""" +An instance of a classification; it doesn't have an identity, this object +exists only when associated with an entity. +""") + classification?: AtlasClassification; + + @doc("The GUID of the entity.") + entityGuids?: string[]; +} + +#suppress "@azure-tools/typespec-azure-core/bad-record-type" "Should use unknown to model Object" +@doc("REST serialization friendly list.") +model AtlasClassifications { + ...PList; +} + +#suppress "@azure-tools/typespec-azure-core/casing-style" "It is an Atlas model" +@doc("Paginated-list, for returning search results.") +model PList { + #suppress "@azure-tools/typespec-azure-core/bad-record-type" "Should use unknown to model Object>" + @doc("An array of objects.") + list?: unknown[]; + + @doc("The size of the page.") + pageSize?: int32; + + @doc("The sorted by field.") + sortBy?: string; + + @doc("to specify whether the result should be sorted? If yes, whether asc or desc.") + sortType?: SortType; + + @doc("The start index of the page.") + startIndex?: int32; + + @doc("The total count of items.") + totalCount?: int32; +} + +@doc("An instance of an entity header map.") +model AtlasEntityHeaders { + @doc("The description of the guid header map,") + guidHeaderMap?: Record; +} + +@doc("Bulk import result") +model BulkImportResult { + @doc("failed importInfoList") + failedImportInfoList?: ImportInfo[]; + + @doc("successful importInfoList") + successImportInfoList?: ImportInfo[]; +} + +@doc("ImportInfo") +model ImportInfo { + @doc("childObjectName") + childObjectName?: string; + + @doc("importStatus") + importStatus?: ImportStatus; + + @doc("parentObjectName") + parentObjectName?: string; + + @doc("remarks") + remarks?: string; +} + +@doc("MoveEntitiesOptions") +model MoveEntitiesOptions { + @doc("An array of entity guids to be moved to target collection.") + entityGuids?: string[]; +} + +@doc("The glossary object.") +model AtlasGlossary { + ...AtlasGlossaryBaseObject; + + @doc("An array of categories.") + categories?: AtlasRelatedCategoryHeader[]; + + @doc("The language of the glossary.") + language?: string; + + @doc("An array of related term headers.") + terms?: AtlasRelatedTermHeader[]; + + @doc("The usage of the glossary.") + usage?: string; +} + +@doc("The header of the related category.") +model AtlasRelatedCategoryHeader { + @doc("The GUID of the category.") + categoryGuid?: string; + + @doc("The description of the category header.") + description?: string; + + @doc("The display text.") + displayText?: string; + + @doc("The GUID of the parent category.") + parentCategoryGuid?: string; + + @doc("The GUID of the relationship.") + relationGuid?: string; +} + +@doc("The header of the related term.") +model AtlasRelatedTermHeader { + @doc("The description of the related term.") + description?: string; + + @doc("The display text.") + displayText?: string; + + @doc("The expression of the term.") + expression?: string; + + @doc("The GUID of the relationship.") + relationGuid?: string; + + @doc("The status of term relationship.") + status?: AtlasTermRelationshipStatus; + + @doc("The steward of the term.") + steward?: string; + + @doc("The GUID of the term.") + termGuid?: string; +} + +@doc("The glossary base object.") +model AtlasGlossaryBaseObject { + ...AtlasBaseModelObject; + + @doc("An array of classifications.") + classifications?: AtlasClassification[]; + + @doc("The long version description.") + longDescription?: string; + + @doc("The name of the glossary object.") + name?: string; + + @doc("The qualified name of the glossary object.") + qualifiedName?: string; + + @doc("The short version of description.") + shortDescription?: string; + + #suppress "@azure-tools/typespec-azure-core/casing-style" "It is an Atlas model" + @doc("ETag for concurrency control.") + lastModifiedTS?: string; + + @doc("The created time of the record.") + createTime?: safeint; + + @doc("The user who created the record.") + createdBy?: string; + + @doc("The update time of the record.") + updateTime?: safeint; + + @doc("The user who updated the record.") + updatedBy?: string; +} + +alias AtlasBaseModelObject = { + @doc("The GUID of the object.") + guid?: string; +}; + +@doc("The glossary category.") +model AtlasGlossaryCategory { + ...AtlasGlossaryBaseObject; + + @doc("The glossary header with basic information.") + anchor?: AtlasGlossaryHeader; + + @doc("An array of children categories.") + childrenCategories?: AtlasRelatedCategoryHeader[]; + + @doc("The header of the related category.") + parentCategory?: AtlasRelatedCategoryHeader; + + @doc("An array of related term headers.") + terms?: AtlasRelatedTermHeader[]; +} + +@doc("The glossary header with basic information.") +model AtlasGlossaryHeader { + @doc("The display text.") + displayText?: string; + + @doc("The GUID of the glossary.") + glossaryGuid?: string; + + @doc("The GUID of the relationship.") + relationGuid?: string; +} + +@doc("The glossary term.") +model AtlasGlossaryTerm { + ...AtlasGlossaryBaseObject; + + @doc("The abbreviation of the term.") + abbreviation?: string; + + #suppress "@azure-tools/typespec-azure-core/bad-record-type" "Should use unknown to model Object" + @doc("The name of the template.") + templateName?: unknown[]; + + @doc("The glossary header with basic information.") + anchor?: AtlasGlossaryHeader; + + @doc("An array of related term headers as antonyms.") + antonyms?: AtlasRelatedTermHeader[]; + + @doc("Status of the AtlasGlossaryTerm") + status?: TermStatus; + + @doc("The nick name of the term.") + nickName?: string; + + @doc("The hierarchy information of the term.") + hierarchyInfo?: PurviewObjectId[]; + + @doc("An array of resource link for term") + resources?: ResourceLink[]; + + @doc("The dictionary of contacts for terms. Key could be Expert or Steward.") + contacts?: Record; + + #suppress "@azure-tools/typespec-azure-core/bad-record-type" "Should use Recode to model Map" + @doc(""" +The custom attributes of the term, which is map>. +The +key of the first layer map is term template name. +""") + attributes?: Record>; + + @doc("An array of related object IDs.") + assignedEntities?: AtlasRelatedObjectId[]; + + @doc("An array of term categorization headers.") + categories?: AtlasTermCategorizationHeader[]; + + @doc("An array of related term headers.") + classifies?: AtlasRelatedTermHeader[]; + + @doc("An array of examples.") + examples?: string[]; + + @doc("An array of related term headers indicating the is-a relationship.") + isA?: AtlasRelatedTermHeader[]; + + @doc("An array of preferred related term headers.") + preferredTerms?: AtlasRelatedTermHeader[]; + + @doc("An array of related term headers that are preferred to.") + preferredToTerms?: AtlasRelatedTermHeader[]; + + @doc("An array of related term headers that are replaced by.") + replacedBy?: AtlasRelatedTermHeader[]; + + @doc("An array of related term headers for replacement.") + replacementTerms?: AtlasRelatedTermHeader[]; + + @doc("An array of related term headers for see also.") + seeAlso?: AtlasRelatedTermHeader[]; + + @doc("An array of related term headers as synonyms.") + synonyms?: AtlasRelatedTermHeader[]; + + @doc("An array of translated related term headers.") + translatedTerms?: AtlasRelatedTermHeader[]; + + @doc("An array of related term headers for translation.") + translationTerms?: AtlasRelatedTermHeader[]; + + @doc("The usage of the term.") + usage?: string; + + @doc("An array of related term headers as valid values.") + validValues?: AtlasRelatedTermHeader[]; + + @doc("An array of related term headers as valid values for other records.") + validValuesFor?: AtlasRelatedTermHeader[]; +} + +@doc("PurviewObjectId") +model PurviewObjectId { + ...AtlasObjectId; + + @doc("Name") + name?: string; + + @doc("Display text") + displayText?: string; + + @doc("Item path") + itemPath?: string; + + @doc("Resource Id") + resourceId?: string; + + #suppress "@azure-tools/typespec-azure-core/bad-record-type" "Should use Recode to model Map" + @doc("Dictionary of ") + properties?: Record; +} + +@doc("Reference to an object-instance of a type - like entity.") +model AtlasObjectId { + @doc("The GUID of the object.") + guid?: string; + + @doc("The name of the type.") + typeName?: string; + + #suppress "@azure-tools/typespec-azure-core/bad-record-type" "Should use Recode to model Map" + @doc("The unique attributes of the object.") + uniqueAttributes?: Record; +} + +@doc("ResourceLink") +model ResourceLink { + @doc("Display name for url.") + displayName?: string; + + @doc("web url. http or https") + url?: string; +} + +@doc(""" +Reference to an object-instance of AtlasEntity type used in relationship +attribute values +""") +model AtlasRelatedObjectId { + ...AtlasObjectId; + + @doc("The display text.") + displayText?: string; + + @doc(""" +Status of the entity - can be active or deleted. Deleted entities are not +removed. +""") + entityStatus?: EntityStatus; + + @doc("Relationship type") + relationshipType?: string; + + @doc(""" +Captures details of struct contents. Not instantiated directly, used only via +AtlasEntity, AtlasClassification. +""") + relationshipAttributes?: AtlasStruct; + + @doc("The GUID of the relationship.") + relationshipGuid?: Azure.Core.uuid; + + @doc("The enum of relationship status.") + relationshipStatus?: StatusAtlasRelationship; +} + +@doc("The basic information for term categorization.") +model AtlasTermCategorizationHeader { + @doc("The GUID of the category.") + categoryGuid?: Azure.Core.uuid; + + @doc("The description of the record.") + description?: string; + + @doc("The display text.") + displayText?: string; + + @doc("The GUID of the relationship.") + relationGuid?: Azure.Core.uuid; + + @doc("The status of term relationship.") + status?: AtlasTermRelationshipStatus; +} + +@doc("The extended information of glossary.") +model AtlasGlossaryExtInfo { + ...AtlasGlossary; + + @doc("The glossary category information.") + categoryInfo?: Record; + + @doc("The glossary term information.") + termInfo?: Record; +} + +@doc("The search query of advanced search request.") +model QueryOptions { + @doc("The keywords applied to all searchable fields.") + keywords?: string; + + @doc(""" +The limit of the number of the search result. default value is 50; maximum +value is 1000. +""") + limit?: int32; + + @doc(""" +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. +""") + continuationToken?: string; + + #suppress "@azure-tools/typespec-azure-core/bad-record-type" "This is a flexible property" + @doc("The sort order of search results, can specify multiple fields.") + orderby?: unknown[]; + + #suppress "@azure-tools/typespec-azure-core/no-unknown" "Should use unknown to model Object" + @doc("The filter for the search. See examples for the usage of supported filters.") + filter?: unknown; + + @doc("The facets for search. See examples for the usage of supported facets.") + facets?: SearchFacetItem[]; + + @doc("The taxonomy setting for search.") + taxonomySetting?: SearchTaxonomySetting; +} + +@doc("The content of a search facet result item.") +model SearchFacetItem { + @doc("The count of the facet item.") + count?: int32; + + @doc("The name of the facet item.") + facet?: string; + + @doc("Define the sorting criteria for items") + sort?: SearchFacetSort; +} + +@doc("The sorting criteria") +model SearchFacetSort { + @doc("Order by count") + count?: SearchSortOrder; + + @doc("Order by value") + value?: SearchSortOrder; +} + +@doc("Search sort order") +enum SearchSortOrder { + @doc("Use ascending order for sorting") + Ascend: "asc", + + @doc("Use descending order for sorting") + Descend: "desc", +} + +@doc("Taxonomy setting for search request") +model SearchTaxonomySetting { + @doc("Asset types") + assetTypes?: string[]; + + @doc("The content of a search facet result item.") + facet?: SearchFacetItem; +} + +@doc("The result of the search result.") +model QueryResult { + @doc(""" +The total number of search results (not the number of documents in a single +page). +""") + @encodedName("application/json", "@search.count") + searchCount?: int32; + + @doc("'True' if the '@search.count' is an approximate value and vise versa.") + @encodedName("application/json", "@search.count.approximate") + searchCountApproximate?: boolean; + + @doc("The token used to get next batch of data. Absent if there's no more data.") + continuationToken?: string; + + @doc(""" +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. +""") + @encodedName("application/json", "@search.facets") + searchFacets?: SearchFacetResultValue; + + @doc("Search result value") + value?: SearchResultValue[]; +} + +@doc(""" +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. +""") +model SearchFacetResultValue { + @doc("Entity type") + entityType?: SearchFacetItemValue[]; + + @doc("Asset type") + assetType?: SearchFacetItemValue[]; + + @doc("Classification") + classification?: SearchFacetItemValue[]; + + @doc("Term") + term?: SearchFacetItemValue[]; + + @doc("Contact id") + contactId?: SearchFacetItemValue[]; + + @doc("Contact type") + contactType?: SearchFacetItemValue[]; + + @doc("Label") + label?: SearchFacetItemValue[]; + + @doc("Glossary type") + glossaryType?: SearchFacetItemValue[]; + + @doc("Term status") + termStatus?: SearchFacetItemValue[]; + + @doc("Term template") + termTemplate?: SearchFacetItemValue[]; +} + +@doc("The content of a search facet result item.") +model SearchFacetItemValue { + @doc("The count of the facet item.") + count?: int32; + + @doc("The name of the facet item.") + value?: string; +} + +@doc("The value item of the search result.") +model SearchResultValue { + @doc(""" +The search score calculated by the search engine. The results are ordered by +search score by default. +""") + @encodedName("application/json", "@search.score") + searchScore?: float32; + + @doc(""" +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. +""") + @encodedName("application/json", "@search.highlights") + searchHighlights?: SearchHighlights; + + @doc(""" +The object type of the record. Object type is the top-level property to +distinguish whether a record is an asset or a term. +""") + objectType?: string; + + @doc("The create time of the record. The Unix epoch format.") + createTime?: safeint; + + @doc("The last update time of the record. The Unix epoch format.") + updateTime?: safeint; + + @doc("The GUID of the record.") + id?: string; + + @doc("The name of the record.") + name?: string; + + @doc("The qualified name of the record.") + qualifiedName?: string; + + @doc("The type name of the asset.") + entityType?: string; + + @doc("The description of the asset.") + description?: string; + + @doc("The endorsement of the asset.") + endorsement?: string; + + @doc("The owner of the record.") + owner?: string; + + @doc("The classifications of the record.") + classification?: string[]; + + @doc("The labels of the asset.") + label?: string[]; + + @doc("The terms assigned to the asset.") + term?: TermSearchResultValue[]; + + @doc("The contacts of the asset.") + contact?: ContactSearchResultValue[]; + + @doc("The asset types of the asset.") + assetType?: string[]; + + @doc(""" +The type name of the term. Could be AtlasGlossary, AtlasGlossaryTerm or +AtlasGlossaryCategory. +""") + glossaryType?: string; + + @doc("The glossary name of the term.") + glossary?: string; + + @doc("The status of the term.") + termStatus?: string; + + @doc("The term template names used by the term.") + termTemplate?: string[]; + + @doc("The definition of the term.") + longDescription?: string; +} + +@doc(""" +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. +""") +model SearchHighlights { + @doc("Id") + id?: string[]; + + @doc("Qualified name") + qualifiedName?: string[]; + + @doc("Name") + name?: string[]; + + @doc("Description") + description?: string[]; + + @doc("Entity type") + entityType?: string[]; +} + +@doc("The context.") +model TermSearchResultValue { + @doc("The name of the term.") + name?: string; + + @doc("The name of the glossary which contains the term.") + glossaryName?: string; + + @doc("The GUID of the term.") + guid?: string; +} + +@doc("The contact in the search and suggest result.") +model ContactSearchResultValue { + @doc("The GUID of the contact.") + id?: string; + + @doc("The description of the contact.") + info?: string; + + @doc(""" +The type of the contact. It can be Expert or Owner for an entity. It can be +Expert or Steward for a glossary term. +""") + contactType?: string; +} + +@doc("The payload of suggest request.") +model SuggestOptions { + @doc(""" +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. +""") + keywords?: string; + + @doc(""" +The number of suggestions we hope to return. The default value is 5. The value +must be a number between 1 and 100. +""") + limit?: int32; + + #suppress "@azure-tools/typespec-azure-core/no-unknown" "Should use unknown to model Object" + @doc("The filter for the search.") + filter?: unknown; +} + +@doc("The result item of the search suggest.") +model SuggestResult { + @doc("The result value") + value?: SuggestResultValue[]; +} + +@doc("The value item of the search suggest.") +model SuggestResultValue { + @doc(""" +The search score calculated by the search engine. The results are ordered by +search score by default. +""") + @encodedName("application/json", "@search.score") + searchScore?: float32; + + @doc(""" +The target text that contains the keyword as prefix. The keyword is wrapped +with emphasis mark. +""") + @encodedName("application/json", "@search.text") + searchText?: string; + + @doc(""" +The object type of the record. Object type is the top-level property to +distinguish whether a record is an asset or a term. +""") + objectType?: string; + + @doc("The create time of the record. The Unix epoch format.") + createTime?: safeint; + + @doc("The last update time of the record. The Unix epoch format.") + updateTime?: safeint; + + @doc("The GUID of the record.") + id?: string; + + @doc("The name of the record.") + name?: string; + + @doc("The qualified name of the record.") + qualifiedName?: string; + + @doc("The type name of the asset.") + entityType?: string; + + @doc("The description of the asset.") + description?: string; + + @doc("The endorsement of the asset.") + endorsement?: string; + + @doc("The owner of the record.") + owner?: string; + + @doc("The classifications of the record.") + classification?: string[]; + + @doc("The labels of the asset.") + label?: string[]; + + @doc("The terms assigned to the asset.") + term?: TermSearchResultValue[]; + + @doc("The contacts of the asset.") + contact?: ContactSearchResultValue[]; + + @doc("The asset types of the asset.") + assetType?: string[]; + + @doc(""" +The type name of the term. Could be AtlasGlossary, AtlasGlossaryTerm or +AtlasGlossaryCategory. +""") + glossaryType?: string; + + @doc("The glossary name of the term.") + glossary?: string; + + @doc("The status of the term.") + termStatus?: string; + + @doc("The term template names used by the term.") + termTemplate?: string[]; + + @doc("The definition of the term.") + longDescription?: string; +} + +@doc("The payload of autocomplete request.") +model AutoCompleteOptions { + @doc(""" +The keywords applied to all fields that support autocomplete operation. It must +be at least 1 character, and no more than 100 characters. +""") + keywords?: string; + + @doc(""" +The number of autocomplete results we hope to return. The default value is 50. +The value must be a number between 1 and 100. +""") + limit?: int32; + + #suppress "@azure-tools/typespec-azure-core/no-unknown" "Should use unknown to model Object" + @doc("The filter for the autocomplete request.") + filter?: unknown; +} + +@doc("The result of the autocomplete request.") +model AutoCompleteResult { + @doc("The result value") + value?: AutoCompleteResultValue[]; +} + +@doc("The value item of the autocomplete suggest.") +model AutoCompleteResultValue { + @doc("The completed term or phrase.") + text?: string; + + @doc("The completed search query text.") + queryPlusText?: string; +} + +@doc("The lineage information.") +model AtlasLineageInfo { + @doc("The GUID of the base entity.") + baseEntityGuid?: string; + + @doc("The GUID entity map.") + guidEntityMap?: Record; + + #suppress "@azure-tools/typespec-azure-core/bad-record-type" "Should use Record to model Map" + @doc("The entity count in specific direction.") + widthCounts?: Record>; + + @doc("The depth of lineage.") + lineageDepth?: int32; + + @doc("The width of lineage.") + lineageWidth?: int32; + + @doc("The number of children node.") + childrenCount?: int32; + + @doc("The enum of lineage direction.") + lineageDirection?: LineageDirection; + + @doc("An array of parentRelations relations.") + parentRelations?: ParentRelation[]; + + @doc("An array of lineage relations.") + relations?: LineageRelation[]; +} + +@doc("The lineage parents relation with GUID of the parent entity and to child entity.") +model ParentRelation { + @doc("The GUID of child entity.") + childEntityId?: string; + + @doc("The GUID of relationship.") + relationshipId?: string; + + @doc("The GUID of parent entity.") + parentEntityId?: string; +} + +@doc("The lineage relation with GUID of the from and to entity.") +model LineageRelation { + @doc("The GUID of from-entity.") + fromEntityId?: string; + + @doc("The GUID of relationship.") + relationshipId?: string; + + @doc("The GUID of to-entity.") + toEntityId?: string; +} + +@doc("Atlas relationship instance.") +model AtlasRelationship { + ...AtlasStruct; + + @doc("The created time of the record.") + createTime?: safeint; + + @doc("The user who created the record.") + createdBy?: string; + + @doc("Reference to an object-instance of a type - like entity.") + end1?: AtlasObjectId; + + @doc("Reference to an object-instance of a type - like entity.") + end2?: AtlasObjectId; + + @doc("The GUID of the relationship.") + guid?: string; + + @doc("The home ID of the relationship.") + homeId?: string; + + @doc("The label of the relationship.") + label?: string; + + @doc("Used to record the provenance of an instance of an entity or relationship") + provenanceType?: int32; + + @doc("The enum of relationship status.") + status?: StatusAtlasRelationship; + + @doc("The update time of the record.") + updateTime?: safeint; + + @doc("The user who updated the record.") + updatedBy?: string; + + @doc("The version of the relationship.") + version?: int64; +} + +@doc("The relationship with extended information.") +model AtlasRelationshipWithExtInfo { + @doc("The referred entity header.") + referredEntities?: Record; + + @doc("Atlas relationship instance.") + relationship?: AtlasRelationship; +} + +@doc("class that captures details of a struct-type.") +model AtlasBusinessMetadataDef { + ...AtlasStructDef; +} + +@doc("class that captures details of a struct-type.") +model AtlasStructDef { + ...AtlasBaseTypeDef; + + @doc("An array of attribute definitions.") + attributeDefs?: AtlasAttributeDef[]; +} + +@doc("class that captures details of a struct-attribute.") +model AtlasAttributeDef { + @doc("single-valued attribute or multi-valued attribute.") + cardinality?: CardinalityValue; + + @doc("An array of constraints.") + constraints?: AtlasConstraintDef[]; + + @doc("The default value of the attribute.") + defaultValue?: string; + + @doc("The description of the attribute.") + description?: string; + + @doc("Determines if it is included in notification.") + includeInNotification?: boolean; + + @doc("Determines if it is indexable.") + isIndexable?: boolean; + + @doc("Determines if it is optional.") + isOptional?: boolean; + + @doc("Determines if it unique.") + isUnique?: boolean; + + @doc("The name of the attribute.") + name?: string; + + @doc("The options for the attribute.") + options?: Record; + + @doc("The name of the type.") + typeName?: string; + + @doc("The maximum count of the values.") + valuesMaxCount?: int32; + + @doc("The minimum count of the values.") + valuesMinCount?: int32; +} + +#suppress "@azure-tools/typespec-azure-core/bad-record-type" "Should use unknown to model Object" +@doc("class that captures details of a constraint.") +model AtlasConstraintDef { + @doc("The parameters of the constraint definition.") + params?: Record; + + @doc("The type of the constraint.") + type?: string; +} + +alias AtlasBaseTypeDef = { + @doc("The enum of type category.") + category?: TypeCategory; + + @doc("The created time of the record.") + createTime?: safeint; + + @doc("The user who created the record.") + createdBy?: string; + + @doc("The date format.") + dateFormatter?: DateFormat; + + @doc("The description of the type definition.") + description?: string; + + @doc("The GUID of the type definition.") + guid?: string; + + @doc("The name of the type definition.") + name?: string; + + @doc("The options for the type definition.") + options?: Record; + + @doc("The service type.") + serviceType?: string; + + @doc("The version of the type.") + typeVersion?: string; + + @doc("The update time of the record.") + updateTime?: safeint; + + @doc("The user who updated the record.") + updatedBy?: string; + + @doc("The version of the record.") + version?: int64; + + #suppress "@azure-tools/typespec-azure-core/casing-style" "It is an Atlas model" + @doc("ETag for concurrency control.") + lastModifiedTS?: string; +}; + +@doc("The date format.") +model DateFormat { + @doc("An array of available locales.") + availableLocales?: string[]; + + @doc("Calendar") + calendar?: float32; + + @doc("The date format.") + dateInstance?: DateFormat; + + @doc("The date format.") + dateTimeInstance?: DateFormat; + + @doc("The date format.") + instance?: DateFormat; + + @doc("Determines the leniency of the date format.") + lenient?: boolean; + + @doc("The number format.") + numberFormat?: NumberFormat; + + @doc("The date format.") + timeInstance?: DateFormat; + + @doc("The timezone information.") + timeZone?: TimeZone; +} + +@doc("The number format.") +model NumberFormat { + @doc("The number format.") + availableLocales?: string[]; + + @doc("The currency.") + currency?: string; + + @doc("The number format.") + currencyInstance?: NumberFormat; + + @doc("Determines if grouping is used.") + groupingUsed?: boolean; + + @doc("The number format.") + instance?: NumberFormat; + + @doc("The number format.") + integerInstance?: NumberFormat; + + @doc("The maximum of fraction digits.") + maximumFractionDigits?: int32; + + @doc("The maximum of integer digits.") + maximumIntegerDigits?: int32; + + @doc("The minimum of fraction digits.") + minimumFractionDigits?: int32; + + @doc("The minimum of integer digits.") + minimumIntegerDigits?: int32; + + @doc("The number format.") + numberInstance?: NumberFormat; + + @doc("Determines if only integer is parsed.") + parseIntegerOnly?: boolean; + + @doc("The number format.") + percentInstance?: NumberFormat; + + @doc("The enum of rounding mode.") + roundingMode?: RoundingMode; +} + +@doc("The timezone information.") +model TimeZone { + @doc("The value of the daylight saving time.") + dstSavings?: int32; + + @doc("The ID of the timezone.") + id?: string; + + @doc("An array of available IDs.") + availableIds?: string[]; + + @doc("The timezone information.") + default?: TimeZone; + + @doc("The display name of the timezone.") + displayName?: string; + + @doc("The raw offset of the timezone.") + rawOffset?: int32; +} + +@doc("class that captures details of a classification-type.") +model AtlasClassificationDef { + ...AtlasStructDef; + + @doc(""" +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. + +""") + entityTypes?: string[]; + + @doc("An array of sub types.") + subTypes?: string[]; + + @doc("An array of super types.") + superTypes?: string[]; +} + +@doc("class that captures details of a entity-type.") +model AtlasEntityDef { + ...AtlasStructDef; + + @doc("An array of sub types.") + subTypes?: string[]; + + @doc("An array of super types.") + superTypes?: string[]; + + @doc("An array of relationship attributes.") + relationshipAttributeDefs?: AtlasRelationshipAttributeDef[]; +} + +@doc(""" +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. +""") +model AtlasRelationshipAttributeDef { + ...AtlasAttributeDef; + + @doc("Determines if it is a legacy attribute.") + isLegacyAttribute?: boolean; + + @doc("The name of the relationship type.") + relationshipTypeName?: string; +} + +@doc("class that captures details of an enum-type.") +model AtlasEnumDef { + ...AtlasBaseTypeDef; + + @doc("The default value.") + defaultValue?: string; + + @doc("An array of enum element definitions.") + elementDefs?: AtlasEnumElementDef[]; +} + +@doc("class that captures details of an enum-element.") +model AtlasEnumElementDef { + @doc("The description of the enum element definition.") + description?: string; + + @doc("The ordinal of the enum element definition.") + ordinal?: int32; + + @doc("The value of the enum element definition.") + value?: string; +} + +@doc(""" +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 +""") +model AtlasRelationshipDef { + ...AtlasStructDef; + + @doc(""" +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. +""") + endDef1?: AtlasRelationshipEndDef; + + @doc(""" +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?: AtlasRelationshipEndDef; + + @doc(""" +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. +""") + relationshipCategory?: RelationshipCategory; + + @doc("The label of the relationship.") + relationshipLabel?: string; +} + +@doc(""" +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. +""") +model AtlasRelationshipEndDef { + @doc("single-valued attribute or multi-valued attribute.") + cardinality?: CardinalityValue; + + @doc("The description of the relationship end definition.") + description?: string; + + @doc("Determines if it is container.") + isContainer?: boolean; + + @doc("Determines if it is a legacy attribute.") + isLegacyAttribute?: boolean; + + @doc("The name of the relationship end definition.") + name?: string; + + @doc("The type of the relationship end.") + type?: string; +} + +@doc("The definitions of type.") +model AtlasTypeDef { + ...AtlasBaseTypeDef; + ...AtlasExtraTypeDef; +} + +@doc("Extra properties for a type.") +model AtlasExtraTypeDef { + @doc(""" +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. + +""") + entityTypes?: string[]; + + @doc("An array of sub types.") + subTypes?: string[]; + + @doc("An array of super types.") + superTypes?: string[]; + + @doc("An array of relationship attributes.") + relationshipAttributeDefs?: AtlasRelationshipAttributeDef[]; + + @doc("The default value.") + defaultValue?: string; + + @doc("An array of enum element definitions.") + elementDefs?: AtlasEnumElementDef[]; + + @doc(""" +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. +""") + endDef1?: AtlasRelationshipEndDef; + + @doc(""" +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?: AtlasRelationshipEndDef; + + @doc(""" +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. +""") + relationshipCategory?: RelationshipCategory; + + @doc("The label of the relationship.") + relationshipLabel?: string; + + @doc("An array of attribute definitions.") + attributeDefs?: AtlasAttributeDef[]; +} + +@doc("The definitions of types.") +model AtlasTypesDef { + @doc("businessMetadataDefs") + businessMetadataDefs?: AtlasBusinessMetadataDef[]; + + @doc("An array of classification definitions.") + classificationDefs?: AtlasClassificationDef[]; + + @doc("An array of entity definitions.") + entityDefs?: AtlasEntityDef[]; + + @doc("An array of enum definitions.") + enumDefs?: AtlasEnumDef[]; + + @doc("An array of relationship definitions.") + relationshipDefs?: AtlasRelationshipDef[]; + + @doc("An array of struct definitions.") + structDefs?: AtlasStructDef[]; + + @doc("An array of term template definitions.") + termTemplateDefs?: TermTemplateDef[]; +} + +@doc("Term template definition for glossary term.") +model TermTemplateDef { + ...AtlasStructDef; +} + +@doc("The basic information of the type definition.") +model AtlasTypeDefHeader { + @doc("The enum of type category.") + category?: TypeCategory; + + @doc("The GUID of the type definition.") + guid?: string; + + @doc("The name of the type definition.") + name?: string; +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/routes.tsp b/specification/purview/Azure.Analytics.Purview.DataMap/routes.tsp new file mode 100644 index 000000000000..bc4f05fe69c8 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/routes.tsp @@ -0,0 +1,2133 @@ +import "@azure-tools/typespec-azure-core"; +import "@typespec/http"; +import "@typespec/versioning"; +import "@typespec/rest"; +import "./models.tsp"; + +using TypeSpec.Rest; +using TypeSpec.Http; +using TypeSpec.Versioning; +using Azure.Core; +using Azure.Core.Traits; +using Azure.Core.Traits.Private; + +namespace PurviewDataMap; + +@doc("The ApiVersion query parameter for Atlas API.") +model AtlasApiVersionParameter { + @doc("The API version to use for this operation.") + @query("api-version") + @minLength(1) + apiVersion?: string; +} + +alias AtlasApiVersionParameterTraits = Azure.Core.Traits.VersionParameterTrait; + +#suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" +@doc("The operation defined for Atlas APIs") +op AtlasOperation< + TParams extends TypeSpec.Reflection.Model, + TResponse, + Traits extends TypeSpec.Reflection.Model = {} +>( + ...TraitProperties, + ...TParams, +): TResponse | AtlasErrorResponse; + +#suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" +op AtlasRpcOperation< + TParams extends TypeSpec.Reflection.Model, + TResponse extends TypeSpec.Reflection.Model, + Traits extends TypeSpec.Reflection.Model = {}, + TraitContexts extends TraitContext = TraitContext.Undefined +> is AtlasOperation< + TParams & TraitProperties, + TResponse & TraitProperties, + Traits +>; + +alias OkResponse = { + @statusCode + status: 200; + + @body + data: T; +}; + +#suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" +op AtlasImportOperation< + TParams extends TypeSpec.Reflection.Model, + TResponse extends TypeSpec.Reflection.Model, + Traits extends TypeSpec.Reflection.Model = {}, + TraitContexts extends TraitContext = TraitContext.Undefined +> is AtlasOperation< + TParams & + TraitProperties< + Traits & + NoConditionalRequests & + NoRepeatableRequests & + NoClientRequestId, + TraitLocation.Parameters, + TraitContext.Action + >, + TResponse & + TraitProperties< + Traits & + NoConditionalRequests & + NoRepeatableRequests & + NoClientRequestId, + TraitLocation.Response, + TraitContext.Action + >, + Traits +>; + +alias MultipartFormDataRequestHeadersTraits = Azure.Core.Traits.RequestHeadersTrait<{ + @doc("The content type for the operation. Always multipart/form-data for this operation.") + @header("content-type") + contentType: "multipart/form-data"; +}>; + +interface Entity { + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + @doc(""" +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. +""") + @route("/atlas/v2/entity") + @post + createOrUpdate is AtlasOperation< + { + @doc(""" +Used to define the update behavior for business attributes when updating +entities. +""") + @query + businessAttributeUpdateBehavior?: BusinessAttributeUpdateBehavior; + + @doc(""" +The collection where entities will be moved to. Only specify a value if you +need to move an entity to another collection. +""") + @query + collectionId?: string; + } & AtlasEntityWithExtInfo, + EntityMutationResult, + AtlasApiVersionParameterTraits + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/prefer-csv-collection-format" "This is an existing Atlas API" + @doc("List entities in bulk identified by its GUIDs.") + @route("/atlas/v2/entity/bulk") + @get + listByGuids is AtlasOperation< + { + @doc("An array of GUIDs of entities to list.") + @query({ + format: "multi", + }) + guid: string[]; + + @doc("Whether to return minimal information for referred entities.") + @query + minExtInfo?: boolean; + + @doc("Whether to ignore relationship attributes.") + @query + ignoreRelationships?: boolean; + }, + AtlasEntitiesWithExtInfo, + AtlasApiVersionParameterTraits + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + @doc(""" +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. +""") + @route("/atlas/v2/entity/bulk") + @post + bulkCreateOrUpdate is AtlasOperation< + { + @doc(""" +The collection where entities will be moved to. Only specify a value if you +need to move an entity to another collection. +""") + @query + collectionId?: string; + + @doc(""" +Used to define the update behavior for business attributes when updating +entities. +""") + @query + businessAttributeUpdateBehavior?: BusinessAttributeUpdateBehavior; + } & AtlasEntitiesWithExtInfo, + EntityMutationResult, + AtlasApiVersionParameterTraits + >; + + #suppress "@azure-tools/typespec-azure-core/prefer-csv-collection-format" "This is an existing Atlas API" + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +Delete a list of entities in bulk identified by their GUIDs or unique +attributes. +""") + @route("/atlas/v2/entity/bulk") + @delete + bulkDelete is AtlasOperation< + { + @doc("An array of GUIDs of entities to delete.") + @query({ + format: "multi", + }) + guid: string[]; + }, + EntityMutationResult, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Associate a classification to multiple entities in bulk.") + @route("/atlas/v2/entity/bulk/classification") + @post + addClassification is AtlasOperation; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get complete definition of an entity given its GUID.") + @route("/atlas/v2/entity/guid/{guid}") + @get + get is AtlasOperation< + { + @doc("The globally unique identifier of the entity.") + @path + guid: string; + + @doc("Whether to return minimal information for referred entities.") + @query + minExtInfo?: boolean; + + @doc("Whether to ignore relationship attributes.") + @query + ignoreRelationships?: boolean; + }, + AtlasEntityWithExtInfo, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +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. +""") + @route("/atlas/v2/entity/guid/{guid}") + @put + partialUpdateAttributeByGuid is AtlasOperation< + { + @doc("The globally unique identifier of the entity.") + @path + guid: string; + + @doc("The name of the attribute.") + @query + name: string; + + #suppress "@azure-tools/typespec-azure-core/no-unknown" "Should use unknown to model Object" + @doc("The value of the attribute.") + @body + body: unknown; + }, + EntityMutationResult, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Delete an entity identified by its GUID.") + @route("/atlas/v2/entity/guid/{guid}") + @delete + delete is AtlasOperation< + { + @doc("The globally unique identifier of the entity.") + @path + guid: string; + }, + EntityMutationResult, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get classification for a given entity represented by a GUID.") + @route("/atlas/v2/entity/guid/{guid}/classification/{classificationName}") + @get + getClassification is AtlasOperation< + { + @doc("The globally unique identifier of the entity.") + @path + guid: string; + + @doc("The name of the classification.") + @path + classificationName: string; + }, + AtlasClassification, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Delete a given classification from an existing entity represented by a GUID.") + @route("/atlas/v2/entity/guid/{guid}/classification/{classificationName}") + @delete + removeClassification is AtlasOperation< + { + @doc("The globally unique identifier of the entity.") + @path + guid: string; + + @doc("The name of the classification.") + @path + classificationName: string; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("List classifications for a given entity represented by a GUID.") + @route("/atlas/v2/entity/guid/{guid}/classifications") + @get + getClassifications is AtlasOperation< + { + @doc("The globally unique identifier of the entity.") + @path + guid: string; + }, + AtlasClassifications, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/request-body-problem" "This is Atlas API behavior" + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Add classifications to an existing entity represented by a GUID.") + @route("/atlas/v2/entity/guid/{guid}/classifications") + @post + addClassifications is AtlasOperation< + { + @doc("The globally unique identifier of the entity.") + @path + guid: string; + + @doc("An array of classifications to be added.") + @body + body: AtlasClassification[]; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/request-body-problem" "This is Atlas API behavior" + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Update classifications to an existing entity represented by a guid.") + @route("/atlas/v2/entity/guid/{guid}/classifications") + @put + updateClassifications is AtlasOperation< + { + @doc("The globally unique identifier of the entity.") + @path + guid: string; + + @doc("An array of classifications to be updated.") + @body + body: AtlasClassification[]; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +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. +""") + @route("/atlas/v2/entity/uniqueAttribute/type/{typeName}") + @get + getByUniqueAttributes is AtlasOperation< + { + @doc("The name of the type.") + @path + typeName: string; + + @doc("Whether to return minimal information for referred entities.") + @query + minExtInfo?: boolean; + + @doc("Whether to ignore relationship attributes.") + @query + ignoreRelationships?: boolean; + + @doc(""" +The qualified name of the entity. (This is only an example. qualifiedName can +be changed to other unique attributes) +""") + @query("attr:qualifiedName") + attribute?: string; + }, + AtlasEntityWithExtInfo, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +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. +""") + @route("/atlas/v2/entity/uniqueAttribute/type/{typeName}") + @put + partialUpdateByUniqueAttributes is AtlasOperation< + { + @doc("The name of the type.") + @path + typeName: string; + + @doc(""" +The qualified name of the entity. (This is only an example. qualifiedName can +be changed to other unique attributes) +""") + @query("attr:qualifiedName") + attribute?: string; + } & AtlasEntityWithExtInfo, + EntityMutationResult, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +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. +""") + @route("/atlas/v2/entity/uniqueAttribute/type/{typeName}") + @delete + deleteByUniqueAttribute is AtlasOperation< + { + @doc("The name of the type.") + @path + typeName: string; + + @doc(""" +The qualified name of the entity. (This is only an example. qualifiedName can +be changed to other unique attributes) +""") + @query("attr:qualifiedName") + attribute?: string; + }, + EntityMutationResult, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +Delete a given classification from an entity identified by its type and unique +attributes. +""") + @route("/atlas/v2/entity/uniqueAttribute/type/{typeName}/classification/{classificationName}") + @delete + removeClassificationByUniqueAttribute is AtlasOperation< + { + @doc("The name of the type.") + @path + typeName: string; + + @doc("The name of the classification.") + @path + classificationName: string; + + @doc(""" +The qualified name of the entity. (This is only an example. qualifiedName can +be changed to other unique attributes) +""") + @query("attr:qualifiedName") + attribute?: string; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/request-body-problem" "This is Atlas API behavior" + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Add classification to the entity identified by its type and unique attributes.") + @route("/atlas/v2/entity/uniqueAttribute/type/{typeName}/classifications") + @post + addClassificationsByUniqueAttribute is AtlasOperation< + { + @doc("The name of the type.") + @path + typeName: string; + + @doc(""" +The qualified name of the entity. (This is only an example. qualifiedName can +be changed to other unique attributes) +""") + @query("attr:qualifiedName") + attribute?: string; + + @doc("An array of classification to be added.") + @body + body: AtlasClassification[]; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/request-body-problem" "This is Atlas API behavior" + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Update classification on an entity identified by its type and unique attributes.") + @route("/atlas/v2/entity/uniqueAttribute/type/{typeName}/classifications") + @put + updateClassificationsByUniqueAttribute is AtlasOperation< + { + @doc("The name of the type.") + @path + typeName: string; + + @doc(""" +The qualified name of the entity. (This is only an example. qualifiedName can +be changed to other unique attributes) +""") + @query("attr:qualifiedName") + attribute?: string; + + @doc("An array of classification to be updated.") + @body + body: AtlasClassification[]; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Set classifications on entities in bulk.") + @route("/atlas/v2/entity/bulk/setClassifications") + @post + bulkSetClassifications is AtlasOperation< + AtlasEntityHeaders, + OkResponse, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/casing-style" "This is Atlas API behavior" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +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. +""") + @route("/atlas/v2/entity/bulk/uniqueAttribute/type/{typeName}") + @get + listByUniqueAttributes is AtlasOperation< + { + @doc("The name of the type.") + @path + typeName: string; + + @doc("Whether to return minimal information for referred entities.") + @query + minExtInfo?: boolean; + + @doc("Whether to ignore relationship attributes.") + @query + ignoreRelationships?: boolean; + + @doc(""" +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) +""") + @query + `attr_N:qualifiedName`?: string; + }, + AtlasEntitiesWithExtInfo, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get entity header given its GUID.") + @route("/atlas/v2/entity/guid/{guid}/header") + @get + getHeader is AtlasOperation< + { + @doc("The globally unique identifier of the entity.") + @path + guid: string; + }, + AtlasEntityHeader, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Remove business metadata from an entity.") + @route("/atlas/v2/entity/guid/{guid}/businessmetadata") + @delete + removeBusinessMetadata is AtlasOperation< + { + @doc("The globally unique identifier of the entity.") + @path + guid: string; + + #suppress "@azure-tools/typespec-azure-core/bad-record-type" "Should use unknown to model Object" + @doc("Business metadata payload") + @body + body: Record>; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Add business metadata to an entity.") + @route("/atlas/v2/entity/guid/{guid}/businessmetadata") + @post + addOrUpdateBusinessMetadata is AtlasOperation< + { + @doc("The globally unique identifier of the entity.") + @path + guid: string; + + @doc(""" +Whether to overwrite the existing business metadata on the entity or not, +default is false. +""") + @query("isOverwrite") + overwrite?: boolean; + + #suppress "@azure-tools/typespec-azure-core/bad-record-type" "Should use unknown to model Object" + @doc("BusinessMetadata payload") + @body + body: Record>; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/bad-record-type" "Should use unknown to model Object" + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is an Atlas existing api" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Delete business metadata attributes from an entity.") + @route("/atlas/v2/entity/guid/{guid}/businessmetadata/{businessMetadataName}") + @delete + removeBusinessMetadataAttributes is AtlasOperation< + { + @doc("BusinessMetadata name") + @path + businessMetadataName: string; + + @doc("The globally unique identifier of the entity.") + @path + guid: string; + + #suppress "@azure-tools/typespec-azure-core/bad-record-type" "Should use unknown to model Object" + @doc("Business metadata attribute payload") + @body + body: Record; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is an Atlas existing api" + #suppress "@azure-tools/typespec-azure-core/bad-record-type" "Should use unknown to model Object" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Add or update business metadata attributes.") + @route("/atlas/v2/entity/guid/{guid}/businessmetadata/{businessMetadataName}") + @post + addOrUpdateBusinessMetadataAttributes is AtlasOperation< + { + @doc("BusinessMetadata name") + @path + businessMetadataName: string; + + @doc("The globally unique identifier of the entity.") + @path + guid: string; + + #suppress "@azure-tools/typespec-azure-core/bad-record-type" "Should use unknown to model Object" + @doc("Business metadata attribute payload") + @body + body: Record; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get the sample Template for uploading/creating bulk BusinessMetaData") + @route("/atlas/v2/entity/businessmetadata/import/template") + @get + getSampleBusinessMetadataTemplate is AtlasRpcOperation< + {}, + { + @header contentType: "application/octet-stream"; + @body body: bytes; + }, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/byos" "representation of existing multipart/form-data operation" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + @doc("Upload the file for creating Business Metadata in BULK") + @route("/atlas/v2/entity/businessmetadata/import") + @post + importBusinessMetadata is AtlasImportOperation< + { + @doc("InputStream of file") + file: bytes; + }, + BulkImportResult, + MultipartFormDataRequestHeadersTraits + >; + + #suppress "@azure-tools/typespec-azure-core/request-body-problem" "This is Atlas API behavior" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + @doc("Delete given labels to a given entity.") + @route("/atlas/v2/entity/guid/{guid}/labels") + @delete + removeLabels is AtlasOperation< + { + @doc("The globally unique identifier of the entity.") + @path + guid: string; + + @doc("set of labels to be deleted") + @body + body?: string[]; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/request-body-problem" "This is Atlas API behavior" + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Set labels to a given entity.") + @route("/atlas/v2/entity/guid/{guid}/labels") + @post + setLabels is AtlasOperation< + { + @doc("The globally unique identifier of the entity.") + @path + guid: string; + + @doc("set of labels to be set to the entity") + @body + body?: string[]; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/request-body-problem" "This is Atlas API behavior" + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Add given labels to a given entity.") + @route("/atlas/v2/entity/guid/{guid}/labels") + @put + addLabel is AtlasOperation< + { + @doc("The globally unique identifier of the entity.") + @path + guid: string; + + @doc("set of labels to be added") + @body + body?: string[]; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/request-body-problem" "This is Atlas API behavior" + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +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. +""") + @route("/atlas/v2/entity/uniqueAttribute/type/{typeName}/labels") + @delete + removeLabelsByUniqueAttribute is AtlasOperation< + { + @doc("The name of the type.") + @path + typeName: string; + + @doc(""" +The qualified name of the entity. (This is only an example. qualifiedName can +be changed to other unique attributes) +""") + @query("attr:qualifiedName") + attribute?: string; + + @doc("set of labels to be deleted") + @body + body?: string[]; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/request-body-problem" "This is Atlas API behavior" + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +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. +""") + @route("/atlas/v2/entity/uniqueAttribute/type/{typeName}/labels") + @post + setLabelsByUniqueAttribute is AtlasOperation< + { + @doc("The name of the type.") + @path + typeName: string; + + @doc(""" +The qualified name of the entity. (This is only an example. qualifiedName can +be changed to other unique attributes) +""") + @query("attr:qualifiedName") + attribute?: string; + + @doc("set of labels to be set") + @body + body?: string[]; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/request-body-problem" "This is Atlas API behavior" + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +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. +""") + @route("/atlas/v2/entity/uniqueAttribute/type/{typeName}/labels") + @put + addLabelsByUniqueAttribute is AtlasOperation< + { + @doc("The name of the type.") + @path + typeName: string; + + @doc(""" +The qualified name of the entity. (This is only an example. qualifiedName can +be changed to other unique attributes) +""") + @query("attr:qualifiedName") + attribute?: string; + + @doc("set of labels to be added") + @body + body?: string[]; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is an existing API" + @doc("Move existing entities to the target collection.") + @route("/entity/moveTo") + @post + moveEntitiesToCollection is Azure.Core.Foundations.Operation< + { + @doc("The collection where entities will be moved to.") + @query + collectionId: string; + } & MoveEntitiesOptions, + EntityMutationResult, + {}, + AtlasErrorResponse + >; +} + +interface Glossary { + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + @doc(""" +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'. +""") + @route("/atlas/v2/glossary") + @get + list is AtlasOperation< + { + @doc("The page size - by default there is no paging.") + @query + limit?: int32; + + @doc("The offset for pagination purpose.") + @query + offset?: int32; + + @doc("The sort order, ASC (default) or DESC.") + @query + sort?: string; + + @doc("Whether ignore terms and categories") + @query + ignoreTermsAndCategories?: boolean; + }, + OkResponse, + AtlasApiVersionParameterTraits + >; + + #suppress "@azure-tools/typespec-azure-core/request-body-problem" "This is Atlas API behavior" + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Create a glossary.") + @route("/atlas/v2/glossary") + @post + create is AtlasOperation; + + #suppress "@azure-tools/typespec-azure-core/request-body-problem" "This is Atlas API behavior" + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Create glossary category in bulk.") + @route("/atlas/v2/glossary/categories") + @post + createCategories is AtlasOperation< + { + @doc("An array of glossary category definitions to be created.") + @body + body: AtlasGlossaryCategory[]; + }, + OkResponse, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Create a glossary category.") + @route("/atlas/v2/glossary/category") + @post + createCategory is AtlasOperation< + AtlasGlossaryCategory, + AtlasGlossaryCategory, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get specific glossary category by its GUID.") + @route("/atlas/v2/glossary/category/{categoryId}") + @get + getCategory is AtlasOperation< + { + @doc("The globally unique identifier of the category.") + @path + categoryId: string; + }, + AtlasGlossaryCategory, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Update the given glossary category by its GUID.") + @route("/atlas/v2/glossary/category/{categoryId}") + @put + updateCategory is AtlasOperation< + { + @doc("The globally unique identifier of the category.") + @path + categoryId: string; + } & AtlasGlossaryCategory, + AtlasGlossaryCategory, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Delete a glossary category.") + @route("/atlas/v2/glossary/category/{categoryId}") + @delete + deleteCategory is AtlasOperation< + { + @doc("The globally unique identifier of the category.") + @path + categoryId: string; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + #suppress "@azure-tools/typespec-azure-core/no-unknown" "Should use unknown to model Object" + @doc(""" +Update the glossary category partially. So far we only supports partial +updating shortDescription and longDescription for category. +""") + @route("/atlas/v2/glossary/category/{categoryId}/partial") + @put + partialUpdateCategory is AtlasOperation< + { + @doc("The globally unique identifier of the category.") + @path + categoryId: string; + + @doc(""" +A map containing keys as attribute names and values as corresponding attribute +values for partial update. +""") + @body + body: Record; + }, + AtlasGlossaryCategory, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +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. +""") + @route("/atlas/v2/glossary/category/{categoryId}/related") + @get + listRelatedCategories is AtlasOperation< + { + @doc("The globally unique identifier of the category.") + @path + categoryId: string; + + @doc("The page size - by default there is no paging.") + @query + limit?: int32; + + @doc("The offset for pagination purpose.") + @query + offset?: int32; + + @doc("The sort order, ASC (default) or DESC.") + @query + sort?: string; + }, + OkResponse>, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get all terms associated with the specific category.") + @route("/atlas/v2/glossary/category/{categoryId}/terms") + @get + listCategoryTerms is AtlasOperation< + { + @doc("The globally unique identifier of the category.") + @path + categoryId: string; + + @doc("The page size - by default there is no paging.") + @query + limit?: int32; + + @doc("The offset for pagination purpose.") + @query + offset?: int32; + + @doc("The sort order, ASC (default) or DESC.") + @query + sort?: string; + }, + OkResponse, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Create a glossary term.") + @route("/atlas/v2/glossary/term") + @post + createTerm is AtlasOperation< + { + @doc("Whether include term hierarchy") + @query + includeTermHierarchy?: boolean; + } & AtlasGlossaryTerm, + AtlasGlossaryTerm, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + @doc("Get a specific glossary term by its GUID. ") + @route("/atlas/v2/glossary/term/{termId}") + @get + getTerm is AtlasOperation< + { + @doc("The globally unique identifier for glossary term.") + @path + termId: string; + }, + AtlasGlossaryTerm, + AtlasApiVersionParameterTraits + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + @doc("Update the given glossary term by its GUID.") + @route("/atlas/v2/glossary/term/{termId}") + @put + updateTerm is AtlasOperation< + { + @doc("The globally unique identifier for glossary term.") + @path + termId: string; + + @doc("Whether include term hierarchy") + @query + includeTermHierarchy?: boolean; + } & AtlasGlossaryTerm, + AtlasGlossaryTerm, + AtlasApiVersionParameterTraits + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Delete a glossary term.") + @route("/atlas/v2/glossary/term/{termId}") + @delete + deleteTerm is AtlasOperation< + { + @doc("The globally unique identifier for glossary term.") + @path + termId: string; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/no-unknown" "Should use unknown to model Object" + @doc(""" +Update the glossary term partially. So far we only supports partial updating +shortDescription, longDescription, abbreviation, usage and status for term. +""") + @route("/atlas/v2/glossary/term/{termId}/partial") + @put + partialUpdateTerm is AtlasOperation< + { + @doc("The globally unique identifier for glossary term.") + @path + termId: string; + + @doc("Whether include term hierarchy") + @query + includeTermHierarchy?: boolean; + + @doc(""" +A map containing keys as attribute names and values as corresponding attribute +values to be updated. +""") + @body + body: Record; + }, + AtlasGlossaryTerm, + AtlasApiVersionParameterTraits + >; + + #suppress "@azure-tools/typespec-azure-core/request-body-problem" "This is Atlas API behavior" + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + @doc("Create glossary terms in bulk.") + @route("/atlas/v2/glossary/terms") + @post + createTerms is AtlasOperation< + { + @doc("Whether include term hierarchy") + @query + includeTermHierarchy?: boolean; + + @doc("An array of glossary term definitions to be created in bulk.") + @body + body: AtlasGlossaryTerm[]; + }, + OkResponse, + AtlasApiVersionParameterTraits + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +List all related objects assigned with the specified term. Recommend using +limit/offset to get pagination result. +""") + @route("/atlas/v2/glossary/terms/{termId}/assignedEntities") + @get + listEntitiesAssignedWithTerm is AtlasOperation< + { + @doc("The globally unique identifier for glossary term.") + @path + termId: string; + + @doc("The page size - by default there is no paging.") + @query + limit?: int32; + + @doc("The offset for pagination purpose.") + @query + offset?: int32; + + @doc("The sort order, ASC (default) or DESC.") + @query + sort?: string; + }, + OkResponse, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/request-body-problem" "This is Atlas API behavior" + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +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. +""") + @route("/atlas/v2/glossary/terms/{termId}/assignedEntities") + @post + assignTermToEntities is AtlasOperation< + { + @doc("The globally unique identifier for glossary term.") + @path + termId: string; + + @doc("An array of related object IDs to which the term has to be associated.") + @body + body: AtlasRelatedObjectId[]; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/request-body-problem" "This is Atlas API behavior" + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Delete the term assignment for the given list of related objects.") + @route("/atlas/v2/glossary/terms/{termId}/assignedEntities") + @delete + deleteTermAssignmentFromEntities is AtlasOperation< + { + @doc("The globally unique identifier for glossary term.") + @path + termId: string; + + @doc("An array of related object IDs from which the term has to be dissociated.") + @body + body: AtlasRelatedObjectId[]; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + @doc(""" +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. +""") + @route("/atlas/v2/glossary/terms/{termId}/related") + @get + listRelatedTerms is AtlasOperation< + { + @doc("The globally unique identifier for glossary term.") + @path + termId: string; + + @doc("The page size - by default there is no paging.") + @query + limit?: int32; + + @doc("The offset for pagination purpose.") + @query + offset?: int32; + + @doc("The sort order, ASC (default) or DESC.") + @query + sort?: string; + }, + OkResponse>, + AtlasApiVersionParameterTraits + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get a specific Glossary by its GUID.") + @route("/atlas/v2/glossary/{glossaryId}") + @get + get is AtlasOperation< + { + @doc("The globally unique identifier for glossary.") + @path + glossaryId: string; + }, + AtlasGlossary, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + @doc("Update the given glossary.") + @route("/atlas/v2/glossary/{glossaryId}") + @put + update is AtlasOperation< + { + @doc("The globally unique identifier for glossary.") + @path + glossaryId: string; + + @doc("Whether ignore terms and categories") + @query + ignoreTermsAndCategories?: boolean; + } & AtlasGlossary, + AtlasGlossary, + AtlasApiVersionParameterTraits + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +Delete a glossary. Will delete underlying terms/categories together. Recommend +separate delete terms and categories. +""") + @route("/atlas/v2/glossary/{glossaryId}") + @delete + delete is AtlasOperation< + { + @doc("The globally unique identifier for glossary.") + @path + glossaryId: string; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +Get the categories belonging to a specific glossary. Recommend using +limit/offset to get pagination result. +""") + @route("/atlas/v2/glossary/{glossaryId}/categories") + @get + listCategories is AtlasOperation< + { + @doc("The globally unique identifier for glossary.") + @path + glossaryId: string; + + @doc("The page size - by default there is no paging.") + @query + limit?: int32; + + @doc("The offset for pagination purpose.") + @query + offset?: int32; + + @doc("The sort order, ASC (default) or DESC.") + @query + sort?: string; + }, + OkResponse, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +Get the category headers belonging to a specific glossary. Recommend using +limit/offset to get pagination result. +""") + @route("/atlas/v2/glossary/{glossaryId}/categories/headers") + @get + listCategoriesHeaders is AtlasOperation< + { + @doc("The globally unique identifier for glossary.") + @path + glossaryId: string; + + @doc("The page size - by default there is no paging.") + @query + limit?: int32; + + @doc("The offset for pagination purpose.") + @query + offset?: int32; + + @doc("The sort order, ASC (default) or DESC.") + @query + sort?: string; + }, + OkResponse, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + @doc(""" +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. +""") + @route("/atlas/v2/glossary/{glossaryId}/detailed") + @get + getDetailed is AtlasOperation< + { + @doc("The globally unique identifier for glossary.") + @path + glossaryId: string; + }, + AtlasGlossaryExtInfo, + AtlasApiVersionParameterTraits + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/no-unknown" "Should use unknown to model Object" + @doc(""" +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. +""") + @route("/atlas/v2/glossary/{glossaryId}/partial") + @put + partialUpdate is AtlasOperation< + { + @doc("The globally unique identifier for glossary.") + @path + glossaryId: string; + + @doc("Whether ignore terms and categories") + @query + ignoreTermsAndCategories?: boolean; + + @doc(""" +A map containing keys as attribute names and values as corresponding attribute +values. +""") + @body + body: Record; + }, + AtlasGlossary, + AtlasApiVersionParameterTraits + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + @doc(""" +Get terms belonging to a specific glossary. Recommend using limit/offset to get +pagination result. +""") + @route("/atlas/v2/glossary/{glossaryId}/terms") + @get + listTerms is AtlasOperation< + { + @doc("The globally unique identifier for glossary.") + @path + glossaryId: string; + + @doc("The page size - by default there is no paging.") + @query + limit?: int32; + + @doc("The offset for pagination purpose.") + @query + offset?: int32; + + @doc("The sort order, ASC (default) or DESC.") + @query + sort?: string; + }, + OkResponse, + AtlasApiVersionParameterTraits + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +Get term headers belonging to a specific glossary. Recommend using limit/offset +to get pagination result. +""") + @route("/atlas/v2/glossary/{glossaryId}/terms/headers") + @get + listTermHeaders is AtlasOperation< + { + @doc("The globally unique identifier for glossary.") + @path + glossaryId: string; + + @doc("The page size - by default there is no paging.") + @query + limit?: int32; + + @doc("The offset for pagination purpose.") + @query + offset?: int32; + + @doc("The sort order, ASC (default) or DESC.") + @query + sort?: string; + }, + OkResponse, + {} + >; +} + +interface Discovery { + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is an existing API" + @doc("Get data using search.") + @route("/search/query") + @post + query is Azure.Core.Foundations.Operation< + QueryOptions, + QueryResult, + {}, + AtlasErrorResponse + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is an existing API" + @doc("Get search suggestions by query criteria.") + @route("/search/suggest") + @post + suggest is Azure.Core.Foundations.Operation< + SuggestOptions, + SuggestResult, + {}, + AtlasErrorResponse + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is an existing API" + @doc("Get auto complete options.") + @route("/search/autocomplete") + @post + autoComplete is Azure.Core.Foundations.Operation< + AutoCompleteOptions, + AutoCompleteResult, + {}, + AtlasErrorResponse + >; +} + +interface Lineage { + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get lineage info of the entity specified by GUID.") + @route("/atlas/v2/lineage/{guid}") + @get + get is AtlasOperation< + { + @doc("The globally unique identifier of the entity.") + @path + guid: string; + + @doc("The number of hops for lineage.") + @query + depth?: int32; + + @doc("The direction of the lineage, which could be INPUT, OUTPUT or BOTH.") + @query + direction: LineageDirection; + }, + AtlasLineageInfo + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is an existing API" + @doc("Return immediate next page lineage info about entity with pagination") + @route("/lineage/{guid}/next/") + @get + getNextPage is Azure.Core.Foundations.Operation< + { + @doc("The globally unique identifier of the entity.") + @path + guid: string; + + @doc("The direction of the lineage, which could be INPUT, OUTPUT or BOTH.") + @query + direction: LineageDirection; + + @doc("The offset for pagination purpose.") + @query + offset?: int32; + + @doc("The page size - by default there is no paging.") + @query + limit?: int32; + }, + AtlasLineageInfo, + {}, + AtlasErrorResponse + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +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. +""") + @route("/atlas/v2/lineage/uniqueAttribute/type/{typeName}") + @get + getByUniqueAttribute is AtlasOperation< + { + @doc("The name of the type.") + @path + typeName: string; + + @doc("The number of hops for lineage.") + @query + depth?: int32; + + @doc("The direction of the lineage, which could be INPUT, OUTPUT or BOTH.") + @query + direction: LineageDirection; + + @doc(""" +The qualified name of the entity. (This is only an example. qualifiedName can +be changed to other unique attributes) +""") + @query("attr:qualifiedName") + attribute?: string; + }, + AtlasLineageInfo, + {} + >; +} + +interface Relationship { + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Create a new relationship between entities.") + @route("/atlas/v2/relationship") + @post + create is AtlasOperation; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Update an existing relationship between entities.") + @route("/atlas/v2/relationship") + @put + update is AtlasOperation; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get relationship information between entities by its GUID.") + @route("/atlas/v2/relationship/guid/{guid}") + @get + get is AtlasOperation< + { + @doc("The globally unique identifier of the relationship.") + @path + guid: string; + + @doc("Limits whether includes extended information.") + @query + extendedInfo?: boolean; + }, + AtlasRelationshipWithExtInfo, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Delete a relationship between entities by its GUID.") + @route("/atlas/v2/relationship/guid/{guid}") + @delete + delete is AtlasOperation< + { + @doc("The globally unique identifier of the relationship.") + @path + guid: string; + }, + void, + {} + >; +} + +interface Type { + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get the businessMetadata definition for the given guid.") + @route("/atlas/v2/types/businessmetadatadef/guid/{guid}") + @get + getBusinessMetadataDefByGuid is AtlasOperation< + { + @doc("businessMetadata guid") + @path + guid: string; + }, + AtlasBusinessMetadataDef, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get the businessMetadata definition by it's name (unique).") + @route("/atlas/v2/types/businessmetadatadef/name/{name}") + @get + getBusinessMetadataDefByName is AtlasOperation< + { + @doc("businessMetadata name") + @path + name: string; + }, + AtlasBusinessMetadataDef, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get the classification definition for the given GUID.") + @route("/atlas/v2/types/classificationdef/guid/{guid}") + @get + getClassificationDefByGuid is AtlasOperation< + { + @doc("The globally unique identifier of the classification.") + @path + guid: string; + }, + AtlasClassificationDef, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get the classification definition by its name (unique).") + @route("/atlas/v2/types/classificationdef/name/{name}") + @get + getClassificationDefByName is AtlasOperation< + { + @doc("The name of the classification.") + @path + name: string; + }, + AtlasClassificationDef, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get the Entity definition for the given GUID.") + @route("/atlas/v2/types/entitydef/guid/{guid}") + @get + getEntityDefByGuid is AtlasOperation< + { + @doc("The globally unique identifier of the entity.") + @path + guid: string; + }, + AtlasEntityDef, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get the entity definition by its name (unique).") + @route("/atlas/v2/types/entitydef/name/{name}") + @get + getEntityDefByName is AtlasOperation< + { + @doc("The name of the entity.") + @path + name: string; + }, + AtlasEntityDef, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get the enum definition for the given GUID.") + @route("/atlas/v2/types/enumdef/guid/{guid}") + @get + getEnumDefByGuid is AtlasOperation< + { + @doc("The globally unique identifier of the enum.") + @path + guid: string; + }, + AtlasEnumDef, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get the enum definition by its name (unique).") + @route("/atlas/v2/types/enumdef/name/{name}") + @get + getEnumDefByName is AtlasOperation< + { + @doc("The name of the enum.") + @path + name: string; + }, + AtlasEnumDef, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get the relationship definition for the given GUID.") + @route("/atlas/v2/types/relationshipdef/guid/{guid}") + @get + getRelationshipDefByGuid is AtlasOperation< + { + @doc("The globally unique identifier of the relationship.") + @path + guid: string; + }, + AtlasRelationshipDef, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get the relationship definition by its name (unique).") + @route("/atlas/v2/types/relationshipdef/name/{name}") + @get + getRelationshipDefByName is AtlasOperation< + { + @doc("The name of the relationship.") + @path + name: string; + }, + AtlasRelationshipDef, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get the struct definition for the given GUID.") + @route("/atlas/v2/types/structdef/guid/{guid}") + @get + getStructDefByGuid is AtlasOperation< + { + @doc("The globally unique identifier of the struct.") + @path + guid: string; + }, + AtlasStructDef, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get the struct definition by its name (unique).") + @route("/atlas/v2/types/structdef/name/{name}") + @get + getStructDefByName is AtlasOperation< + { + @doc("The name of the struct.") + @path + name: string; + }, + AtlasStructDef, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get the type definition for the given GUID.") + @route("/atlas/v2/types/typedef/guid/{guid}") + @get + getByGuid is AtlasOperation< + { + @doc("The globally unique identifier of the type.") + @path + guid: string; + }, + AtlasTypeDef, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Get the type definition by its name (unique).") + @route("/atlas/v2/types/typedef/name/{name}") + @get + getByName is AtlasOperation< + { + @doc("The name of the type.") + @path + name: string; + }, + AtlasTypeDef, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Delete API for type identified by its name.") + @route("/atlas/v2/types/typedef/name/{name}") + @delete + delete is AtlasOperation< + { + @doc("The name of the type.") + @path + name: string; + }, + void, + {} + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + @doc("List all type definitions in bulk.") + @route("/atlas/v2/types/typedefs") + @get + list is AtlasOperation< + { + @doc(""" +Whether include termtemplatedef when return all typedefs. +This is always true +when search filter type=term_template +""") + @query + includeTermTemplate?: boolean; + + @doc("Typedef name as search filter when get typedefs.") + @query + type?: TypeCategory; + }, + AtlasTypesDef, + AtlasApiVersionParameterTraits + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +Create all atlas type definitions in bulk, only new definitions will be +created. +Any changes to the existing definitions will be discarded. +""") + @route("/atlas/v2/types/typedefs") + @post + bulkCreate is AtlasOperation; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc(""" +Update all types in bulk, changes detected in the type definitions would be +persisted. +""") + @route("/atlas/v2/types/typedefs") + @put + bulkUpdate is AtlasOperation; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + #suppress "@azure-tools/typespec-azure-core/operation-missing-api-version" "This is Atlas API, which does not require api version" + @doc("Delete API for all types in bulk.") + @route("/atlas/v2/types/typedefs") + @delete + bulkDelete is AtlasOperation; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is Atlas API" + @doc("List all type definitions returned as a list of minimal information header.") + @route("/atlas/v2/types/typedefs/headers") + @get + listHeaders is AtlasOperation< + { + @doc(""" +Whether include termtemplatedef when return all typedefs. +This is always true +when search filter type=term_template +""") + @query + includeTermTemplate?: boolean; + + @doc("Typedef name as search filter when get typedefs.") + @query + type?: TypeCategory; + }, + OkResponse, + AtlasApiVersionParameterTraits + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is an existing API" + @doc("Get the term template definition for the given GUID.") + @route("/types/termtemplatedef/guid/{guid}") + @get + getTermTemplateDefByGuid is Azure.Core.Foundations.Operation< + { + @doc("The globally unique identifier of the term template.") + @path + guid: string; + }, + TermTemplateDef, + {}, + AtlasErrorResponse + >; + + #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "This is an existing API" + @doc("Get the term template definition by its name (unique).") + @route("/types/termtemplatedef/name/{name}") + @get + getTermTemplateDefByName is Azure.Core.Foundations.Operation< + { + @doc("The unique name of the term template.") + @path + name: string; + }, + TermTemplateDef, + {}, + AtlasErrorResponse + >; +} diff --git a/specification/purview/Azure.Analytics.Purview.DataMap/tspconfig.yaml b/specification/purview/Azure.Analytics.Purview.DataMap/tspconfig.yaml new file mode 100644 index 000000000000..16d1cc8f38c8 --- /dev/null +++ b/specification/purview/Azure.Analytics.Purview.DataMap/tspconfig.yaml @@ -0,0 +1,37 @@ +parameters: + "service-dir": + default: "sdk/purview" + "dependencies": + "additionalDirectories": [] + default: "" +emit: + - "@azure-tools/typespec-autorest" +options: + "@azure-tools/typespec-autorest": + azure-resource-provider-folder: "data-plane" + emitter-output-dir: "{project-root}/.." + examples-directory: "{project-root}/examples" + output-file: "{azure-resource-provider-folder}/Azure.Analytics.Purview.DataMap/{version-status}/{version}/purviewdatamap.json" + omit-unreachable-types: true + "@azure-tools/typespec-python": + package-dir: "azure-purview-datamap" + package-name: "{package-dir}" + package-mode: dataplane + "@azure-tools/typespec-csharp": + package-dir: "Azure.Analytics.Purview.DataMap" + namespace: "{package-dir}" + clear-output-folder: true + model-namespace: false + "@azure-tools/typespec-ts": + package-dir: "purview-datamap-rest" + generateMetadata: true + generateTest: true + packageDetails: + name: "@azure-rest/purview-datamap" + description: Purview DataMap Service" + "@azure-tools/typespec-java": + package-dir: "azure-analytics-purview-datamap" + namespace: com.azure.analytics.purview.datamap +linter: + extends: + - "@azure-tools/typespec-azure-core/all" diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_AutoComplete.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_AutoComplete.json index 6f9992091ded..b2f2665d5b36 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_AutoComplete.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_AutoComplete.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "autoCompleteRequest": { + "body": { "keywords": "exa", "filter": { "and": [ @@ -34,5 +34,7 @@ ] } } - } + }, + "title": "Discovery_AutoComplete", + "operationId": "Discovery_AutoComplete" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query.json index 01a3c24a0366..a7cde65a400e 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": "exampledata", "filter": { "and": [ @@ -103,5 +103,7 @@ ] } } - } + }, + "title": "Discovery_Query", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_And.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_And.json index 510076af8094..a1f45773a687 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_And.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_And.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": null, "limit": 10, "filter": { @@ -74,5 +74,7 @@ ] } } - } + }, + "title": "Discovery_Query_And", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_AndOrNested.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_AndOrNested.json index a18f77f11ea4..7ec39b19f500 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_AndOrNested.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_AndOrNested.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": null, "limit": 10, "filter": { @@ -91,5 +91,7 @@ ] } } - } + }, + "title": "Discovery_Query_AndOrNested", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_AssetType.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_AssetType.json index 6f134d2cbc92..deb289d5ea22 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_AssetType.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_AssetType.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": null, "limit": 10, "filter": { @@ -134,5 +134,7 @@ ] } } - } + }, + "title": "Discovery_Query_AssetType", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Attribute.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Attribute.json index 33e68dd2cc70..6d2ccf524020 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Attribute.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Attribute.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": null, "limit": 10, "filter": { @@ -91,5 +91,7 @@ ] } } - } + }, + "title": "Discovery_Query_Attribute", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_BusinessMetadataAttribute.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_BusinessMetadataAttribute.json index 49a647d73822..2ab33726a034 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_BusinessMetadataAttribute.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_BusinessMetadataAttribute.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": null, "limit": 10, "filter": { @@ -48,5 +48,7 @@ ] } } - } + }, + "title": "Discovery_Query_BusinessMetadataAttribute", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Classification.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Classification.json index 1652e3eb3967..5150545e7d0f 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Classification.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Classification.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": null, "limit": 10, "filter": { @@ -63,5 +63,7 @@ ] } } - } + }, + "title": "Discovery_Query_Classification", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Collection.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Collection.json index 8d51d3b6a9c9..3779d9d497fe 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Collection.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Collection.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": null, "limit": 10, "filter": { @@ -62,5 +62,7 @@ ] } } - } + }, + "title": "Discovery_Query_Collection", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Facet.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Facet.json index d68b074a230f..b417487bea7d 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Facet.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Facet.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": null, "filter": { "objectType": "Tables" @@ -144,5 +144,7 @@ ] } } - } + }, + "title": "Discovery_Query_Facet", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_FileExtension.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_FileExtension.json index 9c2aed22a521..0b7fee10f958 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_FileExtension.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_FileExtension.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": null, "limit": 10, "filter": { @@ -56,5 +56,7 @@ ] } } - } + }, + "title": "Discovery_Query_FileExtension", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_GlossaryTerm.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_GlossaryTerm.json index 15d04904849c..1af1169192d0 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_GlossaryTerm.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_GlossaryTerm.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": "", "limit": 10, "filter": { @@ -90,5 +90,7 @@ } } } - } + }, + "title": "Discovery_Query_GlossaryTerm", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Id.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Id.json index a239b38b5c50..1a983534fbce 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Id.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Id.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": null, "limit": 10, "filter": { @@ -39,5 +39,7 @@ ] } } - } + }, + "title": "Discovery_Query_Id", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Not.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Not.json index 004b8283ffc2..4c6b90d682c4 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Not.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Not.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": null, "limit": 10, "filter": { @@ -54,5 +54,7 @@ ] } } - } + }, + "title": "Discovery_Query_Not", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_ObjectType.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_ObjectType.json index a75ed71cd1e4..f332749b05ee 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_ObjectType.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_ObjectType.json @@ -1,37 +1,35 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": null, "limit": 10, "filter": { "or": [ - [ - { - "objectType": "Dashboards" - }, - { - "objectType": "Data pipelines" - }, - { - "objectType": "Files" - }, - { - "objectType": "Folders" - }, - { - "objectType": "Glossary terms" - }, - { - "objectType": "Reports" - }, - { - "objectType": "Stored procedures" - }, - { - "objectType": "Tables" - } - ] + { + "objectType": "Dashboards" + }, + { + "objectType": "Data pipelines" + }, + { + "objectType": "Files" + }, + { + "objectType": "Folders" + }, + { + "objectType": "Glossary terms" + }, + { + "objectType": "Reports" + }, + { + "objectType": "Stored procedures" + }, + { + "objectType": "Tables" + } ] } }, @@ -71,5 +69,7 @@ ] } } - } + }, + "title": "Discovery_Query_ObjectType", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_PaginationContinuationPage.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_PaginationContinuationPage.json index 99220e6552d4..cbe86e93e8fa 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_PaginationContinuationPage.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_PaginationContinuationPage.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": "exampledata", "filter": { "and": [ @@ -105,5 +105,7 @@ ] } } - } + }, + "title": "Discovery_Query_PaginationContinuationPage", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_PaginationFirstPage.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_PaginationFirstPage.json index 9de3ad93b2b7..fe5522da8ebf 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_PaginationFirstPage.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_PaginationFirstPage.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": "exampledata", "filter": { "and": [ @@ -104,5 +104,7 @@ ] } } - } + }, + "title": "Discovery_Query_PaginationFirstPage", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_PaginationLastPage.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_PaginationLastPage.json index 7320000e5082..4e64dd33405e 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_PaginationLastPage.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_PaginationLastPage.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": "exampledata", "filter": { "and": [ @@ -104,5 +104,7 @@ ] } } - } + }, + "title": "Discovery_Query_PaginationLastPage", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_SystemTime.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_SystemTime.json index bde144d66d3f..d2196fa7ea91 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_SystemTime.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_SystemTime.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": null, "limit": 10, "filter": { @@ -49,5 +49,7 @@ ] } } - } + }, + "title": "Discovery_Query_SystemTime", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Taxonomy.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Taxonomy.json index 6b05a5985854..f2f278e5c48b 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Taxonomy.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Taxonomy.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": "exampledata", "filter": { "and": [ @@ -88,5 +88,7 @@ ] } } - } + }, + "title": "Discovery_Query_Taxonomy", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_TermAssignment.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_TermAssignment.json index 576c69a243c5..0c24709432b3 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_TermAssignment.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_TermAssignment.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": "", "limit": 3, "filter": { @@ -53,5 +53,7 @@ ] } } - } + }, + "title": "Discovery_Query_TermAssignment", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Type.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Type.json index f78c96dd68ac..48480e13fc17 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Type.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Query_Type.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "searchRequest": { + "body": { "keywords": null, "limit": 10, "filter": { @@ -60,5 +60,7 @@ ] } } - } + }, + "title": "Discovery_Query_Type", + "operationId": "Discovery_Query" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Suggest.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Suggest.json index f0886ed0c690..3ff80bee52ec 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Suggest.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Discovery_Suggest.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "suggestRequest": { + "body": { "keywords": "exampledata", "filter": { "and": [ @@ -54,5 +54,7 @@ ] } } - } + }, + "title": "Discovery_Suggest", + "operationId": "Discovery_Suggest" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddClassificationToEntityByGuids.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddClassificationToEntityByGuids.json index c955f4586918..b94ab95331ec 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddClassificationToEntityByGuids.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddClassificationToEntityByGuids.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "request": { + "body": { "classification": { "typeName": "MICROSOFT.FINANCIAL.US.ABA_ROUTING_NUMBER", "attributes": {}, @@ -15,5 +15,7 @@ }, "responses": { "204": {} - } + }, + "title": "Entity_AddClassificationToEntityByGuids", + "operationId": "Entity_AddClassification" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddClassifications.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddClassifications.json index 6aa11763de71..5ab64b05faac 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddClassifications.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddClassifications.json @@ -2,7 +2,7 @@ "parameters": { "Endpoint": "{Endpoint}", "guid": "cc0730ba-9b30-41f0-6953-559d17626d2b", - "classifications": [ + "body": [ { "typeName": "MICROSOFT.FINANCIAL.US.ABA_ROUTING_NUMBER", "entityGuid": "cc0730ba-9b30-41f0-6953-559d17626d2b" @@ -15,5 +15,7 @@ }, "responses": { "204": {} - } + }, + "title": "Entity_AddClassifications", + "operationId": "Entity_AddClassifications" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddClassificationsByUniqueAttribute.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddClassificationsByUniqueAttribute.json index e82bbe57a2f3..0a724e78e134 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddClassificationsByUniqueAttribute.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddClassificationsByUniqueAttribute.json @@ -3,7 +3,7 @@ "Endpoint": "{Endpoint}", "typeName": "azure_storage_account", "attr:qualifiedName": "https://exampleaccount.core.windows.net", - "atlasClassificationArray": [ + "body": [ { "typeName": "MICROSOFT.FINANCIAL.US.ABA_ROUTING_NUMBER" }, @@ -14,5 +14,7 @@ }, "responses": { "204": {} - } + }, + "title": "Entity_AddClassificationsByUniqueAttribute", + "operationId": "Entity_AddClassificationsByUniqueAttribute" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddCustomAttribute.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddCustomAttribute.json index 5fafde7ea05e..5e50da3bc1c7 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddCustomAttribute.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddCustomAttribute.json @@ -1,7 +1,8 @@ { "parameters": { "Endpoint": "{Endpoint}", - "entity": { + "api-version": "2023-09-01", + "body": { "referredEntities": {}, "entity": { "typeName": "azure_storage_account", @@ -51,5 +52,7 @@ } } } - } + }, + "title": "Entity_AddCustomAttribute", + "operationId": "Entity_CreateOrUpdate" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddLabel.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddLabel.json new file mode 100644 index 000000000000..6c8c8ccf153d --- /dev/null +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddLabel.json @@ -0,0 +1,15 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "02c373fe-2823-4be3-97fa-55180a9faa06", + "body": [ + "label1", + "label2" + ] + }, + "responses": { + "204": {} + }, + "title": "Entity_AddLabel", + "operationId": "Entity_AddLabel" +} diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddLabelsByUniqueAttribute.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddLabelsByUniqueAttribute.json index 8d60d206619e..3a2bc5a3f537 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddLabelsByUniqueAttribute.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddLabelsByUniqueAttribute.json @@ -9,5 +9,7 @@ }, "responses": { "204": {} - } + }, + "title": "Entity_AddLabelsByUniqueAttribute", + "operationId": "Entity_AddLabelsByUniqueAttribute" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddOrUpdate_BusinessAttribute.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddOrUpdate_BusinessAttribute.json index 6335668124ae..f91a2897c1e2 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddOrUpdate_BusinessAttribute.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddOrUpdate_BusinessAttribute.json @@ -2,12 +2,14 @@ "parameters": { "Endpoint": "{Endpoint}", "guid": "02c373fe-2823-4be3-97fa-55180a9faa06", - "bmName": "myBizMetaData1", + "businessMetadataName": "myBizMetaData1", "body": { "bizAttr1": "bizAttr1" } }, "responses": { "204": {} - } + }, + "title": "Entity_AddOrUpdate_BusinessAttribute", + "operationId": "Entity_AddOrUpdateBusinessMetadataAttributes" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddOrUpdate_BusinessMetadata.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddOrUpdate_BusinessMetadata.json new file mode 100644 index 000000000000..4141a16cc255 --- /dev/null +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_AddOrUpdate_BusinessMetadata.json @@ -0,0 +1,16 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "02c373fe-2823-4be3-97fa-55180a9faa06", + "body": { + "myBizMetadata1": { + "bizAttr1": "myBizMetaData1.bizAttr1" + } + } + }, + "responses": { + "204": {} + }, + "title": "Entity_AddOrUpdate_BusinessMetadata", + "operationId": "Entity_AddOrUpdateBusinessMetadata" +} diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_BulkCreateOrUpdate.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_BulkCreateOrUpdate.json index 779992eff9ba..81eb02f76d2e 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_BulkCreateOrUpdate.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_BulkCreateOrUpdate.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "entities": { + "body": { "referredEntities": {}, "entities": [ { @@ -100,5 +100,7 @@ } } } - } + }, + "title": "Entity_BulkCreateOrUpdate", + "operationId": "Entity_BulkCreateOrUpdate" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_BulkDelete.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_BulkDelete.json index 067d745f66c1..3b8c27b9b5fc 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_BulkDelete.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_BulkDelete.json @@ -31,5 +31,7 @@ } } } - } + }, + "title": "Entity_BulkDelete", + "operationId": "Entity_BulkDelete" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_BulkSetClassifications.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_BulkSetClassifications.json index 907bbe9c1e97..ceac402f49a7 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_BulkSetClassifications.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_BulkSetClassifications.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "entityHeaders": { + "body": { "guidHeaderMap": { "9fb74c11-ac48-4650-95bc-760665c5bd92": { "attributes": { @@ -35,5 +35,7 @@ "Update:7fcc43ab-55ea-45d4-9971-ce0443cb10bb:azure_storage_account:qualifiedName -> MICROSOFT.PERSONAL.IPADDRESS:(Done)" ] } - } + }, + "title": "Entity_BulkSetClassifications", + "operationId": "Entity_BulkSetClassifications" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Create.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Create.json index b4946962b191..cf8647830754 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Create.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Create.json @@ -1,7 +1,8 @@ { "parameters": { "Endpoint": "{Endpoint}", - "entity": { + "api-version": "2023-09-01", + "body": { "referredEntities": {}, "entity": { "typeName": "azure_storage_account", @@ -56,5 +57,7 @@ } } } - } + }, + "title": "Entity_Create", + "operationId": "Entity_CreateOrUpdate" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Delete.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Delete.json index 029021e09916..9e6ab2104d44 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Delete.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Delete.json @@ -23,5 +23,7 @@ } } } - } + }, + "title": "Entity_Delete", + "operationId": "Entity_Delete" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_DeleteByUniqueAttribute.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_DeleteByUniqueAttribute.json index 34948b6504ab..3df1ba7cee96 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_DeleteByUniqueAttribute.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_DeleteByUniqueAttribute.json @@ -29,5 +29,7 @@ } } } - } + }, + "title": "Entity_DeleteByUniqueAttribute", + "operationId": "Entity_DeleteByUniqueAttribute" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Get.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Get.json index 918d06e41adc..4c89ab5c8872 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Get.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Get.json @@ -1,7 +1,8 @@ { "parameters": { "Endpoint": "{Endpoint}", - "guid": "5cf8a9e5-c9fd-abe0-2e8c-d40024263dcb" + "guid": "5cf8a9e5-c9fd-abe0-2e8c-d40024263dcb", + "minExtInfo": true }, "responses": { "200": { @@ -57,5 +58,7 @@ } } } - } + }, + "title": "Entity_Get", + "operationId": "Entity_Get" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetByUniqueAttributes.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetByUniqueAttributes.json index 1985ed6cb10e..f7ebf7d7d013 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetByUniqueAttributes.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetByUniqueAttributes.json @@ -2,7 +2,8 @@ "parameters": { "Endpoint": "{Endpoint}", "typeName": "azure_storage_account", - "attr:qualifiedName": "https://exampleaccount.core.windows.net" + "attr:qualifiedName": "https://exampleaccount.core.windows.net", + "minExtInfo": true }, "responses": { "200": { @@ -31,5 +32,7 @@ "referredEntities": {} } } - } + }, + "title": "Entity_GetByUniqueAttributes", + "operationId": "Entity_GetByUniqueAttributes" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetClassification.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetClassification.json index 1d976b1e21e0..968a4d7e0fcc 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetClassification.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetClassification.json @@ -13,5 +13,7 @@ "entityStatus": "ACTIVE" } } - } + }, + "title": "Entity_GetClassification", + "operationId": "Entity_GetClassification" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetClassifications.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetClassifications.json index 8f89220119d7..ae0d81292c04 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetClassifications.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetClassifications.json @@ -18,5 +18,7 @@ "sortType": "NONE" } } - } + }, + "title": "Entity_GetClassifications", + "operationId": "Entity_GetClassifications" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetHeader.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetHeader.json index c9ae29bce60d..029a55bbbb96 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetHeader.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetHeader.json @@ -24,5 +24,7 @@ "typeName": "azure_storage_account" } } - } + }, + "title": "Entity_GetHeader", + "operationId": "Entity_GetHeader" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetSampleBusinessMetadataTemplate.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetSampleBusinessMetadataTemplate.json index b25d5b0cc239..34f5b284ae4b 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetSampleBusinessMetadataTemplate.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_GetSampleBusinessMetadataTemplate.json @@ -1,10 +1,13 @@ { "parameters": { - "Endpoint": "{Endpoint}" + "Endpoint": "{Endpoint}", + "api-version": "2023-09-01" }, "responses": { "200": { "body": "EntityType,EntityUniqueAttributeValue,BusinessAttributeName,BusinessAttributeValue,EntityUniqueAttributeName[optional]" } - } + }, + "title": "Entity_GetSampleBusinessMetadataTemplate", + "operationId": "Entity_GetSampleBusinessMetadataTemplate" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_ImportBusinessMetadata.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_ImportBusinessMetadata.json index 37325e736386..5717a38aa7c8 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_ImportBusinessMetadata.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_ImportBusinessMetadata.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "file": "examplefile.csv" + "file": "---multipart-boundary\nContent-Disposition: form-data; name=\"file\"\nContent-Type: application/octet-stream\n\n---multipart-boundary--" }, "responses": { "200": { @@ -16,5 +16,7 @@ ] } } - } + }, + "title": "Entity_ImportBusinessMetadata", + "operationId": "Entity_ImportBusinessMetadata" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_ListByGuids.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_ListByGuids.json index 8d8754364eed..4f48451cdbbe 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_ListByGuids.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_ListByGuids.json @@ -4,7 +4,8 @@ "guid": [ "784c0f2f-afd2-e26b-f9cb-984f6c2c5021", "b4ebc8be-cef4-860a-bee9-28cc34cb5caa" - ] + ], + "minExtInfo": true }, "responses": { "200": { @@ -110,5 +111,7 @@ ] } } - } + }, + "title": "Entity_ListByGuids", + "operationId": "Entity_ListByGuids" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_ListByUniqueAttributes.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_ListByUniqueAttributes.json index 16c42a58932e..176e6972162b 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_ListByUniqueAttributes.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_ListByUniqueAttributes.json @@ -2,7 +2,8 @@ "parameters": { "Endpoint": "{Endpoint}", "typeName": "azure_storage_account", - "attr_N:qualifiedName": "adl://exampleaccount.azuredatalakestore.net/123/1/DP_TFS/CBT/Extensions/DTTP.targets#:xml/Project/PropertyGroup/ExampleName1" + "attr_N:qualifiedName": "adl://exampleaccount.azuredatalakestore.net/123/1/DP_TFS/CBT/Extensions/DTTP.targets#:xml/Project/PropertyGroup/ExampleName1", + "minExtInfo": true }, "responses": { "200": { @@ -46,5 +47,7 @@ ] } } - } + }, + "title": "Entity_ListByUniqueAttributes", + "operationId": "Entity_ListByUniqueAttributes" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_MoveEntitiesToCollection.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_MoveEntitiesToCollection.json index 42e6555a9f4e..a9d546dacff1 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_MoveEntitiesToCollection.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_MoveEntitiesToCollection.json @@ -3,7 +3,7 @@ "Endpoint": "{Endpoint}", "collectionId": "ExampleNewCollection", "api-version": "2023-09-01", - "moveEntitiesRequest": { + "body": { "entityGuids": [ "321493e3-3fb7-4b3e-9df7-3b69154174c2", "b2f9c306-cf65-4bb0-878e-cfaafde156b1" @@ -41,5 +41,7 @@ } } } - } + }, + "title": "Entity_MoveEntitiesToCollection", + "operationId": "Entity_MoveEntitiesToCollection" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_PartialUpdateAttributeByGuid.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_PartialUpdateAttributeByGuid.json index 343a0b2ecb25..4320bdb7e9a7 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_PartialUpdateAttributeByGuid.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_PartialUpdateAttributeByGuid.json @@ -33,5 +33,7 @@ ] } } - } + }, + "title": "Entity_PartialUpdateAttributeByGuid", + "operationId": "Entity_PartialUpdateAttributeByGuid" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_PartialUpdateByUniqueAttributes.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_PartialUpdateByUniqueAttributes.json index a38dc403ff1d..40609617bfa7 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_PartialUpdateByUniqueAttributes.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_PartialUpdateByUniqueAttributes.json @@ -3,9 +3,9 @@ "Endpoint": "{Endpoint}", "typeName": "azure_storage_account", "attr:qualifiedName": "https://exampleaccount.core.windows.net", - "atlasEntityWithExtInfo": { + "body": { "entity": { - "createTime": 1.605766397985E12, + "createTime": 1605766397985.0, "createdBy": "8c062c84-5d25-449f-a990-9d8ab70b8ec7", "guid": "dc507ccf-0c57-4165-9327-f37b0d13fda0", "relationshipAttributes": { @@ -13,7 +13,7 @@ "meanings": [] }, "status": "ACTIVE", - "updateTime": 1.605766397985E12, + "updateTime": 1605766397985.0, "updatedBy": "8c062c84-5d25-449f-a990-9d8ab70b8ec7", "lastModifiedTS": "1", "version": 0.0, @@ -56,5 +56,7 @@ ] } } - } + }, + "title": "Entity_PartialUpdateByUniqueAttributes", + "operationId": "Entity_PartialUpdateByUniqueAttributes" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveBusinessAttribute.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveBusinessAttribute.json index 6335668124ae..717225e30454 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveBusinessAttribute.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveBusinessAttribute.json @@ -2,12 +2,14 @@ "parameters": { "Endpoint": "{Endpoint}", "guid": "02c373fe-2823-4be3-97fa-55180a9faa06", - "bmName": "myBizMetaData1", + "businessMetadataName": "myBizMetaData1", "body": { "bizAttr1": "bizAttr1" } }, "responses": { "204": {} - } + }, + "title": "Entity_RemoveBusinessAttribute", + "operationId": "Entity_RemoveBusinessMetadataAttributes" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveBusinessMetadata.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveBusinessMetadata.json index 9292ad587d04..9e2de7361e36 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveBusinessMetadata.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveBusinessMetadata.json @@ -10,5 +10,7 @@ }, "responses": { "204": {} - } + }, + "title": "Entity_RemoveBusinessMetadata", + "operationId": "Entity_RemoveBusinessMetadata" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveClassification.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveClassification.json index 0967940bc811..408744950b01 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveClassification.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveClassification.json @@ -6,5 +6,7 @@ }, "responses": { "204": {} - } + }, + "title": "Entity_RemoveClassification", + "operationId": "Entity_RemoveClassification" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveClassificationByUniqueAttribute.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveClassificationByUniqueAttribute.json index 4d2cc9927070..75717c4f59ad 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveClassificationByUniqueAttribute.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveClassificationByUniqueAttribute.json @@ -7,5 +7,7 @@ }, "responses": { "204": {} - } + }, + "title": "Entity_RemoveClassificationByUniqueAttribute", + "operationId": "Entity_RemoveClassificationByUniqueAttribute" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveLabels.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveLabels.json new file mode 100644 index 000000000000..743f676c786b --- /dev/null +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveLabels.json @@ -0,0 +1,15 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "02c373fe-2823-4be3-97fa-55180a9faa06", + "body": [ + "label1", + "label2" + ] + }, + "responses": { + "204": {} + }, + "title": "Entity_RemoveLabels", + "operationId": "Entity_RemoveLabels" +} diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveLabelsByUniqueAttribute.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveLabelsByUniqueAttribute.json index 8479ed0cfe43..3ae4c0b565f8 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveLabelsByUniqueAttribute.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_RemoveLabelsByUniqueAttribute.json @@ -9,5 +9,7 @@ }, "responses": { "204": {} - } + }, + "title": "Entity_RemoveLabelsByUniqueAttribute", + "operationId": "Entity_RemoveLabelsByUniqueAttribute" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_SetLabels.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_SetLabels.json new file mode 100644 index 000000000000..e2b2c2eb6344 --- /dev/null +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_SetLabels.json @@ -0,0 +1,15 @@ +{ + "parameters": { + "Endpoint": "{Endpoint}", + "guid": "02c373fe-2823-4be3-97fa-55180a9faa06", + "body": [ + "label1", + "label2" + ] + }, + "responses": { + "204": {} + }, + "title": "Entity_SetLabels", + "operationId": "Entity_SetLabels" +} diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_SetLabelsByUniqueAttribute.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_SetLabelsByUniqueAttribute.json index b2132f45f70b..9ffba096b022 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_SetLabelsByUniqueAttribute.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_SetLabelsByUniqueAttribute.json @@ -10,5 +10,7 @@ }, "responses": { "204": {} - } + }, + "title": "Entity_SetLabelsByUniqueAttribute", + "operationId": "Entity_SetLabelsByUniqueAttribute" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Update.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Update.json index 56799529f337..40e2350403a5 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Update.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_Update.json @@ -1,7 +1,8 @@ { "parameters": { "Endpoint": "{Endpoint}", - "entity": { + "api-version": "2023-09-01", + "body": { "referredEntities": {}, "entity": { "typeName": "azure_storage_account", @@ -55,5 +56,7 @@ } } } - } + }, + "title": "Entity_Update", + "operationId": "Entity_CreateOrUpdate" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_UpdateClassifications.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_UpdateClassifications.json index d558a272e7ea..274b565b8f81 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_UpdateClassifications.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_UpdateClassifications.json @@ -2,7 +2,7 @@ "parameters": { "Endpoint": "{Endpoint}", "guid": "45dd4404-e897-b7e2-ca3c-f6e6b11b4f24", - "classifications": [ + "body": [ { "typeName": "MICROSOFT.FINANCIAL.CREDIT_CARD_NUMBER", "entityGuid": "45dd4404-e897-b7e2-ca3c-f6e6b11b4f24" @@ -15,5 +15,7 @@ }, "responses": { "204": {} - } + }, + "title": "Entity_UpdateClassifications", + "operationId": "Entity_UpdateClassifications" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_UpdateClassificationsByUniqueAttribute.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_UpdateClassificationsByUniqueAttribute.json index e82bbe57a2f3..f3b1777a8e75 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_UpdateClassificationsByUniqueAttribute.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Entity_UpdateClassificationsByUniqueAttribute.json @@ -3,7 +3,7 @@ "Endpoint": "{Endpoint}", "typeName": "azure_storage_account", "attr:qualifiedName": "https://exampleaccount.core.windows.net", - "atlasClassificationArray": [ + "body": [ { "typeName": "MICROSOFT.FINANCIAL.US.ABA_ROUTING_NUMBER" }, @@ -14,5 +14,7 @@ }, "responses": { "204": {} - } + }, + "title": "Entity_UpdateClassificationsByUniqueAttribute", + "operationId": "Entity_UpdateClassificationsByUniqueAttribute" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_AssignTermToEntities.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_AssignTermToEntities.json index 5ff085189499..82aae3a1b087 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_AssignTermToEntities.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_AssignTermToEntities.json @@ -1,8 +1,8 @@ { "parameters": { "Endpoint": "{Endpoint}", - "termGuid": "8a7f65ec-6429-0b9b-3734-ec57bf1e34c2", - "relatedObjectIds": [ + "termId": "8a7f65ec-6429-0b9b-3734-ec57bf1e34c2", + "body": [ { "guid": "ab9f1920-0b94-436d-aeb4-11a32c270fc0", "relationshipAttributes": { @@ -18,5 +18,7 @@ }, "responses": { "204": {} - } + }, + "title": "Glossary_AssignTermToEntities", + "operationId": "Glossary_AssignTermToEntities" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_Create.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_Create.json index a1ec9e6bee07..01289fd09ee1 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_Create.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_Create.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "atlasGlossary": { + "body": { "name": "Glossary", "shortDescription": "Example Short Description", "longDescription": "Example Long Description", @@ -26,5 +26,7 @@ "updateTime": 1672892675688 } } - } + }, + "title": "Glossary_Create", + "operationId": "Glossary_Create" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateCategories.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateCategories.json index 17a515af1f09..7dfb49f4e1ae 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateCategories.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateCategories.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "glossaryCategory": [ + "body": [ { "name": "ExampleCategory2", "anchor": { @@ -41,5 +41,7 @@ } ] } - } + }, + "title": "Glossary_CreateCategories", + "operationId": "Glossary_CreateCategories" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateCategory.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateCategory.json index 7f31caaea342..912e40a4e7ef 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateCategory.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateCategory.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "glossaryCategory": { + "body": { "anchor": { "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8" }, @@ -33,5 +33,7 @@ ] } } - } + }, + "title": "Glossary_CreateCategory", + "operationId": "Glossary_CreateCategory" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateTerm.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateTerm.json index efd7d2d547b2..bd988ea6973b 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateTerm.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateTerm.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "glossaryTerm": { + "body": { "name": "ExampleTerm1", "shortDescription": "Example Short Description", "longDescription": "Example Long Description", @@ -72,5 +72,7 @@ } } } - } + }, + "title": "Glossary_CreateTerm", + "operationId": "Glossary_CreateTerm" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateTermWithTemplate.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateTermWithTemplate.json index c9b7795a1b04..677877660bc8 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateTermWithTemplate.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateTermWithTemplate.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "glossaryTerm": { + "body": { "name": "ExampleTerm", "anchor": { "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8" @@ -47,5 +47,7 @@ } } } - } + }, + "title": "Glossary_CreateTermWithTemplate", + "operationId": "Glossary_CreateTerm" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateTerms.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateTerms.json index ddd48b3a0782..18fcddae9a04 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateTerms.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_CreateTerms.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "glossaryTerm": [ + "body": [ { "anchor": { "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8" @@ -87,5 +87,7 @@ } ] } - } + }, + "title": "Glossary_CreateTerms", + "operationId": "Glossary_CreateTerms" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_Delete.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_Delete.json index 70b4059decdd..88b82510fb9f 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_Delete.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_Delete.json @@ -1,9 +1,11 @@ { "parameters": { "Endpoint": "{Endpoint}", - "glossaryGuid": "c0c54153-13d1-1608-13af-43457cdffe75" + "glossaryId": "c0c54153-13d1-1608-13af-43457cdffe75" }, "responses": { "204": {} - } + }, + "title": "Glossary_Delete", + "operationId": "Glossary_Delete" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_DeleteCategory.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_DeleteCategory.json index 678b949d55e5..c281cd4c2450 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_DeleteCategory.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_DeleteCategory.json @@ -1,9 +1,11 @@ { "parameters": { "Endpoint": "{Endpoint}", - "categoryGuid": "0e391355-252a-e5f3-ac18-5a3602df7616" + "categoryId": "0e391355-252a-e5f3-ac18-5a3602df7616" }, "responses": { "204": {} - } + }, + "title": "Glossary_DeleteCategory", + "operationId": "Glossary_DeleteCategory" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_DeleteTerm.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_DeleteTerm.json index 32fd415f64d5..7fa8e97b845a 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_DeleteTerm.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_DeleteTerm.json @@ -1,9 +1,11 @@ { "parameters": { "Endpoint": "{Endpoint}", - "termGuid": "b0942506-2d7d-1f45-d286-c29ca9e7f2ef" + "termId": "b0942506-2d7d-1f45-d286-c29ca9e7f2ef" }, "responses": { "204": {} - } + }, + "title": "Glossary_DeleteTerm", + "operationId": "Glossary_DeleteTerm" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_Get.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_Get.json index 1eb2a13b1f0b..6e1aaeaa5786 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_Get.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_Get.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "glossaryGuid": "47029611-67a1-42d5-8766-90eb904f7f22" + "glossaryId": "47029611-67a1-42d5-8766-90eb904f7f22" }, "responses": { "200": { @@ -37,5 +37,7 @@ ] } } - } + }, + "title": "Glossary_Get", + "operationId": "Glossary_Get" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_GetCategory.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_GetCategory.json index 2329430d0e4d..1de42a99f57e 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_GetCategory.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_GetCategory.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12" + "categoryId": "ed7458f0-9463-48a5-b5c6-4f785fb34e12" }, "responses": { "200": { @@ -35,5 +35,7 @@ ] } } - } + }, + "title": "Glossary_GetCategory", + "operationId": "Glossary_GetCategory" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_GetDetailed.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_GetDetailed.json index f5aea38d5f1d..0345a931a976 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_GetDetailed.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_GetDetailed.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8" + "glossaryId": "c018ddaf-7c21-4b37-a838-dae5f110c3d8" }, "responses": { "200": { @@ -225,5 +225,7 @@ } } } - } + }, + "title": "Glossary_GetDetailed", + "operationId": "Glossary_GetDetailed" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_GetTerm.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_GetTerm.json index d1bf7157bbed..3b574ac3e20f 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_GetTerm.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_GetTerm.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea" + "termId": "54688d39-b298-4104-9e80-f2a16f44aaea" }, "responses": { "200": { @@ -80,5 +80,7 @@ ] } } - } + }, + "title": "Glossary_GetTerm", + "operationId": "Glossary_GetTerm" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_GetTermWithoutAssets.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_GetTermWithoutAssets.json index c0dcc7655580..3bedbf11a9a4 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_GetTermWithoutAssets.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_GetTermWithoutAssets.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "termId": "54688d39-b298-4104-9e80-f2a16f44aaea", "excludeRelationshipTypes": [ "AtlasGlossarySemanticAssignment" ] @@ -60,5 +60,7 @@ ] } } - } + }, + "title": "Glossary_GetTermWithoutAssets", + "operationId": "Glossary_GetTerm" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_List.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_List.json index f8bc74ada7f4..c454ce6b68f7 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_List.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_List.json @@ -55,5 +55,7 @@ } ] } - } + }, + "title": "Glossary_List", + "operationId": "Glossary_List" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListCategories.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListCategories.json index aabcc66dc2d0..30e8cf73dbfd 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListCategories.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListCategories.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "glossaryId": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", "limit": "-1", "offset": "0", "sort": "ASC" @@ -68,5 +68,7 @@ } ] } - } + }, + "title": "Glossary_ListCategories", + "operationId": "Glossary_ListCategories" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListCategoriesHeaders.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListCategoriesHeaders.json index 277c967f7f0b..a04eb3cba127 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListCategoriesHeaders.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListCategoriesHeaders.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "glossaryId": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", "limit": "-1", "offset": "0", "sort": "ASC" @@ -28,5 +28,7 @@ } ] } - } + }, + "title": "Glossary_ListCategoriesHeaders", + "operationId": "Glossary_ListCategoriesHeaders" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListCategoryTerms.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListCategoryTerms.json index 7fe35d8dd8f2..e1a99139221b 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListCategoryTerms.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListCategoryTerms.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "categoryId": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", "limit": "-1", "offset": "0", "sort": "ASC" @@ -16,5 +16,7 @@ } ] } - } + }, + "title": "Glossary_ListCategoryTerms", + "operationId": "Glossary_ListCategoryTerms" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListEntitiesAssignedWithTerm.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListEntitiesAssignedWithTerm.json index ebfed3c2de40..99c872e87c99 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListEntitiesAssignedWithTerm.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListEntitiesAssignedWithTerm.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "termGuid": "daf0ba4d-bc9a-4536-8a88-4b58e39dd3d4", + "termId": "daf0ba4d-bc9a-4536-8a88-4b58e39dd3d4", "limit": "-1", "offset": "0", "sort": "ASC" @@ -53,5 +53,7 @@ } ] } - } + }, + "title": "Glossary_ListEntitiesAssignedWithTerm", + "operationId": "Glossary_ListEntitiesAssignedWithTerm" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListRelatedCategories.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListRelatedCategories.json index 7523745867a5..2e845fcb0944 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListRelatedCategories.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListRelatedCategories.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "categoryId": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", "limit": "-1", "offset": "0", "sort": "ASC" @@ -25,5 +25,7 @@ ] } } - } + }, + "title": "Glossary_ListRelatedCategories", + "operationId": "Glossary_ListRelatedCategories" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListRelatedTerms.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListRelatedTerms.json index ca90bb6d08d7..56999a9dd79a 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListRelatedTerms.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListRelatedTerms.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", + "termId": "54688d39-b298-4104-9e80-f2a16f44aaea", "limit": "-1", "offset": "0", "sort": "ASC" @@ -25,5 +25,7 @@ ] } } - } + }, + "title": "Glossary_ListRelatedTerms", + "operationId": "Glossary_ListRelatedTerms" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListTermHeaders.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListTermHeaders.json index 1375aa567f2b..6bcfbe8c9fc9 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListTermHeaders.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListTermHeaders.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "glossaryId": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", "limit": "-1", "offset": "0", "sort": "ASC" @@ -21,5 +21,7 @@ } ] } - } + }, + "title": "Glossary_ListTermHeaders", + "operationId": "Glossary_ListTermHeaders" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListTerms.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListTerms.json index 214bbd4c4f76..583aa635b462 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListTerms.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_ListTerms.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "glossaryId": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", "limit": "-1", "offset": "0", "sort": "ASC" @@ -99,5 +99,7 @@ } ] } - } + }, + "title": "Glossary_ListTerms", + "operationId": "Glossary_ListTerms" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_PartialUpdate.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_PartialUpdate.json index 4df90166a6b6..c06db55d9e38 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_PartialUpdate.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_PartialUpdate.json @@ -1,8 +1,8 @@ { "parameters": { "Endpoint": "{Endpoint}", - "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", - "partialUpdates": { + "glossaryId": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "body": { "longDescription": "Example Long Description" } }, @@ -54,5 +54,7 @@ ] } } - } + }, + "title": "Glossary_PartialUpdate", + "operationId": "Glossary_PartialUpdate" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_PartialUpdateCategory.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_PartialUpdateCategory.json index 11516593b6bd..15be08095e73 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_PartialUpdateCategory.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_PartialUpdateCategory.json @@ -1,8 +1,8 @@ { "parameters": { "Endpoint": "{Endpoint}", - "categoryGuid": "3243ea0a-9492-47e1-392e-a84e64980af9", - "partialUpdates": { + "categoryId": "3243ea0a-9492-47e1-392e-a84e64980af9", + "body": { "longDescription": "Example Long Description" } }, @@ -39,5 +39,7 @@ ] } } - } + }, + "title": "Glossary_PartialUpdateCategory", + "operationId": "Glossary_PartialUpdateCategory" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_PartialUpdateTerm.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_PartialUpdateTerm.json index 572d692fa4b6..356a70cf4da3 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_PartialUpdateTerm.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_PartialUpdateTerm.json @@ -1,9 +1,9 @@ { "parameters": { "Endpoint": "{Endpoint}", - "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", - "partialUpdates": { - "longDescription": "Example Long Descrition" + "termId": "54688d39-b298-4104-9e80-f2a16f44aaea", + "body": { + "longDescription": "Example Long Description" } }, "responses": { @@ -54,5 +54,7 @@ ] } } - } + }, + "title": "Glossary_PartialUpdateTerm", + "operationId": "Glossary_PartialUpdateTerm" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_RemoveTermAssignmentFromEntities.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_RemoveTermAssignmentFromEntities.json index ca978c5df1fc..2238f2443727 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_RemoveTermAssignmentFromEntities.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_RemoveTermAssignmentFromEntities.json @@ -1,8 +1,8 @@ { "parameters": { "Endpoint": "{Endpoint}", - "termGuid": "8a7f65ec-6429-0b9b-3734-ec57bf1e34c2", - "relatedObjectIds": [ + "termId": "8a7f65ec-6429-0b9b-3734-ec57bf1e34c2", + "body": [ { "guid": "16feb2a1-2c79-ade1-338d-fb24fcb8b8bd", "relationshipGuid": "624f08bb-3c93-4f03-9ce1-ed2ce2c7c8d5" @@ -11,5 +11,7 @@ }, "responses": { "204": {} - } + }, + "title": "Glossary_RemoveTermAssignmentFromEntities", + "operationId": "Glossary_DeleteTermAssignmentFromEntities" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_Update.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_Update.json index ac2868693994..faca8b5cb2a2 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_Update.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_Update.json @@ -1,8 +1,8 @@ { "parameters": { "Endpoint": "{Endpoint}", - "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", - "updatedGlossary": { + "glossaryId": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", + "body": { "guid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8", "qualifiedName": "Glossary", "name": "Glossary", @@ -92,5 +92,7 @@ ] } } - } + }, + "title": "Glossary_Update", + "operationId": "Glossary_Update" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_UpdateCategory.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_UpdateCategory.json index fb8c92c94fd5..7c145590a59b 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_UpdateCategory.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_UpdateCategory.json @@ -1,8 +1,8 @@ { "parameters": { "Endpoint": "{Endpoint}", - "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", - "glossaryCategory": { + "categoryId": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", + "body": { "guid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12", "qualifiedName": "ExampleCategory1@Glossary", "name": "ExampleCategory1", @@ -59,5 +59,7 @@ ] } } - } + }, + "title": "Glossary_UpdateCategory", + "operationId": "Glossary_UpdateCategory" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_UpdateTerm.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_UpdateTerm.json index 065bba39f639..9ed4cb3964b7 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_UpdateTerm.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Glossary_UpdateTerm.json @@ -1,8 +1,8 @@ { "parameters": { "Endpoint": "{Endpoint}", - "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea", - "glossaryTerm": { + "termId": "54688d39-b298-4104-9e80-f2a16f44aaea", + "body": { "guid": "54688d39-b298-4104-9e80-f2a16f44aaea", "qualifiedName": "ExampleTerm1@Glossary", "name": "ExampleTerm1", @@ -88,5 +88,7 @@ ] } } - } + }, + "title": "Glossary_UpdateTerm", + "operationId": "Glossary_UpdateTerm" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Lineage_Get.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Lineage_Get.json index 122a1804289c..a08de217b1c0 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Lineage_Get.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Lineage_Get.json @@ -20,5 +20,7 @@ "parentRelations": [] } } - } + }, + "title": "Lineage_Get", + "operationId": "Lineage_Get" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Lineage_GetByUniqueAttribute.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Lineage_GetByUniqueAttribute.json index 4b9886deec69..ab738e50995b 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Lineage_GetByUniqueAttribute.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Lineage_GetByUniqueAttribute.json @@ -59,5 +59,7 @@ } } } - } + }, + "title": "Lineage_GetByUniqueAttribute", + "operationId": "Lineage_GetByUniqueAttribute" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Lineage_GetNextPage.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Lineage_GetNextPage.json index 66f7aac1fb7a..778a391f5b59 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Lineage_GetNextPage.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Lineage_GetNextPage.json @@ -21,5 +21,7 @@ "parentRelations": [] } } - } + }, + "title": "Lineage_GetNextPage", + "operationId": "Lineage_GetNextPage" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Relationship_Create.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Relationship_Create.json index 8122eee5cd3a..89d3b4e5afec 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Relationship_Create.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Relationship_Create.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "relationship": { + "body": { "typeName": "AtlasGlossarySynonym", "attributes": { "expression": "Example Expression", @@ -54,5 +54,7 @@ "version": 0 } } - } + }, + "title": "Relationship_Create", + "operationId": "Relationship_Create" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Relationship_Delete.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Relationship_Delete.json index 291912c8ccac..c6e4848b9952 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Relationship_Delete.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Relationship_Delete.json @@ -5,5 +5,7 @@ }, "responses": { "204": {} - } + }, + "title": "Relationship_Delete", + "operationId": "Relationship_Delete" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Relationship_Get.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Relationship_Get.json index 7a9054f95285..182684f354bd 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Relationship_Get.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Relationship_Get.json @@ -35,5 +35,7 @@ } } } - } + }, + "title": "Relationship_Get", + "operationId": "Relationship_Get" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Relationship_Update.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Relationship_Update.json index 3664c81a3ec7..0cd955fe3154 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Relationship_Update.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Relationship_Update.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "relationship": { + "body": { "typeName": "AtlasGlossarySynonym", "attributes": { "expression": "Example Expression", @@ -55,5 +55,7 @@ "version": 0 } } - } + }, + "title": "Relationship_Update", + "operationId": "Relationship_Update" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_BulkCreate.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_BulkCreate.json index 3c08502d3e0f..d91723b6e888 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_BulkCreate.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_BulkCreate.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "typesDef": { + "body": { "enumDefs": [], "structDefs": [], "classificationDefs": [], @@ -67,5 +67,7 @@ "relationshipDefs": [] } } - } + }, + "title": "Type_BulkCreate", + "operationId": "Type_BulkCreate" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_BulkCreateBusinessMetadataDefs.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_BulkCreateBusinessMetadataDefs.json index 66e7d50e8570..433ff8867948 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_BulkCreateBusinessMetadataDefs.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_BulkCreateBusinessMetadataDefs.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "typesDef": { + "body": { "enumDefs": [], "structDefs": [], "classificationDefs": [], @@ -71,5 +71,7 @@ ] } } - } + }, + "title": "Type_BulkCreateBusinessMetadataDefs", + "operationId": "Type_BulkCreate" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_BulkDelete.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_BulkDelete.json index 40e463be1ce9..60ba8acc3b75 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_BulkDelete.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_BulkDelete.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "typesDef": { + "body": { "enumDefs": [], "structDefs": [], "classificationDefs": [], @@ -29,5 +29,7 @@ }, "responses": { "204": {} - } + }, + "title": "Type_BulkDelete", + "operationId": "Type_BulkDelete" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_BulkUpdate.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_BulkUpdate.json index fd37acb1ec1c..7905abbea1af 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_BulkUpdate.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_BulkUpdate.json @@ -1,7 +1,7 @@ { "parameters": { "Endpoint": "{Endpoint}", - "typesDef": { + "body": { "enumDefs": [], "structDefs": [], "classificationDefs": [], @@ -284,5 +284,7 @@ ] } } - } + }, + "title": "Type_BulkUpdate", + "operationId": "Type_BulkUpdate" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_Delete.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_Delete.json index d95c0728b9cb..8a364027401e 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_Delete.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_Delete.json @@ -5,5 +5,7 @@ }, "responses": { "204": {} - } + }, + "title": "Type_Delete", + "operationId": "Type_Delete" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetBusinessMetadataDefByGuid.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetBusinessMetadataDefByGuid.json index 5790a0df446e..34921a8239b7 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetBusinessMetadataDefByGuid.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetBusinessMetadataDefByGuid.json @@ -37,5 +37,7 @@ ] } } - } + }, + "title": "Type_GetBusinessMetadataDefByGuid", + "operationId": "Type_GetBusinessMetadataDefByGuid" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetBusinessMetadataDefByName.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetBusinessMetadataDefByName.json index 89abf18c256d..64d92fefd723 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetBusinessMetadataDefByName.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetBusinessMetadataDefByName.json @@ -37,5 +37,7 @@ ] } } - } + }, + "title": "Type_GetBusinessMetadataDefByName", + "operationId": "Type_GetBusinessMetadataDefByName" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetByGuid.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetByGuid.json index ebd1ed4902de..e94b5ad8b518 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetByGuid.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetByGuid.json @@ -37,5 +37,7 @@ ] } } - } + }, + "title": "Type_GetByGuid", + "operationId": "Type_GetByGuid" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetByName.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetByName.json index 77ec05812c26..804029d070e1 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetByName.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetByName.json @@ -37,5 +37,7 @@ ] } } - } + }, + "title": "Type_GetByName", + "operationId": "Type_GetByName" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetClassificationDefByGuid.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetClassificationDefByGuid.json index 31f09a6d61e6..bf27840af6aa 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetClassificationDefByGuid.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetClassificationDefByGuid.json @@ -22,5 +22,7 @@ "subTypes": [] } } - } + }, + "title": "Type_GetClassificationDefByGuid", + "operationId": "Type_GetClassificationDefByGuid" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetClassificationDefByName.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetClassificationDefByName.json index b7d7ed8a4f74..e7a58bf32bfb 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetClassificationDefByName.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetClassificationDefByName.json @@ -22,5 +22,7 @@ "subTypes": [] } } - } + }, + "title": "Type_GetClassificationDefByName", + "operationId": "Type_GetClassificationDefByName" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetEntityDefByGuid.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetEntityDefByGuid.json index 2728fb2507c3..9c0d6ce53cb7 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetEntityDefByGuid.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetEntityDefByGuid.json @@ -52,5 +52,7 @@ ] } } - } + }, + "title": "Type_GetEntityDefByGuid", + "operationId": "Type_GetEntityDefByGuid" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetEntityDefByName.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetEntityDefByName.json index 0542db979369..140ba1a5b309 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetEntityDefByName.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetEntityDefByName.json @@ -52,5 +52,7 @@ ] } } - } + }, + "title": "Type_GetEntityDefByName", + "operationId": "Type_GetEntityDefByName" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetEnumDefByGuid.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetEnumDefByGuid.json index 9c324ce8d35b..ab9e4048b0d2 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetEnumDefByGuid.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetEnumDefByGuid.json @@ -32,5 +32,7 @@ ] } } - } + }, + "title": "Type_GetEnumDefByGuid", + "operationId": "Type_GetEnumDefByGuid" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetEnumDefByName.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetEnumDefByName.json index 6adfee266b61..62907f8f6a69 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetEnumDefByName.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetEnumDefByName.json @@ -32,5 +32,7 @@ ] } } - } + }, + "title": "Type_GetEnumDefByName", + "operationId": "Type_GetEnumDefByName" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetRelationshipDefByGuid.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetRelationshipDefByGuid.json index 66b6efd3f8bf..71c9a03a65d9 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetRelationshipDefByGuid.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetRelationshipDefByGuid.json @@ -35,5 +35,7 @@ "relationshipLabel": "r:storm_topology_nodes" } } - } + }, + "title": "Type_GetRelationshipDefByGuid", + "operationId": "Type_GetRelationshipDefByGuid" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetRelationshipDefByName.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetRelationshipDefByName.json index 148c7d655371..ecdafc07a934 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetRelationshipDefByName.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetRelationshipDefByName.json @@ -35,5 +35,7 @@ "relationshipLabel": "r:storm_topology_nodes" } } - } + }, + "title": "Type_GetRelationshipDefByName", + "operationId": "Type_GetRelationshipDefByName" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetStructDefByGuid.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetStructDefByGuid.json index d2e1e0901f30..c31ae06aeeb6 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetStructDefByGuid.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetStructDefByGuid.json @@ -42,5 +42,7 @@ ] } } - } + }, + "title": "Type_GetStructDefByGuid", + "operationId": "Type_GetStructDefByGuid" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetStructDefByName.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetStructDefByName.json index 6bffd4888fa2..26f8e843a6d6 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetStructDefByName.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetStructDefByName.json @@ -42,5 +42,7 @@ ] } } - } + }, + "title": "Type_GetStructDefByName", + "operationId": "Type_GetStructDefByName" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetTermTemplateDefByGuid.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetTermTemplateDefByGuid.json index fc5c6208e066..e6c263c691e5 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetTermTemplateDefByGuid.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetTermTemplateDefByGuid.json @@ -79,5 +79,7 @@ ] } } - } + }, + "title": "Type_GetTermTemplateDefByGuid", + "operationId": "Type_GetTermTemplateDefByGuid" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetTermTemplateDefByName.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetTermTemplateDefByName.json index 72f8d97172d8..d8b28d19db05 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetTermTemplateDefByName.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_GetTermTemplateDefByName.json @@ -79,5 +79,7 @@ ] } } - } + }, + "title": "Type_GetTermTemplateDefByName", + "operationId": "Type_GetTermTemplateDefByName" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_List.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_List.json index 4e6b37b8b6f1..1dd18ffe0898 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_List.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_List.json @@ -1,7 +1,8 @@ { "parameters": { "Endpoint": "{Endpoint}", - "includeTermTemplate": true + "includeTermTemplate": true, + "api-version": "2023-09-01" }, "responses": { "200": { @@ -265,5 +266,7 @@ ] } } - } + }, + "title": "Type_List", + "operationId": "Type_List" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_ListEnumDefs.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_ListEnumDefs.json index 0c3b2d78f851..99b6f55910b0 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_ListEnumDefs.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_ListEnumDefs.json @@ -1,7 +1,8 @@ { "parameters": { "Endpoint": "{Endpoint}", - "type": "enum" + "type": "ENUM", + "api-version": "2023-09-01" }, "responses": { "200": { @@ -86,5 +87,7 @@ "relationshipDefs": [] } } - } + }, + "title": "Type_ListEnumDefs", + "operationId": "Type_List" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_ListHeaders.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_ListHeaders.json index 99ec7d9d00b2..288c815d8a88 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_ListHeaders.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_ListHeaders.json @@ -23,5 +23,7 @@ } ] } - } + }, + "title": "Type_ListHeaders", + "operationId": "Type_ListHeaders" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_ListTermTemplateDefs.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_ListTermTemplateDefs.json index 26902f2461c6..c5336e63031c 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_ListTermTemplateDefs.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/examples/Type_ListTermTemplateDefs.json @@ -1,7 +1,8 @@ { "parameters": { "Endpoint": "{Endpoint}", - "type": "term_template" + "type": "TERM_TEMPLATE", + "api-version": "2023-09-01" }, "responses": { "200": { @@ -87,5 +88,7 @@ ] } } - } + }, + "title": "Type_ListTermTemplateDefs", + "operationId": "Type_List" } diff --git a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/purviewdatamap.json b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/purviewdatamap.json index 9a893b74e1d1..800ef24b4921 100644 --- a/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/purviewdatamap.json +++ b/specification/purview/data-plane/Azure.Analytics.Purview.DataMap/stable/2023-09-01/purviewdatamap.json @@ -1,115 +1,147 @@ { "swagger": "2.0", "info": { - "title": "Purview Data Map Service REST API Document", - "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.", - "version": "2023-09-01" + "title": "Azure Analytics Purview Data Map", + "version": "2023-09-01", + "description": "Purview Data Map Service is a fully managed cloud service whose users can\ndiscover the data sources they need and understand the data sources they find.\nAt the same time, Data Map helps organizations get more value from their\nexisting 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}", + "hostTemplate": "{endpoint}/datamap/api", "useSchemePrefix": false, "parameters": [ { - "$ref": "#/parameters/endpoint" + "name": "endpoint", + "in": "path", + "required": true, + "type": "string" } ] }, - "basePath": "/datamap/api", - "schemes": [ - "https" + "produces": [ + "application/json" ], "consumes": [ "application/json" ], - "produces": [ - "application/json" + "security": [ + { + "OAuth2Auth": [ + "https://purview.azure.net/.default" + ] + } ], "securityDefinitions": { - "azure_auth": { + "OAuth2Auth": { + "type": "oauth2", "flow": "implicit", "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize", "scopes": { - "user_impersonation": "impersonate your user account" - }, - "type": "oauth2", - "description": "Azure Active Directory OAuth2 Flow." + "https://purview.azure.net/.default": "" + } } }, - "security": [ - { - "azure_auth": [ - "user_impersonation" - ] - } - ], + "tags": [], "paths": { "/atlas/v2/entity": { "post": { - "tags": [ - "Entity" - ], - "description": "Create or update an entity.\nExisting entity is matched using its unique guid if supplied or by its unique attributes eg: qualifiedName.\nMap and array of collections are not well supported. E.g., array>, array>.\nFor each contact type, the maximum number of contacts is 20.", "operationId": "Entity_CreateOrUpdate", - "x-ms-examples": { - "Entity_Create": { - "$ref": "./examples/Entity_Create.json" + "description": "Create or update an entity.\nExisting entity is matched using its unique guid if\nsupplied or by its unique attributes eg: qualifiedName.\nMap and array of\ncollections are not well supported. E.g., array>, array>.\nFor each contact type, the maximum number of contacts is 20.", + "parameters": [ + { + "$ref": "#/parameters/AtlasApiVersionParameter" }, - "Entity_Update": { - "$ref": "./examples/Entity_Update.json" + { + "name": "businessAttributeUpdateBehavior", + "in": "query", + "description": "Used to define the update behavior for business attributes when updating\nentities.", + "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\nneed to move an entity to another collection.", + "required": false, + "type": "string" }, - "Entity_AddCustomAttribute": { - "$ref": "./examples/Entity_AddCustomAttribute.json" - } - }, - "parameters": [ { + "name": "body", "in": "body", - "name": "entity", - "description": "Atlas entity with extended information.", "required": true, "schema": { "$ref": "#/definitions/AtlasEntityWithExtInfo" } - }, - { - "$ref": "#/parameters/businessAttributeUpdateBehavior" - }, - { - "$ref": "#/parameters/collectionId" - }, - { - "$ref": "#/parameters/atlasAPIVersion" } ], "responses": { "200": { - "description": "Created with EntityMutationResponse.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/EntityMutationResponse" + "$ref": "#/definitions/EntityMutationResult" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$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" + } } } }, "/atlas/v2/entity/bulk": { "get": { - "tags": [ - "Entity" - ], - "description": "List entities in bulk identified by its GUIDs.", "operationId": "Entity_ListByGuids", - "x-ms-examples": { - "Entity_ListByGuids": { - "$ref": "./examples/Entity_ListByGuids.json" - } - }, + "description": "List entities in bulk identified by its GUIDs.", "parameters": [ + { + "$ref": "#/parameters/AtlasApiVersionParameter" + }, { "name": "guid", "in": "query", @@ -119,91 +151,122 @@ "items": { "type": "string" }, - "collectionFormat": "multi", - "x-ms-client-name": "guids" - }, - { - "$ref": "#/parameters/minExtInfo" + "collectionFormat": "multi" }, { - "$ref": "#/parameters/ignoreRelationships" + "name": "minExtInfo", + "in": "query", + "description": "Whether to return minimal information for referred entities.", + "required": false, + "type": "boolean" }, { - "$ref": "#/parameters/atlasAPIVersion" + "name": "ignoreRelationships", + "in": "query", + "description": "Whether to ignore relationship attributes.", + "required": false, + "type": "boolean" } ], "responses": { "200": { - "description": "OK.", + "description": "The request has succeeded.", "schema": { "$ref": "#/definitions/AtlasEntitiesWithExtInfo" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Entity_ListByGuids": { + "$ref": "./examples/Entity_ListByGuids.json" + } } }, "post": { - "tags": [ - "Entity" - ], - "description": "Create or update entities in bulk.\nExisting entity is matched using its unique guid if supplied or by its unique attributes eg: qualifiedName.\nMap and array of collections are not well supported. E.g., array>, array>.\nFor each contact type, the maximum number of contacts is 20.", "operationId": "Entity_BulkCreateOrUpdate", - "x-ms-examples": { - "Entity_BulkCreateOrUpdate": { - "$ref": "./examples/Entity_BulkCreateOrUpdate.json" - } - }, + "description": "Create or update entities in bulk.\nExisting entity is matched using its unique\nguid if supplied or by its unique attributes eg: qualifiedName.\nMap and array\nof collections are not well supported. E.g., array>,\narray>.\nFor each contact type, the maximum number of contacts\nis 20.", "parameters": [ { - "in": "body", - "name": "entities", - "description": "An array of entities to create or update.", - "required": true, - "schema": { - "$ref": "#/definitions/AtlasEntitiesWithExtInfo" - } + "$ref": "#/parameters/AtlasApiVersionParameter" }, { - "$ref": "#/parameters/collectionId" + "name": "collectionId", + "in": "query", + "description": "The collection where entities will be moved to. Only specify a value if you\nneed to move an entity to another collection.", + "required": false, + "type": "string" }, { - "$ref": "#/parameters/atlasAPIVersion" + "name": "businessAttributeUpdateBehavior", + "in": "query", + "description": "Used to define the update behavior for business attributes when updating\nentities.", + "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." + } + ] + } }, { - "$ref": "#/parameters/businessAttributeUpdateBehavior" + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/AtlasEntitiesWithExtInfo" + } } ], "responses": { "200": { - "description": "Ok.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/EntityMutationResponse" + "$ref": "#/definitions/EntityMutationResult" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Entity_BulkCreateOrUpdate": { + "$ref": "./examples/Entity_BulkCreateOrUpdate.json" + } } }, "delete": { - "tags": [ - "Entity" - ], - "description": "Delete a list of entities in bulk identified by their GUIDs or unique attributes.", "operationId": "Entity_BulkDelete", - "x-ms-examples": { - "Entity_BulkDelete": { - "$ref": "./examples/Entity_BulkDelete.json" - } - }, + "description": "Delete a list of entities in bulk identified by their GUIDs or unique\nattributes.", "parameters": [ { "name": "guid", @@ -214,1406 +277,1401 @@ "items": { "type": "string" }, - "collectionFormat": "multi", - "x-ms-client-name": "guids" + "collectionFormat": "multi" } ], "responses": { "200": { - "description": "Deleted with EntityMutationResponse.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/EntityMutationResponse" + "$ref": "#/definitions/EntityMutationResult" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Entity_BulkDelete": { + "$ref": "./examples/Entity_BulkDelete.json" + } } } }, "/atlas/v2/entity/bulk/classification": { "post": { - "tags": [ - "Entity" - ], - "description": "Associate a classification to multiple entities in bulk.", "operationId": "Entity_AddClassification", - "x-ms-examples": { - "Entity_AddClassificationToEntityByGuids": { - "$ref": "./examples/Entity_AddClassificationToEntityByGuids.json" - } - }, + "description": "Associate a classification to multiple entities in bulk.", "parameters": [ { + "name": "body", "in": "body", - "name": "request", - "description": "The request to associate a classification to multiple entities.", "required": true, "schema": { - "$ref": "#/definitions/ClassificationAssociateRequest" + "$ref": "#/definitions/ClassificationAssociateOptions" } } ], "responses": { "204": { - "description": "No Content." + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Entity_AddClassificationToEntityByGuids": { + "$ref": "./examples/Entity_AddClassificationToEntityByGuids.json" + } } } }, - "/atlas/v2/entity/guid/{guid}": { - "get": { - "tags": [ - "Entity" - ], - "operationId": "Entity_Get", - "x-ms-examples": { - "Entity_Get": { - "$ref": "./examples/Entity_Get.json" - } - }, - "description": "Get complete definition of an entity given its GUID.", + "/atlas/v2/entity/bulk/setClassifications": { + "post": { + "operationId": "Entity_BulkSetClassifications", + "description": "Set classifications on entities in bulk.", "parameters": [ { - "$ref": "#/parameters/guid" - }, - { - "$ref": "#/parameters/minExtInfo" - }, - { - "$ref": "#/parameters/ignoreRelationships" + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/AtlasEntityHeaders" + } } ], "responses": { "200": { - "description": "OK.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasEntityWithExtInfo" + "type": "array", + "items": { + "type": "string" + } } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "put": { - "tags": [ - "Entity" - ], - "description": "Update entity partially - create or update entity attribute identified by its GUID.\nSupports only primitive attribute type and entity references.\nIt does not support updating complex types like arrays, and maps.\nNull updates are not possible.", - "operationId": "Entity_PartialUpdateAttributeByGuid", + }, "x-ms-examples": { - "Entity_PartialUpdateEntityAttributeByGuid": { - "$ref": "./examples/Entity_PartialUpdateAttributeByGuid.json" + "Entity_BulkSetClassifications": { + "$ref": "./examples/Entity_BulkSetClassifications.json" } - }, + } + } + }, + "/atlas/v2/entity/bulk/uniqueAttribute/type/{typeName}": { + "get": { + "operationId": "Entity_ListByUniqueAttributes", + "description": "Bulk API to retrieve list of entities identified by its unique attributes.\nIn\naddition to the typeName path parameter, attribute key-value pair(s) can be\nprovided in the following\nformat\n\ntypeName=\\&attr_1:\\=\\&attr_2:\\=\\&attr_3:\\=\\\n\nNOTE:\nThe attrName should be an unique attribute for the given entity-type.\nThe REST\nrequest would look something like this\n\nGET\n/v2/entity/bulk/uniqueAttribute/type/hive_db?attr_1:qualifiedName=db1@cl1&attr_2:qualifiedName=db2@cl1\n\nNote:\nat least one unique attribute must be provided.", "parameters": [ { - "$ref": "#/parameters/guid" + "name": "typeName", + "in": "path", + "description": "The name of the type.", + "required": true, + "type": "string" }, { - "name": "name", + "name": "minExtInfo", "in": "query", - "description": "The name of the attribute.", - "required": true, - "type": "string" + "description": "Whether to return minimal information for referred entities.", + "required": false, + "type": "boolean" }, { - "in": "body", - "name": "body", - "description": "The value of the attribute.", - "required": true, - "schema": { - "type": "object" - } + "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\nattrs_1:qualifiedName=db1@cl1&attrs_2:qualifiedName=db2@cl1. (This is only an\nexample. qualifiedName can be changed to other unique attributes)", + "required": false, + "type": "string" } ], "responses": { "200": { - "description": "Updated with EntityMutationResponse.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/EntityMutationResponse" + "$ref": "#/definitions/AtlasEntitiesWithExtInfo" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "delete": { - "tags": [ - "Entity" - ], - "description": "Delete an entity identified by its GUID.", - "operationId": "Entity_Delete", + }, "x-ms-examples": { - "Entity_Delete": { - "$ref": "./examples/Entity_Delete.json" + "Entity_ListByUniqueAttributes": { + "$ref": "./examples/Entity_ListByUniqueAttributes.json" } - }, + } + } + }, + "/atlas/v2/entity/businessmetadata/import": { + "post": { + "operationId": "Entity_ImportBusinessMetadata", + "description": "Upload the file for creating Business Metadata in BULK", + "consumes": [ + "multipart/form-data" + ], "parameters": [ { - "$ref": "#/parameters/guid" + "name": "file", + "in": "formData", + "description": "InputStream of file", + "required": true, + "type": "file" } ], "responses": { "200": { - "description": "Deleted with EntityMutationResponse.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/EntityMutationResponse" + "$ref": "#/definitions/BulkImportResult" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Entity_ImportBusinessMetadata": { + "$ref": "./examples/Entity_ImportBusinessMetadata.json" + } } } }, - "/atlas/v2/entity/guid/{guid}/classification/{classificationName}": { + "/atlas/v2/entity/businessmetadata/import/template": { "get": { - "tags": [ - "Entity" - ], - "description": "Get classification for a given entity represented by a GUID.", - "operationId": "Entity_GetClassification", - "x-ms-examples": { - "Entity_GetClassification": { - "$ref": "./examples/Entity_GetClassification.json" - } - }, - "parameters": [ - { - "$ref": "#/parameters/guid" - }, - { - "$ref": "#/parameters/classificationName" - } + "operationId": "Entity_GetSampleBusinessMetadataTemplate", + "description": "Get the sample Template for uploading/creating bulk BusinessMetaData", + "produces": [ + "application/octet-stream", + "application/json" ], + "parameters": [], "responses": { "200": { - "description": "The classification for the given entity GUID.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasClassification" + "type": "file" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "delete": { - "tags": [ - "Entity" - ], - "description": "Delete a given classification from an existing entity represented by a GUID.", - "operationId": "Entity_RemoveClassification", + }, "x-ms-examples": { - "Entity_RemoveClassification": { - "$ref": "./examples/Entity_RemoveClassification.json" + "Entity_GetSampleBusinessMetadataTemplate": { + "$ref": "./examples/Entity_GetSampleBusinessMetadataTemplate.json" } - }, + } + } + }, + "/atlas/v2/entity/guid/{guid}": { + "get": { + "operationId": "Entity_Get", + "description": "Get complete definition of an entity given its GUID.", "parameters": [ { - "$ref": "#/parameters/guid" + "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" }, { - "$ref": "#/parameters/classificationName" + "name": "ignoreRelationships", + "in": "query", + "description": "Whether to ignore relationship attributes.", + "required": false, + "type": "boolean" } ], "responses": { - "204": { - "description": "No Content." + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AtlasEntityWithExtInfo" + } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - } - }, - "/atlas/v2/entity/guid/{guid}/classifications": { - "get": { - "tags": [ - "Entity" - ], - "description": "List classifications for a given entity represented by a GUID.", - "operationId": "Entity_GetClassifications", + }, "x-ms-examples": { - "Entity_GetClassifications": { - "$ref": "./examples/Entity_GetClassifications.json" + "Entity_Get": { + "$ref": "./examples/Entity_Get.json" } - }, + } + }, + "put": { + "operationId": "Entity_PartialUpdateAttributeByGuid", + "description": "Update entity partially - create or update entity attribute identified by its\nGUID.\nSupports only primitive attribute type and entity references.\nIt does not support updating complex types like arrays, and maps.\nNull updates are not possible.", "parameters": [ { - "$ref": "#/parameters/guid" + "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": "An array of classifications for the given entity GUID.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasClassifications" + "$ref": "#/definitions/EntityMutationResult" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Entity_PartialUpdateAttributeByGuid": { + "$ref": "./examples/Entity_PartialUpdateAttributeByGuid.json" + } } }, - "post": { - "tags": [ - "Entity" + "delete": { + "operationId": "Entity_Delete", + "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" + } ], - "description": "Add classifications to an existing entity represented by a GUID.", - "operationId": "Entity_AddClassifications", - "x-ms-examples": { - "Entity_AddClassifications": { - "$ref": "./examples/Entity_AddClassifications.json" + "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" + } + } + } + }, + "/atlas/v2/entity/guid/{guid}/businessmetadata": { + "post": { + "operationId": "Entity_AddOrUpdateBusinessMetadata", + "description": "Add business metadata to an entity.", "parameters": [ { - "$ref": "#/parameters/guid" + "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,\ndefault is false.", + "required": false, + "type": "boolean", + "x-ms-client-name": "overwrite" }, { + "name": "body", "in": "body", - "name": "classifications", - "description": "An array of classifications to be added.", + "description": "BusinessMetadata payload", "required": true, "schema": { - "type": "array", - "description": "An array of classifications.", - "items": { - "$ref": "#/definitions/AtlasClassification" + "type": "object", + "additionalProperties": { + "additionalProperties": {}, + "type": "object" } } } ], "responses": { "204": { - "description": "No Content." + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "put": { - "tags": [ - "Entity" - ], - "description": "Update classifications to an existing entity represented by a guid.", - "operationId": "Entity_UpdateClassifications", + }, "x-ms-examples": { - "Entity_UpdateClassifications": { - "$ref": "./examples/Entity_UpdateClassifications.json" + "Entity_AddOrUpdate_BusinessMetadata": { + "$ref": "./examples/Entity_AddOrUpdate_BusinessMetadata.json" } - }, + } + }, + "delete": { + "operationId": "Entity_RemoveBusinessMetadata", + "description": "Remove business metadata from an entity.", "parameters": [ { - "$ref": "#/parameters/guid" + "name": "guid", + "in": "path", + "description": "The globally unique identifier of the entity.", + "required": true, + "type": "string" }, { + "name": "body", "in": "body", - "name": "classifications", - "description": "An array of classifications to be updated.", + "description": "Business metadata payload", "required": true, "schema": { - "type": "array", - "description": "An array of classifications.", - "items": { - "$ref": "#/definitions/AtlasClassification" + "type": "object", + "additionalProperties": { + "additionalProperties": {}, + "type": "object" } } } ], "responses": { "204": { - "description": "No Content." + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Entity_RemoveBusinessMetadata": { + "$ref": "./examples/Entity_RemoveBusinessMetadata.json" + } } } }, - "/atlas/v2/entity/uniqueAttribute/type/{typeName}": { - "get": { - "tags": [ - "Entity" - ], - "description": "Get complete definition of an entity given its type and unique attribute.\n\nIn addition to the typeName path parameter, attribute key-value pair(s) can be provided in the following format:\nattr:\\=.\n\nNOTE: The attrName and attrValue should be unique across entities, eg. qualifiedName.\n\nThe REST request would look something like this:\nGET /v2/entity/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue.", - "operationId": "Entity_GetByUniqueAttributes", - "x-ms-examples": { - "Entity_GetByUniqueAttributes": { - "$ref": "./examples/Entity_GetByUniqueAttributes.json" - } - }, + "/atlas/v2/entity/guid/{guid}/businessmetadata/{businessMetadataName}": { + "post": { + "operationId": "Entity_AddOrUpdateBusinessMetadataAttributes", + "description": "Add or update business metadata attributes.", "parameters": [ { - "$ref": "#/parameters/typeName" - }, - { - "$ref": "#/parameters/minExtInfo" + "name": "businessMetadataName", + "in": "path", + "description": "BusinessMetadata name", + "required": true, + "type": "string" }, { - "$ref": "#/parameters/ignoreRelationships" + "name": "guid", + "in": "path", + "description": "The globally unique identifier of the entity.", + "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" + "name": "body", + "in": "body", + "description": "Business metadata attribute payload", + "required": true, + "schema": { + "type": "object", + "additionalProperties": {} + } } ], "responses": { - "200": { - "description": "AtlasEntityWithExtInfo.", - "schema": { - "$ref": "#/definitions/AtlasEntityWithExtInfo" - } + "204": { + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "put": { - "tags": [ - "Entity" - ], - "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.\n\nIn addition to the typeName path parameter, attribute key-value pair(s) can be provided in the following format:\n\nattr:=.\nNOTE: The attrName and attrValue should be unique across entities, eg. qualifiedName.\n\nThe REST request would look something like this:\nPUT /v2/entity/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue.", - "operationId": "Entity_PartialUpdateByUniqueAttributes", + }, "x-ms-examples": { - "Entity_PartialUpdateEntityByUniqueAttributes": { - "$ref": "./examples/Entity_PartialUpdateByUniqueAttributes.json" + "Entity_AddOrUpdate_BusinessAttribute": { + "$ref": "./examples/Entity_AddOrUpdate_BusinessAttribute.json" } - }, + } + }, + "delete": { + "operationId": "Entity_RemoveBusinessMetadataAttributes", + "description": "Delete business metadata attributes from an entity.", "parameters": [ { - "$ref": "#/parameters/typeName" + "name": "businessMetadataName", + "in": "path", + "description": "BusinessMetadata name", + "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, + "name": "guid", + "in": "path", + "description": "The globally unique identifier of the entity.", + "required": true, "type": "string" }, { + "name": "body", "in": "body", - "name": "atlasEntityWithExtInfo", - "description": "Atlas entity with extended information.", + "description": "Business metadata attribute payload", "required": true, "schema": { - "$ref": "#/definitions/AtlasEntityWithExtInfo" + "type": "object", + "additionalProperties": {} } } ], "responses": { - "200": { - "description": "Updated with EntityMutationResponse.", - "schema": { - "$ref": "#/definitions/EntityMutationResponse" - } + "204": { + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "delete": { - "tags": [ - "Entity" - ], - "description": "Delete an entity identified by its type and unique attributes.\nIn addition to the typeName path parameter, attribute key-value pair(s) can be provided in the following format:\nattr:\\=\\.\nNOTE: The attrName and attrValue should be unique across entities, eg. qualifiedName.\n\nThe REST request would look something like this:\nDELETE /v2/entity/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue.", - "operationId": "Entity_DeleteByUniqueAttribute", + }, "x-ms-examples": { - "Entity_DeleteByUniqueAttribute": { - "$ref": "./examples/Entity_DeleteByUniqueAttribute.json" + "Entity_RemoveBusinessAttribute": { + "$ref": "./examples/Entity_RemoveBusinessAttribute.json" } - }, + } + } + }, + "/atlas/v2/entity/guid/{guid}/classification/{classificationName}": { + "get": { + "operationId": "Entity_GetClassification", + "description": "Get classification for a given entity represented by a GUID.", "parameters": [ { - "$ref": "#/parameters/typeName" + "name": "guid", + "in": "path", + "description": "The globally unique identifier of the entity.", + "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, + "name": "classificationName", + "in": "path", + "description": "The name of the classification.", + "required": true, "type": "string" } ], "responses": { "200": { - "description": "Deleted with EntityMutationResponse.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/EntityMutationResponse" + "$ref": "#/definitions/AtlasClassification" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - } - }, - "/atlas/v2/entity/uniqueAttribute/type/{typeName}/classification/{classificationName}": { - "delete": { - "tags": [ - "Entity" - ], - "description": "Delete a given classification from an entity identified by its type and unique attributes.", - "operationId": "Entity_RemoveClassificationByUniqueAttribute", + }, "x-ms-examples": { - "Entity_RemoveClassificationByUniqueAttribute": { - "$ref": "./examples/Entity_RemoveClassificationByUniqueAttribute.json" + "Entity_GetClassification": { + "$ref": "./examples/Entity_GetClassification.json" } - }, + } + }, + "delete": { + "operationId": "Entity_RemoveClassification", + "description": "Delete a given classification from an existing entity represented by a GUID.", "parameters": [ { - "$ref": "#/parameters/typeName" - }, - { - "$ref": "#/parameters/classificationName" + "name": "guid", + "in": "path", + "description": "The globally unique identifier of the entity.", + "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, + "name": "classificationName", + "in": "path", + "description": "The name of the classification.", + "required": true, "type": "string" } ], "responses": { "204": { - "description": "No Content." + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Entity_RemoveClassification": { + "$ref": "./examples/Entity_RemoveClassification.json" + } } } }, - "/atlas/v2/entity/uniqueAttribute/type/{typeName}/classifications": { - "post": { - "tags": [ - "Entity" - ], - "description": "Add classification to the entity identified by its type and unique attributes.", - "operationId": "Entity_AddClassificationsByUniqueAttribute", - "x-ms-examples": { - "Entity_AddClassificationsByUniqueAttribute": { - "$ref": "./examples/Entity_AddClassificationsByUniqueAttribute.json" - } - }, + "/atlas/v2/entity/guid/{guid}/classifications": { + "get": { + "operationId": "Entity_GetClassifications", + "description": "List classifications for a given entity represented by a GUID.", "parameters": [ { - "$ref": "#/parameters/typeName" - }, - { - "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" - }, - { - "in": "body", - "name": "atlasClassificationArray", - "description": "An array of classification to be added.", + "name": "guid", + "in": "path", + "description": "The globally unique identifier of the entity.", "required": true, - "schema": { - "type": "array", - "description": "An array of classification.", - "items": { - "$ref": "#/definitions/AtlasClassification" - } - } + "type": "string" } ], "responses": { - "204": { - "description": "No Content." + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AtlasClassifications" + } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Entity_GetClassifications": { + "$ref": "./examples/Entity_GetClassifications.json" + } } }, "put": { - "tags": [ - "Entity" - ], - "description": "Update classification on an entity identified by its type and unique attributes.", - "operationId": "Entity_UpdateClassificationsByUniqueAttribute", - "x-ms-examples": { - "Entity_UpdateClassificationsByUniqueAttribute": { - "$ref": "./examples/Entity_UpdateClassificationsByUniqueAttribute.json" - } - }, + "operationId": "Entity_UpdateClassifications", + "description": "Update classifications to an existing entity represented by a guid.", "parameters": [ { - "$ref": "#/parameters/typeName" - }, - { - "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, + "name": "guid", + "in": "path", + "description": "The globally unique identifier of the entity.", + "required": true, "type": "string" }, { + "name": "body", "in": "body", - "name": "atlasClassificationArray", - "description": "An array of classification to be updated.", + "description": "An array of classifications to be updated.", "required": true, "schema": { "type": "array", - "description": "An array of classification.", "items": { "$ref": "#/definitions/AtlasClassification" - } + }, + "x-ms-identifiers": [] } } ], "responses": { "204": { - "description": "No Content." + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - } - }, - "/atlas/v2/entity/bulk/setClassifications": { - "post": { - "tags": [ - "Entity" - ], - "description": "Set classifications on entities in bulk.", - "operationId": "Entity_BulkSetClassifications", + }, "x-ms-examples": { - "Entity_BulkSetClassifications": { - "$ref": "./examples/Entity_BulkSetClassifications.json" + "Entity_UpdateClassifications": { + "$ref": "./examples/Entity_UpdateClassifications.json" } - }, + } + }, + "post": { + "operationId": "Entity_AddClassifications", + "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", - "name": "entityHeaders", - "description": "Atlas entity headers.", + "description": "An array of classifications to be added.", "required": true, "schema": { - "$ref": "#/definitions/AtlasEntityHeaders" + "type": "array", + "items": { + "$ref": "#/definitions/AtlasClassification" + }, + "x-ms-identifiers": [] } } ], "responses": { - "200": { - "description": "OK", - "schema": { - "type": "array", - "description": "Response that indicates each classification mutation result.", - "items": { - "type": "string" - } - } + "204": { + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Entity_AddClassifications": { + "$ref": "./examples/Entity_AddClassifications.json" + } } } }, - "/atlas/v2/entity/bulk/uniqueAttribute/type/{typeName}": { + "/atlas/v2/entity/guid/{guid}/header": { "get": { - "tags": [ - "Entity" - ], - "description": "Bulk API to retrieve list of entities identified by its unique attributes.\nIn addition to the typeName path parameter, attribute key-value pair(s) can be provided in the following format\n\ntypeName=\\&attr_1:\\=\\&attr_2:\\=\\&attr_3:\\=\\\n\nNOTE: The attrName should be an unique attribute for the given entity-type.\nThe REST request would look something like this\n\nGET /v2/entity/bulk/uniqueAttribute/type/hive_db?attr_1:qualifiedName=db1@cl1&attr_2:qualifiedName=db2@cl1\n\nNote: at least one unique attribute must be provided.", - "operationId": "Entity_ListByUniqueAttributes", - "x-ms-examples": { - "Entity_ListByUniqueAttributes": { - "$ref": "./examples/Entity_ListByUniqueAttributes.json" - } - }, + "operationId": "Entity_GetHeader", + "description": "Get entity header given its GUID.", "parameters": [ { - "$ref": "#/parameters/typeName" - }, - { - "$ref": "#/parameters/minExtInfo" - }, - { - "$ref": "#/parameters/ignoreRelationships" - }, - { - "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, + "name": "guid", + "in": "path", + "description": "The globally unique identifier of the entity.", + "required": true, "type": "string" } ], "responses": { "200": { - "description": "OK.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasEntitiesWithExtInfo" + "$ref": "#/definitions/AtlasEntityHeader" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - } - }, - "/atlas/v2/entity/guid/{guid}/header": { - "get": { - "tags": [ - "Entity" - ], - "description": "Get entity header given its GUID.", - "operationId": "Entity_GetHeader", + }, "x-ms-examples": { "Entity_GetHeader": { "$ref": "./examples/Entity_GetHeader.json" } - }, - "parameters": [ - { - "$ref": "#/parameters/guid" - } - ], - "responses": { - "200": { - "schema": { - "$ref": "#/definitions/AtlasEntityHeader" - }, - "description": "AtlasEntityHeader" - }, - "default": { - "description": "Error response describing why the operation failed.", - "schema": { - "$ref": "#/definitions/ErrorResponse" - } - } } } }, - "/atlas/v2/entity/guid/{guid}/businessmetadata": { - "delete": { - "tags": [ - "Entity" - ], - "description": "Remove business metadata from an entity.", - "operationId": "Entity_RemoveBusinessMetadata", - "consumes": [ - "application/json" - ], - "x-ms-examples": { - "Entity_RemoveBusinessMetadata": { - "$ref": "./examples/Entity_RemoveBusinessMetadata.json" - } - }, + "/atlas/v2/entity/guid/{guid}/labels": { + "put": { + "operationId": "Entity_AddLabel", + "description": "Add given labels to a given entity.", "parameters": [ { - "$ref": "#/parameters/guid" + "name": "guid", + "in": "path", + "description": "The globally unique identifier of the entity.", + "required": true, + "type": "string" }, { - "name": "businessMetadata", - "required": false, + "name": "body", "in": "body", + "description": "set of labels to be added", + "required": false, "schema": { - "$ref": "#/definitions/BusinessMetadata" + "type": "array", + "items": { + "type": "string" + } } } ], "responses": { "204": { - "description": "Success" + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Entity_AddLabel": { + "$ref": "./examples/Entity_AddLabel.json" + } } }, "post": { - "tags": [ - "Entity" - ], - "description": "Add business metadata to an entity.", - "operationId": "Entity_AddOrUpdateBusinessMetadata", - "consumes": [ - "application/json" - ], - "x-ms-examples": { - "Entity_AddOrUpdateBusinessMetadata": { - "$ref": "./examples/Entity_AddOrUpdate_BusinessAttribute.json" - } - }, + "operationId": "Entity_SetLabels", + "description": "Set labels to a given entity.", "parameters": [ { - "$ref": "#/parameters/guid" - }, - { - "in": "query", - "type": "boolean", - "name": "isOverwrite", - "description": "Whether to overwrite the existing business metadata on the entity or not, default is false.", - "required": false + "name": "guid", + "in": "path", + "description": "The globally unique identifier of the entity.", + "required": true, + "type": "string" }, { - "name": "businessMetadata", - "required": false, + "name": "body", "in": "body", + "description": "set of labels to be set to the entity", + "required": false, "schema": { - "$ref": "#/definitions/BusinessMetadata" + "type": "array", + "items": { + "type": "string" + } } } ], "responses": { "204": { - "description": "Success" + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Entity_SetLabels": { + "$ref": "./examples/Entity_SetLabels.json" + } } - } - }, - "/atlas/v2/entity/guid/{guid}/businessmetadata/{bmName}": { + }, "delete": { - "tags": [ - "Entity" - ], - "description": "Delete business metadata attributes from an entity.", - "operationId": "Entity_RemoveBusinessMetadataAttributes", - "consumes": [ - "application/json" - ], - "x-ms-examples": { - "Entity_RemoveBusinessAttribute": { - "$ref": "./examples/Entity_RemoveBusinessAttribute.json" - } - }, + "operationId": "Entity_RemoveLabels", + "description": "Delete given labels to a given entity.", "parameters": [ { - "name": "bmName", + "name": "guid", "in": "path", - "type": "string", - "description": "BusinessMetadata name", - "required": true - }, - { - "$ref": "#/parameters/guid" + "description": "The globally unique identifier of the entity.", + "required": true, + "type": "string" }, { - "name": "businessMetadataAttributes", - "required": false, + "name": "body", "in": "body", + "description": "set of labels to be deleted", + "required": false, "schema": { - "$ref": "#/definitions/BusinessMetadataAttributes" + "type": "array", + "items": { + "type": "string" + } } } ], "responses": { "204": { - "description": "Success" + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "post": { - "tags": [ - "Entity" - ], - "description": "Add or update business metadata attributes.", - "operationId": "Entity_AddOrUpdateBusinessMetadataAttributes", - "consumes": [ - "application/json" - ], + }, "x-ms-examples": { - "Entity_AddOrUpdateBusinessAttribute": { - "$ref": "./examples/Entity_AddOrUpdate_BusinessAttribute.json" + "Entity_RemoveLabels": { + "$ref": "./examples/Entity_RemoveLabels.json" } - }, + } + } + }, + "/atlas/v2/entity/uniqueAttribute/type/{typeName}": { + "get": { + "operationId": "Entity_GetByUniqueAttributes", + "description": "Get complete definition of an entity given its type and unique attribute.\n\nIn\naddition to the typeName path parameter, attribute key-value pair(s) can be\nprovided in the following format:\nattr:\\=.\n\nNOTE: The\nattrName and attrValue should be unique across entities, eg.\nqualifiedName.\n\nThe REST request would look something like this:\nGET\n/v2/entity/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue.", "parameters": [ { - "name": "bmName", + "name": "typeName", "in": "path", - "type": "string", - "description": "BusinessMetadata name", - "required": true + "description": "The name of the type.", + "required": true, + "type": "string" }, { - "$ref": "#/parameters/guid" + "name": "minExtInfo", + "in": "query", + "description": "Whether to return minimal information for referred entities.", + "required": false, + "type": "boolean" }, { - "name": "businessMetadataAttributes", + "name": "ignoreRelationships", + "in": "query", + "description": "Whether to ignore relationship attributes.", "required": false, - "in": "body", - "schema": { - "$ref": "#/definitions/BusinessMetadataAttributes" - } + "type": "boolean" + }, + { + "name": "attr:qualifiedName", + "in": "query", + "description": "The qualified name of the entity. (This is only an example. qualifiedName can\nbe changed to other unique attributes)", + "required": false, + "type": "string", + "x-ms-client-name": "attribute" } ], "responses": { - "204": { - "description": "Success" + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AtlasEntityWithExtInfo" + } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - } - }, - "/atlas/v2/entity/businessmetadata/import/template": { - "get": { - "tags": [ - "Entity" - ], - "description": "Get the sample Template for uploading/creating bulk BusinessMetaData", - "operationId": "Entity_GetSampleBusinessMetadataTemplate", - "produces": [ - "application/octet-stream" - ], + }, "x-ms-examples": { - "Entity_GetSampleBusinessMetadataTemplate": { - "$ref": "./examples/Entity_GetSampleBusinessMetadataTemplate.json" + "Entity_GetByUniqueAttributes": { + "$ref": "./examples/Entity_GetByUniqueAttributes.json" } - }, - "parameters": [], + } + }, + "put": { + "operationId": "Entity_PartialUpdateByUniqueAttributes", + "description": "Update entity partially - Allow a subset of attributes to be updated on an\nentity which is identified by its type and unique attribute eg:\nReferenceable.qualifiedName. Null updates are not possible.\n\nIn addition to the\ntypeName path parameter, attribute key-value pair(s) can be provided in the\nfollowing format:\n\nattr:=.\nNOTE: The attrName and\nattrValue should be unique across entities, eg. qualifiedName.\n\nThe REST\nrequest would look something like this:\nPUT\n/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\nbe 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": { - "description": "Template File", - "type": "file" - }, - "description": "Template File" + "$ref": "#/definitions/EntityMutationResult" + } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - } - }, - "/atlas/v2/entity/businessmetadata/import": { - "post": { - "tags": [ - "Entity" - ], - "description": "Upload the file for creating Business Metadata in BULK", - "operationId": "Entity_ImportBusinessMetadata", - "consumes": [ - "multipart/form-data" - ], - "produces": [ - "application/json" - ], + }, "x-ms-examples": { - "Entity_ImportBusinessMetadata": { - "$ref": "./examples/Entity_ImportBusinessMetadata.json" + "Entity_PartialUpdateByUniqueAttributes": { + "$ref": "./examples/Entity_PartialUpdateByUniqueAttributes.json" } - }, + } + }, + "delete": { + "operationId": "Entity_DeleteByUniqueAttribute", + "description": "Delete an entity identified by its type and unique attributes.\nIn addition to\nthe typeName path parameter, attribute key-value pair(s) can be provided in the\nfollowing format:\nattr:\\=\\.\nNOTE: The attrName and\nattrValue should be unique across entities, eg. qualifiedName.\n\nThe REST\nrequest would look something like this:\nDELETE\n/v2/entity/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue.", "parameters": [ { - "name": "uploadedInputStream", - "in": "formData", - "type": "file", - "description": "InputStream of file" + "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\nbe changed to other unique attributes)", + "required": false, + "type": "string", + "x-ms-client-name": "attribute" } ], "responses": { "200": { + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/BulkImportResponse", - "description": "If Business Metadata creation was successful" - }, - "description": "If Business Metadata creation was successful" + "$ref": "#/definitions/EntityMutationResult" + } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Entity_DeleteByUniqueAttribute": { + "$ref": "./examples/Entity_DeleteByUniqueAttribute.json" + } } } }, - "/atlas/v2/entity/guid/{guid}/labels": { + "/atlas/v2/entity/uniqueAttribute/type/{typeName}/classification/{classificationName}": { "delete": { - "tags": [ - "Entity" - ], - "description": "Delete given labels to a given entity.", - "operationId": "Entity_RemoveLabels", - "consumes": [ - "application/json" - ], - "x-ms-examples": { - "Entity_RemoveLabels": { - "$ref": "./examples/Entity_Label.json" - } - }, + "operationId": "Entity_RemoveClassificationByUniqueAttribute", + "description": "Delete a given classification from an entity identified by its type and unique\nattributes.", "parameters": [ { - "$ref": "#/parameters/guid" + "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": "body", + "name": "attr:qualifiedName", + "in": "query", + "description": "The qualified name of the entity. (This is only an example. qualifiedName can\nbe changed to other unique attributes)", "required": false, - "in": "body", - "schema": { - "description": "set of labels to be deleted", - "type": "array", - "items": { - "type": "string" - } - }, - "description": "set of labels to be deleted" + "type": "string", + "x-ms-client-name": "attribute" } ], "responses": { "204": { - "description": "Success" + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "post": { - "tags": [ - "Entity" - ], - "description": "Set labels to a given entity.", - "operationId": "Entity_SetLabels", - "consumes": [ - "application/json" - ], + }, "x-ms-examples": { - "Entity_SetLabel": { - "$ref": "./examples/Entity_Label.json" + "Entity_RemoveClassificationByUniqueAttribute": { + "$ref": "./examples/Entity_RemoveClassificationByUniqueAttribute.json" } - }, + } + } + }, + "/atlas/v2/entity/uniqueAttribute/type/{typeName}/classifications": { + "put": { + "operationId": "Entity_UpdateClassificationsByUniqueAttribute", + "description": "Update classification on an entity identified by its type and unique attributes.", "parameters": [ { - "$ref": "#/parameters/guid" + "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\nbe changed to other unique attributes)", + "required": false, + "type": "string", + "x-ms-client-name": "attribute" }, { "name": "body", - "required": false, "in": "body", + "description": "An array of classification to be updated.", + "required": true, "schema": { - "description": "set of labels to be set to the entity", "type": "array", "items": { - "type": "string" - } - }, - "description": "set of labels to be set to the entity" + "$ref": "#/definitions/AtlasClassification" + }, + "x-ms-identifiers": [] + } } ], "responses": { "204": { - "description": "Success" + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "put": { - "tags": [ - "Entity" - ], - "description": "Add given labels to a given entity.", - "operationId": "Entity_AddLabel", - "consumes": [ - "application/json" - ], + }, "x-ms-examples": { - "Entity_AddLabel": { - "$ref": "./examples/Entity_Label.json" + "Entity_UpdateClassificationsByUniqueAttribute": { + "$ref": "./examples/Entity_UpdateClassificationsByUniqueAttribute.json" } - }, + } + }, + "post": { + "operationId": "Entity_AddClassificationsByUniqueAttribute", + "description": "Add classification to the entity identified by its type and unique attributes.", "parameters": [ { - "$ref": "#/parameters/guid" + "name": "typeName", + "in": "path", + "description": "The name of the type.", + "required": true, + "type": "string" }, { - "name": "body", + "name": "attr:qualifiedName", + "in": "query", + "description": "The qualified name of the entity. (This is only an example. qualifiedName can\nbe 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": { - "description": "set of labels to be added", "type": "array", "items": { - "type": "string" - } - }, - "description": "set of labels to be added" + "$ref": "#/definitions/AtlasClassification" + }, + "x-ms-identifiers": [] + } } ], "responses": { "204": { - "description": "Success" + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Entity_AddClassificationsByUniqueAttribute": { + "$ref": "./examples/Entity_AddClassificationsByUniqueAttribute.json" + } } } }, "/atlas/v2/entity/uniqueAttribute/type/{typeName}/labels": { - "delete": { - "tags": [ - "Entity" - ], - "operationId": "Entity_RemoveLabelsByUniqueAttribute", - "description": "Delete given labels to a given entity identified by its type and unique attribute.\n\nIf labels is null/empty, no labels will be removed.\n\nIf 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.", - "consumes": [ - "application/json" - ], - "x-ms-examples": { - "Entity_RemoveLabelsByUniqueAttribute": { - "$ref": "./examples/Entity_RemoveLabelsByUniqueAttribute.json" - } - }, + "put": { + "operationId": "Entity_AddLabelsByUniqueAttribute", + "description": "Add given labels to a given entity identified by its type and unique\nattributes.\n\nIf labels is null/empty, no labels will be added.\n\nIn addition to\nthe typeName path parameter, attribute key-value pair(s) can be provided in the\nfollowing format: attr:=.\n\nNOTE: The attrName and\nattrValue should be unique across entities, eg. qualifiedName.\n\nThe REST\nrequest would look something like this: PUT\n/v2/entity/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue.", "parameters": [ { - "$ref": "#/parameters/typeName" + "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)", + "description": "The qualified name of the entity. (This is only an example. qualifiedName can\nbe changed to other unique attributes)", "required": false, - "type": "string" + "type": "string", + "x-ms-client-name": "attribute" }, { "name": "body", - "required": false, "in": "body", + "description": "set of labels to be added", + "required": false, "schema": { - "description": "set of labels to be deleted", "type": "array", "items": { "type": "string" } - }, - "description": "set of labels to be deleted" + } } ], "responses": { "204": { - "description": "Success" + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Entity_AddLabelsByUniqueAttribute": { + "$ref": "./examples/Entity_AddLabelsByUniqueAttribute.json" + } } }, "post": { - "tags": [ - "Entity" - ], "operationId": "Entity_SetLabelsByUniqueAttribute", - "description": "Set labels to a given entity identified by its type and unique attributes.\n\nIf labels is null/empty, existing labels will all be removed.\n\nIn addition to the typeName path parameter, attribute key-value pair(s) can be provided in the following format: attr:=.\n\nNOTE: The attrName and attrValue should be unique across entities, eg. qualifiedName.\n\nThe REST request would look something like this: POST /v2/entity/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue.", - "consumes": [ - "application/json" - ], - "x-ms-examples": { - "Entity_SetLabelsByUniqueAttribute": { - "$ref": "./examples/Entity_SetLabelsByUniqueAttribute.json" - } - }, + "description": "Set labels to a given entity identified by its type and unique attributes.\n\nIf\nlabels is null/empty, existing labels will all be removed.\n\nIn addition to the\ntypeName path parameter, attribute key-value pair(s) can be provided in the\nfollowing format: attr:=.\n\nNOTE: The attrName and\nattrValue should be unique across entities, eg. qualifiedName.\n\nThe REST\nrequest would look something like this: POST\n/v2/entity/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue.", "parameters": [ { - "$ref": "#/parameters/typeName" + "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)", + "description": "The qualified name of the entity. (This is only an example. qualifiedName can\nbe changed to other unique attributes)", "required": false, - "type": "string" + "type": "string", + "x-ms-client-name": "attribute" }, { "name": "body", - "required": false, "in": "body", + "description": "set of labels to be set", + "required": false, "schema": { - "description": "set of labels to be set", "type": "array", "items": { "type": "string" } - }, - "description": "set of labels to be set" + } } ], "responses": { "204": { - "description": "Success" + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "put": { - "tags": [ - "Entity" - ], - "operationId": "Entity_AddLabelsByUniqueAttribute", - "description": "Add given labels to a given entity identified by its type and unique attributes.\n\nIf labels is null/empty, no labels will be added.\n\nIn addition to the typeName path parameter, attribute key-value pair(s) can be provided in the following format: attr:=.\n\nNOTE: The attrName and attrValue should be unique across entities, eg. qualifiedName.\n\nThe REST request would look something like this: PUT /v2/entity/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue.", - "consumes": [ - "application/json" - ], + }, "x-ms-examples": { - "Entity_AddLabelsByUniqueAttribute": { - "$ref": "./examples/Entity_AddLabelsByUniqueAttribute.json" + "Entity_SetLabelsByUniqueAttribute": { + "$ref": "./examples/Entity_SetLabelsByUniqueAttribute.json" } - }, + } + }, + "delete": { + "operationId": "Entity_RemoveLabelsByUniqueAttribute", + "description": "Delete given labels to a given entity identified by its type and unique\nattribute.\n\nIf labels is null/empty, no labels will be removed.\n\nIf any labels\nin labels set are non-existing labels, they will be ignored, only existing\nlabels will be removed. In addition to the typeName path parameter, attribute\nkey-value pair(s) can be provided in the following format:\nattr:=. NOTE: The attrName and attrValue should be unique\nacross entities, eg. qualifiedName. The REST request would look something like\nthis: DELETE\n/v2/entity/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue.", "parameters": [ { - "$ref": "#/parameters/typeName" + "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)", + "description": "The qualified name of the entity. (This is only an example. qualifiedName can\nbe changed to other unique attributes)", "required": false, - "type": "string" + "type": "string", + "x-ms-client-name": "attribute" }, { "name": "body", - "required": false, "in": "body", + "description": "set of labels to be deleted", + "required": false, "schema": { - "description": "set of labels to be added", "type": "array", "items": { "type": "string" } - }, - "description": "set of labels to be added" + } } ], "responses": { "204": { - "description": "Success" + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - } - }, - "/entity/moveTo": { - "post": { - "tags": [ - "Entity" - ], - "description": "Move existing entities to the target collection.", - "operationId": "Entity_MoveEntitiesToCollection", - "x-ms-examples": { - "Collection_MoveEntitiesToCollection": { - "$ref": "./examples/Entity_MoveEntitiesToCollection.json" - } }, - "parameters": [ - { - "$ref": "#/parameters/requiredCollectionId" - }, - { - "$ref": "#/parameters/purviewAPIVersion" - }, - { - "in": "body", - "name": "moveEntitiesRequest", - "description": "Entity guids to be moved to target collection.", - "required": true, - "schema": { - "$ref": "#/definitions/MoveEntitiesRequest" - } - } - ], - "responses": { - "200": { - "description": "Created with EntityMutationResponse.", - "schema": { - "$ref": "#/definitions/EntityMutationResponse" - } - }, - "default": { - "description": "Error response describing why the operation failed.", - "schema": { - "$ref": "#/definitions/ErrorResponse" - } + "x-ms-examples": { + "Entity_RemoveLabelsByUniqueAttribute": { + "$ref": "./examples/Entity_RemoveLabelsByUniqueAttribute.json" } } } }, "/atlas/v2/glossary": { "get": { - "tags": [ - "Glossary" - ], - "description": "Get all glossaries. Recommend using limit/offset to get pagination result. Recommend using 'ignoreTermsAndCategories=true' and fetch terms/categories separately using \n\n 'GET /datamap/api/atlas/v2/glossary/{glossaryGuid}/terms' and \n\n 'GET '/datamap/api/atlas/v2/glossary/{glossaryGuid}/categories'.", "operationId": "Glossary_List", - "x-ms-examples": { - "Glossary_List": { - "$ref": "./examples/Glossary_List.json" - } - }, + "description": "Get all glossaries. Recommend using limit/offset to get pagination result.\nRecommend using 'ignoreTermsAndCategories=true' and fetch terms/categories\nseparately using \n\n 'GET /datamap/api/atlas/v2/glossary/{glossaryId}/terms'\nand \n\n 'GET '/datamap/api/atlas/v2/glossary/{glossaryId}/categories'.", "parameters": [ { - "$ref": "#/parameters/limit" + "$ref": "#/parameters/AtlasApiVersionParameter" }, { - "$ref": "#/parameters/offset" + "name": "limit", + "in": "query", + "description": "The page size - by default there is no paging.", + "required": false, + "type": "integer", + "format": "int32" }, { - "$ref": "#/parameters/sort" + "name": "offset", + "in": "query", + "description": "The offset for pagination purpose.", + "required": false, + "type": "integer", + "format": "int32" }, { - "$ref": "#/parameters/ignoreTermsAndCategories" + "name": "sort", + "in": "query", + "description": "The sort order, ASC (default) or DESC.", + "required": false, + "type": "string" }, { - "$ref": "#/parameters/atlasAPIVersion" + "name": "ignoreTermsAndCategories", + "in": "query", + "description": "Whether ignore terms and categories", + "required": false, + "type": "boolean" } ], "responses": { "200": { - "description": "An array of existing glossaries fitting the search criteria or empty list if nothing matches.", + "description": "The request has succeeded.", "schema": { "type": "array", "items": { "$ref": "#/definitions/AtlasGlossary" - } + }, + "x-ms-identifiers": [] } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Glossary_List": { + "$ref": "./examples/Glossary_List.json" + } } }, "post": { - "tags": [ - "Glossary" - ], - "description": "Create a glossary.", "operationId": "Glossary_Create", - "x-ms-examples": { - "Glossary_Create": { - "$ref": "./examples/Glossary_Create.json" - } - }, + "description": "Create a glossary.", "parameters": [ { + "name": "body", "in": "body", - "name": "atlasGlossary", - "description": "Glossary definition, terms & categories can be anchored to a glossary.\nUsing the anchor attribute when creating the Term/Category.", "required": true, "schema": { "$ref": "#/definitions/AtlasGlossary" @@ -1622,2179 +1680,2242 @@ ], "responses": { "200": { - "description": "OK. If glossary creation was successful.", + "description": "The request has succeeded.", "schema": { "$ref": "#/definitions/AtlasGlossary" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Glossary_Create": { + "$ref": "./examples/Glossary_Create.json" + } } } }, - "/atlas/v2/glossary/categories": { - "post": { - "tags": [ - "Glossary" - ], - "description": "Create glossary category in bulk.", - "operationId": "Glossary_CreateCategories", - "x-ms-examples": { - "Glossary_CreateCategories": { - "$ref": "./examples/Glossary_CreateCategories.json" - } - }, + "/atlas/v2/glossary/{glossaryId}": { + "get": { + "operationId": "Glossary_Get", + "description": "Get a specific Glossary by its GUID.", "parameters": [ { - "in": "body", - "name": "glossaryCategory", - "description": "An array of glossary category definitions to be created.", + "name": "glossaryId", + "in": "path", + "description": "The globally unique identifier for glossary.", "required": true, - "schema": { - "type": "array", - "description": "An array of glossary category definitions.", - "items": { - "$ref": "#/definitions/AtlasGlossaryCategory" - } - } + "type": "string" } ], "responses": { "200": { - "description": "OK. If bulk glossary category creation was successful.", + "description": "The request has succeeded.", "schema": { - "type": "array", - "description": "An array of glossary category created successfully in bulk.", - "items": { - "$ref": "#/definitions/AtlasGlossaryCategory" - } + "$ref": "#/definitions/AtlasGlossary" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - } - }, - "/atlas/v2/glossary/category": { - "post": { - "tags": [ - "Glossary" - ], - "description": "Create a glossary category.", - "operationId": "Glossary_CreateCategory", + }, "x-ms-examples": { - "Glossary_CreateCategory": { - "$ref": "./examples/Glossary_CreateCategory.json" + "Glossary_Get": { + "$ref": "./examples/Glossary_Get.json" } - }, + } + }, + "put": { + "operationId": "Glossary_Update", + "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", - "name": "glossaryCategory", - "description": "The glossary category definition. A category must be anchored to a Glossary when creating.\nOptionally, terms belonging to the category and the hierarchy can also be defined during creation.", "required": true, "schema": { - "$ref": "#/definitions/AtlasGlossaryCategory" + "$ref": "#/definitions/AtlasGlossary" } } ], "responses": { "200": { - "description": "OK. If glossary category creation was successful.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasGlossaryCategory" + "$ref": "#/definitions/AtlasGlossary" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - } - }, - "/atlas/v2/glossary/category/{categoryGuid}": { - "get": { - "tags": [ - "Glossary" - ], - "description": "Get specific glossary category by its GUID.", - "operationId": "Glossary_GetCategory", + }, "x-ms-examples": { - "Glossary_GetCategory": { - "$ref": "./examples/Glossary_GetCategory.json" + "Glossary_Update": { + "$ref": "./examples/Glossary_Update.json" } - }, + } + }, + "delete": { + "operationId": "Glossary_Delete", + "description": "Delete a glossary. Will delete underlying terms/categories together. Recommend\nseparate delete terms and categories.", "parameters": [ { - "$ref": "#/parameters/categoryGuid" + "name": "glossaryId", + "in": "path", + "description": "The globally unique identifier for glossary.", + "required": true, + "type": "string" } ], "responses": { - "200": { - "description": "OK. If glossary category exists for given GUID.", - "schema": { - "$ref": "#/definitions/AtlasGlossaryCategory" - } + "204": { + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "put": { - "tags": [ - "Glossary" - ], - "description": "Update the given glossary category by its GUID.", - "operationId": "Glossary_UpdateCategory", + }, "x-ms-examples": { - "Glossary_UpdateCategory": { - "$ref": "./examples/Glossary_UpdateCategory.json" + "Glossary_Delete": { + "$ref": "./examples/Glossary_Delete.json" } - }, - "parameters": [ + } + } + }, + "/atlas/v2/glossary/{glossaryId}/categories": { + "get": { + "operationId": "Glossary_ListCategories", + "description": "Get the categories belonging to a specific glossary. Recommend using\nlimit/offset to get pagination result.", + "parameters": [ { - "$ref": "#/parameters/categoryGuid" + "name": "glossaryId", + "in": "path", + "description": "The globally unique identifier for glossary.", + "required": true, + "type": "string" }, { - "in": "body", - "name": "glossaryCategory", - "description": "The glossary category to be updated.", - "required": true, - "schema": { - "$ref": "#/definitions/AtlasGlossaryCategory" - } + "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": "OK. If glossary category partial update was successful.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasGlossaryCategory" + "type": "array", + "items": { + "$ref": "#/definitions/AtlasGlossaryCategory" + }, + "x-ms-identifiers": [] } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "delete": { - "tags": [ - "Glossary" - ], - "description": "Delete a glossary category.", - "operationId": "Glossary_DeleteCategory", + }, "x-ms-examples": { - "Glossary_DeleteCategory": { - "$ref": "./examples/Glossary_DeleteCategory.json" + "Glossary_ListCategories": { + "$ref": "./examples/Glossary_ListCategories.json" } - }, + } + } + }, + "/atlas/v2/glossary/{glossaryId}/categories/headers": { + "get": { + "operationId": "Glossary_ListCategoriesHeaders", + "description": "Get the category headers belonging to a specific glossary. Recommend using\nlimit/offset to get pagination result.", "parameters": [ { - "$ref": "#/parameters/categoryGuid" + "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": { - "204": { - "description": "OK. If glossary category deletion is successful." + "200": { + "description": "The request has succeeded.", + "schema": { + "type": "array", + "items": { + "$ref": "#/definitions/AtlasRelatedCategoryHeader" + }, + "x-ms-identifiers": [] + } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Glossary_ListCategoriesHeaders": { + "$ref": "./examples/Glossary_ListCategoriesHeaders.json" + } } } }, - "/atlas/v2/glossary/category/{categoryGuid}/partial": { - "put": { - "tags": [ - "Glossary" - ], - "description": "Update the glossary category partially. So far we only supports partial updating shortDescription and longDescription for category.", - "operationId": "Glossary_PartialUpdateCategory", - "x-ms-examples": { - "Glossary_PartialUpdateCategory": { - "$ref": "./examples/Glossary_PartialUpdateCategory.json" - } - }, + "/atlas/v2/glossary/{glossaryId}/detailed": { + "get": { + "operationId": "Glossary_GetDetailed", + "description": "Get a specific glossary with detailed information. This API is not\nrecommend.\n\nRecommend to fetch terms/categories details separately using \n\nGET /datamap/api/atlas/v2/glossary/{glossaryId}/terms and \n\nGET /datamap/api/atlas/v2/glossary/{glossaryId}/categories.", "parameters": [ { - "$ref": "#/parameters/categoryGuid" + "$ref": "#/parameters/AtlasApiVersionParameter" }, { - "in": "body", - "name": "partialUpdates", - "description": "A map containing keys as attribute names and values as corresponding attribute values for partial update.", + "name": "glossaryId", + "in": "path", + "description": "The globally unique identifier for glossary.", "required": true, - "schema": { - "type": "object", - "description": "A map containing keys as attribute names and values as corresponding attribute values." - } + "type": "string" } ], "responses": { "200": { - "description": "OK. If glossary category partial update was successful.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasGlossaryCategory" + "$ref": "#/definitions/AtlasGlossaryExtInfo" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Glossary_GetDetailed": { + "$ref": "./examples/Glossary_GetDetailed.json" + } } } }, - "/atlas/v2/glossary/category/{categoryGuid}/related": { - "get": { - "tags": [ - "Glossary" - ], - "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.", - "operationId": "Glossary_ListRelatedCategories", - "x-ms-examples": { - "Glossary_ListRelatedCategories": { - "$ref": "./examples/Glossary_ListRelatedCategories.json" - } - }, + "/atlas/v2/glossary/{glossaryId}/partial": { + "put": { + "operationId": "Glossary_PartialUpdate", + "description": "Update the glossary partially. Some properties such as qualifiedName are not\nallowed to be updated.\n\nSo far we only supports partial updating\nshortDescription, longDescription, language and usage for glossary. \n\nRecommend\nusing 'ignoreTermsAndCategories=true' to reduce response body size.", "parameters": [ { - "$ref": "#/parameters/categoryGuid" + "$ref": "#/parameters/AtlasApiVersionParameter" }, { - "$ref": "#/parameters/limit" + "name": "glossaryId", + "in": "path", + "description": "The globally unique identifier for glossary.", + "required": true, + "type": "string" }, { - "$ref": "#/parameters/offset" + "name": "ignoreTermsAndCategories", + "in": "query", + "description": "Whether ignore terms and categories", + "required": false, + "type": "boolean" }, { - "$ref": "#/parameters/sort" + "name": "body", + "in": "body", + "description": "A map containing keys as attribute names and values as corresponding attribute\nvalues.", + "required": true, + "schema": { + "type": "object", + "additionalProperties": { + "type": "string" + } + } } ], "responses": { "200": { - "description": "OK. Gets an array of related categories.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/RelatedCategoryHeaders" + "$ref": "#/definitions/AtlasGlossary" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Glossary_PartialUpdate": { + "$ref": "./examples/Glossary_PartialUpdate.json" + } } } }, - "/atlas/v2/glossary/category/{categoryGuid}/terms": { + "/atlas/v2/glossary/{glossaryId}/terms": { "get": { - "tags": [ - "Glossary" - ], - "description": "Get all terms associated with the specific category.", - "operationId": "Glossary_ListCategoryTerms", - "x-ms-examples": { - "Glossary_ListCategoryTerms": { - "$ref": "./examples/Glossary_ListCategoryTerms.json" - } - }, + "operationId": "Glossary_ListTerms", + "description": "Get terms belonging to a specific glossary. Recommend using limit/offset to get\npagination result.", "parameters": [ { - "$ref": "#/parameters/categoryGuid" + "$ref": "#/parameters/AtlasApiVersionParameter" + }, + { + "name": "glossaryId", + "in": "path", + "description": "The globally unique identifier for glossary.", + "required": true, + "type": "string" }, { - "$ref": "#/parameters/limit" + "name": "limit", + "in": "query", + "description": "The page size - by default there is no paging.", + "required": false, + "type": "integer", + "format": "int32" }, { - "$ref": "#/parameters/offset" + "name": "offset", + "in": "query", + "description": "The offset for pagination purpose.", + "required": false, + "type": "integer", + "format": "int32" }, { - "$ref": "#/parameters/sort" + "name": "sort", + "in": "query", + "description": "The sort order, ASC (default) or DESC.", + "required": false, + "type": "string" } ], "responses": { "200": { - "description": "An array of terms for the given category or an empty list.", + "description": "The request has succeeded.", "schema": { "type": "array", - "description": "An array of terms for the given category or an empty list.", "items": { - "$ref": "#/definitions/AtlasRelatedTermHeader" - } + "$ref": "#/definitions/AtlasGlossaryTerm" + }, + "x-ms-identifiers": [] } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Glossary_ListTerms": { + "$ref": "./examples/Glossary_ListTerms.json" + } } } }, - "/atlas/v2/glossary/term": { - "post": { - "tags": [ - "Glossary" - ], - "description": "Create a glossary term.", - "operationId": "Glossary_CreateTerm", - "x-ms-examples": { - "Glossary_CreateTerm": { - "$ref": "./examples/Glossary_CreateTerm.json" - }, - "Glossary_CreateTermWithTemplate": { - "$ref": "./examples/Glossary_CreateTermWithTemplate.json" - } - }, + "/atlas/v2/glossary/{glossaryId}/terms/headers": { + "get": { + "operationId": "Glossary_ListTermHeaders", + "description": "Get term headers belonging to a specific glossary. Recommend using limit/offset\nto get pagination result.", "parameters": [ { - "in": "body", - "name": "glossaryTerm", - "description": "The glossary term definition. A term must be anchored to a Glossary at the time of creation.\nOptionally it can be categorized as well.", + "name": "glossaryId", + "in": "path", + "description": "The globally unique identifier for glossary.", "required": true, - "schema": { - "$ref": "#/definitions/AtlasGlossaryTerm" - } + "type": "string" }, { - "$ref": "#/parameters/includeTermHierarchy" + "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": "OK. If glossary term creation was successful.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasGlossaryTerm" + "type": "array", + "items": { + "$ref": "#/definitions/AtlasRelatedTermHeader" + }, + "x-ms-identifiers": [] } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Glossary_ListTermHeaders": { + "$ref": "./examples/Glossary_ListTermHeaders.json" + } } } }, - "/atlas/v2/glossary/term/{termGuid}": { - "get": { - "tags": [ - "Glossary" - ], - "description": "Get a specific glossary term by its GUID. ", - "operationId": "Glossary_GetTerm", - "x-ms-examples": { - "Glossary_GetTerm": { - "$ref": "./examples/Glossary_GetTerm.json" - }, - "Glossary_GetTerm_WithoutAssets": { - "$ref": "./examples/Glossary_GetTermWithoutAssets.json" - } - }, + "/atlas/v2/glossary/categories": { + "post": { + "operationId": "Glossary_CreateCategories", + "description": "Create glossary category in bulk.", "parameters": [ { - "$ref": "#/parameters/atlasAPIVersion" - }, - { - "$ref": "#/parameters/termGuid" + "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": "OK. If glossary term exists for given GUID.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasGlossaryTerm" + "type": "array", + "items": { + "$ref": "#/definitions/AtlasGlossaryCategory" + }, + "x-ms-identifiers": [] } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "put": { - "tags": [ - "Glossary" - ], - "description": "Update the given glossary term by its GUID.", - "operationId": "Glossary_UpdateTerm", + }, "x-ms-examples": { - "Glossary_UpdateTerm": { - "$ref": "./examples/Glossary_UpdateTerm.json" + "Glossary_CreateCategories": { + "$ref": "./examples/Glossary_CreateCategories.json" } - }, + } + } + }, + "/atlas/v2/glossary/category": { + "post": { + "operationId": "Glossary_CreateCategory", + "description": "Create a glossary category.", "parameters": [ { - "$ref": "#/parameters/atlasAPIVersion" - }, - { - "$ref": "#/parameters/termGuid" - }, - { + "name": "body", "in": "body", - "name": "glossaryTerm", - "description": "The glossary term to be updated.", "required": true, "schema": { - "$ref": "#/definitions/AtlasGlossaryTerm" + "$ref": "#/definitions/AtlasGlossaryCategory" } - }, - { - "$ref": "#/parameters/includeTermHierarchy" } ], "responses": { "200": { - "description": "OK. If glossary term update was successful.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasGlossaryTerm" + "$ref": "#/definitions/AtlasGlossaryCategory" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "delete": { - "tags": [ - "Glossary" - ], - "description": "Delete a glossary term.", - "operationId": "Glossary_DeleteTerm", + }, "x-ms-examples": { - "Glossary_DeleteTerm": { - "$ref": "./examples/Glossary_DeleteTerm.json" + "Glossary_CreateCategory": { + "$ref": "./examples/Glossary_CreateCategory.json" } - }, + } + } + }, + "/atlas/v2/glossary/category/{categoryId}": { + "get": { + "operationId": "Glossary_GetCategory", + "description": "Get specific glossary category by its GUID.", "parameters": [ { - "$ref": "#/parameters/termGuid" + "name": "categoryId", + "in": "path", + "description": "The globally unique identifier of the category.", + "required": true, + "type": "string" } ], "responses": { - "204": { - "description": "OK. If glossary term delete was successful." + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AtlasGlossaryCategory" + } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - } - }, - "/atlas/v2/glossary/term/{termGuid}/partial": { - "put": { - "tags": [ - "Glossary" - ], - "description": "Update the glossary term partially. So far we only supports partial updating shortDescription, longDescription, abbreviation, usage and status for term.", - "operationId": "Glossary_PartialUpdateTerm", + }, "x-ms-examples": { - "Glossary_PartialUpdateTerm": { - "$ref": "./examples/Glossary_PartialUpdateTerm.json" + "Glossary_GetCategory": { + "$ref": "./examples/Glossary_GetCategory.json" } - }, + } + }, + "put": { + "operationId": "Glossary_UpdateCategory", + "description": "Update the given glossary category by its GUID.", "parameters": [ { - "$ref": "#/parameters/atlasAPIVersion" - }, - { - "$ref": "#/parameters/termGuid" - }, - { - "$ref": "#/parameters/includeTermHierarchy" + "name": "categoryId", + "in": "path", + "description": "The globally unique identifier of the category.", + "required": true, + "type": "string" }, { + "name": "body", "in": "body", - "name": "partialUpdates", - "description": "A map containing keys as attribute names and values as corresponding attribute values to be updated.", "required": true, "schema": { - "type": "object", - "description": "A map containing keys as attribute names and values as corresponding attribute values." + "$ref": "#/definitions/AtlasGlossaryCategory" } } ], "responses": { "200": { - "description": "OK. If glossary partial update was successful.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasGlossaryTerm" + "$ref": "#/definitions/AtlasGlossaryCategory" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Glossary_UpdateCategory": { + "$ref": "./examples/Glossary_UpdateCategory.json" + } } - } - }, - "/atlas/v2/glossary/terms": { - "post": { - "tags": [ - "Glossary" + }, + "delete": { + "operationId": "Glossary_DeleteCategory", + "description": "Delete a glossary category.", + "parameters": [ + { + "name": "categoryId", + "in": "path", + "description": "The globally unique identifier of the category.", + "required": true, + "type": "string" + } ], - "description": "Create glossary terms in bulk.", - "operationId": "Glossary_CreateTerms", - "x-ms-examples": { - "Glossary_CreateTerms": { - "$ref": "./examples/Glossary_CreateTerms.json" + "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" + } + } + } + }, + "/atlas/v2/glossary/category/{categoryId}/partial": { + "put": { + "operationId": "Glossary_PartialUpdateCategory", + "description": "Update the glossary category partially. So far we only supports partial\nupdating shortDescription and longDescription for category.", "parameters": [ { - "$ref": "#/parameters/atlasAPIVersion" + "name": "categoryId", + "in": "path", + "description": "The globally unique identifier of the category.", + "required": true, + "type": "string" }, { + "name": "body", "in": "body", - "name": "glossaryTerm", - "description": "An array of glossary term definitions to be created in bulk.", + "description": "A map containing keys as attribute names and values as corresponding attribute\nvalues for partial update.", "required": true, "schema": { - "type": "array", - "description": "An array of glossary term definitions.", - "items": { - "$ref": "#/definitions/AtlasGlossaryTerm" + "type": "object", + "additionalProperties": { + "type": "string" } } - }, - { - "$ref": "#/parameters/includeTermHierarchy" } ], "responses": { "200": { - "description": "OK. If bulk glossary terms creation was successful.", + "description": "The request has succeeded.", "schema": { - "type": "array", - "description": "If bulk glossary terms creation was successful.", - "items": { - "$ref": "#/definitions/AtlasGlossaryTerm" - } + "$ref": "#/definitions/AtlasGlossaryCategory" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Glossary_PartialUpdateCategory": { + "$ref": "./examples/Glossary_PartialUpdateCategory.json" + } } } }, - "/atlas/v2/glossary/terms/{termGuid}/assignedEntities": { + "/atlas/v2/glossary/category/{categoryId}/related": { "get": { - "tags": [ - "Glossary" - ], - "description": "List all related objects assigned with the specified term. Recommend using limit/offset to get pagination result.", - "operationId": "Glossary_ListEntitiesAssignedWithTerm", - "x-ms-examples": { - "Glossary_ListEntitiesAssignedWithTerm": { - "$ref": "./examples/Glossary_ListEntitiesAssignedWithTerm.json" - } - }, + "operationId": "Glossary_ListRelatedCategories", + "description": "Get all related categories (parent and children). Limit, offset, and sort\nparameters are currently not being enabled and won't work even they are passed.", "parameters": [ { - "$ref": "#/parameters/termGuid" + "name": "categoryId", + "in": "path", + "description": "The globally unique identifier of the category.", + "required": true, + "type": "string" }, { - "$ref": "#/parameters/limit" + "name": "limit", + "in": "query", + "description": "The page size - by default there is no paging.", + "required": false, + "type": "integer", + "format": "int32" }, { - "$ref": "#/parameters/offset" + "name": "offset", + "in": "query", + "description": "The offset for pagination purpose.", + "required": false, + "type": "integer", + "format": "int32" }, { - "$ref": "#/parameters/sort" + "name": "sort", + "in": "query", + "description": "The sort order, ASC (default) or DESC.", + "required": false, + "type": "string" } ], "responses": { "200": { - "description": "OK. An array of related objects (if any) for the given glossary or an empty list.", + "description": "The request has succeeded.", "schema": { - "type": "array", - "description": "An array of related objects (if any) for the given glossary or an empty list.", - "items": { - "$ref": "#/definitions/AtlasRelatedObjectId" + "type": "object", + "additionalProperties": { + "items": { + "$ref": "#/definitions/AtlasRelatedCategoryHeader" + }, + "type": "array", + "x-ms-identifiers": [] } } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "post": { - "tags": [ - "Glossary" - ], - "description": "Assign the given term to the provided list of related objects. Recommend using small batches with multiple API calls.\n\n[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.", - "operationId": "Glossary_AssignTermToEntities", + }, "x-ms-examples": { - "Glossary_AssignTermToEntities": { - "$ref": "./examples/Glossary_AssignTermToEntities.json" + "Glossary_ListRelatedCategories": { + "$ref": "./examples/Glossary_ListRelatedCategories.json" } - }, + } + } + }, + "/atlas/v2/glossary/category/{categoryId}/terms": { + "get": { + "operationId": "Glossary_ListCategoryTerms", + "description": "Get all terms associated with the specific category.", "parameters": [ { - "$ref": "#/parameters/termGuid" + "name": "categoryId", + "in": "path", + "description": "The globally unique identifier of the category.", + "required": true, + "type": "string" }, { - "in": "body", - "name": "relatedObjectIds", - "description": "An array of related object IDs to which the term has to be associated.", - "required": true, + "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", - "description": "An array of related object IDs to which the term has to be associated.", "items": { - "$ref": "#/definitions/AtlasRelatedObjectId" - } + "$ref": "#/definitions/AtlasRelatedTermHeader" + }, + "x-ms-identifiers": [] } - } - ], - "responses": { - "204": { - "description": "OK. If the term assignment was successful." }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "delete": { - "tags": [ - "Glossary" - ], - "description": "Delete the term assignment for the given list of related objects.", - "operationId": "Glossary_DeleteTermAssignmentFromEntities", + }, "x-ms-examples": { - "Glossary_RemoveTermAssignmentFromEntities": { - "$ref": "./examples/Glossary_RemoveTermAssignmentFromEntities.json" + "Glossary_ListCategoryTerms": { + "$ref": "./examples/Glossary_ListCategoryTerms.json" } - }, + } + } + }, + "/atlas/v2/glossary/term": { + "post": { + "operationId": "Glossary_CreateTerm", + "description": "Create a glossary term.", "parameters": [ { - "$ref": "#/parameters/termGuid" + "name": "includeTermHierarchy", + "in": "query", + "description": "Whether include term hierarchy", + "required": false, + "type": "boolean" }, { + "name": "body", "in": "body", - "name": "relatedObjectIds", - "description": "An array of related object IDs from which the term has to be dissociated.", "required": true, "schema": { - "type": "array", - "description": "An array of related object IDs from which the term has to be dissociated.", - "items": { - "$ref": "#/definitions/AtlasRelatedObjectId" - } + "$ref": "#/definitions/AtlasGlossaryTerm" } } ], "responses": { - "204": { - "description": "OK. If glossary term dissociation was successful." + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AtlasGlossaryTerm" + } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Glossary_CreateTerm": { + "$ref": "./examples/Glossary_CreateTerm.json" + }, + "Glossary_CreateTermWithTemplate": { + "$ref": "./examples/Glossary_CreateTermWithTemplate.json" + } } } }, - "/atlas/v2/glossary/terms/{termGuid}/related": { + "/atlas/v2/glossary/term/{termId}": { "get": { - "tags": [ - "Glossary" - ], - "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.", - "operationId": "Glossary_ListRelatedTerms", - "x-ms-examples": { - "Glossary_ListRelatedTerms": { - "$ref": "./examples/Glossary_ListRelatedTerms.json" - } - }, + "operationId": "Glossary_GetTerm", + "description": "Get a specific glossary term by its GUID. ", "parameters": [ { - "$ref": "#/parameters/atlasAPIVersion" - }, - { - "$ref": "#/parameters/termGuid" - }, - { - "$ref": "#/parameters/limit" - }, - { - "$ref": "#/parameters/offset" + "$ref": "#/parameters/AtlasApiVersionParameter" }, { - "$ref": "#/parameters/sort" + "name": "termId", + "in": "path", + "description": "The globally unique identifier for glossary term.", + "required": true, + "type": "string" } ], "responses": { "200": { - "description": "OK. An array of related glossary terms for the given glossary or an empty list.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/RelatedTermHeaders" + "$ref": "#/definitions/AtlasGlossaryTerm" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - } - }, - "/atlas/v2/glossary/{glossaryGuid}": { - "get": { - "tags": [ - "Glossary" - ], - "description": "Get a specific Glossary by its GUID.", - "operationId": "Glossary_Get", - "x-ms-examples": { - "Glossary_Get": { - "$ref": "./examples/Glossary_Get.json" - } }, - "parameters": [ - { - "$ref": "#/parameters/glossaryGuid" - } - ], - "responses": { - "200": { - "description": "OK. If glossary with given guid exists.", - "schema": { - "$ref": "#/definitions/AtlasGlossary" - } + "x-ms-examples": { + "Glossary_GetTerm": { + "$ref": "./examples/Glossary_GetTerm.json" }, - "default": { - "description": "Error response describing why the operation failed.", - "schema": { - "$ref": "#/definitions/ErrorResponse" - } + "Glossary_GetTermWithoutAssets": { + "$ref": "./examples/Glossary_GetTermWithoutAssets.json" } } }, "put": { - "tags": [ - "Glossary" - ], - "description": "Update the given glossary.", - "operationId": "Glossary_Update", - "x-ms-examples": { - "Glossary_Update": { - "$ref": "./examples/Glossary_Update.json" - } - }, + "operationId": "Glossary_UpdateTerm", + "description": "Update the given glossary term by its GUID.", "parameters": [ { - "$ref": "#/parameters/atlasAPIVersion" + "$ref": "#/parameters/AtlasApiVersionParameter" }, { - "$ref": "#/parameters/glossaryGuid" + "name": "termId", + "in": "path", + "description": "The globally unique identifier for glossary term.", + "required": true, + "type": "string" }, { - "$ref": "#/parameters/ignoreTermsAndCategories" + "name": "includeTermHierarchy", + "in": "query", + "description": "Whether include term hierarchy", + "required": false, + "type": "boolean" }, { + "name": "body", "in": "body", - "name": "updatedGlossary", - "description": "The glossary definition to be updated.", "required": true, "schema": { - "$ref": "#/definitions/AtlasGlossary" + "$ref": "#/definitions/AtlasGlossaryTerm" } } ], "responses": { "200": { - "description": "OK. If glossary update was successful.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasGlossary" + "$ref": "#/definitions/AtlasGlossaryTerm" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Glossary_UpdateTerm": { + "$ref": "./examples/Glossary_UpdateTerm.json" + } } }, "delete": { - "tags": [ - "Glossary" - ], - "description": "Delete a glossary. Will delete underlying terms/categories together. Recommend separate delete terms and categories.", - "operationId": "Glossary_Delete", - "x-ms-examples": { - "Glossary_Delete": { - "$ref": "./examples/Glossary_Delete.json" - } - }, + "operationId": "Glossary_DeleteTerm", + "description": "Delete a glossary term.", "parameters": [ { - "$ref": "#/parameters/glossaryGuid" + "name": "termId", + "in": "path", + "description": "The globally unique identifier for glossary term.", + "required": true, + "type": "string" } ], "responses": { "204": { - "description": "OK. If glossary delete was successful." + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Glossary_DeleteTerm": { + "$ref": "./examples/Glossary_DeleteTerm.json" + } } } }, - "/atlas/v2/glossary/{glossaryGuid}/categories": { - "get": { - "tags": [ - "Glossary" - ], - "description": "Get the categories belonging to a specific glossary. Recommend using limit/offset to get pagination result.", - "operationId": "Glossary_ListCategories", - "x-ms-examples": { - "Glossary_ListCategories": { - "$ref": "./examples/Glossary_ListCategories.json" - } - }, + "/atlas/v2/glossary/term/{termId}/partial": { + "put": { + "operationId": "Glossary_PartialUpdateTerm", + "description": "Update the glossary term partially. So far we only supports partial updating\nshortDescription, longDescription, abbreviation, usage and status for term.", "parameters": [ { - "$ref": "#/parameters/glossaryGuid" + "$ref": "#/parameters/AtlasApiVersionParameter" }, { - "$ref": "#/parameters/limit" + "name": "termId", + "in": "path", + "description": "The globally unique identifier for glossary term.", + "required": true, + "type": "string" }, { - "$ref": "#/parameters/offset" + "name": "includeTermHierarchy", + "in": "query", + "description": "Whether include term hierarchy", + "required": false, + "type": "boolean" }, { - "$ref": "#/parameters/sort" + "name": "body", + "in": "body", + "description": "A map containing keys as attribute names and values as corresponding attribute\nvalues to be updated.", + "required": true, + "schema": { + "type": "object", + "additionalProperties": { + "type": "string" + } + } } ], "responses": { "200": { - "description": "OK. An array of glossary categories for the given glossary or an empty list.", + "description": "The request has succeeded.", "schema": { - "type": "array", - "description": "An array of glossary categories for the given glossary or an empty list.", - "items": { - "$ref": "#/definitions/AtlasGlossaryCategory" - } + "$ref": "#/definitions/AtlasGlossaryTerm" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Glossary_PartialUpdateTerm": { + "$ref": "./examples/Glossary_PartialUpdateTerm.json" + } } } }, - "/atlas/v2/glossary/{glossaryGuid}/categories/headers": { - "get": { - "tags": [ - "Glossary" - ], - "description": "Get the category headers belonging to a specific glossary. Recommend using limit/offset to get pagination result.", - "operationId": "Glossary_ListCategoriesHeaders", - "x-ms-examples": { - "Glossary_ListCategoriesHeaders": { - "$ref": "./examples/Glossary_ListCategoriesHeaders.json" - } - }, + "/atlas/v2/glossary/terms": { + "post": { + "operationId": "Glossary_CreateTerms", + "description": "Create glossary terms in bulk.", "parameters": [ { - "$ref": "#/parameters/glossaryGuid" - }, - { - "$ref": "#/parameters/limit" + "$ref": "#/parameters/AtlasApiVersionParameter" }, { - "$ref": "#/parameters/offset" + "name": "includeTermHierarchy", + "in": "query", + "description": "Whether include term hierarchy", + "required": false, + "type": "boolean" }, { - "$ref": "#/parameters/sort" + "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": "OK. An array of glossary category headers for the given glossary or an empty list.", + "description": "The request has succeeded.", "schema": { "type": "array", - "description": "An array of glossary category headers for the given glossary or an empty list.", "items": { - "$ref": "#/definitions/AtlasRelatedCategoryHeader" - } + "$ref": "#/definitions/AtlasGlossaryTerm" + }, + "x-ms-identifiers": [] } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Glossary_CreateTerms": { + "$ref": "./examples/Glossary_CreateTerms.json" + } } } }, - "/atlas/v2/glossary/{glossaryGuid}/detailed": { + "/atlas/v2/glossary/terms/{termId}/assignedEntities": { "get": { - "tags": [ - "Glossary" - ], - "description": "Get a specific glossary with detailed information. This API is not recommend.\n\nRecommend to fetch terms/categories details separately using \n\n 'GET /datamap/api/atlas/v2/glossary/{glossaryGuid}/terms' and \n\n 'GET '/datamap/api/atlas/v2/glossary/{glossaryGuid}/categories'.", - "operationId": "Glossary_GetDetailed", - "x-ms-examples": { - "Glossary_GetDetailed": { - "$ref": "./examples/Glossary_GetDetailed.json" - } - }, + "operationId": "Glossary_ListEntitiesAssignedWithTerm", + "description": "List all related objects assigned with the specified term. Recommend using\nlimit/offset to get pagination result.", "parameters": [ { - "$ref": "#/parameters/atlasAPIVersion" + "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" }, { - "$ref": "#/parameters/glossaryGuid" + "name": "sort", + "in": "query", + "description": "The sort order, ASC (default) or DESC.", + "required": false, + "type": "string" } ], "responses": { "200": { - "description": "OK. If glossary exists for given GUID.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasGlossaryExtInfo" + "type": "array", + "items": { + "$ref": "#/definitions/AtlasRelatedObjectId" + }, + "x-ms-identifiers": [] } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - } - }, - "/atlas/v2/glossary/{glossaryGuid}/partial": { - "put": { - "tags": [ - "Glossary" - ], - "description": "Update the glossary partially. Some properties such as qualifiedName are not allowed to be updated.\n\nSo far we only supports partial updating shortDescription, longDescription, language and usage for glossary. \n\nRecommend using 'ignoreTermsAndCategories=true' to reduce response body size.", - "operationId": "Glossary_PartialUpdate", + }, "x-ms-examples": { - "Glossary_PartialUpdate": { - "$ref": "./examples/Glossary_PartialUpdate.json" + "Glossary_ListEntitiesAssignedWithTerm": { + "$ref": "./examples/Glossary_ListEntitiesAssignedWithTerm.json" } - }, + } + }, + "post": { + "operationId": "Glossary_AssignTermToEntities", + "description": "Assign the given term to the provided list of related objects. Recommend using\nsmall batches with multiple API calls.\n\n[Entities Create Or Update\noperation](https://learn.microsoft.com/en-us/rest/api/purview/datamapdataplane/entity/bulk-create-or-update?tabs=HTTP)\nis an alternative to assign a term to multiple entities.", "parameters": [ { - "$ref": "#/parameters/atlasAPIVersion" - }, - { - "$ref": "#/parameters/glossaryGuid" - }, - { - "$ref": "#/parameters/ignoreTermsAndCategories" + "name": "termId", + "in": "path", + "description": "The globally unique identifier for glossary term.", + "required": true, + "type": "string" }, { + "name": "body", "in": "body", - "name": "partialUpdates", - "description": "A map containing keys as attribute names and values as corresponding attribute values.", + "description": "An array of related object IDs to which the term has to be associated.", "required": true, "schema": { - "type": "object", - "description": "A map containing keys as attribute names and values as corresponding attribute values." + "type": "array", + "items": { + "$ref": "#/definitions/AtlasRelatedObjectId" + }, + "x-ms-identifiers": [] } } ], "responses": { - "200": { - "description": "OK. If glossary partial update was successful.", - "schema": { - "$ref": "#/definitions/AtlasGlossary" - } + "204": { + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - } - }, - "/atlas/v2/glossary/{glossaryGuid}/terms": { - "get": { - "tags": [ - "Glossary" - ], - "description": "Get terms belonging to a specific glossary. Recommend using limit/offset to get pagination result.", - "operationId": "Glossary_ListTerms", + }, "x-ms-examples": { - "Glossary_ListTerms": { - "$ref": "./examples/Glossary_ListTerms.json" + "Glossary_AssignTermToEntities": { + "$ref": "./examples/Glossary_AssignTermToEntities.json" } - }, + } + }, + "delete": { + "operationId": "Glossary_DeleteTermAssignmentFromEntities", + "description": "Delete the term assignment for the given list of related objects.", "parameters": [ { - "$ref": "#/parameters/atlasAPIVersion" - }, - { - "$ref": "#/parameters/glossaryGuid" - }, - { - "$ref": "#/parameters/limit" - }, - { - "$ref": "#/parameters/offset" + "name": "termId", + "in": "path", + "description": "The globally unique identifier for glossary term.", + "required": true, + "type": "string" }, { - "$ref": "#/parameters/sort" - } - ], - "responses": { - "200": { - "description": "OK. An array of glossary terms for the given glossary or an empty list.", + "name": "body", + "in": "body", + "description": "An array of related object IDs from which the term has to be dissociated.", + "required": true, "schema": { "type": "array", - "description": "An array of glossary terms for the given glossary or an empty list.", "items": { - "$ref": "#/definitions/AtlasGlossaryTerm" - } + "$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": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Glossary_RemoveTermAssignmentFromEntities": { + "$ref": "./examples/Glossary_RemoveTermAssignmentFromEntities.json" + } } } }, - "/atlas/v2/glossary/{glossaryGuid}/terms/headers": { + "/atlas/v2/glossary/terms/{termId}/related": { "get": { - "tags": [ - "Glossary" - ], - "description": "Get term headers belonging to a specific glossary. Recommend using limit/offset to get pagination result.", - "operationId": "Glossary_ListTermHeaders", - "x-ms-examples": { - "Glossary_ListTermHeaders": { - "$ref": "./examples/Glossary_ListTermHeaders.json" - } - }, + "operationId": "Glossary_ListRelatedTerms", + "description": "Get all related terms for a specific term by its GUID. Limit, offset, and sort\nparameters are currently not being enabled and won't work even they are passed.", "parameters": [ { - "$ref": "#/parameters/glossaryGuid" + "$ref": "#/parameters/AtlasApiVersionParameter" + }, + { + "name": "termId", + "in": "path", + "description": "The globally unique identifier for glossary term.", + "required": true, + "type": "string" }, { - "$ref": "#/parameters/limit" + "name": "limit", + "in": "query", + "description": "The page size - by default there is no paging.", + "required": false, + "type": "integer", + "format": "int32" }, { - "$ref": "#/parameters/offset" + "name": "offset", + "in": "query", + "description": "The offset for pagination purpose.", + "required": false, + "type": "integer", + "format": "int32" }, { - "$ref": "#/parameters/sort" + "name": "sort", + "in": "query", + "description": "The sort order, ASC (default) or DESC.", + "required": false, + "type": "string" } ], "responses": { "200": { - "description": "OK. An array of glossary terms for the given glossary or an empty list.", + "description": "The request has succeeded.", "schema": { - "type": "array", - "description": "An array of glossary terms for the given glossary or an empty list.", - "items": { - "$ref": "#/definitions/AtlasRelatedTermHeader" + "type": "object", + "additionalProperties": { + "items": { + "$ref": "#/definitions/AtlasRelatedTermHeader" + }, + "type": "array", + "x-ms-identifiers": [] } } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - } - }, - "/search/query": { - "post": { - "tags": [ - "Discovery" - ], - "description": "Get data using search.", - "operationId": "Discovery_Query", + }, "x-ms-examples": { - "Discovery_Query": { - "$ref": "./examples/Discovery_Query.json" - }, - "Discovery_Query_And": { - "$ref": "./examples/Discovery_Query_And.json" - }, - "Discovery_Query_Not": { - "$ref": "./examples/Discovery_Query_Not.json" - }, - "Discovery_Query_AndOrNested": { - "$ref": "./examples/Discovery_Query_AndOrNested.json" - }, - "Discovery_Query_SystemTime": { - "$ref": "./examples/Discovery_Query_SystemTime.json" - }, - "Discovery_Query_BusinessMetadataAttribute": { - "$ref": "./examples/Discovery_Query_BusinessMetadataAttribute.json" - }, - "Discovery_Query_Attribute": { - "$ref": "./examples/Discovery_Query_Attribute.json" - }, - "Discovery_Query_Classification": { - "$ref": "./examples/Discovery_Query_Classification.json" - }, - "Discovery_Query_FileExtension": { - "$ref": "./examples/Discovery_Query_FileExtension.json" - }, - "Discovery_Query_Id": { - "$ref": "./examples/Discovery_Query_Id.json" - }, - "Discovery_Query_EntityType": { - "$ref": "./examples/Discovery_Query_Type.json" - }, - "Discovery_Query_AssetType": { - "$ref": "./examples/Discovery_Query_AssetType.json" - }, - "Discovery_Query_Term": { - "$ref": "./examples/Discovery_Query_TermAssignment.json" - }, - "Discovery_Query_Facet": { - "$ref": "./examples/Discovery_Query_Facet.json" - }, - "Discovery_Query_Taxonomy": { - "$ref": "./examples/Discovery_Query_Taxonomy.json" - }, - "Discovery_Query_Collection": { - "$ref": "./examples/Discovery_Query_Collection.json" - }, - "Discovery_Query_GlossaryTerm": { - "$ref": "./examples/Discovery_Query_GlossaryTerm.json" - }, - "Discovery_Query_ObjectType": { - "$ref": "./examples/Discovery_Query_ObjectType.json" - }, - "Discovery_Query_PaginationFirstPage": { - "$ref": "./examples/Discovery_Query_PaginationFirstPage.json" - }, - "Discovery_Query_PaginationContinuationPage": { - "$ref": "./examples/Discovery_Query_PaginationContinuationPage.json" - }, - "Discovery_Query_PaginationLastPage": { - "$ref": "./examples/Discovery_Query_PaginationLastPage.json" + "Glossary_ListRelatedTerms": { + "$ref": "./examples/Glossary_ListRelatedTerms.json" } - }, + } + } + }, + "/atlas/v2/lineage/{guid}": { + "get": { + "operationId": "Lineage_Get", + "description": "Get lineage info of the entity specified by GUID.", "parameters": [ { - "in": "body", - "name": "searchRequest", - "description": "An object specifying the search criteria.", + "name": "guid", + "in": "path", + "description": "The globally unique identifier of the entity.", "required": true, - "schema": { - "$ref": "#/definitions/SearchRequest" - } + "type": "string" + }, + { + "name": "depth", + "in": "query", + "description": "The number of hops for lineage.", + "required": false, + "type": "integer", + "format": "int32" }, { - "$ref": "#/parameters/purviewAPIVersion" + "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": "OK. On successful lookup of the advanced search.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/SearchResult" + "$ref": "#/definitions/AtlasLineageInfo" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Lineage_Get": { + "$ref": "./examples/Lineage_Get.json" + } } } }, - "/search/suggest": { - "post": { - "tags": [ - "Discovery" - ], - "description": "Get search suggestions by query criteria.", - "operationId": "Discovery_Suggest", - "x-ms-examples": { - "Discovery_Suggest": { - "$ref": "./examples/Discovery_Suggest.json" - } - }, + "/atlas/v2/lineage/uniqueAttribute/type/{typeName}": { + "get": { + "operationId": "Lineage_GetByUniqueAttribute", + "description": "Return lineage info about entity.\n\nIn addition to the typeName path parameter,\nattribute key-value pair(s) can be provided in the following\nformat\n\nattr:[attrName]=[attrValue]\n\nNOTE: The attrName and attrValue should be\nunique across entities, eg. qualifiedName.\n\nThe REST request would look\nsomething like this:\n\nGET\n/v2/lineage/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue.", "parameters": [ { - "in": "body", - "name": "suggestRequest", - "description": "An object specifying the suggest criteria.", + "name": "typeName", + "in": "path", + "description": "The name of the type.", "required": true, - "schema": { - "$ref": "#/definitions/SuggestRequest" + "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" + } + ] } }, { - "$ref": "#/parameters/purviewAPIVersion" + "name": "attr:qualifiedName", + "in": "query", + "description": "The qualified name of the entity. (This is only an example. qualifiedName can\nbe changed to other unique attributes)", + "required": false, + "type": "string", + "x-ms-client-name": "attribute" } ], "responses": { "200": { - "description": "OK. On successful lookup of the suggestions.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/SuggestResult" + "$ref": "#/definitions/AtlasLineageInfo" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Lineage_GetByUniqueAttribute": { + "$ref": "./examples/Lineage_GetByUniqueAttribute.json" + } } } }, - "/search/autocomplete": { - "post": { - "tags": [ - "Discovery" - ], - "description": "Get auto complete options.", - "operationId": "Discovery_AutoComplete", - "x-ms-examples": { - "Discovery_AutoComplete": { - "$ref": "./examples/Discovery_AutoComplete.json" - } - }, + "/atlas/v2/relationship": { + "put": { + "operationId": "Relationship_Update", + "description": "Update an existing relationship between entities.", "parameters": [ { + "name": "body", "in": "body", - "name": "autoCompleteRequest", - "description": "An object specifying the autocomplete criteria.", "required": true, "schema": { - "$ref": "#/definitions/AutoCompleteRequest" + "$ref": "#/definitions/AtlasRelationship" } - }, - { - "$ref": "#/parameters/purviewAPIVersion" } ], "responses": { "200": { - "description": "OK. On successful lookup of the auto complete options.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AutoCompleteResult" + "$ref": "#/definitions/AtlasRelationship" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - } - }, - "/atlas/v2/lineage/{guid}": { - "get": { - "tags": [ - "Lineage" - ], - "description": "Get lineage info of the entity specified by GUID.", - "operationId": "Lineage_Get", + }, "x-ms-examples": { - "Lineage_Get": { - "$ref": "./examples/Lineage_Get.json" + "Relationship_Update": { + "$ref": "./examples/Relationship_Update.json" } - }, + } + }, + "post": { + "operationId": "Relationship_Create", + "description": "Create a new relationship between entities.", "parameters": [ { - "$ref": "#/parameters/guid" - }, - { - "$ref": "#/parameters/depth" - }, - { - "$ref": "#/parameters/direction" + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/AtlasRelationship" + } } ], "responses": { "200": { - "description": "OK. If the request is valid.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasLineageInfo" + "$ref": "#/definitions/AtlasRelationship" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Relationship_Create": { + "$ref": "./examples/Relationship_Create.json" + } } } }, - "/lineage/{guid}/next/": { + "/atlas/v2/relationship/guid/{guid}": { "get": { - "tags": [ - "Lineage" - ], - "description": "Return immediate next page lineage info about entity with pagination", - "operationId": "Lineage_GetNextPage", - "x-ms-examples": { - "Lineage_GetNextPage": { - "$ref": "./examples/Lineage_GetNextPage.json" - } - }, + "operationId": "Relationship_Get", + "description": "Get relationship information between entities by its GUID.", "parameters": [ { - "$ref": "#/parameters/guid" - }, - { - "$ref": "#/parameters/direction" - }, - { - "$ref": "#/parameters/offset" - }, - { - "$ref": "#/parameters/limit" + "name": "guid", + "in": "path", + "description": "The globally unique identifier of the relationship.", + "required": true, + "type": "string" }, { - "$ref": "#/parameters/purviewAPIVersion" + "name": "extendedInfo", + "in": "query", + "description": "Limits whether includes extended information.", + "required": false, + "type": "boolean" } ], "responses": { "200": { - "description": "OK. If the input is valid.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasLineageInfo" + "$ref": "#/definitions/AtlasRelationshipWithExtInfo" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - } - }, - "/atlas/v2/lineage/uniqueAttribute/type/{typeName}": { - "get": { - "tags": [ - "Lineage" - ], - "description": "Return lineage info about entity.\n\nIn addition to the typeName path parameter, attribute key-value pair(s) can be provided in the following format\n\nattr:[attrName]=[attrValue]\n\nNOTE: The attrName and attrValue should be unique across entities, eg. qualifiedName.\n\nThe REST request would look something like this:\n\nGET /v2/lineage/uniqueAttribute/type/aType?attr:aTypeAttribute=someValue.", - "operationId": "Lineage_GetByUniqueAttribute", + }, "x-ms-examples": { - "Lineage_GetByUniqueAttribute": { - "$ref": "./examples/Lineage_GetByUniqueAttribute.json" + "Relationship_Get": { + "$ref": "./examples/Relationship_Get.json" } - }, - "produces": [ - "application/json" - ], + } + }, + "delete": { + "operationId": "Relationship_Delete", + "description": "Delete a relationship between entities by its GUID.", "parameters": [ { - "$ref": "#/parameters/typeName" - }, - { - "$ref": "#/parameters/depth" - }, - { - "$ref": "#/parameters/direction" - }, - { - "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, + "name": "guid", + "in": "path", + "description": "The globally unique identifier of the relationship.", + "required": true, "type": "string" } ], "responses": { - "200": { - "schema": { - "$ref": "#/definitions/AtlasLineageInfo", - "description": "If Lineage exists for the given entity" - }, - "description": "If Lineage exists for the given entity" + "204": { + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Relationship_Delete": { + "$ref": "./examples/Relationship_Delete.json" + } } } }, - "/atlas/v2/relationship": { - "post": { - "tags": [ - "Relationship" - ], - "description": "Create a new relationship between entities.", - "operationId": "Relationship_Create", - "x-ms-examples": { - "Relationship_Create": { - "$ref": "./examples/Relationship_Create.json" - } - }, + "/atlas/v2/types/businessmetadatadef/guid/{guid}": { + "get": { + "operationId": "Type_GetBusinessMetadataDefByGuid", + "description": "Get the businessMetadata definition for the given guid.", "parameters": [ { - "in": "body", - "name": "relationship", - "description": "The AtlasRelationship object containing the information for the relationship to be created.", + "name": "guid", + "in": "path", + "description": "businessMetadata guid", "required": true, - "schema": { - "$ref": "#/definitions/AtlasRelationship" - } + "type": "string" } ], "responses": { "200": { - "description": "OK. The relationship is created.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasRelationship" + "$ref": "#/definitions/AtlasBusinessMetadataDef" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "put": { - "tags": [ - "Relationship" - ], - "description": "Update an existing relationship between entities.", - "operationId": "Relationship_Update", + }, "x-ms-examples": { - "Relationship_Update": { - "$ref": "./examples/Relationship_Update.json" + "Type_GetBusinessMetadataDefByGuid": { + "$ref": "./examples/Type_GetBusinessMetadataDefByGuid.json" } - }, + } + } + }, + "/atlas/v2/types/businessmetadatadef/name/{name}": { + "get": { + "operationId": "Type_GetBusinessMetadataDefByName", + "description": "Get the businessMetadata definition by it's name (unique).", "parameters": [ { - "in": "body", - "name": "relationship", - "description": "The AtlasRelationship object containing the information for the relationship to be created.", + "name": "name", + "in": "path", + "description": "businessMetadata name", "required": true, - "schema": { - "$ref": "#/definitions/AtlasRelationship" - } + "type": "string" } ], "responses": { "200": { - "description": "OK. The relationship is updated.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasRelationship" + "$ref": "#/definitions/AtlasBusinessMetadataDef" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Type_GetBusinessMetadataDefByName": { + "$ref": "./examples/Type_GetBusinessMetadataDefByName.json" + } } } }, - "/atlas/v2/relationship/guid/{guid}": { + "/atlas/v2/types/classificationdef/guid/{guid}": { "get": { - "tags": [ - "Relationship" - ], - "description": "Get relationship information between entities by its GUID.", - "operationId": "Relationship_Get", - "x-ms-examples": { - "Relationship_Get": { - "$ref": "./examples/Relationship_Get.json" - } - }, + "operationId": "Type_GetClassificationDefByGuid", + "description": "Get the classification definition for the given GUID.", "parameters": [ { - "$ref": "#/parameters/relationshipGuid" - }, - { - "$ref": "#/parameters/extendedInfo" + "name": "guid", + "in": "path", + "description": "The globally unique identifier of the classification.", + "required": true, + "type": "string" } ], "responses": { "200": { - "description": "OK.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasRelationshipWithExtInfo" + "$ref": "#/definitions/AtlasClassificationDef" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "delete": { - "tags": [ - "Relationship" - ], - "description": "Delete a relationship between entities by its GUID.", - "operationId": "Relationship_Delete", + }, "x-ms-examples": { - "Relationship_Delete": { - "$ref": "./examples/Relationship_Delete.json" + "Type_GetClassificationDefByGuid": { + "$ref": "./examples/Type_GetClassificationDefByGuid.json" } - }, + } + } + }, + "/atlas/v2/types/classificationdef/name/{name}": { + "get": { + "operationId": "Type_GetClassificationDefByName", + "description": "Get the classification definition by its name (unique).", "parameters": [ { - "$ref": "#/parameters/relationshipGuid" + "name": "name", + "in": "path", + "description": "The name of the classification.", + "required": true, + "type": "string" } ], "responses": { - "204": { - "description": "OK. The relationship is deleted." + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AtlasClassificationDef" + } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Type_GetClassificationDefByName": { + "$ref": "./examples/Type_GetClassificationDefByName.json" + } } } }, - "/atlas/v2/types/businessmetadatadef/guid/{guid}": { + "/atlas/v2/types/entitydef/guid/{guid}": { "get": { - "tags": [ - "Type" - ], - "description": "Get the businessMetadata definition for the given guid.", - "operationId": "Type_GetBusinessMetadataDefByGuid", - "x-ms-examples": { - "Type_GetBusinessMetadataDefByGuid": { - "$ref": "./examples/Type_GetBusinessMetadataDefByGuid.json" - } - }, - "produces": [ - "application/json" - ], + "operationId": "Type_GetEntityDefByGuid", + "description": "Get the Entity definition for the given GUID.", "parameters": [ { "name": "guid", "in": "path", - "type": "string", - "description": "businessMetadata guid", - "required": true + "description": "The globally unique identifier of the entity.", + "required": true, + "type": "string" } ], "responses": { "200": { + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasBusinessMetadataDef", - "description": "On successful lookup of the the businessMetadata definition by it's guid" - }, - "description": "On successful lookup of the the businessMetadata definition by it's guid" + "$ref": "#/definitions/AtlasEntityDef" + } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Type_GetEntityDefByGuid": { + "$ref": "./examples/Type_GetEntityDefByGuid.json" + } } } }, - "/atlas/v2/types/businessmetadatadef/name/{name}": { + "/atlas/v2/types/entitydef/name/{name}": { "get": { - "tags": [ - "Type" - ], - "description": "Get the businessMetadata definition by it's name (unique).", - "operationId": "Type_GetBusinessMetadataDefByName", - "x-ms-examples": { - "Type_GetBusinessMetadataDefByName": { - "$ref": "./examples/Type_GetBusinessMetadataDefByName.json" - } - }, - "produces": [ - "application/json" - ], + "operationId": "Type_GetEntityDefByName", + "description": "Get the entity definition by its name (unique).", "parameters": [ { "name": "name", "in": "path", - "type": "string", - "description": "businessMetadata name", - "required": true + "description": "The name of the entity.", + "required": true, + "type": "string" } ], "responses": { "200": { + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasBusinessMetadataDef", - "description": "On successful lookup of the the businessMetadata definition by it's name" - }, - "description": "On successful lookup of the the businessMetadata definition by it's name" + "$ref": "#/definitions/AtlasEntityDef" + } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Type_GetEntityDefByName": { + "$ref": "./examples/Type_GetEntityDefByName.json" + } } } }, - "/atlas/v2/types/classificationdef/guid/{guid}": { + "/atlas/v2/types/enumdef/guid/{guid}": { "get": { - "tags": [ - "Type" - ], - "description": "Get the classification definition for the given GUID.", - "operationId": "Type_GetClassificationDefByGuid", - "x-ms-examples": { - "Type_GetClassificationDefByGuid": { - "$ref": "./examples/Type_GetClassificationDefByGuid.json" - } - }, + "operationId": "Type_GetEnumDefByGuid", + "description": "Get the enum definition for the given GUID.", "parameters": [ { - "$ref": "#/parameters/classificationDefGuid" + "name": "guid", + "in": "path", + "description": "The globally unique identifier of the enum.", + "required": true, + "type": "string" } ], "responses": { "200": { - "description": "OK. On successful lookup of the the classification definition by its GUID.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasClassificationDef" + "$ref": "#/definitions/AtlasEnumDef" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Type_GetEnumDefByGuid": { + "$ref": "./examples/Type_GetEnumDefByGuid.json" + } } } }, - "/atlas/v2/types/classificationdef/name/{name}": { + "/atlas/v2/types/enumdef/name/{name}": { "get": { - "tags": [ - "Type" - ], - "description": "Get the classification definition by its name (unique).", - "operationId": "Type_GetClassificationDefByName", - "x-ms-examples": { - "Type_GetClassificationDefByName": { - "$ref": "./examples/Type_GetClassificationDefByName.json" - } - }, + "operationId": "Type_GetEnumDefByName", + "description": "Get the enum definition by its name (unique).", "parameters": [ { - "$ref": "#/parameters/classificationDefName" + "name": "name", + "in": "path", + "description": "The name of the enum.", + "required": true, + "type": "string" } ], "responses": { "200": { - "description": "OK. On successful lookup of the the classification definition by its name.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasClassificationDef" + "$ref": "#/definitions/AtlasEnumDef" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Type_GetEnumDefByName": { + "$ref": "./examples/Type_GetEnumDefByName.json" + } } } }, - "/atlas/v2/types/entitydef/guid/{guid}": { + "/atlas/v2/types/relationshipdef/guid/{guid}": { "get": { - "tags": [ - "Type" - ], - "description": "Get the Entity definition for the given GUID.", - "operationId": "Type_GetEntityDefByGuid", - "x-ms-examples": { - "Type_GetEntityDefByGuid": { - "$ref": "./examples/Type_GetEntityDefByGuid.json" - } - }, + "operationId": "Type_GetRelationshipDefByGuid", + "description": "Get the relationship definition for the given GUID.", "parameters": [ { - "$ref": "#/parameters/entityDefGuid" + "name": "guid", + "in": "path", + "description": "The globally unique identifier of the relationship.", + "required": true, + "type": "string" } ], "responses": { "200": { - "description": "OK. On successful lookup of the the entity definition by its GUID.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasEntityDef" + "$ref": "#/definitions/AtlasRelationshipDef" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Type_GetRelationshipDefByGuid": { + "$ref": "./examples/Type_GetRelationshipDefByGuid.json" + } } } }, - "/atlas/v2/types/entitydef/name/{name}": { + "/atlas/v2/types/relationshipdef/name/{name}": { "get": { - "tags": [ - "Type" - ], - "description": "Get the entity definition by its name (unique).", - "operationId": "Type_GetEntityDefByName", - "x-ms-examples": { - "Type_GetEntityDefByName": { - "$ref": "./examples/Type_GetEntityDefByName.json" - } - }, + "operationId": "Type_GetRelationshipDefByName", + "description": "Get the relationship definition by its name (unique).", "parameters": [ { - "$ref": "#/parameters/entityDefName" + "name": "name", + "in": "path", + "description": "The name of the relationship.", + "required": true, + "type": "string" } ], "responses": { "200": { - "description": "OK. On successful lookup of the the entity definition by its name.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasEntityDef" + "$ref": "#/definitions/AtlasRelationshipDef" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Type_GetRelationshipDefByName": { + "$ref": "./examples/Type_GetRelationshipDefByName.json" + } } } }, - "/atlas/v2/types/enumdef/guid/{guid}": { + "/atlas/v2/types/structdef/guid/{guid}": { "get": { - "tags": [ - "Type" - ], - "description": "Get the enum definition for the given GUID.", - "operationId": "Type_GetEnumDefByGuid", - "x-ms-examples": { - "Type_GetEnumDefByGuid": { - "$ref": "./examples/Type_GetEnumDefByGuid.json" - } - }, - "parameters": [ - { - "$ref": "#/parameters/enumDefGuid" - } - ], - "responses": { - "200": { - "description": "OK. On successful lookup of the the enum definition by its GUID.", - "schema": { - "$ref": "#/definitions/AtlasEnumDef" - } - }, - "default": { - "description": "Error response describing why the operation failed.", - "schema": { - "$ref": "#/definitions/ErrorResponse" - } - } - } - } - }, - "/atlas/v2/types/enumdef/name/{name}": { - "get": { - "tags": [ - "Type" - ], - "description": "Get the enum definition by its name (unique).", - "operationId": "Type_GetEnumDefByName", - "x-ms-examples": { - "Type_GetEnumDefByName": { - "$ref": "./examples/Type_GetEnumDefByName.json" - } - }, - "parameters": [ - { - "$ref": "#/parameters/enumDefName" - } - ], - "responses": { - "200": { - "description": "OK. On successful lookup of the the enum definition by its name.", - "schema": { - "$ref": "#/definitions/AtlasEnumDef" - } - }, - "default": { - "description": "Error response describing why the operation failed.", - "schema": { - "$ref": "#/definitions/ErrorResponse" - } - } - } - } - }, - "/atlas/v2/types/relationshipdef/guid/{guid}": { - "get": { - "tags": [ - "Type" - ], - "description": "Get the relationship definition for the given GUID.", - "operationId": "Type_GetRelationshipDefByGuid", - "x-ms-examples": { - "Type_GetRelationshipDefByGuid": { - "$ref": "./examples/Type_GetRelationshipDefByGuid.json" - } - }, + "operationId": "Type_GetStructDefByGuid", + "description": "Get the struct definition for the given GUID.", "parameters": [ { - "$ref": "#/parameters/relationshipDefGuid" + "name": "guid", + "in": "path", + "description": "The globally unique identifier of the struct.", + "required": true, + "type": "string" } ], "responses": { "200": { - "description": "OK. On successful lookup of the the relationship definition by its GUID.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/AtlasRelationshipDef" + "$ref": "#/definitions/AtlasStructDef" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - } - }, - "/atlas/v2/types/relationshipdef/name/{name}": { - "get": { - "tags": [ - "Type" - ], - "description": "Get the relationship definition by its name (unique).", - "operationId": "Type_GetRelationshipDefByName", - "x-ms-examples": { - "Type_GetRelationshipDefByName": { - "$ref": "./examples/Type_GetRelationshipDefByName.json" - } }, - "parameters": [ - { - "$ref": "#/parameters/relationshipDefName" - } - ], - "responses": { - "200": { - "description": "OK. On successful lookup of the the relationship definition by its name.", - "schema": { - "$ref": "#/definitions/AtlasRelationshipDef" - } - }, - "default": { - "description": "Error response describing why the operation failed.", - "schema": { - "$ref": "#/definitions/ErrorResponse" - } - } - } - } - }, - "/atlas/v2/types/structdef/guid/{guid}": { - "get": { - "tags": [ - "Type" - ], - "description": "Get the struct definition for the given GUID.", - "operationId": "Type_GetStructDefByGuid", "x-ms-examples": { "Type_GetStructDefByGuid": { "$ref": "./examples/Type_GetStructDefByGuid.json" } - }, - "parameters": [ - { - "$ref": "#/parameters/structDefGuid" - } - ], - "responses": { - "200": { - "description": "OK. On successful lookup of the the struct definition by its GUID.", - "schema": { - "$ref": "#/definitions/AtlasStructDef" - } - }, - "default": { - "description": "Error response describing why the operation failed.", - "schema": { - "$ref": "#/definitions/ErrorResponse" - } - } } } }, "/atlas/v2/types/structdef/name/{name}": { "get": { - "tags": [ - "Type" - ], - "description": "Get the struct definition by its name (unique).", "operationId": "Type_GetStructDefByName", - "x-ms-examples": { - "Type_GetStructDefByName": { - "$ref": "./examples/Type_GetStructDefByName.json" - } - }, + "description": "Get the struct definition by its name (unique).", "parameters": [ { - "$ref": "#/parameters/structDefName" + "name": "name", + "in": "path", + "description": "The name of the struct.", + "required": true, + "type": "string" } ], "responses": { "200": { - "description": "OK. On successful lookup of the the struct definition by its name.", + "description": "The request has succeeded.", "schema": { "$ref": "#/definitions/AtlasStructDef" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Type_GetStructDefByName": { + "$ref": "./examples/Type_GetStructDefByName.json" + } } } }, "/atlas/v2/types/typedef/guid/{guid}": { "get": { - "tags": [ - "Type" - ], - "description": "Get the type definition for the given GUID.", "operationId": "Type_GetByGuid", - "x-ms-examples": { - "Type_GetByGuid": { - "$ref": "./examples/Type_GetByGuid.json" - } - }, + "description": "Get the type definition for the given GUID.", "parameters": [ { - "$ref": "#/parameters/typeDefGuid" + "name": "guid", + "in": "path", + "description": "The globally unique identifier of the type.", + "required": true, + "type": "string" } ], "responses": { "200": { - "description": "OK. On successful lookup of the the type definition by its GUID.", + "description": "The request has succeeded.", "schema": { "$ref": "#/definitions/AtlasTypeDef" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Type_GetByGuid": { + "$ref": "./examples/Type_GetByGuid.json" + } } } }, "/atlas/v2/types/typedef/name/{name}": { "get": { - "tags": [ - "Type" - ], - "description": "Get the type definition by its name (unique).", "operationId": "Type_GetByName", - "x-ms-examples": { - "Type_GetByName": { - "$ref": "./examples/Type_GetByName.json" - } - }, + "description": "Get the type definition by its name (unique).", "parameters": [ { - "$ref": "#/parameters/typeDefName" + "name": "name", + "in": "path", + "description": "The name of the type.", + "required": true, + "type": "string" } ], "responses": { "200": { - "description": "OK. On successful lookup of the the type definition by its name.", + "description": "The request has succeeded.", "schema": { "$ref": "#/definitions/AtlasTypeDef" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Type_GetByName": { + "$ref": "./examples/Type_GetByName.json" + } } }, "delete": { - "tags": [ - "Type" - ], - "description": "Delete API for type identified by its name.", "operationId": "Type_Delete", - "x-ms-examples": { - "Type_Delete": { - "$ref": "./examples/Type_Delete.json" - } - }, + "description": "Delete API for type identified by its name.", "parameters": [ { - "$ref": "#/parameters/typeDefName" + "name": "name", + "in": "path", + "description": "The name of the type.", + "required": true, + "type": "string" } ], "responses": { "204": { - "description": "On successful deletion of the requested type definitions" + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Type_Delete": { + "$ref": "./examples/Type_Delete.json" + } } } }, "/atlas/v2/types/typedefs": { "get": { - "tags": [ - "Type" - ], - "description": "List all type definitions in bulk.", "operationId": "Type_List", - "x-ms-examples": { - "Type_List": { - "$ref": "./examples/Type_List.json" - }, - "Type_ListEnumDefs": { - "$ref": "./examples/Type_ListEnumDefs.json" - }, - "Type_ListTermTemplateDefs": { - "$ref": "./examples/Type_ListTermTemplateDefs.json" - } - }, + "description": "List all type definitions in bulk.", "parameters": [ { - "$ref": "#/parameters/includeTermTemplate" + "$ref": "#/parameters/AtlasApiVersionParameter" }, { - "$ref": "#/parameters/type" + "name": "includeTermTemplate", + "in": "query", + "description": "Whether include termtemplatedef when return all typedefs.\nThis is always true\nwhen search filter type=term_template", + "required": false, + "type": "boolean" }, { - "$ref": "#/parameters/purviewAPIVersion" + "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": "OK. AtlasTypesDef with type definitions matching the search criteria or else returns empty list of type definitions.", + "description": "The request has succeeded.", "schema": { "$ref": "#/definitions/AtlasTypesDef" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "post": { - "tags": [ - "Type" - ], - "description": "Create all atlas type definitions in bulk, only new definitions will be created.\nAny changes to the existing definitions will be discarded.", - "operationId": "Type_BulkCreate", + }, "x-ms-examples": { - "Type_BulkCreate": { - "$ref": "./examples/Type_BulkCreate.json" + "Type_List": { + "$ref": "./examples/Type_List.json" }, - "Type_BulkCreateBusinessMetadataDefs": { - "$ref": "./examples/Type_BulkCreateBusinessMetadataDefs.json" + "Type_ListEnumDefs": { + "$ref": "./examples/Type_ListEnumDefs.json" + }, + "Type_ListTermTemplateDefs": { + "$ref": "./examples/Type_ListTermTemplateDefs.json" } - }, + } + }, + "put": { + "operationId": "Type_BulkUpdate", + "description": "Update all types in bulk, changes detected in the type definitions would be\npersisted.", "parameters": [ { + "name": "body", "in": "body", - "name": "typesDef", - "description": "A composite wrapper object with corresponding lists of the type definition.", "required": true, "schema": { "$ref": "#/definitions/AtlasTypesDef" @@ -3803,35 +3924,31 @@ ], "responses": { "200": { - "description": "OK. On successful update of requested type definitions.", + "description": "The request has succeeded.", "schema": { "$ref": "#/definitions/AtlasTypesDef" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } - } - }, - "put": { - "tags": [ - "Type" - ], - "description": "Update all types in bulk, changes detected in the type definitions would be persisted.", - "operationId": "Type_BulkUpdate", + }, "x-ms-examples": { "Type_BulkUpdate": { "$ref": "./examples/Type_BulkUpdate.json" } - }, + } + }, + "post": { + "operationId": "Type_BulkCreate", + "description": "Create all atlas type definitions in bulk, only new definitions will be\ncreated.\nAny changes to the existing definitions will be discarded.", "parameters": [ { + "name": "body", "in": "body", - "name": "typesDef", - "description": "A composite object that captures all type definition changes.", "required": true, "schema": { "$ref": "#/definitions/AtlasTypesDef" @@ -3840,35 +3957,34 @@ ], "responses": { "200": { - "description": "OK. On successful update of requested type definitions.", + "description": "The request has succeeded.", "schema": { "$ref": "#/definitions/AtlasTypesDef" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Type_BulkCreate": { + "$ref": "./examples/Type_BulkCreate.json" + }, + "Type_BulkCreateBusinessMetadataDefs": { + "$ref": "./examples/Type_BulkCreateBusinessMetadataDefs.json" + } } }, "delete": { - "tags": [ - "Type" - ], - "description": "Delete API for all types in bulk.", "operationId": "Type_BulkDelete", - "x-ms-examples": { - "Type_BulkDelete": { - "$ref": "./examples/Type_BulkDelete.json" - } - }, + "description": "Delete API for all types in bulk.", "parameters": [ { + "name": "body", "in": "body", - "name": "typesDef", - "description": "A composite object that captures all types to be deleted", "required": true, "schema": { "$ref": "#/definitions/AtlasTypesDef" @@ -3877,480 +3993,748 @@ ], "responses": { "204": { - "description": "OK. On successful deletion of the requested type definitions." + "description": "There is no content to send for this request, but the headers may be useful. " }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Type_BulkDelete": { + "$ref": "./examples/Type_BulkDelete.json" + } } } }, "/atlas/v2/types/typedefs/headers": { "get": { - "tags": [ - "Type" - ], - "description": "List all type definitions returned as a list of minimal information header.", "operationId": "Type_ListHeaders", - "x-ms-examples": { - "Type_ListHeaders": { - "$ref": "./examples/Type_ListHeaders.json" - } - }, + "description": "List all type definitions returned as a list of minimal information header.", "parameters": [ { - "$ref": "#/parameters/includeTermTemplate" + "$ref": "#/parameters/AtlasApiVersionParameter" }, { - "$ref": "#/parameters/type" + "name": "includeTermTemplate", + "in": "query", + "description": "Whether include termtemplatedef when return all typedefs.\nThis is always true\nwhen search filter type=term_template", + "required": false, + "type": "boolean" }, { - "$ref": "#/parameters/purviewAPIVersion" + "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": "An array of AtlasTypeDefHeader matching the search criteria\nor an empty list if no match.", + "description": "The request has succeeded.", "schema": { "type": "array", - "description": "An array of AtlasTypeDefHeader matching the search criteria\nor an empty list if no match.", "items": { "$ref": "#/definitions/AtlasTypeDefHeader" - } + }, + "x-ms-identifiers": [] } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Type_ListHeaders": { + "$ref": "./examples/Type_ListHeaders.json" + } } } }, - "/types/termtemplatedef/guid/{guid}": { - "get": { - "tags": [ - "Type" - ], - "description": "Get the term template definition for the given GUID.", - "operationId": "Type_GetTermTemplateDefByGuid", - "x-ms-examples": { - "Type_GetTermTemplateDefByGuid": { - "$ref": "./examples/Type_GetTermTemplateDefByGuid.json" - } - }, + "/entity/moveTo": { + "post": { + "operationId": "Entity_MoveEntitiesToCollection", + "description": "Move existing entities to the target collection.", "parameters": [ { - "$ref": "#/parameters/termTemplateDefGuid" + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "collectionId", + "in": "query", + "description": "The collection where entities will be moved to.", + "required": true, + "type": "string" }, { - "$ref": "#/parameters/purviewAPIVersion" + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/MoveEntitiesOptions" + } } ], "responses": { "200": { - "description": "OK. On successful lookup of the the term template definition by its GUID.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/TermTemplateDef" + "$ref": "#/definitions/EntityMutationResult" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Entity_MoveEntitiesToCollection": { + "$ref": "./examples/Entity_MoveEntitiesToCollection.json" + } } } }, - "/types/termtemplatedef/name/{name}": { + "/lineage/{guid}/next": { "get": { - "tags": [ - "Type" - ], - "description": "Get the term template definition by its name (unique).", - "operationId": "Type_GetTermTemplateDefByName", - "x-ms-examples": { - "Type_GetTermTemplateDefByName": { - "$ref": "./examples/Type_GetTermTemplateDefByName.json" - } - }, + "operationId": "Lineage_GetNextPage", + "description": "Return immediate next page lineage info about entity with pagination", "parameters": [ { - "$ref": "#/parameters/termTemplateDefName" + "$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" }, { - "$ref": "#/parameters/purviewAPIVersion" + "name": "limit", + "in": "query", + "description": "The page size - by default there is no paging.", + "required": false, + "type": "integer", + "format": "int32" } ], "responses": { "200": { - "description": "OK. On successful lookup of the the term template definition by its name.", + "description": "The request has succeeded.", "schema": { - "$ref": "#/definitions/TermTemplateDef" + "$ref": "#/definitions/AtlasLineageInfo" } }, "default": { - "description": "Error response describing why the operation failed.", + "description": "An unexpected error response.", "schema": { - "$ref": "#/definitions/ErrorResponse" + "$ref": "#/definitions/AtlasErrorResponse" } } + }, + "x-ms-examples": { + "Lineage_GetNextPage": { + "$ref": "./examples/Lineage_GetNextPage.json" + } } } - } - }, - "definitions": { - "AtlasAttributeDef": { - "type": "object", - "properties": { - "cardinality": { - "$ref": "#/definitions/Cardinality" - }, - "constraints": { - "type": "array", - "description": "An array of constraints.", - "items": { - "$ref": "#/definitions/AtlasConstraintDef" + }, + "/search/autocomplete": { + "post": { + "operationId": "Discovery_AutoComplete", + "description": "Get auto complete options.", + "parameters": [ + { + "$ref": "#/parameters/Azure.Core.Foundations.ApiVersionParameter" + }, + { + "name": "body", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/AutoCompleteOptions" + } } - }, - "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" + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/AutoCompleteResult" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/AtlasErrorResponse" + } } }, - "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." - } - }, - "title": "AtlasAttributeDef", - "description": "class that captures details of a struct-attribute." - }, - "AtlasBaseModelObject": { - "type": "object", - "properties": { - "guid": { - "type": "string", - "description": "The GUID of the object." + "x-ms-examples": { + "Discovery_AutoComplete": { + "$ref": "./examples/Discovery_AutoComplete.json" + } } - }, - "title": "AtlasBaseModelObject", - "description": "The base model object." + } }, - "AtlasBaseTypeDef": { - "type": "object", - "properties": { - "category": { - "$ref": "#/definitions/TypeCategory" - }, - "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": { - "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" + "/search/query": { + "post": { + "operationId": "Discovery_Query", + "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" + } } }, - "serviceType": { - "readOnly": false, - "description": "The service type.", - "type": "string" - }, - "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": "number", - "description": "The version of the record." - }, - "lastModifiedTS": { - "$ref": "#/definitions/LastModifiedTS" - } - }, - "title": "AtlasBaseTypeDef", - "description": "Base class that captures common-attributes for all types." - }, - "AtlasBusinessMetadataDef": { - "type": "object", - "title": "AtlasBusinessMetadataDef", - "allOf": [ - { - "$ref": "#/definitions/AtlasStructDef" + "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" + } } - ], - "description": "class that captures details of a struct-type." + } }, - "AtlasClassification": { - "type": "object", - "title": "AtlasClassification", - "properties": { - "entityGuid": { - "type": "string", - "description": "The GUID of the entity." - }, - "entityStatus": { - "$ref": "#/definitions/Status" - }, - "removePropagationsOnEntityDelete": { - "type": "boolean", - "description": "Determines if propagations will be removed on entity deletion." + "/search/suggest": { + "post": { + "operationId": "Discovery_Suggest", + "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" + } + } }, - "validityPeriods": { - "type": "array", - "description": "An array of time boundaries indicating validity periods.", - "items": { - "$ref": "#/definitions/TimeBoundary" + "x-ms-examples": { + "Discovery_Suggest": { + "$ref": "./examples/Discovery_Suggest.json" } } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasStruct" - } - ], - "description": "An instance of a classification; it doesn't have an identity, this object exists only when associated with an entity." + } }, - "AtlasClassificationDef": { - "type": "object", - "title": "AtlasClassificationDef", - "properties": { - "entityTypes": { - "type": "array", - "description": "Specifying a list of entityType names in the classificationDef, ensures that classifications can\nonly be applied to those entityTypes.\n
    \n
  • Any subtypes of the entity types inherit the restriction
  • \n
  • Any classificationDef subtypes inherit the parents entityTypes restrictions
  • \n
  • Any classificationDef subtypes can further restrict the parents entityTypes restrictions by specifying a subset of the entityTypes
  • \n
  • An empty entityTypes list when there are no parent restrictions means there are no restrictions
  • \n
  • An empty entityTypes list when there are parent restrictions means that the subtype picks up the parents restrictions
  • \n
  • If a list of entityTypes are supplied, where one inherits from another, this will be rejected. This should encourage cleaner classificationsDefs
  • \n
", - "items": { + "/types/termtemplatedef/guid/{guid}": { + "get": { + "operationId": "Type_GetTermTemplateDefByGuid", + "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" } - }, - "subTypes": { - "type": "array", - "description": "An array of sub types.", - "items": { - "type": "string" + ], + "responses": { + "200": { + "description": "The request has succeeded.", + "schema": { + "$ref": "#/definitions/TermTemplateDef" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "#/definitions/AtlasErrorResponse" + } } }, - "superTypes": { - "type": "array", - "description": "An array of super types.", - "items": { - "type": "string" + "x-ms-examples": { + "Type_GetTermTemplateDefByGuid": { + "$ref": "./examples/Type_GetTermTemplateDefByGuid.json" } } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasStructDef" - } - ], - "description": "class that captures details of a classification-type." - }, - "AtlasClassifications": { - "type": "object", - "title": "AtlasClassifications", - "allOf": [ - { - "$ref": "#/definitions/PList" - } - ], - "description": "REST serialization friendly list." + } }, - "AtlasConstraintDef": { - "type": "object", - "properties": { - "params": { - "type": "object", - "description": "The parameters of the constraint definition.", - "additionalProperties": {} + "/types/termtemplatedef/name/{name}": { + "get": { + "operationId": "Type_GetTermTemplateDefByName", + "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" + } + } }, - "type": { - "type": "string", - "description": "The type of the constraint." - } - }, - "title": "AtlasConstraintDef", - "description": "class that captures details of a constraint." - }, - "AtlasEntitiesWithExtInfo": { - "type": "object", - "title": "AtlasEntitiesWithExtInfo", - "properties": { - "entities": { - "type": "array", - "description": "An array of entities.", - "items": { - "$ref": "#/definitions/AtlasEntity" + "x-ms-examples": { + "Type_GetTermTemplateDefByName": { + "$ref": "./examples/Type_GetTermTemplateDefByName.json" } } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasEntityExtInfo" - } - ], - "description": "An instance of an entity along with extended info - like hive_table, hive_database." - }, - "AtlasEntity": { + } + } + }, + "definitions": { + "AtlasAttributeDef": { "type": "object", - "title": "AtlasEntity", + "description": "class that captures details of a struct-attribute.", "properties": { - "businessAttributes": { - "readOnly": false, - "description": "Business Attributes", - "type": "object", - "additionalProperties": { - "type": "object" - } + "cardinality": { + "$ref": "#/definitions/CardinalityValue", + "description": "single-valued attribute or multi-valued attribute." }, - "classifications": { + "constraints": { "type": "array", - "description": "An array of classifications.", + "description": "An array of constraints.", "items": { - "$ref": "#/definitions/AtlasClassification" - } - }, - "createTime": { - "type": "integer", - "format": "int64", - "description": "The created time of the record." + "$ref": "#/definitions/AtlasConstraintDef" + }, + "x-ms-identifiers": [] }, - "createdBy": { + "defaultValue": { "type": "string", - "description": "The user who created the record." + "description": "The default value of the attribute." }, - "customAttributes": { - "readOnly": false, - "description": "Custom 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" } }, - "guid": { + "typeName": { "type": "string", - "description": "The GUID of the entity." + "description": "The name of the type." }, - "homeId": { + "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 home ID of the entity." + "description": "The user who created the record." }, - "collectionId": { - "readOnly": true, + "dateFormatter": { + "$ref": "#/definitions/DateFormat", + "description": "The date format." + }, + "description": { "type": "string", - "description": "The collection ID of the entity." + "description": "The description of the type definition." }, - "isIncomplete": { - "readOnly": false, - "description": "Whether it is a shell entity", - "type": "boolean" + "guid": { + "type": "string", + "description": "The GUID of the type definition." }, - "labels": { - "readOnly": false, - "description": "labels", - "type": "array", - "items": { + "name": { + "type": "string", + "description": "The name of the type definition." + }, + "options": { + "type": "object", + "description": "The options for the type definition.", + "additionalProperties": { "type": "string" } }, - "meanings": { + "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 term assignment headers indicating the meanings of the entity.", + "description": "An array of attribute definitions.", "items": { - "$ref": "#/definitions/AtlasTermAssignmentHeader" - } + "$ref": "#/definitions/AtlasAttributeDef" + }, + "x-ms-identifiers": [] + } + } + }, + "AtlasClassification": { + "type": "object", + "description": "An instance of a classification; it doesn't have an identity, this object\nexists only when associated with an entity.", + "properties": { + "attributes": { + "type": "object", + "description": "The attributes of the struct.", + "additionalProperties": {} }, - "provenanceType": { - "readOnly": false, - "description": "Used to record the provenance of an instance of an entity or relationship.", - "type": "number" + "typeName": { + "type": "string", + "description": "The name of the type." }, - "proxy": { + "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\nremoved." + }, + "removePropagationsOnEntityDelete": { "type": "boolean", - "description": "Determines if there's a proxy." + "description": "Determines if propagations will be removed on entity deletion." }, - "relationshipAttributes": { + "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 attributes of relationship.", - "additionalProperties": {} + "description": "The options for the type definition.", + "additionalProperties": { + "type": "string" + } }, - "status": { - "$ref": "#/definitions/Status" + "serviceType": { + "type": "string", + "description": "The service type." + }, + "typeVersion": { + "type": "string", + "description": "The version of the type." }, "updateTime": { "type": "integer", @@ -4362,41 +4746,29 @@ "description": "The user who updated the record." }, "version": { - "type": "number", - "description": "The version of the entity." + "type": "integer", + "format": "int64", + "description": "The version of the record." }, - "contacts": { - "type": "object", - "description": "The dictionary of contacts for entities. Key could be Expert or Owner.", - "additionalProperties": { - "type": "array", - "items": { - "$ref": "#/definitions/ContactBasic" - } + "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\nclassifications can\nonly be applied to those entityTypes.\n\nAny subtypes of the entity types inherit the restriction.\n\nAny classificationDef subtypes inherit the parents entityTypes restrictions.\n\nAny classificationDef subtypes can further restrict the parents entityTypes\nrestrictions by specifying a subset of the entityTypes.\n\nAn empty entityTypes list when there are no parent restrictions means there are no\nrestrictions.\n\nAn empty entityTypes list when there are parent\nrestrictions means that the subtype picks up the parents\nrestrictions.\n\nIf a list of entityTypes are supplied, where one inherits\nfrom another, this will be rejected. This should encourage cleaner\nclassificationsDefs.\n", + "items": { + "type": "string" } - } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasStruct" - } - ], - "description": "An instance of an entity - like hive_table, hive_database." - }, - "TermTemplateDef": { - "type": "object", - "title": "TermTemplateDef", - "allOf": [ - { - "$ref": "#/definitions/AtlasStructDef" - } - ], - "description": "term template definition for glossary term." - }, - "AtlasEntityDef": { - "type": "object", - "title": "AtlasEntityDef", - "properties": { + }, "subTypes": { "type": "array", "description": "An array of sub types.", @@ -4410,244 +4782,174 @@ "items": { "type": "string" } - }, - "relationshipAttributeDefs": { - "type": "array", - "description": "An array of relationship attributes.", - "items": { - "$ref": "#/definitions/AtlasRelationshipAttributeDef" - } - } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasStructDef" - } - ], - "description": "class that captures details of a entity-type." - }, - "AtlasEntityExtInfo": { - "type": "object", - "properties": { - "referredEntities": { - "type": "object", - "description": "The referred entities.", - "additionalProperties": { - "$ref": "#/definitions/AtlasEntity" - } } - }, - "title": "AtlasEntityExtInfo", - "description": "An instance of an entity along with extended info - like hive_table, hive_database." + } }, - "AtlasEntityHeader": { + "AtlasClassifications": { "type": "object", - "title": "AtlasEntityHeader", + "description": "REST serialization friendly list.", "properties": { - "classificationNames": { + "list": { "type": "array", - "description": "An array of classification names.", - "items": { - "type": "string" - } - }, - "classifications": { - "type": "array", - "description": "An array of classifications.", - "items": { - "$ref": "#/definitions/AtlasClassification" - } + "description": "An array of objects.", + "items": {} }, - "displayText": { - "type": "string", - "description": "The display text." + "pageSize": { + "type": "integer", + "format": "int32", + "description": "The size of the page." }, - "guid": { + "sortBy": { "type": "string", - "description": "The GUID of the record." - }, - "isIncomplete": { - "readOnly": false, - "description": "Whether it is a shell entity", - "type": "boolean" - }, - "labels": { - "readOnly": false, - "description": "labels", - "type": "array", - "items": { - "type": "string" - } + "description": "The sorted by field." }, - "meaningNames": { - "type": "array", - "description": "An array of meanings.", - "items": { - "type": "string" - } + "sortType": { + "$ref": "#/definitions/SortType", + "description": "to specify whether the result should be sorted? If yes, whether asc or desc." }, - "meanings": { - "type": "array", - "description": "An array of term assignment headers.", - "items": { - "$ref": "#/definitions/AtlasTermAssignmentHeader" - } + "startIndex": { + "type": "integer", + "format": "int32", + "description": "The start index of the page." }, - "status": { - "$ref": "#/definitions/Status" - } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasStruct" + "totalCount": { + "type": "integer", + "format": "int32", + "description": "The total count of items." } - ], - "description": "An instance of an entity - like hive_table, hive_database." + } }, - "AtlasEntityHeaders": { + "AtlasConstraintDef": { "type": "object", - "title": "AtlasEntityHeaders", + "description": "class that captures details of a constraint.", "properties": { - "guidHeaderMap": { - "readOnly": false, - "description": "The description of the guid header map,", + "params": { "type": "object", - "additionalProperties": { - "$ref": "#/definitions/AtlasEntityHeader" - } - } - }, - "description": "An instance of an entity header map." - }, - "AtlasEntityWithExtInfo": { - "type": "object", - "title": "AtlasEntityWithExtInfo", - "properties": { - "entity": { - "$ref": "#/definitions/AtlasEntity" - } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasEntityExtInfo" + "description": "The parameters of the constraint definition.", + "additionalProperties": {} + }, + "type": { + "type": "string", + "description": "The type of the constraint." } - ], - "description": "An instance of an entity along with extended info - like hive_table, hive_database." + } }, - "AtlasEnumDef": { + "AtlasEntitiesWithExtInfo": { "type": "object", - "title": "AtlasEnumDef", + "description": "An instance of an entity along with extended info - like hive_table,\nhive_database.", "properties": { - "defaultValue": { - "type": "string", - "description": "The default value." + "referredEntities": { + "type": "object", + "description": "The referred entities.", + "additionalProperties": { + "$ref": "#/definitions/AtlasEntity" + } }, - "elementDefs": { + "entities": { "type": "array", - "description": "An array of enum element definitions.", + "description": "An array of entities.", "items": { - "$ref": "#/definitions/AtlasEnumElementDef" - } - } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasBaseTypeDef" + "$ref": "#/definitions/AtlasEntity" + }, + "x-ms-identifiers": [] } - ], - "description": "class that captures details of an enum-type." + } }, - "AtlasEnumElementDef": { + "AtlasEntity": { "type": "object", + "description": "An instance of an entity - like hive_table, hive_database.", "properties": { - "description": { - "type": "string", - "description": "The description of the enum element definition." - }, - "ordinal": { - "type": "number", - "description": "The ordinal of the enum element definition." + "attributes": { + "type": "object", + "description": "The attributes of the struct.", + "additionalProperties": {} }, - "value": { + "typeName": { "type": "string", - "description": "The value of the enum element definition." - } - }, - "title": "AtlasEnumElementDef", - "description": "class that captures details of an enum-element." - }, - "AtlasGlossary": { - "type": "object", - "title": "AtlasGlossary", - "properties": { - "categories": { - "type": "array", - "description": "An array of categories.", - "items": { - "$ref": "#/definitions/AtlasRelatedCategoryHeader" - } + "description": "The name of the type." }, - "language": { + "lastModifiedTS": { "type": "string", - "description": "The language of the glossary." + "description": "ETag for concurrency control." }, - "terms": { - "type": "array", - "description": "An array of related term headers.", - "items": { - "$ref": "#/definitions/AtlasRelatedTermHeader" - } + "businessAttributes": { + "type": "object", + "description": "Business attributes", + "additionalProperties": {} }, - "usage": { - "type": "string", - "description": "The usage of the glossary." - } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasGlossaryBaseObject" - } - ], - "description": "The glossary object." - }, - "AtlasGlossaryBaseObject": { - "type": "object", - "title": "AtlasGlossaryBaseObject", - "properties": { "classifications": { "type": "array", "description": "An array of classifications.", "items": { "$ref": "#/definitions/AtlasClassification" - } + }, + "x-ms-identifiers": [] }, - "longDescription": { + "createTime": { + "type": "integer", + "format": "int64", + "description": "The created time of the record." + }, + "createdBy": { "type": "string", - "description": "The long version description." + "description": "The user who created the record." }, - "name": { + "customAttributes": { + "type": "object", + "description": "Custom Attribute", + "additionalProperties": { + "type": "string" + } + }, + "guid": { "type": "string", - "description": "The name of the glossary object." + "description": "The GUID of the entity." }, - "qualifiedName": { + "homeId": { "type": "string", - "description": "The qualified name of the glossary object." + "description": "The home ID of the entity." }, - "shortDescription": { + "collectionId": { "type": "string", - "description": "The short version of description." + "description": "The collection ID of the entity.", + "readOnly": true }, - "lastModifiedTS": { - "$ref": "#/definitions/LastModifiedTS" + "isIncomplete": { + "type": "boolean", + "description": "Whether it is a shell entity" }, - "createTime": { + "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": "int64", - "description": "The created time of the record." + "format": "int32", + "description": "Used to record the provenance of an instance of an entity or relationship." }, - "createdBy": { - "type": "string", - "description": "The user who created the record." + "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\nremoved." }, "updateTime": { "type": "integer", @@ -4657,533 +4959,377 @@ "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" + } } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasBaseModelObject" - } - ], - "description": "The glossary base object." + } }, - "AtlasGlossaryCategory": { + "AtlasEntityDef": { "type": "object", - "title": "AtlasGlossaryCategory", + "description": "class that captures details of a entity-type.", "properties": { - "anchor": { - "$ref": "#/definitions/AtlasGlossaryHeader" + "category": { + "$ref": "#/definitions/TypeCategory", + "description": "The enum of type category." }, - "childrenCategories": { - "type": "array", - "description": "An array of children categories.", - "items": { - "$ref": "#/definitions/AtlasRelatedCategoryHeader" - } + "createTime": { + "type": "integer", + "format": "int64", + "description": "The created time of the record." }, - "parentCategory": { - "$ref": "#/definitions/AtlasRelatedCategoryHeader" + "createdBy": { + "type": "string", + "description": "The user who created the record." }, - "terms": { - "type": "array", - "description": "An array of related term headers.", - "items": { - "$ref": "#/definitions/AtlasRelatedTermHeader" - } - } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasGlossaryBaseObject" - } - ], - "description": "The glossary category." - }, - "AtlasGlossaryExtInfo": { - "type": "object", - "title": "AtlasGlossaryExtInfo", - "properties": { - "categoryInfo": { - "type": "object", - "description": "The glossary category information.", - "additionalProperties": { - "$ref": "#/definitions/AtlasGlossaryCategory" - } + "dateFormatter": { + "$ref": "#/definitions/DateFormat", + "description": "The date format." }, - "termInfo": { - "type": "object", - "description": "The glossary term information.", - "additionalProperties": { - "$ref": "#/definitions/AtlasGlossaryTerm" - } - } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasGlossary" - } - ], - "description": "The extended information of glossary." - }, - "AtlasGlossaryHeader": { - "type": "object", - "properties": { - "displayText": { + "description": { "type": "string", - "description": "The display text." + "description": "The description of the type definition." }, - "glossaryGuid": { + "guid": { "type": "string", - "description": "The GUID of the glossary." + "description": "The GUID of the type definition." }, - "relationGuid": { - "type": "string", - "description": "The GUID of the relationship." - } - }, - "title": "AtlasGlossaryHeader", - "description": "The glossary header with basic information." - }, - "AtlasGlossaryTerm": { - "type": "object", - "title": "AtlasGlossaryTerm", - "properties": { - "abbreviation": { + "name": { "type": "string", - "description": "The abbreviation of the term." - }, - "templateName": { - "type": "array", - "items": { - "type": "object" - } - }, - "anchor": { - "$ref": "#/definitions/AtlasGlossaryHeader" + "description": "The name of the type definition." }, - "antonyms": { - "type": "array", - "description": "An array of related term headers as antonyms.", - "items": { - "$ref": "#/definitions/AtlasRelatedTermHeader" + "options": { + "type": "object", + "description": "The options for the type definition.", + "additionalProperties": { + "type": "string" } }, - "status": { - "$ref": "#/definitions/TermStatus" - }, - "nickName": { + "serviceType": { "type": "string", - "description": "The nick name of the term." + "description": "The service type." }, - "hierarchyInfo": { - "type": "array", - "description": "The hierarchy information of the term.", - "items": { - "$ref": "#/definitions/PurviewObjectId" - } + "typeVersion": { + "type": "string", + "description": "The version of the type." }, - "resources": { - "type": "array", - "description": "An array of resource link for term", - "items": { - "$ref": "#/definitions/ResourceLink" - } + "updateTime": { + "type": "integer", + "format": "int64", + "description": "The update time of the record." }, - "contacts": { - "type": "object", - "description": "The dictionary of contacts for terms. Key could be Expert or Steward.", - "additionalProperties": { - "type": "array", - "items": { - "$ref": "#/definitions/ContactBasic" - } - } + "updatedBy": { + "type": "string", + "description": "The user who updated the record." }, - "attributes": { - "$ref": "#/definitions/TermCustomAttributes" + "version": { + "type": "integer", + "format": "int64", + "description": "The version of the record." }, - "assignedEntities": { - "type": "array", - "description": "An array of related object IDs.", - "items": { - "$ref": "#/definitions/AtlasRelatedObjectId" - } + "lastModifiedTS": { + "type": "string", + "description": "ETag for concurrency control." }, - "categories": { + "attributeDefs": { "type": "array", - "description": "An array of term categorization headers.", + "description": "An array of attribute definitions.", "items": { - "$ref": "#/definitions/AtlasTermCategorizationHeader" - } + "$ref": "#/definitions/AtlasAttributeDef" + }, + "x-ms-identifiers": [] }, - "classifies": { + "subTypes": { "type": "array", - "description": "An array of related term headers.", + "description": "An array of sub types.", "items": { - "$ref": "#/definitions/AtlasRelatedTermHeader" + "type": "string" } }, - "examples": { + "superTypes": { "type": "array", - "description": "An array of examples.", + "description": "An array of super types.", "items": { "type": "string" } }, - "isA": { + "relationshipAttributeDefs": { "type": "array", - "description": "An array of related term headers indicating the is-a relationship.", + "description": "An array of relationship attributes.", "items": { - "$ref": "#/definitions/AtlasRelatedTermHeader" - } + "$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": {} }, - "preferredTerms": { - "type": "array", - "description": "An array of preferred related term headers.", - "items": { - "$ref": "#/definitions/AtlasRelatedTermHeader" - } + "typeName": { + "type": "string", + "description": "The name of the type." }, - "preferredToTerms": { - "type": "array", - "description": "An array of related term headers that are preferred to.", - "items": { - "$ref": "#/definitions/AtlasRelatedTermHeader" - } + "lastModifiedTS": { + "type": "string", + "description": "ETag for concurrency control." }, - "replacedBy": { + "classificationNames": { "type": "array", - "description": "An array of related term headers that are replaced by.", + "description": "An array of classification names.", "items": { - "$ref": "#/definitions/AtlasRelatedTermHeader" + "type": "string" } }, - "replacementTerms": { + "classifications": { "type": "array", - "description": "An array of related term headers for replacement.", + "description": "An array of classifications.", "items": { - "$ref": "#/definitions/AtlasRelatedTermHeader" - } + "$ref": "#/definitions/AtlasClassification" + }, + "x-ms-identifiers": [] }, - "seeAlso": { - "type": "array", - "description": "An array of related term headers for see also.", - "items": { - "$ref": "#/definitions/AtlasRelatedTermHeader" - } + "displayText": { + "type": "string", + "description": "The display text." }, - "synonyms": { - "type": "array", - "description": "An array of related term headers as synonyms.", - "items": { - "$ref": "#/definitions/AtlasRelatedTermHeader" - } + "guid": { + "type": "string", + "description": "The GUID of the record." }, - "translatedTerms": { - "type": "array", - "description": "An array of translated related term headers.", - "items": { - "$ref": "#/definitions/AtlasRelatedTermHeader" - } + "isIncomplete": { + "type": "boolean", + "description": "Whether it is a shell entity" }, - "translationTerms": { + "labels": { "type": "array", - "description": "An array of related term headers for translation.", + "description": "labels", "items": { - "$ref": "#/definitions/AtlasRelatedTermHeader" + "type": "string" } }, - "usage": { - "type": "string", - "description": "The usage of the term." - }, - "validValues": { + "meaningNames": { "type": "array", - "description": "An array of related term headers as valid values.", + "description": "An array of meanings.", "items": { - "$ref": "#/definitions/AtlasRelatedTermHeader" + "type": "string" } }, - "validValuesFor": { + "meanings": { "type": "array", - "description": "An array of related term headers as valid values for other records.", + "description": "An array of term assignment headers.", "items": { - "$ref": "#/definitions/AtlasRelatedTermHeader" - } - } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasGlossaryBaseObject" - } - ], - "description": "The glossary term." - }, - "ResourceLink": { - "title": "ResourceLink", - "type": "object", - "properties": { - "displayName": { - "type": "string", - "description": "Display name for url." + "$ref": "#/definitions/AtlasTermAssignmentHeader" + }, + "x-ms-identifiers": [] }, - "url": { - "type": "string", - "description": "web url. http or https" + "status": { + "$ref": "#/definitions/EntityStatus", + "description": "Status of the entity - can be active or deleted. Deleted entities are not\nremoved." } } }, - "ContactBasic": { - "title": "ContactBasic", + "AtlasEntityHeaders": { "type": "object", + "description": "An instance of an entity header map.", "properties": { - "id": { - "type": "string", - "description": "Azure Active Directory object Id." - }, - "info": { - "type": "string", - "description": "additional information to describe this contact." + "guidHeaderMap": { + "type": "object", + "description": "The description of the guid header map,", + "additionalProperties": { + "$ref": "#/definitions/AtlasEntityHeader" + } } } }, - "TermStatus": { - "type": "string", - "title": "Status", - "description": "Status of the AtlasGlossaryTerm", - "enum": [ - "Draft", - "Approved", - "Alert", - "Expired" - ], - "x-ms-enum": { - "name": "TermStatus", - "modelAsString": true - } - }, - "TermCustomAttributes": { - "title": "attributes", - "description": "The custom attributes of the term, which is map>.\nThe key of the first layer map is term template name.", - "type": "object", - "additionalProperties": { - "$ref": "#/definitions/TermCustomAttributesExtraProperties" - } - }, - "TermCustomAttributesExtraProperties": { - "type": "object", - "description": "The term attribute name and attribute value, which is map", - "additionalProperties": { - "description": "The value of custom term attribute" - } - }, - "AtlasLineageInfo": { + "AtlasEntityWithExtInfo": { "type": "object", + "description": "An instance of an entity along with extended info - like hive_table,\nhive_database.", "properties": { - "baseEntityGuid": { - "type": "string", - "description": "The GUID of the base entity." - }, - "guidEntityMap": { - "type": "object", - "description": "The GUID entity map.", - "additionalProperties": { - "$ref": "#/definitions/AtlasEntityHeader" - } - }, - "widthCounts": { + "referredEntities": { "type": "object", - "description": "The entity count in specific direction.", + "description": "The referred entities.", "additionalProperties": { - "$ref": "#/definitions/AtlasLineageInfoExtraProperties" + "$ref": "#/definitions/AtlasEntity" } }, - "lineageDepth": { - "type": "integer", - "format": "int32", - "description": "The depth of lineage." + "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." }, - "lineageWidth": { + "createTime": { "type": "integer", - "format": "int32", - "description": "The width of lineage." + "format": "int64", + "description": "The created time of the record." }, - "childrenCount": { - "type": "integer", - "format": "int32", - "description": "The number of children node." + "createdBy": { + "type": "string", + "description": "The user who created the record." }, - "lineageDirection": { - "$ref": "#/definitions/LineageDirection" + "dateFormatter": { + "$ref": "#/definitions/DateFormat", + "description": "The date format." }, - "parentRelations": { - "type": "array", - "description": "An array of parentRelations relations.", - "items": { - "$ref": "#/definitions/ParentRelation" - } + "description": { + "type": "string", + "description": "The description of the type definition." }, - "relations": { - "type": "array", - "description": "An array of lineage relations.", - "items": { - "$ref": "#/definitions/LineageRelation" - } - } - }, - "title": "AtlasLineageInfo", - "description": "The lineage information." - }, - "AtlasLineageInfoExtraProperties": { - "type": "object", - "description": "The lineage direction", - "additionalProperties": { - "description": "The entity guid." - } - }, - "AtlasObjectId": { - "type": "object", - "properties": { "guid": { "type": "string", - "description": "The GUID of the object." + "description": "The GUID of the type definition." }, - "typeName": { + "name": { "type": "string", - "description": "The name of the type." + "description": "The name of the type definition." }, - "uniqueAttributes": { + "options": { "type": "object", - "description": "The unique attributes of the object.", - "additionalProperties": {} - } - }, - "title": "AtlasObjectId", - "description": "Reference to an object-instance of a type - like entity." - }, - "PurviewObjectId": { - "type": "object", - "properties": { - "name": { - "type": "string" + "description": "The options for the type definition.", + "additionalProperties": { + "type": "string" + } }, - "displayText": { - "type": "string" + "serviceType": { + "type": "string", + "description": "The service type." }, - "itemPath": { - "type": "string" + "typeVersion": { + "type": "string", + "description": "The version of the type." }, - "resourceId": { - "type": "string" + "updateTime": { + "type": "integer", + "format": "int64", + "description": "The update time of the record." }, - "properties": { - "type": "object", - "additionalProperties": {} - } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasObjectId" - } - ], - "title": "PurviewObjectId" - }, - "AtlasRelatedCategoryHeader": { - "type": "object", - "properties": { - "categoryGuid": { + "updatedBy": { "type": "string", - "description": "The GUID of the category." + "description": "The user who updated the record." }, - "description": { - "type": "string", - "description": "The description of the category header." + "version": { + "type": "integer", + "format": "int64", + "description": "The version of the record." }, - "displayText": { + "lastModifiedTS": { "type": "string", - "description": "The display text." + "description": "ETag for concurrency control." }, - "parentCategoryGuid": { + "defaultValue": { "type": "string", - "description": "The GUID of the parent category." + "description": "The default value." }, - "relationGuid": { - "type": "string", - "description": "The GUID of the relationship." + "elementDefs": { + "type": "array", + "description": "An array of enum element definitions.", + "items": { + "$ref": "#/definitions/AtlasEnumElementDef" + }, + "x-ms-identifiers": [] } - }, - "title": "AtlasRelatedCategoryHeader", - "description": "The header of the related category." + } }, - "AtlasRelatedObjectId": { + "AtlasEnumElementDef": { "type": "object", - "title": "AtlasRelatedObjectId", + "description": "class that captures details of an enum-element.", "properties": { - "displayText": { + "description": { "type": "string", - "description": "The display text." - }, - "entityStatus": { - "$ref": "#/definitions/Status" + "description": "The description of the enum element definition." }, - "relationshipType": { - "type": "string" + "ordinal": { + "type": "integer", + "format": "int32", + "description": "The ordinal of the enum element definition." }, - "relationshipAttributes": { - "$ref": "#/definitions/AtlasStruct" + "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." }, - "relationshipGuid": { + "errorCode": { "type": "string", - "description": "The GUID of the relationship." + "description": "The error code." }, - "relationshipStatus": { - "$ref": "#/definitions/Status_AtlasRelationship" - } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasObjectId" + "errorMessage": { + "type": "string", + "description": "The error message." } - ], - "description": "Reference to an object-instance of AtlasEntity type used in relationship attribute values" + } }, - "AtlasRelatedTermHeader": { + "AtlasGlossary": { "type": "object", + "description": "The glossary object.", "properties": { - "description": { + "guid": { "type": "string", - "description": "The description of the related term." + "description": "The GUID of the object." }, - "displayText": { - "type": "string", - "description": "The display text." + "classifications": { + "type": "array", + "description": "An array of classifications.", + "items": { + "$ref": "#/definitions/AtlasClassification" + }, + "x-ms-identifiers": [] }, - "expression": { + "longDescription": { "type": "string", - "description": "The expression of the term." + "description": "The long version description." }, - "relationGuid": { + "name": { "type": "string", - "description": "The GUID of the relationship." + "description": "The name of the glossary object." }, - "status": { - "$ref": "#/definitions/AtlasTermRelationshipStatus" + "qualifiedName": { + "type": "string", + "description": "The qualified name of the glossary object." }, - "steward": { + "shortDescription": { "type": "string", - "description": "The steward of the term." + "description": "The short version of description." }, - "termGuid": { + "lastModifiedTS": { "type": "string", - "description": "The GUID of the term." - } - }, - "title": "AtlasRelatedTermHeader", - "description": "The header of the related term." - }, - "AtlasRelationship": { - "type": "object", - "title": "AtlasRelationship", - "properties": { + "description": "ETag for concurrency control." + }, "createTime": { "type": "integer", "format": "int64", @@ -5193,31 +5339,85 @@ "type": "string", "description": "The user who created the record." }, - "end1": { - "$ref": "#/definitions/AtlasObjectId" + "updateTime": { + "type": "integer", + "format": "int64", + "description": "The update time of the record." }, - "end2": { - "$ref": "#/definitions/AtlasObjectId" + "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 relationship." + "description": "The GUID of the object." }, - "homeId": { + "classifications": { + "type": "array", + "description": "An array of classifications.", + "items": { + "$ref": "#/definitions/AtlasClassification" + }, + "x-ms-identifiers": [] + }, + "longDescription": { "type": "string", - "description": "The home ID of the relationship." + "description": "The long version description." }, - "label": { + "name": { "type": "string", - "description": "The label of the relationship." + "description": "The name of the glossary object." }, - "provenanceType": { - "readOnly": false, - "description": "Used to record the provenance of an instance of an entity or relationship", - "type": "number" + "qualifiedName": { + "type": "string", + "description": "The qualified name of the glossary object." }, - "status": { - "$ref": "#/definitions/Status_AtlasRelationship" + "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", @@ -5228,2040 +5428,2803 @@ "type": "string", "description": "The user who updated the record." }, - "version": { - "type": "number", - "description": "The version of the relationship." - } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasStruct" - } - ], - "description": "Atlas relationship instance." - }, - "AtlasRelationshipDef": { - "type": "object", - "title": "AtlasRelationshipDef", - "properties": { - "endDef1": { - "$ref": "#/definitions/AtlasRelationshipEndDef" + "anchor": { + "$ref": "#/definitions/AtlasGlossaryHeader", + "description": "The glossary header with basic information." }, - "endDef2": { - "$ref": "#/definitions/AtlasRelationshipEndDef" + "childrenCategories": { + "type": "array", + "description": "An array of children categories.", + "items": { + "$ref": "#/definitions/AtlasRelatedCategoryHeader" + }, + "x-ms-identifiers": [] }, - "relationshipCategory": { - "$ref": "#/definitions/RelationshipCategory" + "parentCategory": { + "$ref": "#/definitions/AtlasRelatedCategoryHeader", + "description": "The header of the related category." }, - "relationshipLabel": { - "type": "string", - "description": "The label of the relationship." - } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasStructDef" + "terms": { + "type": "array", + "description": "An array of related term headers.", + "items": { + "$ref": "#/definitions/AtlasRelatedTermHeader" + }, + "x-ms-identifiers": [] } - ], - "description": "AtlasRelationshipDef is a TypeDef that defines a relationship.\n

\nAs with other typeDefs the AtlasRelationshipDef has a name. Once created the RelationshipDef has a guid.\nThe name and the guid are the 2 ways that the RelationshipDef is identified.\n

\nRelationshipDefs have 2 ends, each of which specify cardinality, an EntityDef type name and name and optionally\nwhether the end is a container.\n

\nRelationshipDefs can have AttributeDefs - though only primitive types are allowed.
\nRelationshipDefs have a relationshipCategory specifying the UML type of relationship required
\nThe way EntityDefs and RelationshipDefs are intended to be used is that EntityDefs will define AttributeDefs these AttributeDefs\nwill not specify an EntityDef type name as their types.\n

\nRelationshipDefs introduce new attributes to the entity instances. For example\n

\nEntityDef A might have attributes attr1,attr2,attr3
\nEntityDef B might have attributes attr4,attr5,attr6
\nRelationshipDef AtoB might define 2 ends
\n\n

\n   end1:  type A, name attr7\n   end2:  type B, name attr8  
\n\n

\nWhen an instance of EntityDef A is created, it will have attributes attr1,attr2,attr3,attr7
\nWhen an instance of EntityDef B is created, it will have attributes attr4,attr5,attr6,attr8\n

\nIn this way relationshipDefs can be authored separately from entityDefs and can inject relationship attributes into\nthe entity instances" + } }, - "AtlasRelationshipEndDef": { + "AtlasGlossaryExtInfo": { "type": "object", + "description": "The extended information of glossary.", "properties": { - "cardinality": { - "$ref": "#/definitions/Cardinality" - }, - "description": { + "guid": { "type": "string", - "description": "The description of the relationship end definition." + "description": "The GUID of the object." }, - "isContainer": { - "type": "boolean", - "description": "Determines if it is container." + "classifications": { + "type": "array", + "description": "An array of classifications.", + "items": { + "$ref": "#/definitions/AtlasClassification" + }, + "x-ms-identifiers": [] }, - "isLegacyAttribute": { - "type": "boolean", - "description": "Determines if it is a legacy attribute." + "longDescription": { + "type": "string", + "description": "The long version description." }, "name": { "type": "string", - "description": "The name of the relationship end definition." + "description": "The name of the glossary object." }, - "type": { + "qualifiedName": { "type": "string", - "description": "The type of the relationship end." - } - }, - "title": "AtlasRelationshipEndDef", - "description": "The relationshipEndDef represents an end of the relationship. The end of the relationship is defined by a type, an\nattribute name, cardinality and whether it is the container end of the relationship." - }, - "AtlasRelationshipAttributeDef": { - "type": "object", - "properties": { - "isLegacyAttribute": { - "type": "boolean", - "description": "Determines if it is a legacy attribute." + "description": "The qualified name of the glossary object." }, - "relationshipTypeName": { + "shortDescription": { "type": "string", - "description": "The name of the relationship type." - } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasAttributeDef" - } - ], - "title": "AtlasRelationshipEndDef", - "description": "The relationshipEndDef represents an end of the relationship. The end of the relationship is defined by a type, an\nattribute name, cardinality and whether it is the container end of the relationship." - }, - "AtlasRelationshipWithExtInfo": { - "type": "object", - "properties": { - "referredEntities": { - "type": "object", - "description": "The referred entity header.", - "additionalProperties": { - "$ref": "#/definitions/AtlasEntityHeader" - } - }, - "relationship": { - "$ref": "#/definitions/AtlasRelationship" - } - }, - "title": "AtlasRelationshipWithExtInfo", - "description": "The relationship with extended information." - }, - "AtlasStruct": { - "type": "object", - "properties": { - "attributes": { - "type": "object", - "description": "The attributes of the struct.", - "additionalProperties": {} + "description": "The short version of description." }, - "typeName": { + "lastModifiedTS": { "type": "string", - "description": "The name of the type." + "description": "ETag for concurrency control." }, - "lastModifiedTS": { - "$ref": "#/definitions/LastModifiedTS" - } - }, - "title": "AtlasStruct", - "description": "Captures details of struct contents. Not instantiated directly, used only via AtlasEntity, AtlasClassification." - }, - "AtlasStructDef": { - "type": "object", - "title": "AtlasStructDef", - "properties": { - "attributeDefs": { - "type": "array", - "description": "An array of attribute definitions.", - "items": { - "$ref": "#/definitions/AtlasAttributeDef" - } - } - }, - "allOf": [ - { - "$ref": "#/definitions/AtlasBaseTypeDef" - } - ], - "description": "class that captures details of a struct-type." - }, - "AtlasTermAssignmentHeader": { - "type": "object", - "properties": { - "confidence": { + "createTime": { "type": "integer", - "format": "int32", - "description": "The confidence of the term assignment." + "format": "int64", + "description": "The created time of the record." }, "createdBy": { "type": "string", "description": "The user who created the record." }, - "description": { - "type": "string", - "description": "The description of the term assignment." + "updateTime": { + "type": "integer", + "format": "int64", + "description": "The update time of the record." }, - "displayText": { + "updatedBy": { "type": "string", - "description": "The display text." + "description": "The user who updated the record." }, - "expression": { - "type": "string", - "description": "The expression of the term assignment." + "categories": { + "type": "array", + "description": "An array of categories.", + "items": { + "$ref": "#/definitions/AtlasRelatedCategoryHeader" + }, + "x-ms-identifiers": [] }, - "relationGuid": { + "language": { "type": "string", - "description": "The GUID of the relationship." + "description": "The language of the glossary." }, - "status": { - "$ref": "#/definitions/AtlasTermAssignmentStatus" + "terms": { + "type": "array", + "description": "An array of related term headers.", + "items": { + "$ref": "#/definitions/AtlasRelatedTermHeader" + }, + "x-ms-identifiers": [] }, - "steward": { + "usage": { "type": "string", - "description": "The steward of the term." + "description": "The usage of the glossary." }, - "termGuid": { - "type": "string", - "description": "The GUID of the term." + "categoryInfo": { + "type": "object", + "description": "The glossary category information.", + "additionalProperties": { + "$ref": "#/definitions/AtlasGlossaryCategory" + } + }, + "termInfo": { + "type": "object", + "description": "The glossary term information.", + "additionalProperties": { + "$ref": "#/definitions/AtlasGlossaryTerm" + } } - }, - "title": "AtlasTermAssignmentHeader", - "description": "The header for term assignment." + } }, - "AtlasTermAssignmentStatus": { - "type": "string", - "title": "AtlasTermAssignmentStatus", - "description": "The status of terms assignment.", - "enum": [ - "DISCOVERED", - "PROPOSED", - "IMPORTED", - "VALIDATED", - "DEPRECATED", - "OBSOLETE", - "OTHER" - ], - "x-ms-enum": { - "name": "AtlasTermAssignmentStatus", - "modelAsString": true - } - }, - "AtlasTermCategorizationHeader": { + "AtlasGlossaryHeader": { "type": "object", + "description": "The glossary header with basic information.", "properties": { - "categoryGuid": { - "type": "string", - "description": "The GUID of the category." - }, - "description": { - "type": "string", - "description": "The description of the record." - }, "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." - }, - "status": { - "$ref": "#/definitions/AtlasTermRelationshipStatus" } - }, - "title": "AtlasTermCategorizationHeader", - "description": "The basic information for term categorization." - }, - "AtlasTermRelationshipStatus": { - "type": "string", - "title": "AtlasTermRelationshipStatus", - "description": "The status of term relationship.", - "enum": [ - "DRAFT", - "ACTIVE", - "DEPRECATED", - "OBSOLETE", - "OTHER" - ], - "x-ms-enum": { - "name": "AtlasTermRelationshipStatus", - "modelAsString": true } }, - "AtlasTypeDefHeader": { + "AtlasGlossaryTerm": { "type": "object", + "description": "The glossary term.", "properties": { - "category": { - "$ref": "#/definitions/TypeCategory" - }, "guid": { "type": "string", - "description": "The GUID of the type definition." + "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 type definition." - } - }, - "title": "AtlasTypeDefHeader", - "description": "The basic information of the type definition." - }, - "AtlasTypesDef": { - "type": "object", - "properties": { - "businessMetadataDefs": { - "readOnly": false, - "description": "businessMetadataDefs", + "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", - "items": { - "$ref": "#/definitions/AtlasBusinessMetadataDef" - } + "description": "The name of the template.", + "items": {} }, - "classificationDefs": { + "anchor": { + "$ref": "#/definitions/AtlasGlossaryHeader", + "description": "The glossary header with basic information." + }, + "antonyms": { "type": "array", - "description": "An array of classification definitions.", + "description": "An array of related term headers as antonyms.", "items": { - "$ref": "#/definitions/AtlasClassificationDef" - } + "$ref": "#/definitions/AtlasRelatedTermHeader" + }, + "x-ms-identifiers": [] }, - "entityDefs": { + "status": { + "$ref": "#/definitions/TermStatus", + "description": "Status of the AtlasGlossaryTerm" + }, + "nickName": { + "type": "string", + "description": "The nick name of the term." + }, + "hierarchyInfo": { "type": "array", - "description": "An array of entity definitions.", + "description": "The hierarchy information of the term.", "items": { - "$ref": "#/definitions/AtlasEntityDef" - } + "$ref": "#/definitions/PurviewObjectId" + }, + "x-ms-identifiers": [] }, - "enumDefs": { + "resources": { "type": "array", - "description": "An array of enum definitions.", + "description": "An array of resource link for term", "items": { - "$ref": "#/definitions/AtlasEnumDef" + "$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" } }, - "relationshipDefs": { - "type": "array", - "description": "An array of relationship definitions.", - "items": { - "$ref": "#/definitions/AtlasRelationshipDef" + "attributes": { + "type": "object", + "description": "The custom attributes of the term, which is map>.\nThe\nkey of the first layer map is term template name.", + "additionalProperties": { + "additionalProperties": {}, + "type": "object" } }, - "structDefs": { + "assignedEntities": { "type": "array", - "description": "An array of struct definitions.", + "description": "An array of related object IDs.", "items": { - "$ref": "#/definitions/AtlasStructDef" - } + "$ref": "#/definitions/AtlasRelatedObjectId" + }, + "x-ms-identifiers": [] }, - "termTemplateDefs": { + "categories": { "type": "array", - "description": "An array of term template definitions.", + "description": "An array of term categorization headers.", "items": { - "$ref": "#/definitions/TermTemplateDef" - } - } - }, - "title": "AtlasTypesDef", - "description": "The definitions of types." - }, - "AtlasExtraTypeDef": { - "type": "object", - "properties": { - "entityTypes": { + "$ref": "#/definitions/AtlasTermCategorizationHeader" + }, + "x-ms-identifiers": [] + }, + "classifies": { "type": "array", - "description": "Specifying a list of entityType names in the classificationDef, ensures that classifications can\nonly be applied to those entityTypes.\n

    \n
  • Any subtypes of the entity types inherit the restriction
  • \n
  • Any classificationDef subtypes inherit the parents entityTypes restrictions
  • \n
  • Any classificationDef subtypes can further restrict the parents entityTypes restrictions by specifying a subset of the entityTypes
  • \n
  • An empty entityTypes list when there are no parent restrictions means there are no restrictions
  • \n
  • An empty entityTypes list when there are parent restrictions means that the subtype picks up the parents restrictions
  • \n
  • If a list of entityTypes are supplied, where one inherits from another, this will be rejected. This should encourage cleaner classificationsDefs
  • \n
", + "description": "An array of related term headers.", "items": { - "type": "string" - } + "$ref": "#/definitions/AtlasRelatedTermHeader" + }, + "x-ms-identifiers": [] }, - "subTypes": { + "examples": { "type": "array", - "description": "An array of sub types.", + "description": "An array of examples.", "items": { "type": "string" } }, - "superTypes": { + "isA": { "type": "array", - "description": "An array of super types.", + "description": "An array of related term headers indicating the is-a relationship.", "items": { - "type": "string" - } + "$ref": "#/definitions/AtlasRelatedTermHeader" + }, + "x-ms-identifiers": [] }, - "relationshipAttributeDefs": { + "preferredTerms": { "type": "array", - "description": "An array of relationship attributes.", + "description": "An array of preferred related term headers.", "items": { - "$ref": "#/definitions/AtlasRelationshipAttributeDef" - } + "$ref": "#/definitions/AtlasRelatedTermHeader" + }, + "x-ms-identifiers": [] }, - "defaultValue": { - "type": "string", - "description": "The default value." + "preferredToTerms": { + "type": "array", + "description": "An array of related term headers that are preferred to.", + "items": { + "$ref": "#/definitions/AtlasRelatedTermHeader" + }, + "x-ms-identifiers": [] }, - "elementDefs": { + "replacedBy": { "type": "array", - "description": "An array of enum element definitions.", + "description": "An array of related term headers that are replaced by.", "items": { - "$ref": "#/definitions/AtlasEnumElementDef" - } + "$ref": "#/definitions/AtlasRelatedTermHeader" + }, + "x-ms-identifiers": [] }, - "endDef1": { - "$ref": "#/definitions/AtlasRelationshipEndDef" + "replacementTerms": { + "type": "array", + "description": "An array of related term headers for replacement.", + "items": { + "$ref": "#/definitions/AtlasRelatedTermHeader" + }, + "x-ms-identifiers": [] }, - "endDef2": { - "$ref": "#/definitions/AtlasRelationshipEndDef" + "seeAlso": { + "type": "array", + "description": "An array of related term headers for see also.", + "items": { + "$ref": "#/definitions/AtlasRelatedTermHeader" + }, + "x-ms-identifiers": [] }, - "relationshipCategory": { - "$ref": "#/definitions/RelationshipCategory" + "synonyms": { + "type": "array", + "description": "An array of related term headers as synonyms.", + "items": { + "$ref": "#/definitions/AtlasRelatedTermHeader" + }, + "x-ms-identifiers": [] }, - "relationshipLabel": { - "type": "string", - "description": "The label of the relationship." + "translatedTerms": { + "type": "array", + "description": "An array of translated related term headers.", + "items": { + "$ref": "#/definitions/AtlasRelatedTermHeader" + }, + "x-ms-identifiers": [] }, - "attributeDefs": { + "translationTerms": { "type": "array", - "description": "An array of attribute definitions.", + "description": "An array of related term headers for translation.", "items": { - "$ref": "#/definitions/AtlasAttributeDef" - } - } - }, - "title": "AtlasExtraTypeDef", - "description": "Extra properties for a type." - }, - "AtlasTypeDef": { - "type": "object", - "allOf": [ - { - "$ref": "#/definitions/AtlasBaseTypeDef" - }, - { - "$ref": "#/definitions/AtlasExtraTypeDef" - } - ], - "title": "AtlasTypeDef", - "description": "The definitions of type." - }, - "ImportInfo": { - "type": "object", - "title": "ImportInfo", - "properties": { - "childObjectName": { - "readOnly": false, - "description": "childObjectName", - "type": "string" - }, - "importStatus": { - "readOnly": false, - "$ref": "#/definitions/ImportStatus", - "description": "importStatus" - }, - "parentObjectName": { - "readOnly": false, - "description": "parentObjectName", - "type": "string" + "$ref": "#/definitions/AtlasRelatedTermHeader" + }, + "x-ms-identifiers": [] }, - "remarks": { - "readOnly": false, - "description": "remarks", - "type": "string" - } - }, - "example": { - "childObjectName": "...", - "importStatus": "SUCCESS", - "parentObjectName": "...", - "remarks": "..." - }, - "description": "ImportInfo" - }, - "ImportStatus": { - "type": "string", - "title": "ImportStatus", - "enum": [ - "SUCCESS", - "FAILED" - ], - "description": "ImportStatus", - "x-ms-enum": { - "name": "importStatus", - "modelAsString": true - } - }, - "BulkImportResponse": { - "type": "object", - "title": "BulkImportResponse", - "properties": { - "failedImportInfoList": { - "readOnly": false, - "description": "failed importInfoList", - "type": "array", - "items": { - "$ref": "#/definitions/ImportInfo" - } + "usage": { + "type": "string", + "description": "The usage of the term." }, - "successImportInfoList": { - "readOnly": false, - "description": "successful importInfoList", + "validValues": { "type": "array", + "description": "An array of related term headers as valid values.", "items": { - "$ref": "#/definitions/ImportInfo" - } - } - }, - "example": { - "failedImportInfoList": [ - { - "childObjectName": "...", - "importStatus": "SUCCESS", - "parentObjectName": "...", - "remarks": "..." - }, - { - "childObjectName": "...", - "importStatus": "SUCCESS", - "parentObjectName": "...", - "remarks": "..." - } - ], - "successImportInfoList": [ - { - "childObjectName": "...", - "importStatus": "FAILED", - "parentObjectName": "...", - "remarks": "..." + "$ref": "#/definitions/AtlasRelatedTermHeader" }, - { - "childObjectName": "...", - "importStatus": "FAILED", - "parentObjectName": "...", - "remarks": "..." - } - ] - }, - "description": "example" - }, - "Cardinality": { - "type": "string", - "title": "Cardinality", - "description": "single-valued attribute or multi-valued attribute.", - "enum": [ - "SINGLE", - "LIST", - "SET" - ], - "x-ms-enum": { - "name": "Cardinality", - "modelAsString": true - } - }, - "ClassificationAssociateRequest": { - "type": "object", - "properties": { - "classification": { - "$ref": "#/definitions/AtlasClassification" + "x-ms-identifiers": [] }, - "entityGuids": { - "type": "array", - "description": "The GUID of the entity.", - "items": { - "type": "string" - } - } - }, - "title": "ClassificationAssociateRequest", - "description": "The request for classification association." - }, - "MoveEntitiesRequest": { - "type": "object", - "properties": { - "entityGuids": { + "validValuesFor": { "type": "array", - "description": "An array of entity guids to be moved to target collection.", + "description": "An array of related term headers as valid values for other records.", "items": { - "type": "string" - } + "$ref": "#/definitions/AtlasRelatedTermHeader" + }, + "x-ms-identifiers": [] } } }, - "DateFormat": { + "AtlasLineageInfo": { "type": "object", - "title": "DateFormat", + "description": "The lineage information.", "properties": { - "availableLocales": { - "type": "array", - "description": "An array of available locales.", - "items": { - "type": "string" - } - }, - "calendar": { - "type": "number" - }, - "dateInstance": { - "$ref": "#/definitions/DateFormat" - }, - "dateTimeInstance": { - "$ref": "#/definitions/DateFormat" - }, - "instance": { - "$ref": "#/definitions/DateFormat" - }, - "lenient": { - "type": "boolean", - "description": "Determines the leniency of the date format." - }, - "numberFormat": { - "$ref": "#/definitions/NumberFormat" - }, - "timeInstance": { - "$ref": "#/definitions/DateFormat" + "baseEntityGuid": { + "type": "string", + "description": "The GUID of the base entity." }, - "timeZone": { - "$ref": "#/definitions/TimeZone" - } - }, - "description": "The date format." - }, - "EntityMutationResponse": { - "type": "object", - "properties": { - "guidAssignments": { + "guidEntityMap": { "type": "object", - "description": "A map of GUID assignments with entities.", + "description": "The GUID entity map.", "additionalProperties": { - "type": "string" + "$ref": "#/definitions/AtlasEntityHeader" } }, - "mutatedEntities": { + "widthCounts": { "type": "object", - "description": "The entity headers of mutated entities.", + "description": "The entity count in specific direction.", "additionalProperties": { - "type": "array", - "items": { - "$ref": "#/definitions/AtlasEntityHeader" - } + "additionalProperties": {}, + "type": "object" } }, - "partialUpdatedEntities": { + "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 entity headers that partially updated.", + "description": "An array of parentRelations relations.", "items": { - "$ref": "#/definitions/AtlasEntityHeader" - } + "$ref": "#/definitions/ParentRelation" + }, + "x-ms-identifiers": [] + }, + "relations": { + "type": "array", + "description": "An array of lineage relations.", + "items": { + "$ref": "#/definitions/LineageRelation" + }, + "x-ms-identifiers": [] } - }, - "title": "EntityMutationResponse", - "description": "The mutation response of entity." - }, - "LineageDirection": { - "type": "string", - "title": "LineageDirection", - "description": "The enum of lineage direction.", - "enum": [ - "INPUT", - "OUTPUT", - "BOTH" - ], - "x-ms-enum": { - "name": "LineageDirection", - "modelAsString": true } }, - "LineageRelation": { + "AtlasObjectId": { "type": "object", + "description": "Reference to an object-instance of a type - like entity.", "properties": { - "fromEntityId": { + "guid": { "type": "string", - "description": "The GUID of from-entity." + "description": "The GUID of the object." }, - "relationshipId": { + "typeName": { "type": "string", - "description": "The GUID of relationship." + "description": "The name of the type." }, - "toEntityId": { - "type": "string", - "description": "The GUID of to-entity." + "uniqueAttributes": { + "type": "object", + "description": "The unique attributes of the object.", + "additionalProperties": {} } - }, - "title": "LineageRelation", - "description": "The lineage relation with GUID of the from and to entity." + } }, - "ParentRelation": { + "AtlasRelatedCategoryHeader": { "type": "object", + "description": "The header of the related category.", "properties": { - "childEntityId": { + "categoryGuid": { "type": "string", - "description": "The GUID of child entity." + "description": "The GUID of the category." }, - "relationshipId": { + "description": { "type": "string", - "description": "The GUID of relationship." + "description": "The description of the category header." }, - "parentEntityId": { + "displayText": { "type": "string", - "description": "The GUID of parent entity." + "description": "The display text." + }, + "parentCategoryGuid": { + "type": "string", + "description": "The GUID of the parent category." + }, + "relationGuid": { + "type": "string", + "description": "The GUID of the relationship." } - }, - "title": "ParentRelation", - "description": "The lineage parents relation with GUID of the parent entity and to child entity." + } }, - "NumberFormat": { + "AtlasRelatedObjectId": { "type": "object", - "title": "NumberFormat", + "description": "Reference to an object-instance of AtlasEntity type used in relationship\nattribute values", "properties": { - "availableLocales": { - "type": "array", - "description": "The number format.", - "items": { - "type": "string" - } + "guid": { + "type": "string", + "description": "The GUID of the object." }, - "currency": { + "typeName": { "type": "string", - "description": "The currency." + "description": "The name of the type." }, - "currencyInstance": { - "$ref": "#/definitions/NumberFormat" + "uniqueAttributes": { + "type": "object", + "description": "The unique attributes of the object.", + "additionalProperties": {} }, - "groupingUsed": { - "type": "boolean", - "description": "Determines if grouping is used." + "displayText": { + "type": "string", + "description": "The display text." }, - "instance": { - "$ref": "#/definitions/NumberFormat" - }, - "integerInstance": { - "$ref": "#/definitions/NumberFormat" - }, - "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" - }, - "parseIntegerOnly": { - "type": "boolean", - "description": "Determines if only integer is parsed." - }, - "percentInstance": { - "$ref": "#/definitions/NumberFormat" - }, - "roundingMode": { - "$ref": "#/definitions/RoundingMode" - } - }, - "description": "The number format." - }, - "TermGuid": { - "type": "string", - "title": "termGuid", - "description": "The globally unique identifier for glossary term." - }, - "PList": { - "type": "object", - "properties": { - "list": { - "type": "array", - "description": "An array of objects.", - "items": { - "type": "object", - "properties": {} - } - }, - "pageSize": { - "type": "integer", - "format": "int32", - "description": "The size of the page." + "entityStatus": { + "$ref": "#/definitions/EntityStatus", + "description": "Status of the entity - can be active or deleted. Deleted entities are not\nremoved." }, - "sortBy": { + "relationshipType": { "type": "string", - "description": "The sorted by field." + "description": "Relationship type" }, - "sortType": { - "$ref": "#/definitions/SortType" + "relationshipAttributes": { + "$ref": "#/definitions/AtlasStruct", + "description": "Captures details of struct contents. Not instantiated directly, used only via\nAtlasEntity, AtlasClassification." }, - "startIndex": { - "type": "integer", - "format": "int64", - "description": "The start index of the page." + "relationshipGuid": { + "$ref": "#/definitions/Azure.Core.uuid", + "description": "The GUID of the relationship." }, - "totalCount": { - "type": "integer", - "format": "int64", - "description": "The total count of items." + "relationshipStatus": { + "$ref": "#/definitions/StatusAtlasRelationship", + "description": "The enum of relationship status." } - }, - "title": "PList", - "description": "Paginated-list, for returning search results." - }, - "RelationshipCategory": { - "type": "string", - "title": "RelationshipCategory", - "description": "The Relationship category determines the style of relationship around containment and lifecycle.\nUML terminology is used for the values.\n

\nASSOCIATION is a relationship with no containment.
\nCOMPOSITION and AGGREGATION are containment relationships.\n

\nThe difference being in the lifecycles of the container and its children. In the COMPOSITION case,\nthe children cannot exist without the container. For AGGREGATION, the life cycles\nof the container and children are totally independent.", - "enum": [ - "ASSOCIATION", - "AGGREGATION", - "COMPOSITION" - ], - "x-ms-enum": { - "name": "RelationshipCategory", - "modelAsString": true - } - }, - "RoundingMode": { - "type": "string", - "title": "RoundingMode", - "description": "The enum of rounding mode.", - "enum": [ - "UP", - "DOWN", - "CEILING", - "FLOOR", - "HALF_UP", - "HALF_DOWN", - "HALF_EVEN", - "UNNECESSARY" - ], - "x-ms-enum": { - "name": "RoundingMode", - "modelAsString": true - } - }, - "SortType": { - "type": "string", - "title": "SortType", - "description": "to specify whether the result should be sorted? If yes, whether asc or desc.", - "enum": [ - "NONE", - "ASC", - "DESC" - ], - "x-ms-enum": { - "name": "SortType", - "modelAsString": true - } - }, - "Status": { - "type": "string", - "title": "Status", - "description": "Status of the entity - can be active or deleted. Deleted entities are not removed.", - "enum": [ - "ACTIVE", - "DELETED" - ], - "x-ms-enum": { - "name": "Status", - "modelAsString": true - } - }, - "Status_AtlasRelationship": { - "type": "string", - "title": "Status", - "description": "The enum of relationship status.", - "enum": [ - "ACTIVE", - "DELETED" - ], - "x-ms-enum": { - "name": "Status_AtlasRelationship", - "modelAsString": true } }, - "TimeBoundary": { + "AtlasRelatedTermHeader": { "type": "object", + "description": "The header of the related term.", "properties": { - "endTime": { + "description": { "type": "string", - "description": "The end of the time boundary." + "description": "The description of the related term." }, - "startTime": { + "displayText": { "type": "string", - "description": "The start of the time boundary." + "description": "The display text." }, - "timeZone": { + "expression": { "type": "string", - "description": "The timezone of the time boundary." - } - }, - "title": "TimeBoundary", - "description": "Captures time-boundary details" - }, - "TimeZone": { - "type": "object", - "properties": { - "dstSavings": { - "type": "integer", - "format": "int32", - "description": "The value of the daylight saving time." + "description": "The expression of the term." }, - "id": { + "relationGuid": { "type": "string", - "description": "The ID of the timezone." - }, - "availableIds": { - "type": "array", - "description": "An array of available IDs.", - "items": { - "type": "string" - } + "description": "The GUID of the relationship." }, - "default": { - "$ref": "#/definitions/TimeZone" + "status": { + "$ref": "#/definitions/AtlasTermRelationshipStatus", + "description": "The status of term relationship." }, - "displayName": { + "steward": { "type": "string", - "description": "The display name of the timezone." + "description": "The steward of the term." }, - "rawOffset": { - "type": "integer", - "format": "int32", - "description": "The raw offset of the timezone." + "termGuid": { + "type": "string", + "description": "The GUID of the term." } - }, - "title": "TimeZone", - "description": "The timezone information." - }, - "TypeCategory": { - "type": "string", - "title": "TypeCategory", - "description": "The enum of type category.", - "enum": [ - "PRIMITIVE", - "OBJECT_ID_TYPE", - "ENUM", - "STRUCT", - "CLASSIFICATION", - "ENTITY", - "ARRAY", - "MAP", - "RELATIONSHIP", - "TERM_TEMPLATE" - ], - "x-ms-enum": { - "name": "TypeCategory", - "modelAsString": true } }, - "SuggestResult": { - "type": "object", - "properties": { - "value": { - "type": "array", - "items": { - "$ref": "#/definitions/SuggestResultValue" - } - } - }, - "title": "SuggestResult", - "description": "The result item of the search suggest." - }, - "SuggestResultValue": { + "AtlasRelationship": { "type": "object", + "description": "Atlas relationship instance.", "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." + "attributes": { + "type": "object", + "description": "The attributes of the struct.", + "additionalProperties": {} }, - "@search.text": { + "typeName": { "type": "string", - "description": "The target text that contains the keyword as prefix. The keyword is wrapped with emphasis mark." + "description": "The name of the type." }, - "objectType": { + "lastModifiedTS": { "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." + "description": "ETag for concurrency control." }, "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." + "description": "The created time of the record." }, - "id": { + "createdBy": { "type": "string", - "description": "The GUID of the record." + "description": "The user who created the record." }, - "name": { - "type": "string", - "description": "The name of the record." + "end1": { + "$ref": "#/definitions/AtlasObjectId", + "description": "Reference to an object-instance of a type - like entity." }, - "qualifiedName": { - "type": "string", - "description": "The qualified name of the record." + "end2": { + "$ref": "#/definitions/AtlasObjectId", + "description": "Reference to an object-instance of a type - like entity." }, - "entityType": { + "guid": { "type": "string", - "description": "The type name of the asset." + "description": "The GUID of the relationship." }, - "description": { + "homeId": { "type": "string", - "description": "The description of the asset." + "description": "The home ID of the relationship." }, - "endorsement": { + "label": { "type": "string", - "description": "The endorsement of the asset." + "description": "The label of the relationship." }, - "owner": { - "type": "string", - "description": "The owner of the record." + "provenanceType": { + "type": "integer", + "format": "int32", + "description": "Used to record the provenance of an instance of an entity or relationship" }, - "classification": { - "type": "array", - "description": "The classifications of the record.", - "items": { - "type": "string" - } + "status": { + "$ref": "#/definitions/StatusAtlasRelationship", + "description": "The enum of relationship status." }, - "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" - } - }, - "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." - } - }, - "title": "SuggestResultValue", - "description": "The value item of the search suggest." - }, - "SearchResult": { - "type": "object", - "properties": { - "@search.count": { + "updateTime": { "type": "integer", - "format": "int32", - "description": "The total number of search results (not the number of documents in a single page)." - }, - "@search.count.approximate": { - "type": "boolean", - "description": "'True' if the '@search.count' is an approximate value and vise versa." + "format": "int64", + "description": "The update time of the record." }, - "continuationToken": { + "updatedBy": { "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": "The user who updated the record." }, - "value": { - "type": "array", - "items": { - "$ref": "#/definitions/SearchResultValue" - } + "version": { + "type": "integer", + "format": "int64", + "description": "The version of the relationship." } - }, - "title": "SearchResult", - "description": "The result of the search result." + } }, - "SearchFacetResultValue": { + "AtlasRelationshipAttributeDef": { "type": "object", + "description": "The relationshipEndDef represents an end of the relationship. The end of the\nrelationship is defined by a type, an\nattribute name, cardinality and whether\nit is the container end of the relationship.", "properties": { - "entityType": { - "type": "array", - "items": { - "$ref": "#/definitions/SearchFacetItemValue" - } + "cardinality": { + "$ref": "#/definitions/CardinalityValue", + "description": "single-valued attribute or multi-valued attribute." }, - "assetType": { + "constraints": { "type": "array", + "description": "An array of constraints.", "items": { - "$ref": "#/definitions/SearchFacetItemValue" - } + "$ref": "#/definitions/AtlasConstraintDef" + }, + "x-ms-identifiers": [] }, - "classification": { - "type": "array", - "items": { - "$ref": "#/definitions/SearchFacetItemValue" - } + "defaultValue": { + "type": "string", + "description": "The default value of the attribute." }, - "term": { - "type": "array", - "items": { - "$ref": "#/definitions/SearchFacetItemValue" - } + "description": { + "type": "string", + "description": "The description of the attribute." }, - "contactId": { - "type": "array", - "items": { - "$ref": "#/definitions/SearchFacetItemValue" - } + "includeInNotification": { + "type": "boolean", + "description": "Determines if it is included in notification." }, - "contactType": { - "type": "array", - "items": { - "$ref": "#/definitions/SearchFacetItemValue" - } + "isIndexable": { + "type": "boolean", + "description": "Determines if it is indexable." }, - "label": { - "type": "array", - "items": { - "$ref": "#/definitions/SearchFacetItemValue" - } + "isOptional": { + "type": "boolean", + "description": "Determines if it is optional." }, - "glossaryType": { - "type": "array", - "items": { - "$ref": "#/definitions/SearchFacetItemValue" - } + "isUnique": { + "type": "boolean", + "description": "Determines if it unique." }, - "termStatus": { - "type": "array", - "items": { - "$ref": "#/definitions/SearchFacetItemValue" - } + "name": { + "type": "string", + "description": "The name of the attribute." }, - "termTemplate": { - "type": "array", - "items": { - "$ref": "#/definitions/SearchFacetItemValue" + "options": { + "type": "object", + "description": "The options for the attribute.", + "additionalProperties": { + "type": "string" } - } - }, - "title": "Context", - "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." - }, - "SearchFacetItemValue": { - "type": "object", - "properties": { - "count": { + }, + "typeName": { + "type": "string", + "description": "The name of the type." + }, + "valuesMaxCount": { "type": "integer", "format": "int32", - "description": "The count of the facet item." + "description": "The maximum count of the values." }, - "value": { - "type": "string", - "description": "The name of the facet item." - } - }, - "title": "SearchFacetItemValue", - "description": "The content of a search facet result item." - }, - "SearchFacetItem": { - "type": "object", - "properties": { - "count": { + "valuesMinCount": { "type": "integer", "format": "int32", - "description": "The count of the facet item." + "description": "The minimum count of the values." }, - "facet": { - "type": "string", - "description": "The name of the facet item." + "isLegacyAttribute": { + "type": "boolean", + "description": "Determines if it is a legacy attribute." }, - "sort": { - "type": "object" + "relationshipTypeName": { + "type": "string", + "description": "The name of the relationship type." } - }, - "title": "SearchFacetItemValue", - "description": "The content of a search facet result item." - }, - "SearchOrderItem": { - "type": "object", - "description": "See examples for the usage of search order." + } }, - "SearchResultValue": { + "AtlasRelationshipDef": { "type": "object", + "description": "AtlasRelationshipDef is a TypeDef that defines a relationship.\nAs with other typeDefs the AtlasRelationshipDef has a name. Once created the\nRelationshipDef has a guid.\nThe name and the guid are the 2 ways that the\nRelationshipDef is identified.\nRelationshipDefs have 2 ends, each of which\nspecify cardinality, an EntityDef type name and name and optionally\nwhether the\nend is a container.\nRelationshipDefs can have AttributeDefs - though only\nprimitive types are allowed. \nRelationshipDefs have a relationshipCategory\nspecifying the UML type of relationship required \nThe way EntityDefs and\nRelationshipDefs are intended to be used is that EntityDefs will define\nAttributeDefs these AttributeDefs\nwill not specify an EntityDef type name as\ntheir types.\nRelationshipDefs introduce new attributes to the entity\ninstances. For example\nEntityDef A might have attributes attr1,attr2,attr3\n\nEntityDef B might have attributes attr4,attr5,attr6 \nRelationshipDef\nAtoB might define 2 ends \n\nend1: type A, name attr7\nend2: type B, name attr8 \n\nWhen an instance of EntityDef A is created, it\nwill have attributes attr1,attr2,attr3,attr7 \nWhen an instance of EntityDef\nB is created, it will have attributes attr4,attr5,attr6,attr8\n\nIn this way\nrelationshipDefs can be authored separately from entityDefs and can inject\nrelationship attributes into\nthe entity instances", "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." - }, - "@search.highlights": { - "$ref": "#/definitions/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." + "category": { + "$ref": "#/definitions/TypeCategory", + "description": "The enum of type category." }, "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." + "description": "The created time of the record." }, - "qualifiedName": { + "createdBy": { "type": "string", - "description": "The qualified name of the record." + "description": "The user who created the record." }, - "entityType": { - "type": "string", - "description": "The type name of the asset." + "dateFormatter": { + "$ref": "#/definitions/DateFormat", + "description": "The date format." }, "description": { "type": "string", - "description": "The description of the asset." + "description": "The description of the type definition." }, - "endorsement": { + "guid": { "type": "string", - "description": "The endorsement of the asset." + "description": "The GUID of the type definition." }, - "owner": { + "name": { "type": "string", - "description": "The owner of the record." + "description": "The name of the type definition." }, - "classification": { - "type": "array", - "description": "The classifications of the record.", - "items": { + "options": { + "type": "object", + "description": "The options for the type definition.", + "additionalProperties": { "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" - } + "serviceType": { + "type": "string", + "description": "The service type." }, - "contact": { - "type": "array", - "description": "The contacts of the asset.", - "items": { - "$ref": "#/definitions/ContactSearchResultValue" - } + "typeVersion": { + "type": "string", + "description": "The version of the type." }, - "assetType": { - "type": "array", - "description": "The asset types of the asset.", - "items": { - "type": "string" - } + "updateTime": { + "type": "integer", + "format": "int64", + "description": "The update time of the record." }, - "glossaryType": { + "updatedBy": { "type": "string", - "description": "The type name of the term. Could be AtlasGlossary, AtlasGlossaryTerm or AtlasGlossaryCategory." + "description": "The user who updated the record." }, - "glossary": { - "type": "string", - "description": "The glossary name of the term." + "version": { + "type": "integer", + "format": "int64", + "description": "The version of the record." }, - "termStatus": { + "lastModifiedTS": { "type": "string", - "description": "The status of the term." + "description": "ETag for concurrency control." }, - "termTemplate": { + "attributeDefs": { "type": "array", - "description": "The term template names used by the term.", + "description": "An array of attribute definitions.", "items": { - "type": "string" - } + "$ref": "#/definitions/AtlasAttributeDef" + }, + "x-ms-identifiers": [] }, - "longDescription": { + "endDef1": { + "$ref": "#/definitions/AtlasRelationshipEndDef", + "description": "The relationshipEndDef represents an end of the relationship. The end of the\nrelationship is defined by a type, an\nattribute name, cardinality and whether\nit is the container end of the relationship." + }, + "endDef2": { + "$ref": "#/definitions/AtlasRelationshipEndDef", + "description": "The relationshipEndDef represents an end of the relationship. The end of the\nrelationship is defined by a type, an\nattribute name, cardinality and whether\nit is the container end of the relationship." + }, + "relationshipCategory": { + "$ref": "#/definitions/RelationshipCategory", + "description": "The Relationship category determines the style of relationship around\ncontainment and lifecycle.\nUML terminology is used for the values.\nASSOCIATION is a relationship with no containment. \nCOMPOSITION and AGGREGATION are containment relationships.\nThe difference being in the lifecycles of the container and its children. \nIn the COMPOSITION case, the children cannot exist without the container.\nFor AGGREGATION, the life cycles of the container and children are totally independent." + }, + "relationshipLabel": { "type": "string", - "description": "The definition of the term." + "description": "The label of the relationship." } - }, - "title": "SearchResultValue", - "description": "The value item of the search result." + } }, - "SearchHighlights": { + "AtlasRelationshipEndDef": { "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.", + "description": "The relationshipEndDef represents an end of the relationship. The end of the\nrelationship is defined by a type, an\nattribute name, cardinality and whether\nit is the container end of the relationship.", "properties": { - "id": { - "type": "array", - "items": { - "type": "string" - } + "cardinality": { + "$ref": "#/definitions/CardinalityValue", + "description": "single-valued attribute or multi-valued attribute." }, - "qualifiedName": { - "type": "array", - "items": { - "type": "string" - } + "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": "array", - "items": { - "type": "string" - } + "type": "string", + "description": "The name of the relationship end definition." }, - "description": { - "type": "array", - "items": { - "type": "string" + "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" } }, - "entityType": { - "type": "array", - "items": { - "type": "string" - } + "relationship": { + "$ref": "#/definitions/AtlasRelationship", + "description": "Atlas relationship instance." } - }, - "title": "SearchHighlights" + } }, - "TermSearchResultValue": { + "AtlasStruct": { "type": "object", + "description": "Captures details of struct contents. Not instantiated directly, used only via\nAtlasEntity, AtlasClassification.", "properties": { - "name": { - "type": "string", - "description": "The name of the term." + "attributes": { + "type": "object", + "description": "The attributes of the struct.", + "additionalProperties": {} }, - "glossaryName": { + "typeName": { "type": "string", - "description": "The name of the glossary which contains the term." + "description": "The name of the type." }, - "guid": { + "lastModifiedTS": { "type": "string", - "description": "The GUID of the term." + "description": "ETag for concurrency control." } - }, - "title": "Context", - "description": "The context." + } }, - "ContactSearchResultValue": { + "AtlasStructDef": { "type": "object", + "description": "class that captures details of a struct-type.", "properties": { - "id": { - "type": "string", - "description": "The GUID of the contact." + "category": { + "$ref": "#/definitions/TypeCategory", + "description": "The enum of type category." }, - "info": { + "createTime": { + "type": "integer", + "format": "int64", + "description": "The created time of the record." + }, + "createdBy": { "type": "string", - "description": "The description of the contact." + "description": "The user who created the record." }, - "contactType": { + "dateFormatter": { + "$ref": "#/definitions/DateFormat", + "description": "The date format." + }, + "description": { "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." - } - }, - "title": "contact", - "description": "The contact in the search and suggest result." - }, - "AutoCompleteRequest": { - "type": "object", - "properties": { - "keywords": { + "description": "The description of the type definition." + }, + "guid": { "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." + "description": "The GUID of the type definition." }, - "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." + "name": { + "type": "string", + "description": "The name of the type definition." }, - "filter": { + "options": { "type": "object", - "description": "The filter for the autocomplete request." - } - }, - "title": "AutoCompleteRequest", - "description": "The query of autocomplete request." - }, - "AutoCompleteResult": { - "type": "object", - "properties": { - "value": { - "type": "array", - "items": { - "$ref": "#/definitions/AutoCompleteResultValue" + "description": "The options for the type definition.", + "additionalProperties": { + "type": "string" } - } - }, - "title": "AutoCompleteResult", - "description": "The result of the autocomplete request." - }, - "AutoCompleteResultValue": { - "type": "object", - "properties": { - "text": { - "type": "string", - "description": "The completed term or phrase." }, - "queryPlusText": { + "serviceType": { "type": "string", - "description": "The completed search query text." - } - }, - "title": "AutoCompleteResultValue", - "description": "The value item of the autocomplete suggest." - }, - "SearchRequest": { - "type": "object", - "properties": { - "keywords": { + "description": "The service type." + }, + "typeVersion": { "type": "string", - "description": "The keywords applied to all searchable fields." + "description": "The version of the type." }, - "limit": { + "updateTime": { "type": "integer", - "format": "int32", - "description": "The limit of the number of the search result. default value is 50; maximum value is 1000." + "format": "int64", + "description": "The update time of the record." }, - "continuationToken": { + "updatedBy": { "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." + "description": "The user who updated the record." }, - "orderby": { - "type": "array", - "description": "The sort order of search results, can specify multiple fields.", - "items": { - "$ref": "#/definitions/SearchOrderItem" - } + "version": { + "type": "integer", + "format": "int64", + "description": "The version of the record." }, - "filter": { - "type": "object", - "description": "The filter for the search. See examples for the usage of supported filters." + "lastModifiedTS": { + "type": "string", + "description": "ETag for concurrency control." }, - "facets": { + "attributeDefs": { "type": "array", + "description": "An array of attribute definitions.", "items": { - "$ref": "#/definitions/SearchFacetItem" - } - }, - "taxonomySetting": { - "type": "object", - "properties": { - "assetTypes": { - "type": "array", - "items": { - "type": "string" - } - }, - "facet": { - "$ref": "#/definitions/SearchFacetItem" - } - } + "$ref": "#/definitions/AtlasAttributeDef" + }, + "x-ms-identifiers": [] } - }, - "title": "SearchRequest", - "description": "The search query of advanced search request." + } }, - "SuggestRequest": { + "AtlasTermAssignmentHeader": { "type": "object", + "description": "The header for term assignment.", "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": { + "confidence": { "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." + "description": "The confidence of the term assignment." }, - "filter": { - "type": "object", - "description": "The filter for the search." + "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." } - }, - "title": "SuggestRequest", - "description": "The query of suggest request." + } }, - "LastModifiedTS": { + "AtlasTermAssignmentStatus": { "type": "string", - "title": "lastModifiedTS", - "description": "ETag for concurrency control." + "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." + } + ] + } }, - "ErrorResponse": { - "description": "An error response from the service", + "AtlasTermCategorizationHeader": { "type": "object", + "description": "The basic information for term categorization.", "properties": { - "requestId": { - "type": "string", - "description": "The request ID." + "categoryGuid": { + "$ref": "#/definitions/Azure.Core.uuid", + "description": "The GUID of the category." }, - "errorCode": { + "description": { "type": "string", - "description": "The error code." + "description": "The description of the record." }, - "errorMessage": { + "displayText": { "type": "string", - "description": "The error message." + "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." } } }, - "RelatedCategoryHeaders": { - "type": "object", - "description": "An array of related categories.", - "additionalProperties": { - "type": "array", - "items": { - "$ref": "#/definitions/AtlasRelatedCategoryHeader" - } + "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" + } + ] } }, - "RelatedTermHeaders": { + "AtlasTypeDef": { "type": "object", - "description": "An array of related glossary terms for the given glossary or an empty list.", - "additionalProperties": { - "type": "array", - "items": { - "$ref": "#/definitions/AtlasRelatedTermHeader" + "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\nclassifications can\nonly be applied to those entityTypes.\n\nAny subtypes of the entity types inherit the restriction.\n\nAny classificationDef subtypes inherit the parents entityTypes restrictions.\n\nAny classificationDef subtypes can further restrict the parents entityTypes\nrestrictions by specifying a subset of the entityTypes.\n\nAn empty entityTypes list when there are no parent restrictions means there are no\nrestrictions.\n\nAn empty entityTypes list when there are parent\nrestrictions means that the subtype picks up the parents\nrestrictions.\n\nIf a list of entityTypes are supplied, where one inherits\nfrom another, this will be rejected. This should encourage cleaner\nclassificationsDefs.\n", + "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\nrelationship is defined by a type, an\nattribute name, cardinality and whether\nit is the container end of the relationship." + }, + "endDef2": { + "$ref": "#/definitions/AtlasRelationshipEndDef", + "description": "The relationshipEndDef represents an end of the relationship. The end of the\nrelationship is defined by a type, an\nattribute name, cardinality and whether\nit is the container end of the relationship." + }, + "relationshipCategory": { + "$ref": "#/definitions/RelationshipCategory", + "description": "The Relationship category determines the style of relationship around\ncontainment and lifecycle.\nUML terminology is used for the values.\n\nASSOCIATION is a relationship with no containment. \nCOMPOSITION and AGGREGATION are containment relationships.\n\nThe difference being in the lifecycles of the container and its children. \nIn the COMPOSITION case, the children cannot exist without the container. \nFor 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": [] } } }, - "BusinessMetadata": { + "AtlasTypeDefHeader": { "type": "object", - "additionalProperties": { - "type": "object" - }, - "description": "BusinessMetadata" + "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." + } + } }, - "BusinessMetadataAttributes": { + "AtlasTypesDef": { "type": "object", - "additionalProperties": { - "type": "object" - }, - "description": "BusinessMetadataAttributes" - } - }, - "parameters": { - "endpoint": { - "name": "endpoint", - "description": "The datamap endpoint of your Purview account. Example: https://{accountName}.purview.azure.com", - "x-ms-parameter-location": "client", - "required": true, - "type": "string", - "format": "url", - "in": "path", - "x-ms-skip-url-encoding": true - }, - "guid": { - "name": "guid", - "description": "The globally unique identifier of the entity.", - "in": "path", - "required": true, - "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" - }, - "classificationName": { - "name": "classificationName", - "description": "The name of the classification.", - "in": "path", - "required": true, - "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" - }, - "typeName": { - "name": "typeName", - "description": "The name of the type.", - "in": "path", - "required": true, - "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" - }, - "categoryGuid": { - "name": "categoryGuid", - "description": "The globally unique identifier of the category.", - "in": "path", - "required": true, - "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" - }, - "limit": { - "name": "limit", - "description": "The page size - by default there is no paging.", - "in": "query", - "required": false, - "type": "integer", - "format": "int32", - "x-ms-parameter-location": "method" + "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": [] + } + } }, - "offset": { - "name": "offset", - "description": "The offset for pagination purpose.", - "in": "query", - "required": false, - "type": "integer", - "format": "int32", - "x-ms-parameter-location": "method" + "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\nbe 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.\nThe value must be a number between 1 and 100." + }, + "filter": { + "description": "The filter for the autocomplete request." + } + } }, - "sort": { - "name": "sort", - "description": "The sort order, ASC (default) or DESC.", - "in": "query", - "required": false, - "type": "string", - "default": "ASC", - "x-ms-parameter-location": "method" + "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": [] + } + } }, - "termGuid": { - "name": "termGuid", - "in": "path", - "description": "The globally unique identifier for glossary term.", - "required": true, - "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "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." + } + } }, - "fileId": { - "name": "fileId", - "in": "path", - "description": "The globally unique identifier for file.", - "required": true, + "Azure.Core.uuid": { "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "format": "uuid", + "description": "Universally Unique Identifier" }, - "glossaryGuid": { - "name": "glossaryGuid", - "in": "path", - "description": "The globally unique identifier for glossary.", - "required": true, - "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "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": [] + } + } }, - "operationGuid": { - "name": "operationGuid", - "in": "path", - "description": "The globally unique identifier for async operation job.", - "required": true, + "CardinalityValue": { "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "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" + } + ] + } }, - "glossaryName": { - "name": "glossaryName", - "in": "path", - "description": "The name of the glossary.", - "required": true, - "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "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\nexists only when associated with an entity." + }, + "entityGuids": { + "type": "array", + "description": "The GUID of the entity.", + "items": { + "type": "string" + } + } + } }, - "searchLimit": { - "name": "limit", - "description": "Limits the result set to only include the specified number of entries.", - "in": "query", - "required": false, - "type": "integer", - "format": "int32", - "x-ms-parameter-location": "method" + "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." + } + } }, - "searchKeyword": { - "name": "keyword", - "description": "The keyword to get auto complete.", - "in": "query", - "required": true, - "type": "string", - "x-ms-parameter-location": "method" + "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\nExpert or Steward for a glossary term." + } + } }, - "depth": { - "name": "depth", - "description": "The number of hops for lineage.", - "in": "query", - "required": false, - "type": "integer", - "default": 3, - "format": "int32", - "x-ms-parameter-location": "method" - }, - "direction": { - "name": "direction", - "description": "The direction of the lineage, which could be INPUT, OUTPUT or BOTH.", - "in": "query", - "required": true, + "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": [ - "BOTH", - "INPUT", - "OUTPUT" + "ACTIVE", + "DELETED" ], "x-ms-enum": { - "name": "direction", - "modelAsString": true - }, - "x-ms-parameter-location": "method" + "name": "EntityStatus", + "modelAsString": true, + "values": [ + { + "name": "Active", + "value": "ACTIVE", + "description": "The status is active." + }, + { + "name": "Deleted", + "value": "DELETED", + "description": "The status is deleted." + } + ] + } }, - "extendedInfo": { - "name": "extendedInfo", - "description": "Limits whether includes extended information.", - "in": "query", - "required": false, - "type": "boolean", - "x-ms-parameter-location": "method" + "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" + } + } }, - "relationshipGuid": { - "name": "guid", - "description": "The globally unique identifier of the relationship.", - "in": "path", - "required": true, + "ImportStatus": { "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "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" + } + ] + } }, - "classificationDefGuid": { - "name": "guid", - "description": "The globally unique identifier of the classification.", - "in": "path", - "required": true, + "LineageDirection": { "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "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" + } + ] + } }, - "classificationDefName": { - "name": "name", - "description": "The name of the classification.", - "in": "path", - "required": true, - "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "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." + } + } }, - "entityDefGuid": { - "name": "guid", - "description": "The globally unique identifier of the entity.", - "in": "path", - "required": true, - "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "MoveEntitiesOptions": { + "type": "object", + "description": "MoveEntitiesOptions", + "properties": { + "entityGuids": { + "type": "array", + "description": "An array of entity guids to be moved to target collection.", + "items": { + "type": "string" + } + } + } }, - "entityDefName": { - "name": "name", - "description": "The name of the entity.", - "in": "path", - "required": true, - "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "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." + } + } }, - "termTemplateDefGuid": { - "name": "guid", - "description": "The globally unique identifier of the term template.", - "in": "path", - "required": true, - "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "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." + } + } }, - "termTemplateDefName": { - "name": "name", - "description": "The name of the term template.", - "in": "path", - "required": true, - "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "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": {} + } + } }, - "enumDefGuid": { - "name": "guid", - "description": "The globally unique identifier of the enum.", - "in": "path", - "required": true, - "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "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\nvalue is 1000." + }, + "continuationToken": { + "type": "string", + "description": "The token used to get next batch of data. Default 'Null' to get the first\nbatch, 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." + } + } }, - "enumDefName": { - "name": "name", - "description": "The name of the enum.", - "in": "path", - "required": true, - "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "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\npage).", + "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,\ncontactId, and label. When the facet is specified in the request, the value of\nthe 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" + } + } + } }, - "relationshipDefGuid": { - "name": "guid", - "description": "The globally unique identifier of the relationship.", - "in": "path", - "required": true, + "RelationshipCategory": { "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" - }, - "relationshipDefName": { - "name": "name", - "description": "The name of the relationship.", - "in": "path", - "required": true, - "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "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" + } + ] + } }, - "structDefGuid": { - "name": "guid", - "description": "The globally unique identifier of the struct.", - "in": "path", - "required": true, + "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", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "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" + } + ] + } }, - "structDefName": { - "name": "name", - "description": "The name of the struct.", - "in": "path", - "required": true, + "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,\ncontactId, and label. When the facet is specified in the request, the value of\nthe 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,\ndescription, entityType. When the keyword appears in those fields, the value of\nthe field, attached with emphasis mark, is returned as an element of\n@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\nsearch 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,\ndescription, entityType. When the keyword appears in those fields, the value of\nthe field, attached with emphasis mark, is returned as an element of\n@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\ndistinguish 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\nAtlasGlossaryCategory." + }, + "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", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "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" + } + ] + } }, - "typeDefGuid": { - "name": "guid", - "description": "The globally unique identifier of the type.", - "in": "path", - "required": true, + "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", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "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" + } + ] + } }, - "typeDefName": { - "name": "name", - "description": "The name of the type.", - "in": "path", - "required": true, + "StatusAtlasRelationship": { "type": "string", - "minLength": 1, - "maxLength": 4096, - "x-ms-parameter-location": "method" + "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\nat least 1 character, and no more than 100 characters. In the index schema we\ndefined a default suggester which lists all the supported fields and specifies\na search mode." + }, + "limit": { + "type": "integer", + "format": "int32", + "description": "The number of suggestions we hope to return. The default value is 5. The value\nmust 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\nsearch 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\nwith 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\ndistinguish 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\nAtlasGlossaryCategory." + }, + "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." + } + } }, - "userId": { - "name": "userId", - "description": "The user ID.", - "in": "path", - "required": true, - "type": "string", - "x-ms-parameter-location": "method" + "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." + } + } }, - "principalId": { - "name": "principalId", - "description": "The principal ID.", - "in": "path", - "required": true, + "TermStatus": { "type": "string", - "x-ms-parameter-location": "method" - }, - "minExtInfo": { - "name": "minExtInfo", - "description": "Whether to return minimal information for referred entities.", - "in": "query", - "required": false, - "type": "boolean", - "default": false, - "x-ms-parameter-location": "method" - }, - "ignoreRelationships": { - "name": "ignoreRelationships", - "description": "Whether to ignore relationship attributes.", - "in": "query", - "required": false, - "type": "boolean", - "default": false, - "x-ms-parameter-location": "method" - }, - "includeTermTemplate": { - "name": "includeTermTemplate", - "description": "Whether include termtemplatedef when return all typedefs.\nThis is always true when search filter type=term_template", - "in": "query", - "required": false, - "type": "boolean", - "default": false, - "x-ms-parameter-location": "method" - }, - "includeTermHierarchy": { - "name": "includeTermHierarchy", - "description": "Whether include term hierarchy", - "in": "query", - "required": false, - "type": "boolean", - "default": false, - "x-ms-parameter-location": "method" - }, - "extInfo": { - "name": "extInfo", - "description": "Whether include extended information like contact display name and attribute values", - "in": "query", - "required": false, - "type": "boolean", - "default": false, - "x-ms-parameter-location": "method" + "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" + } + ] + } }, - "ignoreTermsAndCategories": { - "name": "ignoreTermsAndCategories", - "description": "Whether ignore terms and categories", - "in": "query", - "required": false, - "type": "boolean", - "default": false, - "x-ms-parameter-location": "method" + "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": [] + } + } }, - "purviewAPIVersion": { - "name": "api-version", - "description": "The version of the API.", - "in": "query", - "required": true, - "type": "string", - "x-ms-parameter-location": "method" + "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." + } + } }, - "atlasAPIVersion": { - "name": "api-version", - "description": "The version of the API.", - "in": "query", - "required": false, - "type": "string", - "x-ms-parameter-location": "method" + "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." + } + } }, - "type": { - "name": "type", - "description": "Typedef name as search filter when get typedefs.", - "in": "query", - "required": false, + "TypeCategory": { "type": "string", + "description": "Type Category", "enum": [ - "enum", - "entity", - "classification", - "relationship", - "struct", - "term_template" + "PRIMITIVE", + "OBJECT_ID_TYPE", + "ENUM", + "STRUCT", + "CLASSIFICATION", + "ENTITY", + "ARRAY", + "MAP", + "RELATIONSHIP", + "TERM_TEMPLATE" ], "x-ms-enum": { - "name": "type", - "modelAsString": true - }, - "x-ms-parameter-location": "method" - }, - "requiredCollectionId": { - "name": "collectionId", - "description": "The collection where entities will be moved to.", - "in": "query", - "required": true, - "type": "string", - "x-ms-parameter-location": "method" - }, - "collectionId": { - "name": "collectionId", - "description": "The collection where entities will be moved to. Only specify a value if you need to move an entity to another collection.", + "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", - "x-ms-parameter-location": "method" - }, - "forceDeleteEntityAssignment": { - "name": "forceDeleteEntityAssignment", - "description": "Whether delete entity assignment", - "in": "query", - "required": false, - "type": "boolean", - "default": false, - "x-ms-parameter-location": "method" - }, - "forceDeleteChild": { - "name": "forceDeleteChild", - "description": "Whether delete child terms together with the parent term", - "in": "query", - "required": false, - "type": "boolean", - "default": false, - "x-ms-parameter-location": "method" + "minLength": 1, + "x-ms-parameter-location": "method", + "x-ms-client-name": "apiVersion" }, - "businessAttributeUpdateBehavior": { - "name": "businessAttributeUpdateBehavior", - "description": "Used to define the update behavior for business attributes when updating entities.", + "Azure.Core.Foundations.ApiVersionParameter": { + "name": "api-version", "in": "query", - "required": false, + "description": "The API version to use for this operation.", + "required": true, "type": "string", - "enum": [ - "ignore", - "replace", - "merge" - ], - "x-ms-enum": { - "name": "businessAttributeUpdateBehavior", - "modelAsString": true - }, - "x-ms-parameter-location": "method" + "minLength": 1, + "x-ms-parameter-location": "method", + "x-ms-client-name": "apiVersion" } } } diff --git a/specification/purview/data-plane/readme.md b/specification/purview/data-plane/readme.md index be24c40594c6..2f951e1b0917 100644 --- a/specification/purview/data-plane/readme.md +++ b/specification/purview/data-plane/readme.md @@ -46,6 +46,7 @@ These settings apply only when `--tag=package-2023-09` is specified on the comma input-file: - Azure.Analytics.Purview.DataMap/stable/2023-09-01/purviewdatamap.json ``` + ### Tag: package-preview-2023-02 These settings apply only when `--tag=package-preview-2023-02` is specified on the command line. @@ -295,6 +296,19 @@ See configuration in [readme.python.md](./readme.python.md) ## Suppression +``` yaml +directive: + - suppress: AvoidAnonymousParameter + from: purviewdatamap.json + reason: This rule is irrelevant for data-plane TypeSpec specs. + - suppress: AvoidAnonymousTypes + from: purviewdatamap.json + reason: This rule is irrelevant for data-plane TypeSpec specs. + - suppress: IntegerTypeMustHaveFormat + from: purviewdatamap.json + reason: This rule is irrelevant for SDKs generated directly by TypeSpec. +``` + ``` yaml directive: - suppress: R3013