From 2f0072a56207613dacc2bc7b2523afb547e758e7 Mon Sep 17 00:00:00 2001 From: Alexandra Bucur Date: Thu, 8 Jun 2023 14:08:04 +0300 Subject: [PATCH 1/2] Document Asset Catalog and move it to Tech Preview Signed-off-by: Alexandra Bucur --- .../get-asset-classifications.md | 31 ++ .../omas/asset-catalog/get-asset-context.md | 31 ++ .../omas/asset-catalog/get-asset-details.md | 30 ++ .../asset-catalog/get-asset-relationships.md | 33 ++ .../omas/asset-catalog/get-asset-universe.md | 30 ++ .../omas/asset-catalog/get-supported-types.md | 29 ++ .../services/omas/asset-catalog/overview.md | 53 ++-- ...-Catalog-endpoints.postman_collection.json | 290 ++++++++++++++++++ .../services/omas/asset-catalog/search.md | 30 ++ 9 files changed, 533 insertions(+), 24 deletions(-) create mode 100644 site/docs/services/omas/asset-catalog/get-asset-classifications.md create mode 100644 site/docs/services/omas/asset-catalog/get-asset-context.md create mode 100644 site/docs/services/omas/asset-catalog/get-asset-details.md create mode 100644 site/docs/services/omas/asset-catalog/get-asset-relationships.md create mode 100644 site/docs/services/omas/asset-catalog/get-asset-universe.md create mode 100644 site/docs/services/omas/asset-catalog/get-supported-types.md create mode 100644 site/docs/services/omas/asset-catalog/samples/collections/Asset-Catalog-endpoints.postman_collection.json create mode 100644 site/docs/services/omas/asset-catalog/search.md diff --git a/site/docs/services/omas/asset-catalog/get-asset-classifications.md b/site/docs/services/omas/asset-catalog/get-asset-classifications.md new file mode 100644 index 0000000000..52ce138b2f --- /dev/null +++ b/site/docs/services/omas/asset-catalog/get-asset-classifications.md @@ -0,0 +1,31 @@ + + + +# Get Asset Classifications + +This is the ability to retrieve all classifications that exist on a specific asset. + +More examples can be found in the +[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json) + +``` +GET {{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/supportedTypes +``` +Path and request parameters: +* `serverName` - unique identifier for requested server +* `userId` - the unique identifier for the user +* `assetGUID` - the unique identifier for the asset +* `assetType` - the type of the asset +* `classificationName` - the name of the classification + +Response: +* `ClassificationsResponse` - the classification for the asset + +---8<-- "snippets/abbr.md" + + + + + + + diff --git a/site/docs/services/omas/asset-catalog/get-asset-context.md b/site/docs/services/omas/asset-catalog/get-asset-context.md new file mode 100644 index 0000000000..02137bfed2 --- /dev/null +++ b/site/docs/services/omas/asset-catalog/get-asset-context.md @@ -0,0 +1,31 @@ + + + +# Get Asset Context + +Return the full context of an asset/glossary term based on its identifier. +The response contains the list of the connections assigned to the asset. + +More examples can be found in the +[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json) + +``` +GET {{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/asset-context/{{asset-guid}} +``` +Path and request parameters: +* `serverName` - unique identifier for requested server. +* `userId` - the unique identifier for the user +* `assetGUID` - the global unique identifier of the asset +* `assetType` - the type of the asset + +Response: +* `AssetResponse` - list of properties used to narrow the search + +---8<-- "snippets/abbr.md" + + + + + + + diff --git a/site/docs/services/omas/asset-catalog/get-asset-details.md b/site/docs/services/omas/asset-catalog/get-asset-details.md new file mode 100644 index 0000000000..7c420d731e --- /dev/null +++ b/site/docs/services/omas/asset-catalog/get-asset-details.md @@ -0,0 +1,30 @@ + + + +# Get Asset Details + +Fetches asset's properties, relationships and classifications + +More examples can be found in the +[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json) + +``` +GET {{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/asset-details/{{asset-guid}} +``` +Path and request parameters: +* `serverName` - unique identifier for requested server. +* `userId` - the unique identifier for the user +* `assetGUID` - the global unique identifier of the asset +* `assetType` - the type of the asset + +Response: +* `AssetCatalogResponse` - list of properties used to narrow the search + +---8<-- "snippets/abbr.md" + + + + + + + diff --git a/site/docs/services/omas/asset-catalog/get-asset-relationships.md b/site/docs/services/omas/asset-catalog/get-asset-relationships.md new file mode 100644 index 0000000000..3c53c7d2a6 --- /dev/null +++ b/site/docs/services/omas/asset-catalog/get-asset-relationships.md @@ -0,0 +1,33 @@ + + + +# Get Asset Relationships + +Fetches the relationships for a specific asset + +More examples can be found in the +[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json) + +``` +GET {{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/asset-relationships/{{asset-guid}}?assetType={{asset-type}}&relationshipType={{relationship-type}} +``` +Path and request parameters: +* `serverName` - unique identifier for requested server +* `userId` - the unique identifier for the user +* `assetGUID` - the unique identifier for the asset +* `assetType` - the type of the asset +* `relationshipType` - the type of the relationship +* `from` - offset +* `pageSize` - limit the number of the assets returned + +Response: +* `RelationshipListResponse` - list of relationships for the given asset + +---8<-- "snippets/abbr.md" + + + + + + + diff --git a/site/docs/services/omas/asset-catalog/get-asset-universe.md b/site/docs/services/omas/asset-catalog/get-asset-universe.md new file mode 100644 index 0000000000..3f2ccff5b2 --- /dev/null +++ b/site/docs/services/omas/asset-catalog/get-asset-universe.md @@ -0,0 +1,30 @@ + + + +# Get Asset Universe + +Fetches asset's header, classification, properties and relationships + +More examples can be found in the +[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json) + +``` +GET {{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/asset-relationships/{{asset-guid}}?assetType={{asset-type}}&relationshipType={{relationship-type}} +``` +Path and request parameters: +* `serverName` - unique identifier for requested server +* `userId` - the unique identifier for the user +* `assetGUID` - the unique identifier for the asset +* `assetType` - the type of the asset + +Response: +* `AssetCatalogResponse` - the asset with its header and the list of associated classifications and relationship + +---8<-- "snippets/abbr.md" + + + + + + + diff --git a/site/docs/services/omas/asset-catalog/get-supported-types.md b/site/docs/services/omas/asset-catalog/get-supported-types.md new file mode 100644 index 0000000000..66bfaf4276 --- /dev/null +++ b/site/docs/services/omas/asset-catalog/get-supported-types.md @@ -0,0 +1,29 @@ + + + +# Get Supported Types + +Returns the list with supported types for search, including the sub-types supported + +More examples can be found in the +[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json) + +``` +GET {{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/supportedTypes +``` +Path and request parameters: +* `serverName` - unique identifier for requested server +* `userId` - the unique identifier for the user +* `type` - the type + +Response: +* `AssetCatalogSupportedTypes` - list of types and sub-types supported for search + +---8<-- "snippets/abbr.md" + + + + + + + diff --git a/site/docs/services/omas/asset-catalog/overview.md b/site/docs/services/omas/asset-catalog/overview.md index 88568903cf..6857e99c31 100644 --- a/site/docs/services/omas/asset-catalog/overview.md +++ b/site/docs/services/omas/asset-catalog/overview.md @@ -1,7 +1,7 @@ ---8<-- "snippets/content-status/in-development.md" +--8<-- "snippets/content-status/tech-preview.md" # Asset Catalog Open Metadata Access Service (OMAS) @@ -21,47 +21,52 @@ to it. This includes: * assets The Asset Catalog REST API supports: - * the retrieval of assets based on unique identifiers * the retrieval of asset's relationships and classifications -* the retrieval of assets based on known classification or relationship -* to query for related assets and to retrieve an asset neighborhood +* to query for related assets +* the retrieval of assets based on their type The module structure for the Asset Catalog OMAS is as follows: - * [asset-catalog-client](asset-catalog-client) supports the client library. * [asset-catalog-api](asset-catalog-api) supports the common Java classes that are used both by the client and the server. * [asset-catalog-server](asset-catalog-server) supports the server side implementation of the access service. - This includes the - * interaction with the [administration services](/services/admin-services/overview) for - registration, configuration, initialization and termination of the access service. - * interaction with the [repository services](/services/omrs) to work with open metadata from the - [cohort](/concepts/cohort-member). - * support for the access service's API and its related event management. -* [asset-catalog-spring](asset-catalog-spring) supports the REST API using the [Spring](/guides/contributor/runtime/#spring) libraries. + This includes the + * interaction with the [administration services](../../admin-services) for + registration, configuration, initialization and termination of the access service. + * interaction with the [repository services](../../repository-services) to work with open metadata from the + [cohort](https://egeria-project.org/concepts/cohort-member). + * support for the access service's API and its related event management. +* [asset-catalog-spring](asset-catalog-spring) supports the REST API using the [Spring](../../../developer-resources/Spring.md) libraries. +* [asset-catalog-topic-connector](asset-catalog-topic-connector) supports asynchronous messaging through a connector + and connector provider class + +## Using the Asset Catalog OMAS + +Below is the list of tasks supported by Asset Catalog OMAS. + +#### [Get Asset Classifications](get-asset-classifications.md) +#### [Get Asset Context](get-asset-context.md) +#### [Get Asset Details](get-asset-details.md) +#### [Get Asset Relationships](get-asset-relationships.md) +#### [Get Asset Universe](get-asset-universe.md) +#### [Get Supported Types](get-supported-types.md) +#### [Search](search.md) + -###Search solution +## Search Solution The search will return Assets, Glossary Terms and Schema Elements that match the search criteria. -As the asset search is to be performed against on one or more repositories a search engine will be used. +As the asset search is to be performed against on one or more repositories a search engine will be used. The search will be performed using the existing properties of the asset, glossary terms and/or schema elements. Indexing will be performed by the Asset Catalog OMAS according to supported zones. The search result will contain: guid, name (name or displayName), description, qualifiedName, classifications, zoneMembership (the basic properties of the element). In order to get the full context of the element, a second call is performed. At this step, the specific relationships are traverse for getting the connection to the asset and to get the schema type that is behind the given asset. -This call is using the asset global identifier and the asset type. +This call is using the asset global identifier and the asset type. ![Figure 1: Search](egeria-asset-search.png) -> Figure 1:Integration of search engine - -###Other Services -Asset Catalog OMAS provides services to fetch the asset -* classifications -* relationships -* specific entities that connects two assets -* relationships between two known entities -* related assets +> Figure 1: Integration of search engine --8<-- "snippets/abbr.md" diff --git a/site/docs/services/omas/asset-catalog/samples/collections/Asset-Catalog-endpoints.postman_collection.json b/site/docs/services/omas/asset-catalog/samples/collections/Asset-Catalog-endpoints.postman_collection.json new file mode 100644 index 0000000000..8d5e458bdd --- /dev/null +++ b/site/docs/services/omas/asset-catalog/samples/collections/Asset-Catalog-endpoints.postman_collection.json @@ -0,0 +1,290 @@ +{ + "info": { + "_postman_id": "bc085e19-5492-4446-b323-6ce7c7a0642f", + "name": "Asset Catalog endpoints", + "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" + }, + "item": [ + { + "name": "1. Get supported types", + "request": { + "method": "GET", + "header": [ + { + "key": "Content-Type", + "name": "Content-Type", + "type": "text", + "value": "application/json" + } + ], + "url": { + "raw": "{{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/supportedTypes?type={{asset-type}}", + "host": [ + "{{base-url}}" + ], + "path": [ + "servers", + "{{server-id}}", + "open-metadata", + "access-services", + "asset-catalog", + "users", + "{{user-id}}", + "supportedTypes" + ], + "query": [ + { + "key": "type", + "value": "{{asset-type}}" + } + ] + } + }, + "response": [] + }, + { + "name": "2. Search", + "request": { + "method": "POST", + "header": [ + { + "key": "Content-Type", + "name": "Content-Type", + "value": "application/json", + "type": "text" + } + ], + "body": { + "mode": "raw", + "raw": "{\n\t\"class\": \"SearchParameters\",\n\t\"status\": \"ACTIVE\",\n\t\"from\": 0,\n\t\"pageSize\":100,\n\t\"isCaseInsensitive\": false\n}", + "options": { + "raw": { + "language": "json" + } + } + }, + "url": { + "raw": "{{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/search?searchCriteria={{search-criteria}}", + "host": [ + "{{base-url}}" + ], + "path": [ + "servers", + "{{server-id}}", + "open-metadata", + "access-services", + "asset-catalog", + "users", + "{{user-id}}", + "search" + ], + "query": [ + { + "key": "searchCriteria", + "value": "{{search-criteria}}" + } + ] + } + }, + "response": [] + }, + { + "name": "3. Get asset details", + "request": { + "method": "GET", + "header": [ + { + "key": "Content-Type", + "name": "Content-Type", + "type": "text", + "value": "application/json" + } + ], + "url": { + "raw": "{{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/asset-details/{{asset-guid}}/?assetType={{asset-type}}", + "host": [ + "{{base-url}}" + ], + "path": [ + "servers", + "{{server-id}}", + "open-metadata", + "access-services", + "asset-catalog", + "users", + "{{user-id}}", + "asset-details", + "{{asset-guid}}", + "" + ], + "query": [ + { + "key": "assetType", + "value": "{{asset-type}}" + } + ] + } + }, + "response": [] + }, + { + "name": "4. Get asset classifications", + "request": { + "method": "GET", + "header": [ + { + "key": "Content-Type", + "name": "Content-Type", + "type": "text", + "value": "application/json" + } + ], + "url": { + "raw": "{{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/asset-classifications/{{asset-guid}}?classificationName={{classification-name}}", + "host": [ + "{{base-url}}" + ], + "path": [ + "servers", + "{{server-id}}", + "open-metadata", + "access-services", + "asset-catalog", + "users", + "{{user-id}}", + "asset-classifications", + "{{asset-guid}}" + ], + "query": [ + { + "key": "from", + "value": "0", + "disabled": true + }, + { + "key": "pageSize", + "value": "10", + "disabled": true + }, + { + "key": "assetType", + "value": "{{asset-type-1}}", + "disabled": true + }, + { + "key": "classificationName", + "value": "{{classification-name}}" + } + ] + } + }, + "response": [] + }, + { + "name": "5. Get asset relationships", + "request": { + "method": "GET", + "header": [ + { + "key": "Content-Type", + "name": "Content-Type", + "type": "text", + "value": "application/json" + } + ], + "url": { + "raw": "{{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/asset-relationships/{{asset-guid}}?assetType={{asset-type}}&relationshipType={{relationship-type}}", + "host": [ + "{{base-url}}" + ], + "path": [ + "servers", + "{{server-id}}", + "open-metadata", + "access-services", + "asset-catalog", + "users", + "{{user-id}}", + "asset-relationships", + "{{asset-guid}}" + ], + "query": [ + { + "key": "assetType", + "value": "{{asset-type}}" + }, + { + "key": "relationshipType", + "value": "{{relationship-type}}" + } + ] + } + }, + "response": [] + }, + { + "name": "6. Get asset context", + "request": { + "method": "GET", + "header": [ + { + "key": "Content-Type", + "name": "Content-Type", + "type": "text", + "value": "application/json" + } + ], + "url": { + "raw": "{{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/asset-context/{{asset-guid}}", + "host": [ + "{{base-url}}" + ], + "path": [ + "servers", + "{{server-id}}", + "open-metadata", + "access-services", + "asset-catalog", + "users", + "{{user-id}}", + "asset-context", + "{{asset-guid}}" + ] + } + }, + "response": [] + }, + { + "name": "7. Get asset universe", + "request": { + "method": "GET", + "header": [ + { + "key": "Content-Type", + "name": "Content-Type", + "type": "text", + "value": "application/json" + } + ], + "url": { + "raw": "{{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/asset-universe/{{asset-guid}}", + "host": [ + "{{base-url}}" + ], + "path": [ + "servers", + "{{server-id}}", + "open-metadata", + "access-services", + "asset-catalog", + "users", + "{{user-id}}", + "asset-universe", + "{{asset-guid}}" + ] + } + }, + "response": [] + } + ] +} \ No newline at end of file diff --git a/site/docs/services/omas/asset-catalog/search.md b/site/docs/services/omas/asset-catalog/search.md new file mode 100644 index 0000000000..a72c429247 --- /dev/null +++ b/site/docs/services/omas/asset-catalog/search.md @@ -0,0 +1,30 @@ + + + +# Search + +Returns the list with supported types for search, including the sub-types supported + +More examples can be found in the +[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json) + +``` +GET {{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/supportedTypes +``` +Path and request parameters: +* `serverName` - unique identifier for requested server +* `userId` - the unique identifier for the user +* `searchCriteria` - a string expression of the characteristics of the required assets +* `searchParameters` - constrains to make the assets' search results more precise + +Response: +* `AssetListResponse` - list of found assets + +---8<-- "snippets/abbr.md" + + + + + + + From fdda272ebc65cb56ca130af1672120dad0339d5a Mon Sep 17 00:00:00 2001 From: Alexandra Bucur Date: Tue, 20 Jun 2023 14:14:53 +0300 Subject: [PATCH 2/2] Add java client details for Asset Catalog methods Signed-off-by: Alexandra Bucur --- .../omas/asset-catalog/get-asset-classifications.md | 9 +++++++-- .../services/omas/asset-catalog/get-asset-context.md | 10 ++++++++-- .../services/omas/asset-catalog/get-asset-details.md | 12 +++++++++--- .../omas/asset-catalog/get-asset-relationships.md | 12 +++++++++--- .../omas/asset-catalog/get-asset-universe.md | 12 +++++++++--- .../omas/asset-catalog/get-supported-types.md | 12 +++++++++--- site/docs/services/omas/asset-catalog/search.md | 12 +++++++++--- 7 files changed, 60 insertions(+), 19 deletions(-) diff --git a/site/docs/services/omas/asset-catalog/get-asset-classifications.md b/site/docs/services/omas/asset-catalog/get-asset-classifications.md index 52ce138b2f..916e3b6f78 100644 --- a/site/docs/services/omas/asset-catalog/get-asset-classifications.md +++ b/site/docs/services/omas/asset-catalog/get-asset-classifications.md @@ -5,9 +5,11 @@ This is the ability to retrieve all classifications that exist on a specific asset. -More examples can be found in the -[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json) +## Java client + +AssetCatalog.java, method (more details in javadoc): [ClassificationListResponse getClassificationsForAsset(String userId, String assetGUID, String assetType, String classificationName) throws InvalidParameterException, PropertyServerException;](https://odpi.github.io/egeria/org/odpi/openmetadata/accessservices/assetcatalog/AssetCatalog.html#getClassificationsForAsset(java.lang.String,java.lang.String,java.lang.String,java.lang.String)) +## REST endpoint ``` GET {{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/supportedTypes ``` @@ -21,6 +23,9 @@ Path and request parameters: Response: * `ClassificationsResponse` - the classification for the asset +More examples can be found in the +[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json). + ---8<-- "snippets/abbr.md" diff --git a/site/docs/services/omas/asset-catalog/get-asset-context.md b/site/docs/services/omas/asset-catalog/get-asset-context.md index 02137bfed2..bd4eb1a67a 100644 --- a/site/docs/services/omas/asset-catalog/get-asset-context.md +++ b/site/docs/services/omas/asset-catalog/get-asset-context.md @@ -6,8 +6,11 @@ Return the full context of an asset/glossary term based on its identifier. The response contains the list of the connections assigned to the asset. -More examples can be found in the -[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json) +## Java client + +AssetCatalog.java, method (more details in javadoc): [AssetResponse getAssetContext(String userId, String assetGUID, String assetType) throws InvalidParameterException, PropertyServerException;](https://odpi.github.io/egeria/org/odpi/openmetadata/accessservices/assetcatalog/AssetCatalog.html#getAssetContext(java.lang.String,java.lang.String,java.lang.String)) + +## REST endpoint ``` GET {{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/asset-context/{{asset-guid}} @@ -21,6 +24,9 @@ Path and request parameters: Response: * `AssetResponse` - list of properties used to narrow the search +More examples can be found in the +[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json). + ---8<-- "snippets/abbr.md" diff --git a/site/docs/services/omas/asset-catalog/get-asset-details.md b/site/docs/services/omas/asset-catalog/get-asset-details.md index 7c420d731e..04acda61c9 100644 --- a/site/docs/services/omas/asset-catalog/get-asset-details.md +++ b/site/docs/services/omas/asset-catalog/get-asset-details.md @@ -3,10 +3,13 @@ # Get Asset Details -Fetches asset's properties, relationships and classifications +Fetches asset's properties, relationships and classifications. -More examples can be found in the -[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json) +## Java client + +AssetCatalog.java, method (more details in javadoc): [AssetCatalogResponse getAssetDetails(String userId, String assetGUID, String assetType) throws InvalidParameterException, PropertyServerException;](https://odpi.github.io/egeria/org/odpi/openmetadata/accessservices/assetcatalog/AssetCatalog.html#getAssetDetails(java.lang.String,java.lang.String,java.lang.String)) + +## REST endpoint ``` GET {{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/asset-details/{{asset-guid}} @@ -20,6 +23,9 @@ Path and request parameters: Response: * `AssetCatalogResponse` - list of properties used to narrow the search +More examples can be found in the +[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json). + ---8<-- "snippets/abbr.md" diff --git a/site/docs/services/omas/asset-catalog/get-asset-relationships.md b/site/docs/services/omas/asset-catalog/get-asset-relationships.md index 3c53c7d2a6..946e9c82fa 100644 --- a/site/docs/services/omas/asset-catalog/get-asset-relationships.md +++ b/site/docs/services/omas/asset-catalog/get-asset-relationships.md @@ -3,10 +3,13 @@ # Get Asset Relationships -Fetches the relationships for a specific asset +Fetches the relationships for a specific asset. -More examples can be found in the -[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json) +## Java client + +AssetCatalog.java, method (more details in javadoc): [RelationshipResponse getRelationshipBetweenEntities(String userId, String entity1GUID, String entity2GUID, String relationshipType) throws InvalidParameterException, PropertyServerException;](https://odpi.github.io/egeria/org/odpi/openmetadata/accessservices/assetcatalog/AssetCatalog.html#getRelationshipBetweenEntities(java.lang.String,java.lang.String,java.lang.String,java.lang.String)) + +## REST endpoint ``` GET {{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/asset-relationships/{{asset-guid}}?assetType={{asset-type}}&relationshipType={{relationship-type}} @@ -23,6 +26,9 @@ Path and request parameters: Response: * `RelationshipListResponse` - list of relationships for the given asset +More examples can be found in the +[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json). + ---8<-- "snippets/abbr.md" diff --git a/site/docs/services/omas/asset-catalog/get-asset-universe.md b/site/docs/services/omas/asset-catalog/get-asset-universe.md index 3f2ccff5b2..2c3e9078d3 100644 --- a/site/docs/services/omas/asset-catalog/get-asset-universe.md +++ b/site/docs/services/omas/asset-catalog/get-asset-universe.md @@ -3,10 +3,13 @@ # Get Asset Universe -Fetches asset's header, classification, properties and relationships +Fetches asset's header, classification, properties and relationships. -More examples can be found in the -[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json) +## Java client + +AssetCatalog.java, method (more details in javadoc): [AssetCatalogResponse getAssetUniverse(String userId, String assetGUID, String assetType) throws InvalidParameterException, PropertyServerException;](https://odpi.github.io/egeria/org/odpi/openmetadata/accessservices/assetcatalog/AssetCatalog.html#getAssetUniverse(java.lang.String,java.lang.String,java.lang.String)) + +## REST endpoint ``` GET {{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/asset-relationships/{{asset-guid}}?assetType={{asset-type}}&relationshipType={{relationship-type}} @@ -20,6 +23,9 @@ Path and request parameters: Response: * `AssetCatalogResponse` - the asset with its header and the list of associated classifications and relationship +More examples can be found in the +[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json). + ---8<-- "snippets/abbr.md" diff --git a/site/docs/services/omas/asset-catalog/get-supported-types.md b/site/docs/services/omas/asset-catalog/get-supported-types.md index 66bfaf4276..8598e4f23a 100644 --- a/site/docs/services/omas/asset-catalog/get-supported-types.md +++ b/site/docs/services/omas/asset-catalog/get-supported-types.md @@ -3,10 +3,13 @@ # Get Supported Types -Returns the list with supported types for search, including the sub-types supported +Returns the list with supported types for search, including the sub-types supported. -More examples can be found in the -[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json) +## Java client + +AssetCatalog.java, method (more details in javadoc): [AssetCatalogSupportedTypes getSupportedTypes(String userId, String type) throws InvalidParameterException, PropertyServerException;](https://odpi.github.io/egeria/org/odpi/openmetadata/accessservices/assetcatalog/AssetCatalog.html#getSupportedTypes(java.lang.String,java.lang.String)) + +## REST endpoint ``` GET {{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/supportedTypes @@ -19,6 +22,9 @@ Path and request parameters: Response: * `AssetCatalogSupportedTypes` - list of types and sub-types supported for search +More examples can be found in the +[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json). + ---8<-- "snippets/abbr.md" diff --git a/site/docs/services/omas/asset-catalog/search.md b/site/docs/services/omas/asset-catalog/search.md index a72c429247..e5e124ba24 100644 --- a/site/docs/services/omas/asset-catalog/search.md +++ b/site/docs/services/omas/asset-catalog/search.md @@ -3,10 +3,13 @@ # Search -Returns the list with supported types for search, including the sub-types supported +Returns the list with supported types for search, including the sub-types supported. -More examples can be found in the -[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json) +## Java client + +AssetCatalog.java, method (more details in javadoc): [AssetListResponse searchByType(String userId, String searchCriteria, SearchParameters searchParameters) throws InvalidParameterException, PropertyServerException;](https://odpi.github.io/egeria/org/odpi/openmetadata/accessservices/assetcatalog/AssetCatalog.html#searchByType(java.lang.String,java.lang.String,org.odpi.openmetadata.accessservices.assetcatalog.model.rest.body.SearchParameters)) + +## REST endpoint ``` GET {{base-url}}/servers/{{server-id}}/open-metadata/access-services/asset-catalog/users/{{user-id}}/supportedTypes @@ -20,6 +23,9 @@ Path and request parameters: Response: * `AssetListResponse` - list of found assets +More examples can be found in the +[sample collection](samples/collections/Asset-Catalog-endpoints.postman_collection.json). + ---8<-- "snippets/abbr.md"