IBM Cloud API Docs

Introduction to IBM Knowledge Catalog as a Service

Note: this documentation page is under construction. Refer to Watson Data API documentation page for full description of APIs provided by IBM Knowledge Catalog.

You can use the IBM Knowledge Catalog as a Service APIs to establish business vocabulary, import and enrich data assets, analyze data quality, define data protection rules, and more.

IBM Knowledge Catalog as a Service builds on top of the common core functionality for Data and AI SaaS products. The common core functionality provides fundamental features, such as managing catalogs, projects, assets and connections. You can view common core functionality APIs here.

If you are looking for the IBM Knowledge Catalog software APIs, see here.

For more information, see these resources:

Authentication

Before you can call a common core API you must first create an IAM bearer token. Each token is valid only for one hour, and after a token expires you must create a new one if you want to continue using the API. The recommended method to retrieve a token programmatically is to create an API key for your IBM Cloud identity and then use the IAM token API to exchange that key for a token.

You can create a token in IBM Cloud or by using the IBM Cloud command line interface (CLI).

To create a token in the IBM Cloud:

  1. Log in to IBM Cloud and select Manage > Access (IAM) > API keys.
  2. Create an API key for your own personal identity, copy the key value, and save it in a secure place. After you leave the page, you will no longer be able to access this value.
  3. With your API key, set up a REST API tool and run the following command to the right

You can read more about managing API keys at Understanding API keys documentation page.

  1. Use the value of the access_token property for your API calls. Set the access_token value as the authorization header parameter for requests to the APIs. The format is Authorization: Bearer <access_token_value_here>. For example: Authorization: Bearer eyJhbGciOiJIUz......sgrKIi8hdFs

To create a token by using the IBM Cloud CLI:

  1. Follow the steps to install the CLI, log in to IBM Cloud, and get the token described in Getting an IAM API token programmatically. Remove Bearer from the returned IAM token value in your API calls.

Curl command with API key to retrieve token

curl -X POST 'https://iam.cloud.ibm.com/identity/token'   -H 'Content-Type: application/x-www-form-urlencoded'   -d 'grant_type=urn:ibm:params:oauth:grant-type:apikey&apikey=MY_APIKEY'

Response

{
"access_token": "eyJhbGciOiJIUz......sgrKIi8hdFs",
"refresh_token": "SPrXw5tBE3......KBQ+luWQVY=",
"token_type": "Bearer",
"expires_in": 3600,
"expiration": 1473188353
}

Error handling

Responses with 400-series or 500-series status codes are returned when a request cannot be completed. The body of these responses follows the error model, which contains a code field to identify the problem and a message field to explain how to solve the problem. Each individual endpoint has specific error messages. All responses with 500 or 503 status codes are logged and treated as a critical failure that requires an emergency fix.

Rate Limiting

The following rate limiting headers are supported by some of the common core service APIs:

  1. X-RateLimit-Limit: If rate limiting is active, this header indicates the number of requests permitted per hour;
  2. X-RateLimit-Remaining: If rate limiting is active, this header indicates the number of requests remaining in the current rate limit window;
  3. X-RateLimit-Reset: If rate limiting is active, this header indicates the time at which the current rate limit window resets, as a UNIX timestamp.

Methods

List data profiles

Status: Complete

Get the list of data profiles in the specified project or catalog for a given dataAsset, provided the caller has the necessary rights to do so. The returned results can be filtered by using one or more of the listed parameters.

| Field | Match type | Example | | --------------- | ------------ | ------------------------------ | | dataset_id | Equals | ?dataset_id=5210c7d-cf6b |

GET /v2/data_profiles

Request

Query Parameters

  • The ID of the data set to use.

  • The ID of the catalog to use. catalog_id or project_id is required.

  • The ID of the project to use. catalog_id or project_id is required.

  • Whether to include the entity component. If set to false, only the metadata component is populated in the response.

    Default: true

  • Include minimum payload for profiling results. If set to true, only minimum required details for DPS are available in the response.

    Default: false

  • Return the analysis results for specified column. This option will be ignored for data profile run using data flow.

Response

A page from a collection of data profiles.

Status Code

  • Success.

  • You are not permitted to perform this action.

  • You are not authorized to list the available data profiles.

  • Not Found.

  • An error occurred. The data profiles cannot be listed.

No Sample Response

This method does not specify any sample responses.

Create data profile

Status: Complete

Creates a data profile for a given data set in the specified project or catalog, provided the caller has the necessary rights to do so. Subsequent calls to use the data profile must specify the relevant project or catalog ID that the data profile was created in.

The request payload must include the 'metadata' section containing the data set id and catalog/project id.

The request payload can have the 'entity' section which is optional specifying the data profile options. If these options are not specified, default options are taken. To create several data profiles at once in the specified project or catalog, specify an array of data set in the attribute dataset_ids instead of a single data set in the attribute dataset_id. In this case, the data profiles are created in a single job that can be found in the execution section of the returned data profile entity.

AMQP 1.0 Messages

When a new data profile is created, a message is fired with a state of the new data profile in the body.

Topic

v2.data_profiles.:guid.POST ,where the ":guid" represents the profile_id of the created Data Profile

Subscribe to it by using "v2.data_profiles.*.POST" Binding Key.

Example Message

Topic: v2.data_profiles.5210c7d-cf6b-4204-95d2-95d84ecbe382.POST

Message:

{
 "event": "CREATE_DATA_PROFILE",
 "actor": {          
   "user_name": "john@acme.com"          
 },
 "published": "2015-05-10T15:04:15Z",
 "url": { /* The href of the DataProfile created */}
 "status_code": { /* The Http Status code , 201 if the DataProfile is created successfully */}
 "state": { /* the data profile object equivalent to the one obtained by GET /v2/data_profiles/{profile_id} API */ }
 "details": {
    "catalog_id": "f3c59258-abdd-4e24-828b-0495ec519339",
    "dataset_id": "e522db21-59e8-44ab-81b2-bb40c3030a6f",
    "profile_id": "5165d439-96f0-40d4-90b2-93795deab61b",
    "is_governed": false { /* set to true if the catalog is_governed else set it to false}
   }
}
POST /v2/data_profiles

Request

Query Parameters

  • Whether to start the profiling service immediately after the data profile is created.

  • Whether to use Metadata enrichment for profiling. If set to true, Metadata enrichment features are eanbled (will use new Lite services).

    Default: false

  • Whether to charge the bulk profiling to include term assignment charges.

    Default: false

The data profile to create.

Response

A data profile holds the data profiling controls, options and results of a data set.

Status Code

  • Success.

  • Accepted.

  • You are not authorized to create a data profile.

  • You are not permitted to perform this action.

  • The data profile cannot be found.

  • An error occurred. The data profile cannot be created.

No Sample Response

This method does not specify any sample responses.

Get data profile

Status: Complete

Gets a data profile from a project or catalog, provided the call has the required right to do so.

GET /v2/data_profiles/{profile_id}

Request

Path Parameters

  • The profile ID to use.

Query Parameters

  • The ID of the data set to use.

  • The ID of the catalog to use. catalog_id or project_id is required.

  • The ID of the project to use. catalog_id or project_id is required.

  • Include minimum payload for profiling results. If set to true, only minimum required details for DPS are available in the response.

    Default: false

Response

A data profile holds the data profiling controls, options and results of a data set.

Status Code

  • Success.

  • You are not authorized to get the data profile you specified.

  • You are not permitted to perform this action.

  • The data profile you specified cannot be found.

  • An error occurred. The data profile you specified cannot be fetched.

No Sample Response

This method does not specify any sample responses.

Delete data profile

Status: Complete

Deletes a specified data profile in a project or catalog, provided the caller has the necessary rights to do so.

The data profile is not deleted if the profiling process is still running unless the stop_in_progress_runs parameter is set to true.

DELETE /v2/data_profiles/{profile_id}

Request

Path Parameters

  • The profile ID to use.

Query Parameters

  • The ID of the data set to use.

  • The ID of the catalog to use. catalog_id or project_id is required.

  • The ID of the project to use. catalog_id or project_id is required.

  • Whether to stop all running profiling processes. Data profiles that are running must be stopped before they can be deleted.

    Default: false

  • Whether to use Metadata enrichment for profiling. If set to true, Metadata enrichment features are eanbled (will use new Lite services).

    Default: false

Response

Status Code

  • Success.

  • You are not authorized to delete data profiles.

  • You are not permitted to perform this action.

  • Data profile not found.

  • Data source not supported for profiling.

  • An error occurred. The data profile cannot be deleted.

No Sample Response

This method does not specify any sample responses.

Update data profile

Status: Complete

Updates a data profile in the project or catalog specified in the data profile, provided the caller has the necessary rights to do so.

During update, the entire data profile is replaced, apart from any read-only or response-only attributes.

If the profiling processes is running and the start parameter is set to true, then a data profile is only updated if the stop_in_progress_runs parameter is set to true.

The updates must be specified by using the JSON patch format, described in RFC 6902.

AMQP 1.0 Messages

When a data profile is modified, a message is fired with a state of the modified data profile in the body.

Topic

v2.data_profiles.:guid.PATCH

Subscribe to it by using "v2.data_profiles.*.PATCH" Binding Key.

Example Message

Topic: v2.data_profiles.5210c7d-cf6b-4204-95d2-95d84ecbe382.PATCH

Message:

{
 "event": "UPDATE_DATA_PROFILE",
 "actor": {          
   "user_name": "john@acme.com",           
 },
 "published": "2015-05-10T15:04:15Z",
 "url": { /* The href of the DataProfile created */}
 "status_code": { /* The Http Status code , 200 if the DataProfile is updated successfully */}
 "state": { /* the data profile object equivalent to the one obtained by GET /v2/data_profiles/{profile_id} API */ }
 "details": {
    "catalog_id": "f3c59258-abdd-4e24-828b-0495ec519339",
    "dataset_id": "e522db21-59e8-44ab-81b2-bb40c3030a6f",
    "profile_id": "5165d439-96f0-40d4-90b2-93795deab61b",
    "is_governed": false { /* set to true if the catalog is_governed else set it to false}
  }
}
PATCH /v2/data_profiles/{profile_id}

Request

Path Parameters

  • The profile ID to use.

Query Parameters

  • The ID of the data set to use.

  • The ID of the catalog to use. catalog_id or project_id is required.

  • The ID of the project to use. catalog_id or project_id is required.

  • Whether to stop all running profiling processes. Data profiles that are running must be stopped before they can be deleted.

    Default: false

  • Whether to use Metadata enrichment for profiling. If set to true, Metadata enrichment features are eanbled (will use new Lite services).

    Default: false

  • Whether to start the profiling service immediately after the data profile is updated.

The updates to make in the data profile.

Response

A data profile holds the data profiling controls, options and results of a data set.

Status Code

  • Success.

  • You are not authorized to update the data profile you specified.

  • You are not permitted to perform this action.

  • The data profile you specified cannot be found.

  • An error occurred. The data profile you specified cannot be updated.

No Sample Response

This method does not specify any sample responses.

Update data profiles

Status: Complete

Updates data profiles in the project or catalog for one or more assets, provided the caller has the necessary rights to do so.

During update, the entire data profiles are replaced, apart from any read-only or response-only attributes.

If any profiling process is running and the start parameter is set to true, then a data profile is only updated if the stop_in_progress_runs parameter is set to true.

The updates must be specified by using the JSON patch format, described in RFC 6902.

AMQP 1.0 Messages

When a data profile is modified, a message is fired with a state of the modified data profile in the body.

Topic

v2.data_profiles.:guid.PATCH

Subscribe to it by using "v2.data_profiles.*.PATCH" Binding Key.

Example Message

Topic: v2.data_profiles.5210c7d-cf6b-4204-95d2-95d84ecbe382.PATCH Message:

{
 "event": "UPDATE_DATA_PROFILE",
 "actor": {          
   "user_name": "john@acme.com",           
 },
 "published": "2015-05-10T15:04:15Z",
 "url": { /* The href of the DataProfile created */}
 "status_code": { /* The Http Status code , 200 if the DataProfile is updated successfully */}
 "state": { /* the data profile object equivalent to the one obtained by GET /v2/data_profiles/{profile_id} API */ }
 "details": {
    "catalog_id": "f3c59258-abdd-4e24-828b-0495ec519339",
    "dataset_id": "e522db21-59e8-44ab-81b2-bb40c3030a6f",
    "profile_id": "5165d439-96f0-40d4-90b2-93795deab61b",
    "is_governed": false { /* set to true if the catalog is_governed else set it to false}
  }
}
POST /v2/data_profiles/bulk

Request

Query Parameters

  • The ID of the catalog to use. catalog_id or project_id is required.

  • The ID of the project to use. catalog_id or project_id is required.

The updates to make in the one or more data profiles.

Response

Contains updates to more than one asset via a POST request, as specified by the JSON patch format in RFC 6902

Status Code

  • Success.

  • You are not authorized to update the data profile you specified.

  • You are not permitted to perform this action.

  • The catalog / project you specified cannot be found.

  • An error occurred. The catalog / project you specified cannot be updated.

No Sample Response

This method does not specify any sample responses.

Stop profiling process

Status: Complete

Stops an in-progress profiling run in the specified project or catalog, provided the caller has the necessary rights to do so. This API will request the action to be performed and return, not perform the action and wait for it to complete.

PUT /v2/data_profiles/{profile_id}/execution

Request

Path Parameters

  • The profile ID to use.

Query Parameters

  • The ID of the data set to use.

  • The ID of the catalog to use. catalog_id or project_id is required.

  • The ID of the project to use. catalog_id or project_id is required.

  • Whether to use Metadata enrichment for profiling. If set to true, Metadata enrichment features are eanbled (will use new Lite services).

    Default: false

The requested action to perform on the profile run.

Response

Status Code

  • Requested.

  • You are not authorized to stop the profiling process.

  • You are not permitted to perform this action.

  • The data profile you specified cannot be found.

  • An error occurred. The profiling process cannot be stopped.

No Sample Response

This method does not specify any sample responses.

Get profiling logs

Status: Complete

Get the logs for the data profile job run on data set in a project or catalog.

GET /v2/data_profiles/{profile_id}/logs

Request

Path Parameters

  • The profile ID to use.

Query Parameters

  • The ID of the data set to use.

  • The ID of the catalog to use. catalog_id or project_id is required.

  • The ID of the project to use. catalog_id or project_id is required.

Response

A collection of data profile job run log entries.

Status Code

  • Success.

  • You are not authorized to get the profiling logs.

  • You are not permitted to perform this action.

  • The data profile you specified cannot be found.

  • An error occurred. Failed to get profiling logs.

No Sample Response

This method does not specify any sample responses.

Get the list of data quality dimensions available.

Status: Complete

Get the list of data quality dimensions available.

GET /v2/data_profiles/dqdimensions

Request

No Request Parameters

This method does not accept any request parameters.

Response

A collection of data quality dimensions.

Status Code

  • Success.

  • You are not permitted to perform this action.

  • An error occurred. Failed to get quality dimensions.

No Sample Response

This method does not specify any sample responses.

Modify asset level classification

Status: Complete

Modifies asset level classification detail in the data_profile attribute in the specified project or catalog, provided the caller has the necessary rights to do so. This API is used for CRUD operations on asset level classification.

The patch request for classification should contain the classification details that are to be added to the data_profile attribute.

The updates must be specified by using the JSON patch format, described in RFC 6902.

PATCH /v2/data_profiles/classification

Request

Query Parameters

  • The ID of the data set to use.

  • The ID of the catalog to use. catalog_id or project_id is required.

  • The ID of the project to use. catalog_id or project_id is required.

  • Whether to use Metadata enrichment for profiling. If set to true, Metadata enrichment features are eanbled (will use new Lite services).

    Default: false

The asset level classification details that are added to the data_profile attribute.

Response

Custom data to be associated with a given object

Status Code

  • Success.

  • Invalid classification details provided as part of the patch call.

  • You are not authorized to modify the data_profile attribute with asset level classification details.

  • You are not permitted to perform this action.

  • The asset classification cannot be found.

  • An error occurred. The data_profile attribute cannot be modified with asset level classification detail.

No Sample Response

This method does not specify any sample responses.

Export data profile

Status: Complete

Export data profile of dataset in a project or catalog. (For internal use only)

GET /v2/data_profiles/export

Request

Query Parameters

  • The ID of the data set to use.

  • The ID of the export task ID to use.

  • The ID of the catalog to use. catalog_id or project_id is required.

  • The ID of the project to use. catalog_id or project_id is required.

Response

Status Code

  • Success.

  • You are not authorized to persist results.

  • You are not permitted to perform this action.

  • Asset or profile is missing

  • An error occurred. The profiling results cannot be saved.

  • This API is not Implemented.

No Sample Response

This method does not specify any sample responses.

Import data profile

Status: Complete

Import data profile of dataset in a project or catalog. (For internal use only)

POST /v2/data_profiles/import

Request

Query Parameters

  • The ID of the data set to use.

  • The ID of the catalog to use. catalog_id or project_id is required.

  • The ID of the project to use. catalog_id or project_id is required.

The data profile to import.

Response

Status Code

  • Success.

  • You are not authorized to persist results.

  • You are not permitted to perform this action.

  • Asset or profile is missing

  • An error occurred. The profiling results cannot be saved.

  • This API is not Implemented.

No Sample Response

This method does not specify any sample responses.

This filters rows from the frequency distribution.

This filters rows from the frequency distribution.

POST /v2/data_profiles/{profile_id}/unique_values

Request

Path Parameters

  • The profile ID to use.

filters to get frequency distribution

Response

list of frequency distribution result of the column

Status Code

  • Success.

  • You are not authorized to get the key analysis you specified.

  • You are not permitted to perform this action.

  • The key analysis task you specified cannot be found.

  • An error occurred. The data profile you specified cannot be fetched.

No Sample Response

This method does not specify any sample responses.

Get data profile options

Status: Complete

Get the data profile options for the Account specified in the IAM token. If the account level data profile options is not available check if it is specified at project or catalog account level, provided the caller has the necessary rights to do so.

GET /v2/data_profiles/options

Request

Query Parameters

  • The ID of the catalog to use. catalog_id or project_id is required.

  • The ID of the project to use. catalog_id or project_id is required.

  • Whether to use Metadata enrichment for profiling. If set to true, Metadata enrichment features are eanbled (will use new Lite services).

    Default: false

Response

Definition of a data profile options.

Status Code

  • Success.

  • You are not permitted to perform this action.

  • You are not authorized to list the available data profiles options.

  • Not Found.

  • An error occurred. The data profiles options cannot be listed.

  • This API is not Implemented.

No Sample Response

This method does not specify any sample responses.

Create data profile options

Status: Complete

Creates a data profile options for a given Account Id in the specified project or catalog, provided the caller has the necessary rights to do so.

POST /v2/data_profiles/options

Request

Query Parameters

  • Whether to use Metadata enrichment for profiling. If set to true, Metadata enrichment features are eanbled (will use new Lite services).

    Default: false

The data profile option to create.

Response

Definition of a data profile options.

Status Code

  • Success.

  • You are not authorized to create data profile options.

  • You are not permitted to perform this action.

  • The data profile options cannot be found.

  • An error occurred. The data profile options cannot be created.

  • This API is not Implemented.

No Sample Response

This method does not specify any sample responses.

Delete data profile options

Status: Complete

Delete the list of data profile options in the specified project or catalog, provided the caller has the necessary rights to do so. If the user specifies the catalog_id or the project_id then the data profile options specified for the catalog or project is deleted. If none of the query parameters,catalog_id or project_id is specified, the default is to delete the account level data profile options.

DELETE /v2/data_profiles/options

Request

Query Parameters

  • Comma separated list of the BSS Account IDs to use (restriced usage).

  • The ID of the catalog to use. catalog_id or project_id is required.

  • The ID of the project to use. catalog_id or project_id is required.

  • Whether to use Metadata enrichment for profiling. If set to true, Metadata enrichment features are eanbled (will use new Lite services).

    Default: false

Response

Status Code

  • Success.

  • You are not permitted to perform this action.

  • You are not authorized to list the available data profiles options.

  • Not Found.

  • An error occurred. The data profiles options cannot be listed.

  • This API is not Implemented.

No Sample Response

This method does not specify any sample responses.

Update the data profile options.

Status: Complete

Updates the data profile options for a given Account in the specified project or catalog, provided the caller has the necessary rights to do so. The data profile options that can be modified are max_row_count,row_percentage,max_distribution_size,max_numeric_stats_bin disabled flag in classification options,ibm_class_codes and custom_class_codes.

If the user specifies the catalog_id or the project_id then the data profile options specified for the catalog or project is updated. Update the account level data profile options if catalog_id or project_id is not specified.

PATCH /v2/data_profiles/options

Request

Query Parameters

  • The ID of the catalog to use. catalog_id or project_id is required.

  • The ID of the project to use. catalog_id or project_id is required.

  • Whether to use Metadata enrichment for profiling. If set to true, Metadata enrichment features are eanbled (will use new Lite services).

    Default: false

The data profile options to add.

Response

Definition of a data profile options.

Status Code

  • Success.

  • You are not authorized to update the data profile options.

  • You are not permitted to perform this action.

  • The data profile options you specified cannot be found.

  • An error occurred. The data profile options cannot be updated.

  • This API is not Implemented.

No Sample Response

This method does not specify any sample responses.

Persist profiling results

Status: Complete

Persist profiling results of dataset in a project or catalog. (For internal use only)

POST /v2/data_profiles/results

Request

Query Parameters

  • The ID of the data set to use.

  • The tenant ID to use.

  • The ID of the catalog to use. catalog_id or project_id is required.

  • The ID of the project to use. catalog_id or project_id is required.

  • The ID to be used for tracking end to end flow.

The data profile option to create.

Response

Status Code

  • Success.

  • You are not authorized to persist results.

  • You are not permitted to perform this action.

  • Asset or profile is missing

  • An error occurred. The profiling results cannot be saved.

  • This API is not Implemented.

No Sample Response

This method does not specify any sample responses.

Update data profile results status

Status: Complete

Update data profile result status of dataset in a project or catalog. (For internal use only)

POST /v2/data_profiles/results/status

Request

Query Parameters

  • The ID of the data set to use.

  • The tenant ID to use.

  • The ID of the catalog to use. catalog_id or project_id is required.

  • The ID of the project to use. catalog_id or project_id is required.

  • The ID to be used for tracking end to end flow.

The data profile result status to update.

Response

Status Code

  • Success.

  • You are not authorized to update data profile result status.

  • You are not permitted to perform this action.

  • Asset or profile is missing

  • An error occurred. The data profile result status cannot be saved.

  • This API is not Implemented.

No Sample Response

This method does not specify any sample responses.

Get bivariate results of given asset.

Status: Complete

Get bivariate results of dataset in a project or catalog. (For internal use only)

GET /v2/data_profiles/bivariate_results

Request

Query Parameters

  • The ID of the data set to use.

  • The ID of the catalog to use. catalog_id or project_id is required.

  • The ID of the project to use. catalog_id or project_id is required.

Response

Bivariate results to be associated with given asset.

Status Code

  • Success.

  • You are not authorized to persist results.

  • You are not permitted to perform this action.

  • Asset is missing

  • An error occurred. The bivariate results cannot be retrieved.

  • This API is not Implemented.

No Sample Response

This method does not specify any sample responses.

Persist bivariate results of given asset.

Status: Complete

Persist bivariate results of dataset in a project or catalog. (For internal use only)

POST /v2/data_profiles/bivariate_results

Request

Query Parameters

  • The ID of the data set to use.

  • The ID of the catalog to use. catalog_id or project_id is required.

  • The ID of the project to use. catalog_id or project_id is required.

The bivariate results to persist.

Response

Status Code

  • Success.

  • You are not authorized to persist results.

  • You are not permitted to perform this action.

  • Asset is missing

  • An error occurred. The bivariate results cannot be saved.

  • This API is not Implemented.

No Sample Response

This method does not specify any sample responses.

Migrate data profile quality results to new Data Quality service

Status: Complete

Migrate data profile quality results of dataset in a project or catalog to new Data Quality service.

POST /v2/data_profiles/migrate

Request

Query Parameters

  • The ID of the catalog to use. catalog_id or project_id is required.

  • The ID of the project to use. catalog_id or project_id is required.

  • The ID of the data set to use.(Use comma separated data set Id's for multiple data sets)

Response

Migration status logging to track progress.

Status Code

  • Successfully initiated migration process.

  • Bad request. Provided parameters could be invalid.

  • You are not authorized, either token is expired or invalid.

  • You are not permitted to perform this action. Only Editor or Admin are allowed.

  • Catalog or Project not found.

  • An error occurred. The profiling results cannot be migrated to data quality service.

  • This API is not Implemented.

No Sample Response

This method does not specify any sample responses.

List Hummingbird tasks

Status: Complete

Get the list of Hummingbird tasks for a specified accout or type, provided the caller has the necessary rights to do so.

GET /v1/hb_tasks

Request

Query Parameters

  • The BSS Account ID to use.

  • The type of the job.

  • Fetch complete details of job.

    Default: false

Response

Collection of HB tasks.

Status Code

  • Success.

  • You are not permitted to perform this action.

  • You are not authorized to list the available Hummingbird tasks.

  • Not Found.

  • An error occurred. The HB tasks cannot be listed.

No Sample Response

This method does not specify any sample responses.

Create a Hummingbird task

Status: Complete

Creates a Hummingbird task entry job.

POST /v1/hb_tasks

Request

The Hummingbird task to create.

Response

An HbTaskResponse holds details about Hummingbird job and the status of task in queue.

Status Code

  • Success.

  • You are not authorized to create a Hummingbird task.

  • You are not permitted to perform this action.

  • The data profile cannot be found.

  • An error occurred. The Hummingbird task cannot be created.

No Sample Response

This method does not specify any sample responses.

Stop Hummingbird tasks

Status: Complete

Stops given Hummingbird task ids. If the Hummingbird task is already completed or is not found then it will be ignored. If the task is locked by other process then it will be ignored as well.

POST /v1/hb_tasks/stop

Request

The Hummingbird task ids to stop.

Response

A StopHbTasksResponse holds details about stop Hummingbird tasks response.

Status Code

  • Success.

  • You are not authorized to cancel Hummingbird tasks.

  • You are not permitted to perform this action.

  • An error occurred. The Hummingbird tasks cannot be stopped.

No Sample Response

This method does not specify any sample responses.

Delete Hummingbird tasks

Status: Complete

Delete given Hummingbird task ids. If a Hummingbird task is not found then it will be ignored. If the Hummingbird task is running and stop_in_progress_job is not true then it will be ignored. If the task is locked by other process then it will be ignored as well.

POST /v1/hb_tasks/delete

Request

Query Parameters

  • Stop running job.

    Default: false

The Hummingbird task ids to delete.

Response

A StopHbTasksResponse holds details about stop Hummingbird tasks response.

Status Code

  • Success.

  • You are not authorized to cancel a Hummingbird task.

  • You are not permitted to perform this action.

  • An error occurred. The Hummingbird tasks cannot be deleted.

No Sample Response

This method does not specify any sample responses.

Get HB task

Status: Complete

Gets a Hummingbird task.

GET /v1/hb_tasks/{hb_task_id}

Request

Path Parameters

  • The ID of the HB task to use.

Response

An HbTaskResponse holds details about Hummingbird job and the status of task in queue.

Status Code

  • Success.

  • You are not authorized to get the data profile you specified.

  • You are not permitted to perform this action.

  • The HB task you specified cannot be found.

  • An error occurred. The HB task you specified cannot be fetched.

No Sample Response

This method does not specify any sample responses.

Delete Hummingbird task

Status: Complete

Deletes a specified Hummingbird task.

This api will throw an exception if stop_in_progress_job parameter is not true and if job is running.

DELETE /v1/hb_tasks/{hb_task_id}

Request

Path Parameters

  • The ID of the HB task to use.

Query Parameters

  • Stop running job.

    Default: false

Response

Status Code

  • Success.

  • You are not authorized to delete Hummingbird task.

  • You are not permitted to perform this action.

  • Hummingbird task not found.

  • An error occurred. The Hummingbird task cannot be deleted.

No Sample Response

This method does not specify any sample responses.

Start Hummingbird task

Status: Complete

Start the specified Hummingbird task, if it is in QUEUED state.

The Hummingbird task is starte in engine, if it is in queued state

POST /v1/hb_tasks/{hb_task_id}/start

Request

Path Parameters

  • The ID of the HB task to use.

Response

Status Code

  • Success.

  • The Hummingbird task is not QUEUED.

  • You are not authorized to start Hummingbird task.

  • You are not permitted to perform this action.

  • Hummingbird task not found.

  • An error occurred. The failed to start Hummingbird task.

No Sample Response

This method does not specify any sample responses.

Stop Hummingbird task

Status: Complete

Stop the specified Hummingbird task.

The Hummingbird task is force stopped in engine

POST /v1/hb_tasks/{hb_task_id}/stop

Request

Path Parameters

  • The ID of the HB task to use.

Response

Status Code

  • Success.

  • You are not authorized to delete Hummingbird task.

  • You are not permitted to perform this action.

  • Hummingbird task not found.

  • An error occurred. The failed to stop Hummingbird task.

No Sample Response

This method does not specify any sample responses.

Get Hummingbird task logs

Status: Complete

Get the spark job logs for Hummingbird task. In order to retrieve the job logs, the HB spark job must be successfully submitted. This will generate a job_id. When successful, this api would return the Hummingbird spark job log.

GET /v1/hb_tasks/{hb_task_id}/logs

Request

Path Parameters

  • The ID of the HB task to use.

Query Parameters

  • The ID of the HB job to use.

Response

Status Code

  • Success.

  • You are not authorized to get Hummingbird task logs.

  • You are not permitted to perform this action.

  • Hummingbird task not found.

  • An error occurred. Failed to retrieve Hummingbird task logs.

No Sample Response

This method does not specify any sample responses.

List all data quality rules or a subset of them

Get a list of data quality rules in the project.

GET /data_quality/v3/projects/{project_id}/rules

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Query Parameters

  • The start token of the resource from where the page should begin.

    Possible values: 1 ≤ length ≤ 512

    Example: g1AAAAA-eJzLYWBgYMpgSmHgKy5JLCrJTq2MT8lPzkzJBYqzmxiYWJiZGYGkOWDSyBJZAPCBD58

  • The maximum number of resources to return.

    Possible values: 1 ≤ value ≤ 200

    Default: 200

    Example: 20

  • Comma-separated list of data quality rule identifiers.

    Possible values: 1 ≤ length ≤ 10000

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5,b1ba1d22-71a7-4adf-99b2-3c8ba1949710

Response

A collection of data quality rules to be returned.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to get the list of data quality rules in the specified project.

  • An error occurred. The list of data quality rules could not be returned.

Example responses
  • {"total_count":100,"limit":50,"first":{"href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/rules?limit=50"},"rules":[{"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf","bound_expression":["TEST.table1.col1<=TEST.table2.col2"],"is_valid":true,"href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/rules/7b3f3a79-6412-480b-a20c-393a3f7addbf","name":"table1.col1LessOrEqualTable2.col2","description":"The column TEST.table1.col1 has fewer or the same number of values as column TEST.table2.col2","sampling":{"size":2500,"interval":13,"sampling_type":"every_nth"},"output":{"columns":[{"variable_name":"col1","name":"out1","type":"rule_variable","disambiguator":1},{"name":"out2","type":"column","source_column":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col1","type":"column"}},{"expression":"col1-col2","name":"out4","type":"rule_expression","disambiguator":2},{"metric":"system_time","name":"out5","type":"metric"}],"database":{"records_type":"all_records","update_type":"append","location":{"connection":{"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf"},"schema_name":"TEST","table_name":"output"}},"maximum_record_count":500},"input":{"definitions":[{"definition":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"disambiguator":1,"bindings":[{"variable_name":"col1","target":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col1","type":"column"}}]},{"definition":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"disambiguator":2,"bindings":[{"variable_name":"col2","target":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col2","type":"column"}}]}]},"joins":[{"type":"inner_join","left_data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"right_data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93xyz"},"left_column_name":"col1","right_column_name":"col2"}],"dimension":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"apply_all_present_dimensions":false}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Create data quality rule

Create a data quality rule.

POST /data_quality/v3/projects/{project_id}/rules

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Data quality rule to create.

Example: {"name":"table1.col1LessOrEqualTable2.col2","description":"The column TEST.table1.col1 has fewer or the same number of values as column TEST.table2.col2","sampling":{"size":2500,"interval":13,"sampling_type":"every_nth"},"output":{"columns":[{"variable_name":"col1","name":"out1","type":"rule_variable","disambiguator":1},{"name":"out2","type":"column","source_column":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col1","type":"column"}},{"expression":"col1-col2","name":"out4","type":"rule_expression","disambiguator":2},{"metric":"system_time","name":"out5","type":"metric"}],"database":{"records_type":"all_records","update_type":"append","location":{"connection":{"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf"},"schema_name":"TEST","table_name":"output"}},"maximum_record_count":500},"input":{"definitions":[{"definition":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"disambiguator":1,"bindings":[{"variable_name":"col1","target":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col1","type":"column"}}]},{"definition":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"disambiguator":2,"bindings":[{"variable_name":"col2","target":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col2","type":"column"}}]}]},"joins":[{"type":"inner_join","left_data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"right_data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93xyz"},"left_column_name":"col1","right_column_name":"col2"}],"dimension":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"apply_all_present_dimensions":false}

Response

A data quality rule defines an executable applying a boolean expression on bound columns.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to create data quality rules in the specified project.

  • An error occurred. The data quality rule could not be created.

Example responses
  • {"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf","bound_expression":["TEST.table1.col1<=TEST.table2.col2"],"is_valid":true,"href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/rules/7b3f3a79-6412-480b-a20c-393a3f7addbf","name":"table1.col1LessOrEqualTable2.col2","description":"The column TEST.table1.col1 has fewer or the same number of values as column TEST.table2.col2","sampling":{"size":2500,"interval":13,"sampling_type":"every_nth"},"output":{"columns":[{"variable_name":"col1","name":"out1","type":"rule_variable","disambiguator":1},{"name":"out2","type":"column","source_column":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col1","type":"column"}},{"expression":"col1-col2","name":"out4","type":"rule_expression","disambiguator":2},{"metric":"system_time","name":"out5","type":"metric"}],"database":{"records_type":"all_records","update_type":"append","location":{"connection":{"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf"},"schema_name":"TEST","table_name":"output"}},"maximum_record_count":500},"input":{"definitions":[{"definition":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"disambiguator":1,"bindings":[{"variable_name":"col1","target":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col1","type":"column"}}]},{"definition":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"disambiguator":2,"bindings":[{"variable_name":"col2","target":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col2","type":"column"}}]}]},"joins":[{"type":"inner_join","left_data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"right_data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93xyz"},"left_column_name":"col1","right_column_name":"col2"}],"dimension":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"apply_all_present_dimensions":false}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Delete data quality rules

Delete the data quality rules for the given list of rule identifiers.

DELETE /data_quality/v3/projects/{project_id}/rules

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Query Parameters

  • Comma-separated list of data quality rule identifiers.

    Possible values: 1 ≤ length ≤ 10000

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5,b1ba1d22-71a7-4adf-99b2-3c8ba1949710

  • The option to delete related output tables when deleting data quality rules.

    Default: false

  • The option to cancel unfinished jobs before deleting or updating data quality rules.

    Default: false

Response

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to delete the data quality rules in the specified project.

  • An error occurred. The data quality rules cannot be deleted.

Example responses
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Validate data quality rule

Check the validity of the data quality rule.

POST /data_quality/v3/projects/{project_id}/validate_rule

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Data quality rule to validate.

Example: {"name":"table1.col1LessOrEqualTable2.col2","description":"The column TEST.table1.col1 has fewer or the same number of values as column TEST.table2.col2","sampling":{"size":2500,"interval":13,"sampling_type":"every_nth"},"output":{"columns":[{"variable_name":"col1","name":"out1","type":"rule_variable","disambiguator":1},{"name":"out2","type":"column","source_column":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col1","type":"column"}},{"expression":"col1-col2","name":"out4","type":"rule_expression","disambiguator":2},{"metric":"system_time","name":"out5","type":"metric"}],"database":{"records_type":"all_records","update_type":"append","location":{"connection":{"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf"},"schema_name":"TEST","table_name":"output"}},"maximum_record_count":500},"input":{"definitions":[{"definition":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"disambiguator":1,"bindings":[{"variable_name":"col1","target":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col1","type":"column"}}]},{"definition":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"disambiguator":2,"bindings":[{"variable_name":"col2","target":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col2","type":"column"}}]}]},"joins":[{"type":"inner_join","left_data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"right_data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93xyz"},"left_column_name":"col1","right_column_name":"col2"}],"dimension":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"apply_all_present_dimensions":false}

Response

A data quality rule defines an executable applying a boolean expression on bound columns.

Status Code

  • The data quality rule is valid.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to validate data quality rules in the specified project.

  • The data quality rule is invalid. See the error message for the cause.

Example responses
  • {"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf","bound_expression":["TEST.table1.col1<=TEST.table2.col2"],"is_valid":true,"href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/rules/7b3f3a79-6412-480b-a20c-393a3f7addbf","name":"table1.col1LessOrEqualTable2.col2","description":"The column TEST.table1.col1 has fewer or the same number of values as column TEST.table2.col2","sampling":{"size":2500,"interval":13,"sampling_type":"every_nth"},"output":{"columns":[{"variable_name":"col1","name":"out1","type":"rule_variable","disambiguator":1},{"name":"out2","type":"column","source_column":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col1","type":"column"}},{"expression":"col1-col2","name":"out4","type":"rule_expression","disambiguator":2},{"metric":"system_time","name":"out5","type":"metric"}],"database":{"records_type":"all_records","update_type":"append","location":{"connection":{"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf"},"schema_name":"TEST","table_name":"output"}},"maximum_record_count":500},"input":{"definitions":[{"definition":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"disambiguator":1,"bindings":[{"variable_name":"col1","target":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col1","type":"column"}}]},{"definition":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"disambiguator":2,"bindings":[{"variable_name":"col2","target":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col2","type":"column"}}]}]},"joins":[{"type":"inner_join","left_data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"right_data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93xyz"},"left_column_name":"col1","right_column_name":"col2"}],"dimension":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"apply_all_present_dimensions":false}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Get data quality rule

Gets the data quality rule with the given identifier.

GET /data_quality/v3/projects/{project_id}/rules/{id}

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • The data quality rule identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Response

A data quality rule defines an executable applying a boolean expression on bound columns.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to get the data quality rule with the given identifier from the specified project.

  • The data quality rule cannot be found.

  • An error occurred. The data quality rule with the given identifier cannot be returned.

Example responses
  • {"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf","bound_expression":["TEST.table1.col1<=TEST.table2.col2"],"is_valid":true,"href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/rules/7b3f3a79-6412-480b-a20c-393a3f7addbf","name":"table1.col1LessOrEqualTable2.col2","description":"The column TEST.table1.col1 has fewer or the same number of values as column TEST.table2.col2","sampling":{"size":2500,"interval":13,"sampling_type":"every_nth"},"output":{"columns":[{"variable_name":"col1","name":"out1","type":"rule_variable","disambiguator":1},{"name":"out2","type":"column","source_column":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col1","type":"column"}},{"expression":"col1-col2","name":"out4","type":"rule_expression","disambiguator":2},{"metric":"system_time","name":"out5","type":"metric"}],"database":{"records_type":"all_records","update_type":"append","location":{"connection":{"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf"},"schema_name":"TEST","table_name":"output"}},"maximum_record_count":500},"input":{"definitions":[{"definition":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"disambiguator":1,"bindings":[{"variable_name":"col1","target":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col1","type":"column"}}]},{"definition":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"disambiguator":2,"bindings":[{"variable_name":"col2","target":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col2","type":"column"}}]}]},"joins":[{"type":"inner_join","left_data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"right_data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93xyz"},"left_column_name":"col1","right_column_name":"col2"}],"dimension":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"apply_all_present_dimensions":false}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Delete data quality rule

Delete the data quality rule with the given identifier.

DELETE /data_quality/v3/projects/{project_id}/rules/{id}

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • The data quality rule identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Query Parameters

  • The option to delete related output tables when deleting data quality rules.

    Default: false

  • The option to cancel unfinished jobs before deleting or updating data quality rules.

    Default: false

Response

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to delete the data quality rule from the specified project.

  • The data quality rule cannot be found.

  • An error occurred. The data quality rule cannot be deleted.

Example responses
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Update data quality rule

Updates a data quality rule as specified in the payload details of the update rule request. The updates must be specified by using the JSON patch format, described in RFC 6902.

The following attributes can be patched:

  • name (value can only be replaced)
  • definition (value can only be replaced)
  • description (value can be added, removed, or replaced)
  • dimension (value can be added, removed, or replaced)
  • input (value can be added, removed or replaced)
  • output (value can be added, removed, or replaced)
  • joins (value can be added, removed, or replaced)
  • sampling (value can be added, removed, or replaced)
  • data_stage/propagate_all_incoming_columns (value can be added, removed, or replaced)
PATCH /data_quality/v3/projects/{project_id}/rules/{id}

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • The data quality rule identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Query Parameters

  • The option to cancel unfinished jobs before deleting or updating data quality rules.

    Default: false

  • The option to keep the current data quality rule input binding relationships while updating the data quality rule.

    Default: false

The updates to make in the data quality rule.

Example: [{"op":"replace","path":"/description","value":"Column col1 has fewer or the same number of values as column col2"}]

Response

A data quality rule defines an executable applying a boolean expression on bound columns.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to update the data quality rule in the specified project.

  • The data quality rule cannot be found.

  • An error occurred. The data quality rule was not updated.

Example responses
  • {"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf","bound_expression":["TEST.table1.col1<=TEST.table2.col2"],"is_valid":true,"href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/rules/7b3f3a79-6412-480b-a20c-393a3f7addbf","name":"table1.col1LessOrEqualTable2.col2","description":"The column TEST.table1.col1 has fewer or the same number of values as column TEST.table2.col2","sampling":{"size":2500,"interval":13,"sampling_type":"every_nth"},"output":{"columns":[{"variable_name":"col1","name":"out1","type":"rule_variable","disambiguator":1},{"name":"out2","type":"column","source_column":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col1","type":"column"}},{"expression":"col1-col2","name":"out4","type":"rule_expression","disambiguator":2},{"metric":"system_time","name":"out5","type":"metric"}],"database":{"records_type":"all_records","update_type":"append","location":{"connection":{"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf"},"schema_name":"TEST","table_name":"output"}},"maximum_record_count":500},"input":{"definitions":[{"definition":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"disambiguator":1,"bindings":[{"variable_name":"col1","target":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col1","type":"column"}}]},{"definition":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"disambiguator":2,"bindings":[{"variable_name":"col2","target":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col2","type":"column"}}]}]},"joins":[{"type":"inner_join","left_data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"right_data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93xyz"},"left_column_name":"col1","right_column_name":"col2"}],"dimension":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"apply_all_present_dimensions":false}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Run data quality rule

Run the data quality rule with the given identifier.

POST /data_quality/v3/projects/{project_id}/rules/{id}/execute

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • The data quality rule identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Response

The representation of a data quality rule execution.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to run the data quality rule in the specified project.

  • The data quality rule cannot be found.

  • An error occurred. The data quality rule cannot be run.

Example responses
  • {"name":"table1.col1LessOrEqualTable2.col2","job":{"id":"aa398b69-3e91-4830-877a-91a8e21f56de"},"job_run":{"id":"aa398b69-3e91-4830-877a-91a8e21f5123"},"status":{"state":"analyzed"},"started_at":"2022-02-01T18:10:02.000Z","ended_at":"2022-02-01T18:11:02.000Z","run_by":"IBMid-270002ABCD","sampling":{"size":2500,"interval":13,"sampling_type":"every_nth"},"input":{"definitions":[{"bound_expression":"TEST.table1.col1<=TEST.table2.col2"}]},"output":{"columns":[{"variable_name":"col1","name":"out1","type":"rule_variable","disambiguator":1},{"name":"out2","type":"column","source_column":{"data_asset":{"id":"aa398b69-3e91-4830-877a-91a8e21f56de"},"column_name":"col1","type":"column"}},{"expression":"col1-col2","name":"out4","type":"rule_expression","disambiguator":2},{"metric":"system_time","name":"out5","type":"metric"}],"database":{"records_type":"all_records","update_type":"append","location":{"connection":{"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf"},"schema_name":"TEST","table_name":"output"}},"maximum_record_count":500},"output_table":{"id":"5d4254a6-0c9e-4a02-bc24-4a89eee06f12"},"tested_record_count":1000,"passing_record_count":987,"failing_record_count":13,"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf","href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/rules/7b3f3a79-6412-480b-a20c-393a3f7addbf/executions/7b3f3a79-6412-480b-a20c-393a3f7adabc"}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Get data quality rule from catalog

Gets the data quality rule from catalog with the given identifier.

GET /data_quality/v3/catalogs/{catalog_id}/rules/{id}

Request

Path Parameters

  • The identifier of the catalog to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • The data quality rule identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Response

A data quality rule defines an executable applying a boolean expression on bound columns.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to get the data quality rule with the given identifier from the specified catalog.

  • The data quality rule cannot be found.

  • An error occurred. The data quality rule with the given identifier cannot be returned.

Example responses
  • {"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf","bound_expression":["TEST.table1.col1<=TEST.table2.col2"],"is_valid":true,"href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/rules/7b3f3a79-6412-480b-a20c-393a3f7addbf","name":"table1.col1LessOrEqualTable2.col2","description":"The column TEST.table1.col1 has fewer or the same number of values as column TEST.table2.col2","sampling":{"size":2500,"interval":13,"sampling_type":"every_nth"},"output":{"columns":[{"variable_name":"col1","name":"out1","type":"rule_variable","disambiguator":1},{"name":"out2","type":"column","source_column":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col1","type":"column"}},{"expression":"col1-col2","name":"out4","type":"rule_expression","disambiguator":2},{"metric":"system_time","name":"out5","type":"metric"}],"database":{"records_type":"all_records","update_type":"append","location":{"connection":{"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf"},"schema_name":"TEST","table_name":"output"}},"maximum_record_count":500},"input":{"definitions":[{"definition":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"disambiguator":1,"bindings":[{"variable_name":"col1","target":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col1","type":"column"}}]},{"definition":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"disambiguator":2,"bindings":[{"variable_name":"col2","target":{"data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"column_name":"col2","type":"column"}}]}]},"joins":[{"type":"inner_join","left_data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"right_data_asset":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93xyz"},"left_column_name":"col1","right_column_name":"col2"}],"dimension":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"apply_all_present_dimensions":false}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

List history of all data quality rule run results or a subset of them

Gets the list of data quality rule runs. By default, the runs are sorted newest to oldest.

GET /data_quality/v3/projects/{project_id}/rules/{rule_id}/executions

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • The data quality rule identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Query Parameters

  • The start token of the resource from where the page should begin.

    Possible values: 1 ≤ length ≤ 512

    Example: g1AAAAA-eJzLYWBgYMpgSmHgKy5JLCrJTq2MT8lPzkzJBYqzmxiYWJiZGYGkOWDSyBJZAPCBD58

  • The maximum number of resources to return.

    Possible values: 1 ≤ value ≤ 200

    Default: 200

    Example: 20

  • The property name by which the results should be sorted. For descending order, use the hyphen (-) prefix with the value. If you omit this query parameter, the order value is -started_at, which means, results are sorted by the started_at value in descending order. The allowed fields are started_at, passing_record_count, failing_record_count, tested_record_count, status.state.

    Possible values: 1 ≤ length ≤ 128

Response

Data quality rule run history

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to get the data quality rule history in the specified project.

  • An error occurred. The data quality rule history could not be returned.

Example responses
  • {"limit":20,"total_count":100,"first":{"href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/rules/c19cde3a-5940-4c7a-ad0f-ee18f5f29c12/executions?limit=20"},"executions":[{"name":"table1.col1LessOrEqualTable2.col2","description":"The column TEST.table1.col1 has fewer or the same number of values as column TEST.table2.col2","job":{"id":"aa398b69-3e91-4830-877a-91a8e21f56de"},"job_run":{"id":"aa398b69-3e91-4830-877a-91a8e21f5123"},"status":{"state":"analyzed"},"started_at":"2022-02-01T18:10:02.000Z","ended_at":"2022-02-01T18:11:02.000Z","run_by":"IBMid-270002ABCD","sampling":{"size":2500,"interval":13,"sampling_type":"every_nth"},"output":{"columns":[{"variable_name":"col1","name":"out1","type":"rule_variable","disambiguator":1},{"name":"out2","type":"column","source_column":{"data_asset":{"id":"aa398b69-3e91-4830-877a-91a8e21f56de"},"column_name":"col1","type":"column"}},{"expression":"col1-col2","name":"out4","type":"rule_expression","disambiguator":2},{"metric":"system_time","name":"out5","type":"metric"}],"database":{"records_type":"all_records","update_type":"append","location":{"connection":{"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf"},"schema_name":"TEST","table_name":"output"}},"maximum_record_count":500},"output_table":{"id":"5d4254a6-0c9e-4a02-bc24-4a89eee06f12"},"tested_record_count":1000,"bound_expression":["TEST.table1.col1<=TEST.table2.col2"],"passing_record_count":987,"failing_record_count":13,"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf","href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/rules/7b3f3a79-6412-480b-a20c-393a3f7addbf/executions/7b3f3a79-6412-480b-a20c-393a3f7adabc"}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Get the data quality rule run

Gets the data quality rule run result with the given identifier.

GET /data_quality/v3/projects/{project_id}/rules/{rule_id}/executions/{id}

Request

Path Parameters

  • The data quality rule identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • The run identifier to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Response

The representation of a data quality rule execution.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to get the data quality rule run result in the specified project.

  • An error occurred. The result of data quality rule run could not be returned.

Example responses
  • {"name":"table1.col1LessOrEqualTable2.col2","job":{"id":"aa398b69-3e91-4830-877a-91a8e21f56de"},"job_run":{"id":"aa398b69-3e91-4830-877a-91a8e21f5123"},"status":{"state":"analyzed"},"started_at":"2022-02-01T18:10:02.000Z","ended_at":"2022-02-01T18:11:02.000Z","run_by":"IBMid-270002ABCD","sampling":{"size":2500,"interval":13,"sampling_type":"every_nth"},"input":{"definitions":[{"bound_expression":"TEST.table1.col1<=TEST.table2.col2"}]},"output":{"columns":[{"variable_name":"col1","name":"out1","type":"rule_variable","disambiguator":1},{"name":"out2","type":"column","source_column":{"data_asset":{"id":"aa398b69-3e91-4830-877a-91a8e21f56de"},"column_name":"col1","type":"column"}},{"expression":"col1-col2","name":"out4","type":"rule_expression","disambiguator":2},{"metric":"system_time","name":"out5","type":"metric"}],"database":{"records_type":"all_records","update_type":"append","location":{"connection":{"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf"},"schema_name":"TEST","table_name":"output"}},"maximum_record_count":500},"output_table":{"id":"5d4254a6-0c9e-4a02-bc24-4a89eee06f12"},"tested_record_count":1000,"passing_record_count":987,"failing_record_count":13,"id":"7b3f3a79-6412-480b-a20c-393a3f7addbf","href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/rules/7b3f3a79-6412-480b-a20c-393a3f7addbf/executions/7b3f3a79-6412-480b-a20c-393a3f7adabc"}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

List all data quality definitions or a subset of them

Gets the list of all data quality definitions.

GET /data_quality/v3/projects/{project_id}/definitions

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Query Parameters

  • The start token of the resource from where the page should begin.

    Possible values: 1 ≤ length ≤ 512

    Example: g1AAAAA-eJzLYWBgYMpgSmHgKy5JLCrJTq2MT8lPzkzJBYqzmxiYWJiZGYGkOWDSyBJZAPCBD58

  • The maximum number of resources to return.

    Possible values: 1 ≤ value ≤ 200

    Default: 200

    Example: 20

  • Comma-separated list of data quality definition identifiers.

    Possible values: 1 ≤ length ≤ 10000

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5,b1ba1d22-71a7-4adf-99b2-3c8ba1949710

Response

An array of data quality definitions.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to get the list of data quality definitions in the specified project.

  • An error occurred. The list of data quality definitions cannot be returned.

Example responses
  • {"total_count":100,"limit":200,"first":{"href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/definitions?limit=200"},"definitions":[{"description":"Column col1 has fewer or the same number of values as column col2","id":"7b3f3a79-6412-480b-a20c-393a3f7adoi","name":"col1LessOrEqualCol2","expression":"col1 <= col2","dimension":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/definitions/7b3f3a79-6412-480b-a20c-393a3f7addbf"}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Create data quality definition

Creates a data quality definition in the specified project.

POST /data_quality/v3/projects/{project_id}/definitions

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Data quality definition to create.

Example: {"name":"col1LessOrEqualCol2","description":"Column col1 has fewer or the same number of values as column col2","expression":"col1 <= col2","dimension":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"}}

Response

A data quality definition defines a boolean rule along with the variables.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to create a definition in the specified project.

  • An error occurred. The definition was not created.

Example responses
  • {"description":"Column col1 has fewer or the same number of values as column col2","id":"7b3f3a79-6412-480b-a20c-393a3f7adoi","name":"col1LessOrEqualCol2","expression":"col1 <= col2","dimension":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/definitions/7b3f3a79-6412-480b-a20c-393a3f7addbf"}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Delete data quality definitions

Delete the data quality definitions with the given identifiers.

DELETE /data_quality/v3/projects/{project_id}/definitions

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Query Parameters

  • Comma separated list of data quality definition identifiers.

    Possible values: 1 ≤ length ≤ 10000

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5,b1ba1d22-71a7-4adf-99b2-3c8ba1949710

Response

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to delete the data quality definitions in the specified project or catalog.

  • An error occurred. The data quality definitions cannot be deleted.

Example responses
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Validate data quality definition expression

Validate the specified definition expression.

POST /data_quality/v3/projects/{project_id}/validate_definition

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Query Parameters

  • True if the expression to validate is an output column expression. False if the expression to validate is a data quality definition expression. Default value is false.

Data quality definition to validate.

Example: {"name":"col1LessOrEqualCol2","description":"Column col1 has fewer or the same number of values as column col2","expression":"col1 <= col2","dimension":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"}}

Response

This response contains the rule expression variables and their types.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to validate the data quality definition in the specified project or catalog.

  • An error occurred. The data quality definitions could not be validated.

Example responses
  • {"variables":[{"name":"col1","type":"numeric","usage":"input_data"},{"name":"col2","type":"numeric","usage":"input_data"}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Get data quality definition

Gets the data quality definition with the given identifier.

GET /data_quality/v3/projects/{project_id}/definitions/{id}

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • The data quality definition identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Response

A data quality definition defines a boolean rule along with the variables.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to get the data quality definition with the given ID from the specified project or catalog.

  • The data quality definition cannot be found.

  • An error occurred. The data quality definition with the given identifier could not be returned.

Example responses
  • {"description":"Column col1 has fewer or the same number of values as column col2","id":"7b3f3a79-6412-480b-a20c-393a3f7adoi","name":"col1LessOrEqualCol2","expression":"col1 <= col2","dimension":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/definitions/7b3f3a79-6412-480b-a20c-393a3f7addbf"}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Replace data quality definition

Replace a data quality definition.

PUT /data_quality/v3/projects/{project_id}/definitions/{id}

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • The data quality definition identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Data quality definition to replace.

Example: {"name":"col1LessOrEqualCol2","description":"Column col1 has fewer or the same number of values as column col2","expression":"col1 <= col2","dimension":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"}}

Response

A data quality definition defines a boolean rule along with the variables.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to update data quality definitions in the specified project or catalog.

  • An error occurred. The data quality definition was not updated.

Example responses
  • {"description":"Column col1 has fewer or the same number of values as column col2","id":"7b3f3a79-6412-480b-a20c-393a3f7adoi","name":"col1LessOrEqualCol2","expression":"col1 <= col2","dimension":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/definitions/7b3f3a79-6412-480b-a20c-393a3f7addbf"}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Delete data quality definition

Delete the data quality definition with the given identifier.

DELETE /data_quality/v3/projects/{project_id}/definitions/{id}

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • The data quality definition identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Response

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to delete the data quality definition from the specified project.

  • The data quality definition cannot be found.

  • An error occurred. The data quality definition cannot be deleted.

Example responses
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Update data quality definition

Updates a data quality definition as specified in the payload details of the update definition request. The updates must be specified by using the JSON patch format, described in RFC 6902.

The following attributes can be patched.

  • name (value can only be replaced)
  • description (value can be added, removed, or replaced)
  • expression (value can only be replaced)
  • dimension (value can be added, removed, or replaced)
PATCH /data_quality/v3/projects/{project_id}/definitions/{id}

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • The data quality definition identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

The updates to make in the data quality definition.

Example: [{"op":"replace","path":"/description","value":"Column col1 has fewer or the same number of values as column col2"}]

Response

A data quality definition defines a boolean rule along with the variables.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to update the data quality definition in the specified project.

  • The data quality definition cannot be found.

  • An error occurred. The data quality definition was not updated.

Example responses
  • {"description":"Column col1 has fewer or the same number of values as column col2","id":"7b3f3a79-6412-480b-a20c-393a3f7adoi","name":"col1LessOrEqualCol2","expression":"col1 <= col2","dimension":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/definitions/7b3f3a79-6412-480b-a20c-393a3f7addbf"}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Get data quality definition from catalog

Gets the data quality definition from catalog with the given identifier.

GET /data_quality/v3/catalogs/{catalog_id}/definitions/{id}

Request

Path Parameters

  • The identifier of the catalog to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • The data quality definition identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Response

A data quality definition defines a boolean rule along with the variables.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to get the data quality definition with the given ID from the specified project or catalog.

  • The data quality definition cannot be found.

  • An error occurred. The data quality definition with the given identifier could not be returned.

Example responses
  • {"description":"Column col1 has fewer or the same number of values as column col2","id":"7b3f3a79-6412-480b-a20c-393a3f7adoi","name":"col1LessOrEqualCol2","expression":"col1 <= col2","dimension":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/definitions/7b3f3a79-6412-480b-a20c-393a3f7addbf"}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Update data quality definition in catlog

Updates a data quality definition as specified in the payload details of the update definition request. The updates must be specified by using the JSON patch format, described in RFC 6902.

The following attributes can be patched.

  • dimension (value can be added, removed, or replaced)
PATCH /data_quality/v3/catalogs/{catalog_id}/definitions/{id}

Request

Path Parameters

  • The identifier of the catalog to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • The data quality definition identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

The updates to make in the data quality definition.

Example: [{"op":"replace","path":"/description","value":"Column col1 has fewer or the same number of values as column col2"}]

Response

A data quality definition defines a boolean rule along with the variables.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to update the data quality definition in the specified catalog.

  • The data quality definition cannot be found.

  • An error occurred. The data quality definition was not updated.

Example responses
  • {"description":"Column col1 has fewer or the same number of values as column col2","id":"7b3f3a79-6412-480b-a20c-393a3f7adoi","name":"col1LessOrEqualCol2","expression":"col1 <= col2","dimension":{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93abc"},"href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/definitions/7b3f3a79-6412-480b-a20c-393a3f7addbf"}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

List all data quality dimensions

Gets the list of all data quality dimensions

GET /data_quality/v3/projects/{project_id}/dimensions

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Query Parameters

  • The start token of the resource from where the page should begin.

    Possible values: 1 ≤ length ≤ 512

    Example: g1AAAAA-eJzLYWBgYMpgSmHgKy5JLCrJTq2MT8lPzkzJBYqzmxiYWJiZGYGkOWDSyBJZAPCBD58

  • The maximum number of resources to return.

    Possible values: 1 ≤ value ≤ 200

    Default: 200

    Example: 20

Response

A collection of data quality dimensions.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You are not permitted to get data quality dimensions of the specified project.

  • An error occurred. The list of data quality dimensions cannot be returned.

Example responses
  • {"limit":20,"total_count":100,"first":{"href":"https://cloud.ibm.com/data_quality/v3/projects/c19cde3a-5940-4c7a-ad0f-ee18f5f29c00/dimensions?limit=20"},"dimensions":[{"id":"371114cd-5516-4691-8b2e-1e66edf66486","name":"Completeness","description":"The proportion of data stored against the potential for 100%.","creator_id":"SYSTEM","created_at":"2022-02-01T18:11:02.000Z"},{"id":"57561203-36e6-4bb0-adfb-ece981fba845","name":"Uniqueness","description":"No entity instance (`abc`) will be recorded more than once based on how `abc` is identified.","creator_id":"SYSTEM","created_at":"2022-02-01T18:11:02.000Z"},{"id":"a3134282-ed85-4140-ae61-e5f712a61985","name":"Timeliness","description":"The degree to which data represent reality from the required point in time.","creator_id":"SYSTEM","created_at":"2022-02-01T18:11:02.000Z"},{"id":"ec453723-669c-48bb-82c1-11b69b3b8c93","name":"Validity","description":"Data is valid if it conforms to the syntax (format, type, range) of its definition.","creator_id":"SYSTEM","created_at":"2022-02-01T18:11:02.000Z"},{"id":"5f66813e-adb1-4f3f-a65f-40e3066aac07","name":"Accuracy","description":"The degree to which data correctly describes the real world object or event being described.","creator_id":"SYSTEM","created_at":"2022-02-01T18:11:02.000Z"},{"id":"5f66813e-adb1-4f3f-a65f-40e3066aa123","name":"Consistency","description":"The absence of difference when comparing two or more representations of an object against a definition.","creator_id":"SYSTEM","created_at":"2022-02-01T18:11:02.000Z"}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Get project settings for data quality rules

Gets the project settings for data quality rules.

GET /data_quality/v3/projects/{project_id}/settings

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Response

Project settings.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to get the data quality rule settings in the specified project.

  • An error occurred. The project settings for data quality rules could not be returned.

Example responses
  • {"default_else_value":true,"ignore_trailing_spaces":false,"implicit_casting":true,"max_string_length":1024,"allow_quoted_variables":false}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Replace project settings for data quality rules

Replace project settings for data quality rules.

PUT /data_quality/v3/projects/{project_id}/settings

Request

Path Parameters

  • The identifier of the project to use.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Project settings for data quality rules.

Example: {"default_else_value":true,"ignore_trailing_spaces":false,"implicit_casting":true,"max_string_length":1024,"allow_quoted_variables":false}

Response

Project settings.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to define project settings for data quality rules in the specified project.

  • An error occurred. The project settings for data quality rules were not created or updated.

Example responses
  • {"default_else_value":true,"ignore_trailing_spaces":false,"implicit_casting":true,"max_string_length":1024,"allow_quoted_variables":false}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}

Get data quality assets

Get a list of data quality assets.

GET /data_quality/v4/assets

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.assets.read

    User must be a collaborator for the container

Request

Query Parameters

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The start token of the resource from where the page should begin. If omitted, begins with first resource.

    Possible values: 1 ≤ length ≤ 512

    Example: g1AAAAA-eJzLYWBgYMpgSmHgKy5JLCrJTq2MT8lPzkzJBYqzmxiYWJiZGYGkOWDSyBJZAPCBD58

  • The maximum number of resources to return.

    Possible values: 1 ≤ value ≤ 200

    Default: 200

    Example: 20

  • If true include the children in the returned resource. If false, only return the resource without its eventual children.

    Default: false

  • The type of the resource to search. If omitted, filtering on type is not applied

    Possible values: 1 ≤ length ≤ 200

Response

A collection of data quality assets.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to get the list of data quality assets.

  • An error occurred. The list of data quality assets cannot be returned.

Example responses
  • {"total_count":1,"limit":200,"first":{"href":"https://cloud.ibm.com/data_quality/v4/assets?limit=200"},"assets":[{"id":"894d01fd-bdfc-4a4f-b68b-62751e06e06a","name":"CUSTOMERS","type":"data_asset","native_id":"8ddc659c-b155-498d-b310-4ac8cf629ccc/9a1f3644-3ad4-47be-8eb5-006d367c8702","weight":1,"creator_id":"SYSTEM","created_at":"2022-02-02T10:51:02.000Z"}]}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Create Data quality assets

Create a data quality asset.

POST /data_quality/v4/assets

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.assets.create

    User must be either Admin(administrator) or Editor for the container

Request

Query Parameters

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

Data quality asset to create.

Example: {"native_id":"8ddc659c-b155-498d-b310-4ac8cf629ccc/9a1f3644-3ad4-47be-8eb5-006d367c8702","name":"CUSTOMERS","type":"data_asset","weight":1}

Response

A data asset on which data quality is measured.

Status Code

  • Success

  • The given payload is invalid and the asset is not created.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to create a data quality asset.

  • The data quality asset exists already and cannot be created.

  • An error occurred. The data quality asset cannot be created.

Example responses
  • {"id":"894d01fd-bdfc-4a4f-b68b-62751e06e06a","name":"CUSTOMERS","type":"data_asset","native_id":"8ddc659c-b155-498d-b310-4ac8cf629ccc/9a1f3644-3ad4-47be-8eb5-006d367c8702","weight":1,"creator_id":"SYSTEM","created_at":"2022-02-02T10:51:02.000Z"}
  • {"trace":"6vbjp9d2t4s9b2ckyspdw4vft","status_code":400,"errors":[{"code":"missing_required_field","message":"Bad Request: {\"trace\":\"8f7b7693-1f08-4b4a-b2bd-5732d06ad19e\", \"errors\":[{\"code\":\"invalid_parameter\", \"message\":\"COMSV3006E: Missing or Invalid asset id\", \"target\":{\"name\":\"asset\",\"type\":\"parameter\"}}]}"}]}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"28izpw5l1a4orh823i6bkqmm","status_code":409,"errors":[{"code":"already_exists","message":"The dimension with name 'Completeness' already exists."}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Get a data quality asset

Get the data quality asset with the given identifier.

GET /data_quality/v4/assets/{id}

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.assets.read

    User must be a collaborator for the container

Request

Path Parameters

  • The data quality asset identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Query Parameters

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • If true include the children in the returned resource. If false, only return the resource without its eventual children.

    Default: false

Response

A data asset on which data quality is measured.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to get the data quality asset.

  • The data quality asset with the given ID cannot be found.

  • An error occurred. The data quality asset cannot be returned.

Example responses
  • {"id":"894d01fd-bdfc-4a4f-b68b-62751e06e06a","name":"CUSTOMERS","type":"data_asset","native_id":"8ddc659c-b155-498d-b310-4ac8cf629ccc/9a1f3644-3ad4-47be-8eb5-006d367c8702","weight":1,"creator_id":"SYSTEM","created_at":"2022-02-02T10:51:02.000Z"}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Delete data quality asset

Delete the data quality asset with the given identifier and all its children recursively

DELETE /data_quality/v4/assets/{id}

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.assets.delete

    User must be either Admin(administrator) or Editor for the container

Auditing

Calling this method generates the following auditing event, depending on any listed conditions.

  • wdp-data_quality.issue.delete

    Tracking event with action name 'wdp-data_quality.issue.delete' is logged as the asset related issues are deleted.

Request

Path Parameters

  • The data quality asset identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Query Parameters

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • If true, delete all children recursively. Otherwise, only selected one is deleted.

    Default: false

Response

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to delete the data quality asset.

  • The data quality asset cannot be found.

  • An error occurred. The data quality asset cannot be deleted.

Example responses
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Update or patch a data quality asset

Update a data quality asset as specified in the payload details of the request.

The updates must be specified by using the JSON patch format, described in RFC 6902.

The following attributes can be updated: - /name (value can only be replaced) - /weight (value can only be replaced)

PATCH /data_quality/v4/assets/{id}

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.assets.update

    User must be either Admin(administrator) or Editor for the container

Request

Path Parameters

  • The data quality asset identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Query Parameters

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

The updates to make in the data quality rule.

Example: [{"op":"replace","path":"/description","value":"The proportion of data stored against the potential for 100% of the data."}]

Response

A data asset on which data quality is measured.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to update the data quality asset.

  • The data quality asset with the given ID cannot be found.

  • An error occurred. The data quality asset cannot be updated.

Example responses
  • {"id":"894d01fd-bdfc-4a4f-b68b-62751e06e06a","name":"CUSTOMERS","type":"data_asset","native_id":"8ddc659c-b155-498d-b310-4ac8cf629ccc/9a1f3644-3ad4-47be-8eb5-006d367c8702","weight":1,"creator_id":"SYSTEM","created_at":"2022-02-02T10:51:02.000Z"}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Search data quality asset with given native id and type

Search for a data quality asset by its native id and type

POST /data_quality/v4/search_dq_asset

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.assets.read

    User must be a collaborator for the container

Request

Query Parameters

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The native id, as known by the DQ producer, of the resource to search. If not provided, other identity parameters must be provided.

    Possible values: 1 ≤ length ≤ 500

  • The type of the resource to search. If omitted, filtering on type is not applied

    Possible values: 1 ≤ length ≤ 200

  • The identity of the IBM Knowledge Catalog asset this DQ asset is referring to

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • If true include the children in the returned resource. If false, only return the resource without its eventual children.

    Default: false

Response

A data asset on which data quality is measured.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to search data quality assets.

  • The data quality asset cannot be found.

  • An error occurred. The data quality asset cannot be searched.

Example responses
  • {"id":"894d01fd-bdfc-4a4f-b68b-62751e06e06a","name":"CUSTOMERS","type":"data_asset","native_id":"8ddc659c-b155-498d-b310-4ac8cf629ccc/9a1f3644-3ad4-47be-8eb5-006d367c8702","weight":1,"creator_id":"SYSTEM","created_at":"2022-02-02T10:51:02.000Z"}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Get data quality checks

Get a list of data quality checks.

GET /data_quality/v4/checks

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.checks.read

    User must be a collaborator for the container

Request

Query Parameters

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The start token of the resource from where the page should begin. If omitted, begins with first resource.

    Possible values: 1 ≤ length ≤ 512

    Example: g1AAAAA-eJzLYWBgYMpgSmHgKy5JLCrJTq2MT8lPzkzJBYqzmxiYWJiZGYGkOWDSyBJZAPCBD58

  • The maximum number of resources to return.

    Possible values: 1 ≤ value ≤ 200

    Default: 200

    Example: 20

  • If true include the children in the returned resource. If false, only return the resource without its eventual children.

    Default: false

  • The type of the resource to search. If omitted, filtering on type is not applied

    Possible values: 1 ≤ length ≤ 200

Response

A collection of data quality checks.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to get the list of data quality checks.

  • An error occurred. The list of data quality checks cannot be returned.

Example responses
  • {"total_count":1,"limit":200,"first":{"href":"https://cloud.ibm.com/data_quality/v4/checks?limit=200"},"checks":[{"id":"894d01fd-bdfc-4a4f-b68b-62751e06e06a","name":"check_uniqueness_of_id","dimension":{"id":"371114cd-5516-4691-8b2e-1e66edf66486","name":"COMPLETENESS","creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"},"type":"data_rule","native_id":"8ddc659c-b155-498d-b310-4ac8cf629ccc/9a1f3644-3ad4-47be-8eb5-006d367c8702","creator_id":"SYSTEM","created_at":"2022-02-02T10:51:02.000Z"}]}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Create data quality checks

Create a data quality check.

POST /data_quality/v4/checks

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.checks.create

    User must be either Admin(administrator) or Editor for the container

Request

Query Parameters

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

Data quality check to create.

Example: {"dimension":{"id":"371114cd-5516-4691-8b2e-1e66edf66486"},"name":"check_uniqueness_of_id","type":"data_rule","native_id":"8ddc659c-b155-498d-b310-4ac8cf629ccc/9a1f3644-3ad4-47be-8eb5-006d367c8702"}

Response

A data quality check, i.e. an action to measure data quality.

Status Code

  • Success

  • The given payload is invalid and the check is not created.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to create a data quality check.

  • The data quality check exists already and cannot be created.

  • An error occurred. The data quality check cannot be created.

Example responses
  • {"id":"6be18374-573a-4cf8-8ab7-e428506e428b","name":"check_uniqueness_of_id","dimension":{"id":"371114cd-5516-4691-8b2e-1e66edf66486","name":"COMPLETENESS","creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"},"type":"data_rule","native_id":"4cdcd382-4e3a-4537-b7ae-09993acee4cf/3e51167c-6eb2-4069-96dc-5d6df808fd47","creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"}
  • {"trace":"6vbjp9d2t4s9b2ckyspdw4vft","status_code":400,"errors":[{"code":"missing_required_field","message":"Bad Request: {\"trace\":\"8f7b7693-1f08-4b4a-b2bd-5732d06ad19e\", \"errors\":[{\"code\":\"invalid_parameter\", \"message\":\"COMSV3006E: Missing or Invalid asset id\", \"target\":{\"name\":\"asset\",\"type\":\"parameter\"}}]}"}]}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"28izpw5l1a4orh823i6bkqmm","status_code":409,"errors":[{"code":"already_exists","message":"The dimension with name 'Completeness' already exists."}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Get a data quality check

Get the data quality check with the given identifier.

GET /data_quality/v4/checks/{id}

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.checks.read

    User must be a collaborator for the container

Request

Path Parameters

  • The data quality check identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Query Parameters

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • If true include the children in the returned resource. If false, only return the resource without its eventual children.

    Default: false

Response

A data quality check, i.e. an action to measure data quality.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to get the data quality check.

  • The data quality check with the given ID cannot be found.

  • An error occurred. The data quality check cannot be returned.

Example responses
  • {"id":"6be18374-573a-4cf8-8ab7-e428506e428b","name":"check_uniqueness_of_id","dimension":{"id":"371114cd-5516-4691-8b2e-1e66edf66486","name":"COMPLETENESS","creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"},"type":"data_rule","native_id":"4cdcd382-4e3a-4537-b7ae-09993acee4cf/3e51167c-6eb2-4069-96dc-5d6df808fd47","creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Delete a data quality check

Delete the data quality check with the given identifier and all its children recursively

DELETE /data_quality/v4/checks/{id}

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.checks.delete

    User must be either Admin(administrator) or Editor for the container

Auditing

Calling this method generates the following auditing event, depending on any listed conditions.

  • wdp-data_quality.issue.delete

    Tracking event with action name 'wdp-data_quality.issue.delete' is logged as corresponding issues for check are deleted

Request

Path Parameters

  • The data quality check identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Query Parameters

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • If true, delete all children recursively. Otherwise, only selected one is deleted.

    Default: false

Response

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to delete the data quality check.

  • The data quality check cannot be found.

  • An error occurred. The data quality check cannot be deleted.

Example responses
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Update or patch a data quality check

Update a data quality check as specified in the payload details of the request.

The updates must be specified by using the JSON patch format, described in RFC 6902.

The following attributes can be updated: - /name (value can only be replace) - /dimension/id (value can be add, remove or replace) - /details (value can be add, remove or replace)

PATCH /data_quality/v4/checks/{id}

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.checks.update

    User must be either Admin(administrator) or Editor for the container

Request

Path Parameters

  • The data quality check identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Query Parameters

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

The updates to make in the data quality rule.

Example: [{"op":"replace","path":"/description","value":"The proportion of data stored against the potential for 100% of the data."}]

Response

A data quality check, i.e. an action to measure data quality.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to update the data quality check.

  • The data quality check with the given ID cannot be found.

  • An error occurred. The data quality check cannot be updated.

Example responses
  • {"id":"6be18374-573a-4cf8-8ab7-e428506e428b","name":"check_uniqueness_of_id","dimension":{"id":"371114cd-5516-4691-8b2e-1e66edf66486","name":"COMPLETENESS","creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"},"type":"data_rule","native_id":"4cdcd382-4e3a-4537-b7ae-09993acee4cf/3e51167c-6eb2-4069-96dc-5d6df808fd47","creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Search for a data quality check by its native id and type

Search for a data quality check by its native id and type

POST /data_quality/v4/search_dq_check

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.checks.read

    User must be a collaborator for the container

Request

Query Parameters

  • The native id, as known by the DQ producer, of the resource to search.

    Possible values: 1 ≤ length ≤ 500

  • The type of the resource to search.

    Possible values: 1 ≤ length ≤ 200

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • If true include the children in the returned resource. If false, only return the resource without its eventual children.

    Default: false

Response

A data quality check, i.e. an action to measure data quality.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to search data quality checks.

  • The data quality check cannot be found.

  • An error occurred. The data quality check cannot be searched.

Example responses
  • {"id":"6be18374-573a-4cf8-8ab7-e428506e428b","name":"check_uniqueness_of_id","dimension":{"id":"371114cd-5516-4691-8b2e-1e66edf66486","name":"COMPLETENESS","creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"},"type":"data_rule","native_id":"4cdcd382-4e3a-4537-b7ae-09993acee4cf/3e51167c-6eb2-4069-96dc-5d6df808fd47","creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Get a list of data quality dimensions

Get a list of data quality dimensions.

GET /data_quality/v4/dimensions

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.dimensions.read

    Any platform level user.

Request

Query Parameters

  • The start token of the resource from where the page should begin. If omitted, begins with first resource.

    Possible values: 1 ≤ length ≤ 512

    Example: g1AAAAA-eJzLYWBgYMpgSmHgKy5JLCrJTq2MT8lPzkzJBYqzmxiYWJiZGYGkOWDSyBJZAPCBD58

  • The maximum number of resources to return.

    Possible values: 1 ≤ value ≤ 200

    Default: 200

    Example: 20

Response

A collection of data quality dimensions.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to get the list of data quality dimensions.

  • An error occurred. The list of data quality dimensions cannot be returned.

Example responses
  • {"total_count":1,"limit":200,"first":{"href":"https://cloud.ibm.com/data_quality/v4/dimensions?limit=200"},"dimensions":[{"id":"371114cd-5516-4691-8b2e-1e66edf66486","name":"Completeness","description":"The proportion of data stored against the potential for 100 percent.","is_default":false,"creator_id":"SYSTEM","created_at":"2022-02-01T18:11:02.000Z"}]}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Create a data quality dimension

Create a data quality dimension.

POST /data_quality/v4/dimensions

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.dimensions.create

    User must have the platform administrator permission

Request

Data quality dimension to create.

Example: {"name":"Completeness10","description":"The proportion of data stored against the potential for 100 percent represented as integer 10."}

Response

Status Code

  • Success

  • The given payload is invalid and the dimension is not created.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to create a data quality dimension.

  • The data quality dimension exists already and cannot be created.

  • An error occurred. The data quality dimension cannot be created.

Example responses
  • {"id":"371114cd-5516-4691-8b2e-1e66edf66486","name":"Completeness","description":"The proportion of data stored against the potential for 100 percent.","is_default":false,"creator_id":"SYSTEM","created_at":"2022-02-01T18:11:02.000Z"}
  • {"trace":"6vbjp9d2t4s9b2ckyspdw4vft","status_code":400,"errors":[{"code":"missing_required_field","message":"Bad Request: {\"trace\":\"8f7b7693-1f08-4b4a-b2bd-5732d06ad19e\", \"errors\":[{\"code\":\"invalid_parameter\", \"message\":\"COMSV3006E: Missing or Invalid asset id\", \"target\":{\"name\":\"asset\",\"type\":\"parameter\"}}]}"}]}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"28izpw5l1a4orh823i6bkqmm","status_code":409,"errors":[{"code":"already_exists","message":"The dimension with name 'Completeness' already exists."}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Get the data quality dimension with the given identifier

Get the data quality dimension with the given identifier.

GET /data_quality/v4/dimensions/{id}

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.dimensions.read

    Any platform level user.

Request

Path Parameters

  • The data quality dimension identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Response

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to get the data quality dimension.

  • The data quality dimension with the given ID cannot be found.

  • An error occurred. The data quality dimension cannot be returned.

Example responses
  • {"id":"371114cd-5516-4691-8b2e-1e66edf66486","name":"Completeness","description":"The proportion of data stored against the potential for 100 percent.","is_default":false,"creator_id":"SYSTEM","created_at":"2022-02-01T18:11:02.000Z"}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Delete the data quality dimension with the given identifier.

Delete the data quality dimension with the given identifier.

All data quality checks associated to this dimension will point to no dimension. All DQ scores stored for this dimension will be deleted

DELETE /data_quality/v4/dimensions/{id}

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.dimensions.delete

    User must have the platform administrator permission.

Request

Path Parameters

  • The data quality dimension identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Response

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to delete the data quality dimension.

  • The data quality dimension cannot be found.

  • An error occurred. The data quality dimension cannot be deleted.

Example responses
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Update a data quality dimension

Update a data quality dimension as specified in the payload details of the request.

The updates must be specified by using the JSON patch format, described in RFC 6902.

The following attributes can be updated: - /name (value can only be replaced) - /description (value can be added, removed, or replaced)

PATCH /data_quality/v4/dimensions/{id}

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.dimensions.update

    User must have the platform administrator permission.

Request

Path Parameters

  • The data quality dimension identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

The updates to make in the data quality rule.

Example: [{"op":"replace","path":"/description","value":"The proportion of data stored against the potential for 100% of the data."}]

Response

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to update the data quality dimension.

  • The data quality dimension with the given ID cannot be found.

  • An error occurred. The data quality dimension cannot be updated.

Example responses
  • {"id":"371114cd-5516-4691-8b2e-1e66edf66486","name":"Completeness","description":"The proportion of data stored against the potential for 100 percent.","is_default":false,"creator_id":"SYSTEM","created_at":"2022-02-01T18:11:02.000Z"}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Search for data quality dimensions by name or part of their names

Search for data quality dimensions by name or part of their names

POST /data_quality/v4/search_dq_dimension

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.dimensions.read

    Any platform level user.

Request

Query Parameters

  • The name of the resource to search or a part of the name of the resources to search.

    Possible values: 1 ≤ length ≤ 200

Response

A collection of data quality dimensions.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to search data quality dimensions.

  • An error occurred. The data quality dimension cannot be searched.

Example responses
  • {"total_count":1,"limit":200,"first":{"href":"https://cloud.ibm.com/data_quality/v4/dimensions?limit=200"},"dimensions":[{"id":"371114cd-5516-4691-8b2e-1e66edf66486","name":"Completeness","description":"The proportion of data stored against the potential for 100 percent.","is_default":false,"creator_id":"SYSTEM","created_at":"2022-02-01T18:11:02.000Z"}]}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Get a list of data quality issues

Get a list of data quality issues.

GET /data_quality/v4/issues

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.issues.read

    User must be a collaborator for the container

Request

Query Parameters

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The start token of the resource from where the page should begin. If omitted, begins with first resource.

    Possible values: 1 ≤ length ≤ 512

    Example: g1AAAAA-eJzLYWBgYMpgSmHgKy5JLCrJTq2MT8lPzkzJBYqzmxiYWJiZGYGkOWDSyBJZAPCBD58

  • The maximum number of resources to return.

    Possible values: 1 ≤ value ≤ 200

    Default: 200

    Example: 20

  • Comma-separated list of data quality asset identifier to search issues of. If not provided, filtering on asset is not applied.

    Possible values: 1 ≤ length ≤ 10000

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5,b1ba1d22-71a7-4adf-99b2-3c8ba1949710

  • Comma-separated list of data quality check id identifier to search issues of. If not provided, filtering on a check is not applied.

    Possible values: 1 ≤ length ≤ 10000

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5,b1ba1d22-71a7-4adf-99b2-3c8ba1949710

  • Comma-separated list of data quality check native id identifier to search issues of. If not provided, filtering on a check is not applied. Only one of checkId or checkNativeId should be provided; if both are provided, an error will be thrown.

    Possible values: 1 ≤ length ≤ 10000

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5,b1ba1d22-71a7-4adf-99b2-3c8ba1949710

  • The name or part of the name of data quality check identifier to search issues of. If not provided, filtering on name of check is not applied.

    Possible values: 1 ≤ length ≤ 200

  • Comma-separated list of data quality dimension identifiers.

    Possible values: 1 ≤ length ≤ 10000

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5,b1ba1d22-71a7-4adf-99b2-3c8ba1949710

  • If true, returns only the latest issue summary of each DQ check. If false, returns the latest and archived issues.

    Default: true

  • The type of the resource to search. If omitted, filtering on type is not applied

    Possible values: 1 ≤ length ≤ 200

  • If true include the children in the returned resource. If false, only return the resource without its eventual children.

    Default: true

  • The issue attribute to sort on. If omitted, sorting on last update time is applied

    Allowable values: [check_name,check_type,check_dimension_name,percent_occurrences,ignored,updated_at]

    Default: updated_at

    Example: check_name

  • The direction to sort with. If omitted, sorting attribute descending is applied

    Allowable values: [asc,desc]

    Default: desc

    Example: asc

Response

A collection of data quality issues.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to get the list of data quality issues.

  • An error occurred. The list of data quality issues cannot be returned.

Example responses
  • {"total_count":1,"limit":200,"first":{"href":"https://cloud.ibm.com/data_quality/v4/issues?limit=200"},"issues":[{"id":"046605b5-48d9-489e-b846-8ef96a7a1aba","check":{"id":"6be18374-573a-4cf8-8ab7-e428506e428b","name":"MY_RULE","native_id":"cdcd4382-4e3a-4537-b7ae-09993acee4cf/3e51167c-6eb2-4069-96dc-5d6df808fd47","type":"ANY","creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"},"reported_for":{"id":"894d01fd-bdfc-4a4f-b68b-62751e06e06a","nativeId":"739e06f8-3gk2-4c4u-8ab7-e5682g06f05a"},"number_of_occurrences":123,"number_of_tested_records":456789,"creator_id":"SYSTEM","created_at":"2022-02-02T10:51:02.000Z"}]}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Create a data quality issue

Create a data quality issue.

POST /data_quality/v4/issues

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.issues.create

    User must be either Admin(administrator) or Editor for the container

Auditing

Calling this method generates the following auditing event, depending on any listed conditions.

  • wdp-data_quality.issue.create

    Tracking event with action name 'wdp-data_quality.issue.create' is logged

Request

Query Parameters

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

Data quality issue to create.

Example: {"check":{"id":"6be18374-573a-4cf8-8ab7-e428506e428b"},"reported_for":{"id":"894d01fd-bdfc-4a4f-b68b-62751e06e06a"},"number_of_occurrences":123,"number_of_tested_records":456789,"status":"actual","ignored":false}

Response

A data quality issue, i.e. a data quality problem detected during a check.

Status Code

  • Success

  • The given payload is invalid and the issue is not created.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to create a data quality issue.

  • The data quality issue exists already and cannot be created.

  • An error occurred. The data quality issue cannot be created.

Example responses
  • {"id":"046605b5-48d9-489e-b846-8ef96a7a1aba","check":{"id":"6be18374-573a-4cf8-8ab7-e428506e428b","name":"MY_RULE","native_id":"cdcd382-4e3a-4537-b7ae-09993acee4cf/3e51167c-6eb2-4069-96dc-5d6df808fd47","type":"ANY","created_at":"2022-02-02T14:00:45.000Z","creator_id":"SYSTEM"},"reported_for":{"id":"894d01fd-bdfc-4a4f-b68b-62751e06e06a"},"number_of_occurrences":123,"number_of_tested_records":456789,"status":"actual","creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"}
  • {"trace":"6vbjp9d2t4s9b2ckyspdw4vft","status_code":400,"errors":[{"code":"missing_required_field","message":"Bad Request: {\"trace\":\"8f7b7693-1f08-4b4a-b2bd-5732d06ad19e\", \"errors\":[{\"code\":\"invalid_parameter\", \"message\":\"COMSV3006E: Missing or Invalid asset id\", \"target\":{\"name\":\"asset\",\"type\":\"parameter\"}}]}"}]}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"28izpw5l1a4orh823i6bkqmm","status_code":409,"errors":[{"code":"already_exists","message":"The dimension with name 'Completeness' already exists."}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Get the data quality issue with the given identifier

Get the data quality issue with the given identifier.

GET /data_quality/v4/issues/{id}

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.issues.read

    User must be a collaborator for the container

Request

Path Parameters

  • The data quality issue identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Query Parameters

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

Response

A data quality issue, i.e. a data quality problem detected during a check.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to get the data quality issue.

  • The data quality issue with the given ID cannot be found.

  • An error occurred. The data quality issue cannot be returned.

Example responses
  • {"id":"046605b5-48d9-489e-b846-8ef96a7a1aba","check":{"id":"6be18374-573a-4cf8-8ab7-e428506e428b","name":"MY_RULE","native_id":"cdcd382-4e3a-4537-b7ae-09993acee4cf/3e51167c-6eb2-4069-96dc-5d6df808fd47","type":"ANY","created_at":"2022-02-02T14:00:45.000Z","creator_id":"SYSTEM"},"reported_for":{"id":"894d01fd-bdfc-4a4f-b68b-62751e06e06a"},"number_of_occurrences":123,"number_of_tested_records":456789,"status":"actual","creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Update a data quality issue as specified in the payload details of the request.

Update a data quality issue as specified in the payload details of the request.

The updates must be specified by using the JSON patch format, described in RFC 6902.

The following attributes can be updated: - /ignored (value can only be replaced)

PATCH /data_quality/v4/issues/{id}

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.issues.update

    User must be either Admin(administrator) or Editor for the container

Auditing

Calling this method generates the following auditing event, depending on any listed conditions.

  • wdp-data_quality.issue.update

    Tracking event with action name 'wdp-data_quality.issue.update' is logged

Request

Path Parameters

  • The data quality issue identifier.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

Query Parameters

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

The updates to make in the data quality rule.

Example: [{"op":"replace","path":"/description","value":"The proportion of data stored against the potential for 100% of the data."}]

Response

A data quality issue, i.e. a data quality problem detected during a check.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to update the data quality issue.

  • The data quality issue with the given ID cannot be found.

  • An error occurred. The data quality issue cannot be updated.

Example responses
  • {"id":"046605b5-48d9-489e-b846-8ef96a7a1aba","check":{"id":"6be18374-573a-4cf8-8ab7-e428506e428b","name":"MY_RULE","native_id":"cdcd382-4e3a-4537-b7ae-09993acee4cf/3e51167c-6eb2-4069-96dc-5d6df808fd47","type":"ANY","created_at":"2022-02-02T14:00:45.000Z","creator_id":"SYSTEM"},"reported_for":{"id":"894d01fd-bdfc-4a4f-b68b-62751e06e06a"},"number_of_occurrences":123,"number_of_tested_records":456789,"status":"actual","creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Search for a data quality issue by its native id

Search for a data quality issue by its native id

POST /data_quality/v4/search_dq_issue

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.issues.read

    User must be a collaborator for the container

Request

Query Parameters

  • The data quality asset identifier

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • The data quality check identifier to search issues of.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

Response

A data quality issue, i.e. a data quality problem detected during a check on a given asset.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to search data quality issues.

  • The data quality issue cannot be found.

  • An error occurred. The data quality issue cannot be searched.

Example responses
  • {"id":"046605b5-48d9-489e-b846-8ef96a7a1aba","check":{"id":"6be18374-573a-4cf8-8ab7-e428506e428b","name":"MY_RULE","native_id":"cdcd382-4e3a-4537-b7ae-09993acee4cf/3e51167c-6eb2-4069-96dc-5d6df808fd47","type":"ANY","created_at":"2022-02-02T14:00:45.000Z","creator_id":"SYSTEM"},"reported_for":{"id":"894d01fd-bdfc-4a4f-b68b-62751e06e06a"},"number_of_occurrences":123,"number_of_tested_records":456789,"status":"actual","creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z","archived_issues":[{"id":"046605b5-48d9-489e-b846-8ef96a7a1aba","check":{"id":"6be18374-573a-4cf8-8ab7-e428506e428b","name":"MY_RULE","native_id":"cdcd382-4e3a-4537-b7ae-09993acee4cf/3e51167c-6eb2-4069-96dc-5d6df808fd47","type":"ANY","created_at":"2022-02-02T14:00:45.000Z","creator_id":"SYSTEM"},"reported_for":{"id":"894d01fd-bdfc-4a4f-b68b-62751e06e06a"},"number_of_occurrences":123,"number_of_tested_records":456789,"status":"archive","creator_id":"SYSTEM","created_at":"2022-02-01T14:00:45.000Z"}]}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cfkvi16tv9bimp2rqve666na0","status_code":404,"errors":[{"code":"not_found","message":"Requested resource was not found.","more_info":"https://www.ibm.com/docs/en/cloud-paks/cp-data/4.5.x?topic=rules-creating-data","target":{"type":"field","name":"name"}}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Create several data quality issues

Create several data quality issues. The related DQ assets referenced by their native ID are created if they do not already exist.

POST /data_quality/v4/create_issues

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.issues.create

    User must be either Admin(administrator) or Editor for the container

Auditing

Calling this method generates the following auditing event, depending on any listed conditions.

  • wdp-data_quality.issue.bulk.create

    Tracking event with action name 'wdp-data_quality.issue.bulk.create' is logged

Request

Query Parameters

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • If true, the assets will be refreshed, and any assets not present in the updated list will be deleted from the database. If false, no action will be taken.

    Default: false

Data quality issues to create and their related DQ assets.

Example: {"issues":[{"check":{"id":"6be18374-573a-4cf8-8ab7-e428506e428b"},"reported_for":{"native_id":"8ddc659c-b155-498d-b310-4ac8cf629ccc/9a1f3644-3ad4-47be-8eb5-006d367c8702","type":"profile"},"number_of_occurrences":123,"number_of_tested_records":456789,"ignored":false}],"assets":[{"name":"CUSTOMERS","type":"data_asset","native_id":"8ddc659c-b155-498d-b310-4ac8cf629ccc/9a1f3644-3ad4-47be-8eb5-006d367c8702","weight":1}],"existing_checks":[{"id":"6be18374-573a-4cf8-8ab7-e428506e428b"}]}

Response

A collection of data quality issues.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to create data quality issues.

  • An error occurred. The data quality issues cannot be created.

Example responses
  • {"total_count":1,"limit":200,"first":{"href":"https://cloud.ibm.com/data_quality/v4/issues?limit=200"},"issues":[{"id":"046605b5-48d9-489e-b846-8ef96a7a1aba","check":{"id":"6be18374-573a-4cf8-8ab7-e428506e428b","name":"MY_RULE","native_id":"cdcd4382-4e3a-4537-b7ae-09993acee4cf/3e51167c-6eb2-4069-96dc-5d6df808fd47","type":"ANY","creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"},"reported_for":{"id":"894d01fd-bdfc-4a4f-b68b-62751e06e06a","nativeId":"739e06f8-3gk2-4c4u-8ab7-e5682g06f05a"},"number_of_occurrences":123,"number_of_tested_records":456789,"creator_id":"SYSTEM","created_at":"2022-02-02T10:51:02.000Z"}]}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

Get a list of data quality scores for a given asset

Get a list of data quality scores for a given asset.

GET /data_quality/v4/scores

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following action, depending on any listed conditions. You can check your access by going to Users > User > Access.

  • dataquality.scores.create

    User must be either Admin(administrator) or Editor for the container

Request

Query Parameters

  • The data quality asset identifier

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • The ID of the catalog to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The ID of the project to use. A catalog_id or project_id is required.

    Possible values: 1 ≤ length ≤ 100

  • The data quality dimension identifier. If not provided, filtering on dimension is not applied.

    Possible values: 1 ≤ length ≤ 128

    Example: b1ba1d22-71a7-4adf-99b2-3c8ba19497f5

  • If true include the children in the returned resource. If false, only return the resource without its eventual children.

    Default: false

  • Query for scores older than the given number of days

    Possible values: 0 ≤ value ≤ 10000

    Default: 0

Response

A collection of data quality scores.

Status Code

  • Success.

  • Your authorization to access this method is missing, invalid, or expired.

  • You do not have permission to get the list of data quality scores.

  • An error occurred. The list of data quality scores cannot be returned.

Example responses
  • {"total_count":100,"asset":{"id":"6be18374-573a-4cf8-8ab7-e428506e428b","name":"CUSTOMERS"},"scores":[{"status":"actual","score":0.8,"number_of_checks":1,"timestamp":"2022-02-14T18:11:02Z","dimension_scores":[{"dimension":{"id":"6be18374-573a-4cf8-8ab7-e428506e428b","name":"COMPLETENESS","description":"Dimension related to completeness","is_default":false,"creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"},"score":0.4,"timestamp":"2022-02-14T18:11:02Z"},{"dimension":{"id":"7be18374-573a-4cf8-8ab7-e428506e428b","name":"ACCURACY","description":"Dimension related to accuracy","is_default":false,"creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"},"score":0.7,"timestamp":"2022-02-13T18:11:02Z"}]},{"status":"archive","score":0.6,"number_of_checks":2,"timestamp":"2022-02-12T18:11:02Z","dimension_scores":[{"dimension":{"id":"6be18374-573a-4cf8-8ab7-e428506e428b","name":"COMPLETENESS","description":"Dimension related to completeness","is_default":false,"creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"},"score":0.23,"timestamp":"2022-02-12T18:11:02Z"}]},{"status":"archive","score":0.7,"number_of_checks":2,"timestamp":"2022-02-11T18:11:02Z","dimension_scores":[{"dimension":{"id":"6be18374-573a-4cf8-8ab7-e428506e428b","name":"COMPLETENESS","description":"Dimension related to completeness","is_default":false,"creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"},"score":0.23,"timestamp":"2022-02-11T18:11:02Z"}]}],"children":[{"asset":{"id":"5be18374-573a-4cf8-8ab7-e428506e428b","name":"ID"},"scores":[{"status":"actual","score":0.8,"number_of_checks":1,"timestamp":"2022-02-14T18:11:02Z","dimension_scores":[{"dimension":{"id":"6be18374-573a-4cf8-8ab7-e428506e428b","name":"COMPLETENESS","description":"Dimension related to completeness","is_default":false,"creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"},"score":0.4,"timestamp":"2022-02-14T18:11:02Z"}]},{"status":"archive","score":0.6,"number_of_checks":1,"timestamp":"2022-02-12T18:11:02Z","dimension_scores":[{"dimension":{"id":"6be18374-573a-4cf8-8ab7-e428506e428b","name":"COMPLETENESS","description":"Dimension related to completeness","is_default":false,"creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"},"score":0.23,"timestamp":"2022-02-12T18:11:02Z"}]},{"status":"archive","score":0.7,"number_of_checks":1,"timestamp":"2022-02-11T18:11:02Z","dimension_scores":[{"dimension":{"id":"6be18374-573a-4cf8-8ab7-e428506e428b","name":"COMPLETENESS","description":"Dimension related to completeness","is_default":false,"creator_id":"SYSTEM","created_at":"2022-02-02T14:00:45.000Z"},"score":0.23,"timestamp":"2022-02-11T18:11:02Z"}]}]}]}
  • {"trace":"3tirwt88tsejqwh801zw88lek","status_code":403,"errors":[{"code":"not_authorized","message":"User IBMid-341983Z157 with role null is not authorized to perform the operation CREATE."}]}
  • {"trace":"cwuhtyfus0m8f6e49e2g6m4hr","status_code":500,"errors":[{"code":"internal_error","message":"An IOException was caught when accessing asset 'cbf21aa7-cb89-4ee8-9817-0f1d86fbe0cd'."}]}

list all governance types

Lists all governance types. A governance type groups like operations together. For example, the Access governance type groups operations related to access of assets.

GET /v3/enforcement/governance_types

Request

No Request Parameters

This method does not accept any request parameters.

Response

Response for the /v3/enforcement/governance_types API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

retrieve a governanceType

Retrieves detailed information on a governance type. This includes all of the operations defined for the governance type and the allowed and default outcomes of each operation.

GET /v3/enforcement/governance_types/{governance_type_name}

Request

Path Parameters

  • the name of the governance type

Response

Response for the /v3/enforcement/governance_types/{governanceTypeId} API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

list user defined rule predicate terms

List all user defined left hand side terms defined in the policy engine.

GET /v3/enforcement/lhs/udp

Request

No Request Parameters

This method does not accept any request parameters.

Response

Response for the /v3/enforcement/udp API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

create user defined left hand side term

Create a left hand side term to be used in rules defined in the policy engine.

POST /v3/enforcement/lhs/udp

Request

LHS RuleTerm JSON

Response

Response for the /v3/enforcement/udp/{termName} API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

get a user defined left hand side term

Get the user defined left hand side term in the term cache of the policy engine.

GET /v3/enforcement/lhs/udp/{lhsTermId}

Request

Path Parameters

  • ID of the LHS term to get

Response

Response for the /v3/enforcement/udp/{termName} API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

delete a user defined left hand side term

Delete a left hand side term in the term cache of the policy engine. This cache is maintained for performance and is used for evaluating policies. It is refreshed periodically from technical terms maintained in the glossary.

DELETE /v3/enforcement/lhs/udp/{lhsTermId}

Request

Path Parameters

  • ID of the custom LHS to delete

Response

Status Code

  • No Content (OK)

  • Bad Request

  • Unauthorized

  • Forbidden

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

retrieve and aggregate policy related metrics

This API retrieves policy enforcement metrics based on query parameters, which include metric type, date range, policy, user, rule, governanceType, outcome, host type, cached, context operation, context location, asset type and asset location. It then sums these metrics according to a specified aggregation type.

GET /v3/enforcement/policy_metrics/analysis/3d

Request

Query Parameters

  • The type of metrics to return

    Allowable values: [enforcements,denials,operational_policies,operational_rules]

  • The type of aggregation to perform on the selected metrics (days, months, years, policies, rules, users, governanceTypes, outcomes)

    Allowable values: [days,months,years,policies,rules,users,outcomes,governance_type,pep_host_types,is_pep_cache,context_operations,context_locations,asset_types,asset_locations]

  • The type of aggregation to perform on the selected metrics (days, months, years, policies, rules, users, governanceTypes, outcomes)

    Allowable values: [days,months,years,policies,rules,users,outcomes,governance_type,pep_host_types,is_pep_cache,context_operations,context_locations,asset_types,asset_locations]

  • ISO 8601 date/time specifying the starting time to return metrics data

  • ISO 8601 date/time specifying the ending time to return metrics data

  • The policy to return metrics of, or all policies if not specified

  • The rule to return metrics of, or all rules if not specified

  • The user to return metrics about, or all users if not specified

  • The governanceType to return metrics about, or all governanceTypes if not specified

    Allowable values: [Access,Classification,Curation,Lifecycle,ResourceControl,DMR,AIGovernance,DLR]

  • The enforcement outcome to return metrics about, or all outcomes if not specified

  • The PEP host type to return metrics about, or all PEP host types if not specified

  • Metrics on decisions retrieved from cache versus from server, or both if not specified

  • The context operation to return metrics about, or all context operations if not specified

  • The context location to return metrics about, or all context locations if not specified

  • The asset type to return metrics about, or all asset types if not specified

  • The asset location to return metrics about, or all asset locations if not specified

  • The order to sort the metrics. The following values are allowed:

    • aggregate, -aggregate -- ascending or descending order by the aggregate
    • count, -count -- ascending or descending order by enforcement count

Response

Response for the /v3/enforcement/policy_metrics API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not Found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

retrieve and aggregate policy related metrics

This API retrieves policy enforcement metrics based on query parameters, which include metric type, date range, policy, user, rule, governanceType, outcome, host type, cached, context operation, context location, asset type and asset location. It then sums these metrics according to a specified aggregation type.

GET /v3/enforcement/policy_metrics

Request

Query Parameters

  • The type of metrics to return

    Allowable values: [enforcements,denials,operational_policies,operational_rules]

  • The type of aggregation to perform on the selected metrics (days, months, years, policies, rules, users, governanceTypes, outcomes)

    Allowable values: [days,months,years,policies,rules,users,outcomes,governance_type,pep_host_types,is_pep_cache,context_operations,context_locations,asset_types,asset_locations]

  • ISO 8601 date/time specifying the starting time to return metrics data

  • ISO 8601 date/time specifying the ending time to return metrics data

  • The policy to return metrics of, or all policies if not specified

  • The rule to return metrics of, or all rules if not specified

  • The user to return metrics about, or all users if not specified

  • The governanceType to return metrics about, or all governanceTypes if not specified

    Allowable values: [Access,Classification,Curation,Lifecycle,ResourceControl,DMR,AIGovernance,DLR]

  • The enforcement outcome to return metrics about, or all outcomes if not specified

  • The PEP host type to return metrics about, or all PEP host types if not specified

  • Metrics on decisions retrieved from cache versus from server, or both if not specified

  • The context operation to return metrics about, or all context operations if not specified

  • The context location to return metrics about, or all context locations if not specified

  • The asset type to return metrics about, or all asset types if not specified

  • The asset location to return metrics about, or all asset locations if not specified

  • The order to sort the metrics. The following values are allowed:

    • aggregate, -aggregate -- ascending or descending order by the aggregate
    • count, -count -- ascending or descending order by enforcement count

Response

Response for the /v3/enforcement/policy_metrics API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not Found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

list all roles in policy engine.

Lists all roles of the policy engine.

GET /v3/enforcement/roles

Request

No Request Parameters

This method does not accept any request parameters.

Response

Response for the /v3/enforcement/roles API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

create a custom role

Creates a cusotm role. This will include a list of existing permissions to be associated with the role. Maximum length allowed for 'name' parameter: 80 characters, maximum length allowed for 'description' parameter: 1000 characters. Allowed characters for the 'name' parameter: letters from any language, numbers in any script, space, dot, underscore, hyphen. Strings with characters other than these are rejected (only for the name parameter).

POST /v3/enforcement/roles

Request

Role Permission Request json

Response

Response for the POST and PUT /v3/enforcement/roles APIs and GET /enforcement/roles/role_id API

Status Code

  • Created

  • Bad Request

  • Unauthorized

  • Forbidden

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

retrieve a role

Retrieves detailed information on a role given the role's identifier. This includes a list of permissions associated with this role.

GET /v3/enforcement/roles/{role_id}

Request

Path Parameters

  • role ID

Response

Response for the POST and PUT /v3/enforcement/roles APIs and GET /enforcement/roles/role_id API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not Found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

update a custom category role

Updates a custom category role. This API is also used to add and remove permissions from the custom category role. The permissions should be passed as an array of string that has permissions ids.Maximum length allowed for 'name' parameter: 80 characters, maximum length allowed for 'description' parameter: 1000 characters. If the parameter 'name' is modified, allowed characters for the 'name' parameter: letters from any language, numbers in any script, space, dot, underscore, hyphen. Strings with characters other than these are rejected (only for the name parameter).

PUT /v3/enforcement/roles/{role_id}

Request

Path Parameters

  • role ID

role json

Response

Response for the POST and PUT /v3/enforcement/roles APIs and GET /enforcement/roles/role_id API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not Found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

delete a custom category role

Deletes a cusotm category role.

DELETE /v3/enforcement/roles/{role_id}

Request

Path Parameters

  • role ID

Response

Status Code

  • No Content (OK)

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not Found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

list all permissions in policy engine.

Lists all permissions of the policy engine.

GET /v3/enforcement/roles/permissions

Request

No Request Parameters

This method does not accept any request parameters.

Response

Response for the /v3/enforcement/roles/permissions API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Sync a rule

Syncs a rule in DPS with its global search index. If rule is found in DPS, its global search index is updated. If rule is not found in DPS, its global search index is removed.

PUT /v3/enforcement/rules/sync/{rule_id}

Request

Path Parameters

  • Rule ID

Response

Response for the /v3/enforcement/rules/{ruleId} API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not Found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

retrieve a rule

Retrieves detailed information on a rule given the rule's identifier.

GET /v3/enforcement/rules/{rule_id}

Request

Path Parameters

  • Rule ID

Response

Response for the /v3/enforcement/rules/{ruleId} API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not Found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

update a rule

Updates a rule. Maximum length allowed for 'name' parameter: 80 characters, maximum length allowed for 'description' parameter: 1000 characters. If the parameter 'name' is modified, allowed characters for the 'name' parameter: letters from any language, numbers in any script, space, dot, underscore, hyphen. Strings with characters other than these are rejected (only for the name parameter). The governance_type_id cannot be modified.

PUT /v3/enforcement/rules/{rule_id}

Request

Path Parameters

  • Rule ID

Rule json

Response

Response for the /v3/enforcement/rules/{ruleId} API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not Found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

delete a rule

Deletes a rule. A rule can only be deleted if it is not currently associated with any policy (in any state).

DELETE /v3/enforcement/rules/{rule_id}

Request

Path Parameters

  • Rule ID

Response

Status Code

  • No Content (OK)

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not Found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

list all rules

Lists all defined rules. This includes all rules associated with policies and rules not associated with any policy. When more than one filter criteria is specified, the resulting collection satisfies all the criteria.

GET /v3/enforcement/rules

Request

Query Parameters

  • Specify name of the rule to search for or use filter of the form 'contains:xx' to search for rules containing provided phrase as part of name or use filter of the form 'exact:xx' to search for rules with exact name.

  • Specify description of the rule to search for or use filter of the form 'contains:xx' to search for rules containing provided phrase as part of description.

  • If specified, only rules with a matching trigger expression will be returned.

  • If specified, only rules with a matching action will be returned.

  • If specified, only rules in the matching state will be returned.

    Allowable values: [draft,active,archived]

  • If speficied, only rules with the matching governance type/types will be returned.

  • The order to sort the rules. The following values are allowed:

    • name, -name -- ascending or descending order by the name
    • modified_date, -modified_date -- ascending or descending order by modified date

    Allowable values: [name,-name,modified_date,-modified_date]

  • The maximum number of Rules to return. The default value is 50.

    Default: 50

  • The index of the first matching Rule to include in the result. The default value is 0.

    Default: 0

Response

Response for the /v3/enforcement/rules API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

create a rule

Creates a rule. A rule has two key properties:

  1. a trigger defining when the rule should be enforced, and
  2. an action describing what operations to perform or outcome to enforce.

Trigger

A trigger is a boolean expression represented using nested arrays. The following describes the syntax:

 Expression: 
 [ -conditions- ] 
 
 Conditions: 
 -predicate- 
 "NOT", -predicate- 
 -predicate-, "AND"|"OR", -conditions- 
 "NOT", -predicate-, "AND"|"OR", -conditions- 
 
 Predicate: 
 [ "$-term-", "EXISTS" ] 
 [ "$-term-", "EQUALS"|"LESS_THAN"|"GREATER_THAN"|"CONTAINS", "#-literal-"|"$-term-" ] 
 -expression- 

where:

  • -term- is a technical term defined in the term glossary.
  • -literal- is a literal. For numerics a string representation of the number should be specified. For times, milliseconds are used (from Unix epoch). For boolean, #true and #false are used.

The definition of the operators in a predicate:

  • EXISTS -- means that the term has a value of some kind.
  • EQUALS -- evaluates to true if the left and right sides are equal.
  • LESS_THAN -- evaluates to true if the left is less in numeric value than the right.
  • GREATER_THAN -- evaluates to true if the left is greater in numeric value than the right.
  • CONTAINS -- is meant to test an array term (such as Asset.Tags) with a single value. It evaluates to true if the value on the right side equals one of the values on the array on the left side.
    However it will also supports a single value on the left, in which case it behaves just like EQUALS -- regular expressions or wildcards are not supported.

For all of the operators (except EXISTS), if the right hand side evaluates to an array, each value of the array is compared to the left side, according to the operator definition, and if any comparison is true then the result of the evaluation is true.

Examples:

 [["$Asset.Type", "EQUALS", "#Project"]] 
 ["NOT", ["$Asset.Tags", "CONTAINS", "#sensitive"], "AND", ["NOT", "$Asset.Tags", "CONTAINS", "#confidential"]] 
 [["$User.Name", "EQUALS", "$Asset.Owner"]] 

Action

The action is an name with optional parameters or subaction describing an operation to perform. For simple actions like Deny, only the action name will be provided. For actions such as Transform, a subaction with parameters describing the type of transform is also provided. The allowed actions depends on the governance type.

Examples:

 {"name": "Deny"} 
 {"name": "Transform", "subaction": {"name": "anonymizeColumns", "parameters": [{"name": "column_name", "value": "CCN"}]}} 

The maximum length allowed for 'name' parameter is 80 characters, maximum length allowed for 'description' parameter: 1000 characters. Allowed characters for the 'name' parameter: letters from any language, numbers in any script, space, dot, underscore, hyphen. Strings with characters other than these are rejected (only for the name parameter).

POST /v3/enforcement/rules

Request

Rule json

Response

Response for the /v3/enforcement/rules/{ruleId} API

Status Code

  • Merged with an existing 'ResourceControl' rule.

  • Created

  • Bad Request

  • Unauthorized

  • Forbidden

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

export all rules

Export all defined rules as JSON.This includes all rules associated with policies and rules not associated with any policy.

GET /v3/enforcement/rules/export

Request

Query Parameters

  • The maximum number of Rules to return. The default value is 50.

    Default: 50

  • The index of the first matching Rule to include in the result. The default value is 0.

    Default: 0

  • For export between two different systems. If specified as true, the ids in rules will be converted to names and added as export_components in the exported file

    Default: false

Response

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

retrieve terms used in a rule

Retrieves the names of all terms used in a rule.

GET /v3/enforcement/rules/{rule_id}/terms

Request

Path Parameters

  • Rule ID

Response

Response for the /v3/policy_rules/{ruleId}/terms API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not Found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

import rules

Imports rules using content recieved as application/octet-stream media type. Assumes content to be in UTF-8 charset. Expects "rules" JSON array contained in a JSON objects. Ignores other fields. Rule GUID is prerserved. Retruns JSON array containing GUIDs of newly imported rules.

POST /v3/enforcement/rules/import

Request

Query Parameters

  • For import between two different systems. If specified as true, the names in export_components of the import file will be matched and converted to the target system's ids.

    Default: false

  • For external imports, if specified as true, the whole import will fail if there are any rules that fail to match ids in the target system. If specified as false, an analysis report will be returned.

    Default: false

The input stream for reading imported terms

Response

Response for the /v3/enforcement/rules/export API and /v3/enforcement/rules/import

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Content cannot be more than 1MB

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

retrieve tenant settings

Retrieves governance information and settings about a particular tenant given the tenant identifier.

GET /v3/enforcement/settings

Request

No Request Parameters

This method does not accept any request parameters.

Response

Response for the /v3/enforcement/settings/{tenantId} API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not Found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

update tenant settings

Updates governance information and settings for the given tenant.

PUT /v3/enforcement/settings

Request

governedTenant json

Response

Response for the /v3/enforcement/settings/{tenantId} API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not Found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Create a metadata enrichment area asset

Creates a new metadata enrichment asset and the corresponding job definition. If a data scope is provided the decoration of data scope assets will be started in background and the response will contain the execution ID of that background process. After background processing has finished a RabbitMQ event is sent to CAMS topic exchange CatalogServiceMessageHub with topic v2.metadata_enrichment.{mdeAreaId}.create_enrichment_area and message body as described in model RabbitMqNotificationMessage. If no data scope is provided an empty enrichment area is created without starting a background decoration task. In that case the field asyncExecutionInfo will be missing in the response. If query paramter enrichImmediate is true, which is the default setting, and the data scope is not empty a new enrichment job run will be triggered automatically.

POST /v2/metadata_enrichment/metadata_enrichment_area

Request

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

  • should enrichment be run immediately after area creation

    Default: true

Object containing information for creating a metadata enrichment area asset

Response

An object containing information about a metadata enrichment area asset

Status Code

  • Success

  • Unauthorized

  • Forbidden

  • Error

No Sample Response

This method does not specify any sample responses.

Retrieve metadata enrichment settings

Retrieve metadata enrichment settings

GET /v2/metadata_enrichment/metadata_enrichment_area/settings

Request

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

Response

Status Code

  • Success

  • Unauthorized

  • Forbidden

  • Error

No Sample Response

This method does not specify any sample responses.

Create or update metadata enrichment settings

Create or update metadata enrichment settings

PUT /v2/metadata_enrichment/metadata_enrichment_area/settings

Request

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

Metadata enrichment settings

Response

Status Code

  • Success

  • Unauthorized

  • Forbidden

  • Error

No Sample Response

This method does not specify any sample responses.

Retrieve details of a Metadata Enrichment Area asset

Retrieve details of a metadata enrichment area asset

GET /v2/metadata_enrichment/metadata_enrichment_area/{metadata_enrichment_area_id}

Request

Path Parameters

  • Id of the metadata enrichment area asset.

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

  • whether to include data asset count summary in the response

    Default: false

Response

An object containing information about a metadata enrichment area asset

Status Code

  • Success

  • Unauthorized

  • Forbidden

  • Not found

  • Gone

  • Error

No Sample Response

This method does not specify any sample responses.

Delete a metadata enrichment asset

Delete a metadata enrichment area asset

DELETE /v2/metadata_enrichment/metadata_enrichment_area/{metadata_enrichment_area_id}

Request

Path Parameters

  • Id of the metadata enrichment area asset.

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

Response

Status Code

  • No Content

  • Unauthorized

  • Forbidden

  • Not found

  • Gone

  • Error

No Sample Response

This method does not specify any sample responses.

edit a metadata enrichment area asset

Edit a metadata enrichment area asset

PATCH /v2/metadata_enrichment/metadata_enrichment_area/{metadata_enrichment_area_id}

Request

Path Parameters

  • Id of the metadata enrichment area asset.

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

  • Force the operation even when the metadata enrichment area is being updated.

Object carrying the update request.

Response

An object containing information about a metadata enrichment area asset

Status Code

  • Success

  • Unauthorized

  • Forbidden

  • Not found

  • Gone

  • Error

No Sample Response

This method does not specify any sample responses.

Add or remove assets from data scope

Add or remove assets from data scope

PATCH /v2/metadata_enrichment/metadata_enrichment_area/{metadata_enrichment_area_id}/data_scope

Request

Path Parameters

  • Id of the metadata enrichment area asset.

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

  • Force the operation even when the metadata enrichment area is being updated.

Object carrying the update request.

Response

Status Code

  • Accepted

  • Unauthorized

  • Forbidden

  • Not found

  • Gone

  • Error

No Sample Response

This method does not specify any sample responses.

Assign business terms to data assets

Add terms to given data assets. This api is executed synchronously. It verifies that all assets are part of the given MDE area. If validation fails method ends with an error.

POST /v2/metadata_enrichment/metadata_enrichment_area/{metadata_enrichment_area_id}/data_scope/enrichment_assets/assign_terms

Request

Path Parameters

  • Id of the metadata enrichment area asset.

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

  • whether to process the request asynchronously

    Default: false

List of data assets and terms to assign

Response

Status Code

  • Success

  • Accepted

  • Unauthorized

  • Forbidden

  • Error

No Sample Response

This method does not specify any sample responses.

Assign business terms to columns of data assets

Add terms to given asset columns. This api is executed synchronously. It verifies that all assets are part of the given MDE area. If validation fails method ends with an error.

POST /v2/metadata_enrichment/metadata_enrichment_area/{metadata_enrichment_area_id}/data_scope/enrichment_assets/columns/assign_terms

Request

Path Parameters

  • Id of the metadata enrichment area asset.

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

  • whether to process the request asynchronously

    Default: false

List of columns of data assets and terms to assign

Response

Status Code

  • Success

  • Accepted

  • Unauthorized

  • Forbidden

  • Error

No Sample Response

This method does not specify any sample responses.

Assign or remove a data class to columns of data assets

Assign or remove data class to columns of data assets

POST /v2/metadata_enrichment/metadata_enrichment_area/{metadata_enrichment_area_id}/data_scope/enrichment_assets/columns/dataclass

Request

Path Parameters

  • Id of the metadata enrichment area asset.

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

  • whether to process the request asynchronously

    Default: false

List of columns of data assets and id of data class and operation to be performed

Response

Status Code

  • Success

  • Unauthorized

  • Forbidden

  • Error

No Sample Response

This method does not specify any sample responses.

Remove business terms from columns of data assets.

Removes either all terms or selected terms from given asset columns. When terms are provided with the payload only the given terms are removed from the given columns. If no terms are provided all terms are removed.

POST /v2/metadata_enrichment/metadata_enrichment_area/{metadata_enrichment_area_id}/data_scope/enrichment_assets/columns/remove_terms

Request

Path Parameters

  • Id of the metadata enrichment area asset.

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

  • whether to process the request asynchronously

    Default: false

List of columns of data assets and terms to assign

Response

Status Code

  • Success

  • Accepted

  • Unauthorized

  • Forbidden

  • Error

No Sample Response

This method does not specify any sample responses.

Adds or updates the review timestamp for given columns.

Adds/updates the 'reviewed' time stamp to/of the given asset columns.This api is executed synchronously. It fetches the assets that belong to the given columns via CAMS bulk get and verifies that all given assets are part of the given MDE area and are ready for review which means that either profiling or term assignment must be finished. It also validates that the columns exist on the asset. If validation fails the method returns an error. Otherwise for all given columns the review timestamp gets updated via CAMS bulk patch. Returns the new review timestamp.

POST /v2/metadata_enrichment/metadata_enrichment_area/{metadata_enrichment_area_id}/data_scope/enrichment_assets/columns/review

Request

Path Parameters

  • Id of the metadata enrichment area asset.

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

Array containing list of asset Ids with columns.

Response

Status Code

  • Success

  • Unauthorized

  • Forbidden

  • Error

No Sample Response

This method does not specify any sample responses.

Removes review timestamp for given columns.

Removes the 'reviewed' time stamp from the given asset columns. This api is executed synchronously. It fetches alle assets that belong to the given columns via CAMS bulk get and verifies that all given assets are part of the given MDE area. Assets that have no review data are skipped. It also validates that the columns exist on the asset. If validation fails the method returns an error. Otherwise for all given columns the review timestamp will be removed via CAMS bulk patch.

POST /v2/metadata_enrichment/metadata_enrichment_area/{metadata_enrichment_area_id}/data_scope/enrichment_assets/columns/unreview

Request

Path Parameters

  • Id of the metadata enrichment area asset.

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

Array containing list of asset Ids with columns.

Response

Status Code

  • No content

  • Unauthorized

  • Forbidden

  • Error

No Sample Response

This method does not specify any sample responses.

Enrich selected data assets

Enrich selected data assets

POST /v2/metadata_enrichment/metadata_enrichment_area/{metadata_enrichment_area_id}/data_scope/enrichment_assets/enrich

Request

Path Parameters

  • Id of the metadata enrichment area asset.

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

Array containing list of asset Ids.

Response

Status Code

  • Success

  • Unauthorized

  • Forbidden

  • Error

No Sample Response

This method does not specify any sample responses.

Remove business terms from data assets

Removes either all terms or selected terms from given list of data assets. When terms are provided with the payload only the given terms are removed from the given assets. If no terms are provided all terms are removed.

POST /v2/metadata_enrichment/metadata_enrichment_area/{metadata_enrichment_area_id}/data_scope/enrichment_assets/remove_terms

Request

Path Parameters

  • Id of the metadata enrichment area asset.

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

  • whether to process the request asynchronously

    Default: false

List of data assets and terms to remove

Response

Status Code

  • Success

  • Accepted

  • Unauthorized

  • Forbidden

  • Error

No Sample Response

This method does not specify any sample responses.

Review a given list of data assets.

Adds/updates the 'reviewed' time stamp to/of given data assets. This api is executed synchronously. It fetches the given assets via CAMS bulk get and verifies that all given assets are part of the given MDE area and are ready for review which means that either profiling or term assignment must be finished. If validation fails the method returns an error. Otherwise the review timestamp of all assets gets updated via CAMS bulk patch. Returns the new review timestamp.

POST /v2/metadata_enrichment/metadata_enrichment_area/{metadata_enrichment_area_id}/data_scope/enrichment_assets/review

Request

Path Parameters

  • Id of the metadata enrichment area asset.

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

Array containing list of asset Ids.

Response

Status Code

  • Success

  • Bad Request. If parameters are missing or at least one of the given assets is not ready for review

  • Unauthorized

  • Forbidden

  • Not found. If at least one of the given assets is not member of the given metadata enrichment area.

  • Error

No Sample Response

This method does not specify any sample responses.

Removes review timestamp from the given assets

Removes the 'reviewed' time stamp from the given data assets. This api is executed synchronously. It fetches the given assets via CAMS bulk get and verifies that all given assets are part of the given MDE area. Assets that have no review data are skipped. If validation fails the method returns an error. Otherwise the review timestamp is removed from of all assets via CAMS bulk patch.

POST /v2/metadata_enrichment/metadata_enrichment_area/{metadata_enrichment_area_id}/data_scope/enrichment_assets/unreview

Request

Path Parameters

  • Id of the metadata enrichment area asset.

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

Array containing list of asset Ids.

Response

Status Code

  • No content

  • Bad Request. If parameters are missing.

  • Unauthorized

  • Forbidden

  • Not found. If at least one of the given assets is not member of the given metadata. enrichment area.

  • Error

No Sample Response

This method does not specify any sample responses.

Publish all assets or a subset of assets of a Metadata Enrichment Area to a catalog

Publish assets asynchronously. If publishScope is 'selected_assets' either /asset_ids or /filter/search_criteria has to be specified. If publisScope is 'all_assets' none of both must be specified.

POST /v2/metadata_enrichment/metadata_enrichment_area/{metadata_enrichment_area_id}/publish_assets

Request

Path Parameters

  • Id of the metadata enrichment area asset.

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

  • tells if all assets in mde area should be published or only selected assets

    Allowable values: [all_assets,selected_assets]

Publish assets to a catalog

Response

Status Code

  • Success

  • Unauthorized

  • Forbidden

  • Error

No Sample Response

This method does not specify any sample responses.

Create a Metadata Import asset

Create a Metadata Import asset.

POST /v2/metadata_imports

Request

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

  • If this value is set to true, a Job is created together. The relation is also done between mdetadata import asset. The response message includes entity.jobId. The job name is generated from the name of metadata import with a unique suffix.

    Default: false

  • A candidate of Job name. The job is created with a specified name. If the name already exists, an error is returned. The create_job parameter should be set to true.

Object containing information for creating a metadata import asset

Response

An object containing information about a metadata import asset

Status Code

  • Success

  • Unauthorized

  • Forbidden

  • Error

No Sample Response

This method does not specify any sample responses.

Bulk delete data assets in Metadata discovery

Delete assets in bulk

POST /v2/metadata_imports/bulk_delete_assets

Request

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

  • The catalog_id and / or project_id must be provided. If catalog_id is provided, the catalog must exist and the caller must be an admin or editor member of the catalog. Only data discovery runs associated with the catalog will be returned.

Array containing list of data asset Ids.

Response

Status Code

  • Success

  • Unauthorized

  • Forbidden

  • Error

No Sample Response

This method does not specify any sample responses.

Bulk delete metadata import assets in Metadata discovery

Delete metadata import assets in bulk

DELETE /v2/metadata_imports/bulk_delete_metadataImport_assets

Request

Query Parameters

  • Comma separated list of metadata import asset IDs.

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

Response

Status Code

  • Success

  • Unauthorized

  • Forbidden

  • Error

No Sample Response

This method does not specify any sample responses.

Create a job to publish the data assets and configure the list of data assets to be included in the job.

Publish assets in bulk

POST /v2/metadata_imports/bulk_publish_assets

Request

Query Parameters

  • The connection_id may be optionally provided to retrieve data discovery runs associated with the connection.

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

  • The catalog_id and / or project_id must be provided. If catalog_id is provided, the catalog must exist and the caller must be an admin or editor member of the catalog. Only data discovery runs associated with the catalog will be returned.

  • mdi id to retrieve the MDI object

Array containing list of data asset Ids.

Response

Status Code

  • Success

  • Unauthorized

  • Forbidden

  • Error

No Sample Response

This method does not specify any sample responses.

Get a list of supported datasource types

INTERNAL: Get list of supported connection types.

GET /v2/metadata_imports/connections

Request

No Request Parameters

This method does not accept any request parameters.

Response

Status Code

  • Success

  • Unauthorized

  • Forbidden

  • Error

No Sample Response

This method does not specify any sample responses.

Restart the pending a job run

Restart the pending a job run. It should be called after restore from the backup data. This API is not unavailable on IBM Cloud. The Admin role is necessary to call this API.

POST /v2/metadata_imports/recover_task

Request

Object containing information for recovering import

Response

status message

Status Code

  • Success

  • Unauthorized

  • Forbidden

  • Error

No Sample Response

This method does not specify any sample responses.

Retrieve details of a Metadata Import

Retrieve details of a metadata import

GET /v2/metadata_imports/{metadata_import_id}

Request

Path Parameters

  • Id of the metadata import asset.

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

Response

An object containing information about a metadata import asset

Status Code

  • Success

  • Unauthorized

  • Forbidden

  • Not found

  • Gone

  • Error

No Sample Response

This method does not specify any sample responses.

delete a metadata import asset

delete a metadata import asset

DELETE /v2/metadata_imports/{metadata_import_id}

Request

Path Parameters

  • Id of the metadata import asset.

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

Response

Status Code

  • No content

  • Unauthorized

  • Forbidden

  • Not found

  • Gone

  • Error

No Sample Response

This method does not specify any sample responses.

edit a metadata import asset

edit a metadata import asset

PATCH /v2/metadata_imports/{metadata_import_id}

Request

Path Parameters

  • Id of the metadata import asset.

Query Parameters

  • The project_id must be provided. The project must exist and the caller must be an admin or editor member of the project.

Object carrying the update request.

Response

An object containing information about a metadata import asset

Status Code

  • Success

  • Unauthorized

  • Forbidden

  • Not found

  • Gone

  • Error

No Sample Response

This method does not specify any sample responses.

Creates a category in the glossary

This method can be used to create a new category in the glossary.

POST /v3/categories

Request

Represents a category to be created.

Response

  • Response returned on creating a category.
    It differs from its base class ({@link CreateResponse}) because it does not include {@code /version/{version_id}} in paths of returned URLs (the categories API does not have such endpoints, only {@code GET /categories/{category_id}}).

Status Code

  • The category has been created successfully.

  • Bad Request

  • Unauthorized

  • Forbidden

  • UniqueConstraintViolation - category with given name and parent already exists.

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "href": "/v3/categories/285b7b78-3d64-48e6-a9b6-e02f4c32295f",
          "artifact_id": "285b7b78-3d64-48e6-a9b6-e02f4c32295f",
          "version_id": "12e37d76-f28b-4dc9-a35e-0c3e30f9f8ea_0",
          "global_id": "18091466-981e-4113-8943-2ddf162bff6d_285b7b78-3d64-48e6-a9b6-e02f4c32295f",
          "entity_type": "category"
        }
      ]
    }

Start category boostrap process

Assigns default owners and view permissions for root categories without any role assignments set

POST /v3/categories/collaborators/bootstrap

Request

No Request Parameters

This method does not accept any request parameters.

Response

Bootstrap Status

Status Code

  • The boostrap process started successfully

  • The boostrap is already in progress

  • Unauthorized

  • Internal Server Error

Example responses
  • IN_PROGRESS

    {
      "status": "IN_PROGRESS",
      "current_step": "Bootstrapping category e39ada11-8338-3704-90e3-681a71e7c839",
      "completed_records": 0,
      "total_records": 3
    }

Get status of category bootstrap process

Get status of category bootstrap process

GET /v3/categories/collaborators/bootstrap/status

Request

No Request Parameters

This method does not accept any request parameters.

Response

Bootstrap Status

Status Code

  • Bootstrap status fetched successfully

  • Unauthorized

  • Internal Server Error

Example responses
  • IN_PROGRESS

    {
      "status": "IN_PROGRESS",
      "current_step": "Bootstrapping category e39ada11-8338-3704-90e3-681a71e7c839",
      "completed_records": 0,
      "total_records": 3
    }
  • NEW

    {
      "status": "NEW",
      "current_step": "Initializing role assignment bootstrap process",
      "completed_records": 0
    }
  • NOT_STARTED

    {
      "status": "NOT_STARTED"
    }
  • SUCCEEDED

    {
      "status": "SUCCEEDED",
      "completion_message": "Bootstrap process completed",
      "completed_records": 3,
      "total_records": 3
    }

Get history status of category bootstrap process

Get history status of category bootstrap process

GET /v3/categories/collaborators/bootstrap/status/history

Request

No Request Parameters

This method does not accept any request parameters.

Response

Response returned on retrieving bootstrap status history.

Status Code

  • Bootstrap status history fetched successfully

  • Unauthorized

  • Internal Server Error

Example responses
  • SUCCEEDED

    {
      "bootstrap_status_history": [
        {
          "status": "SUCCEEDED",
          "completion_message": "No categories requiring bootstrap process",
          "completed_records": 0,
          "total_records": 0
        },
        {
          "status": "SUCCEEDED",
          "completion_message": "Bootstrap process completed",
          "completed_records": 3,
          "total_records": 3
        }
      ]
    }

Retrieves category hierarchy paths for given artifact ids of categories

This method can be used for retrieving hierarchy paths of categories

GET /v3/categories/hierarchy

Request

Query Parameters

  • The id of the category whose path is fetched

    Possible values: 1 ≤ length ≤ 100, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Response

Response returned on retrieving hierarchy path for category.

Status Code

  • The hierarchy paths of categories have been retrieved successfully

  • Unauthorized

  • The category with given {guid} does not exist in the glossary.

  • Internal Server Error

Example responses
  • {
      "category_hierarchy_paths": [
        {
          "category_id": "b50f0822-eff3-4912-932e-aa61e5e7ac9a",
          "category_hierarchy_path": [
            {
              "artifact_id": "4c4b18ae-010c-4986-a308-93c6f22095d6",
              "name": "category name 1",
              "user_access": true
            },
            {
              "artifact_id": "fedc7149-5504-4ea9-aca7-3ad025be6f7d",
              "name": "category name 2",
              "user_access": true
            }
          ]
        }
      ]
    }

Retrieves category hierarchy paths for given artifact ids of categories

This method can be used for retrieving hierarchy paths of categories

POST /v3/categories/hierarchy

Request

Query Parameters

  • The maximum number of categories to return - must be at least 1 and cannot exceed 1000. The default value is 10.

    Possible values: 1 ≤ value ≤ 1000

    Default: 10

  • The index of the first matching category to include in the result.

List of glossary resources

Examples:
{
  "resources": [
    {
      "artifact_id": "2b9bb7cf-502e-43a2-9ecc-645e909cba33"
    }
  ]
}

Response

Response returned on retrieving hierarchy path for category.

Status Code

  • The hierarchy paths of categories have been retrieved successfully

  • Unauthorized

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "metadata": {
            "artifact_type": "category",
            "artifact_id": "2b9bb7cf-502e-43a2-9ecc-645e909cba33",
            "version_id": "5b6a662e-10d5-47fd-b485-655521ee491a_0",
            "source_repository_id": "2513bb40-5ce0-440e-9aa7-f473d1c22f9f",
            "source_repository_name": "WKC_BG_2513bb40-5ce0-440e-9aa7-f473d1c22f9f",
            "global_id": "2513bb40-5ce0-440e-9aa7-f473d1c22f9f_2b9bb7cf-502e-43a2-9ecc-645e909cba33",
            "created_by": "System",
            "created_at": "2023-11-13T06:50:09.240Z",
            "modified_by": "System",
            "modified_at": "2023-11-13T06:50:09.240Z",
            "revision": "0",
            "name": "child of child2 category",
            "short_description": "child of child2-sd",
            "state": "PUBLISHED",
            "tags": [],
            "read_only": false
          },
          "entity": {
            "parent_category_id": "b02920a4-09ae-4a62-a25f-03a2d7ba0507",
            "reporting_authorized": false,
            "long_description": "child of child2-ld",
            "state": "PUBLISHED",
            "default_locale_id": "en-US",
            "reference_copy": false
          }
        }
      ],
      "offset": 0,
      "last": {
        "href": "/v3/categories/hierarchy?limit=10&offset=0",
        "offset": "0"
      },
      "set_uri": false,
      "limit": 10,
      "count": 1,
      "first": {
        "href": "/v3/categories/hierarchy?limit=10&offset=0",
        "offset": "0"
      }
    }

Retrieves the special [uncategorized] category

This method can be used for retrieving details of the special [uncategorized] category, which is a default one for all artifacts.

GET /v3/categories/uncategorized

Request

No Request Parameters

This method does not accept any request parameters.

Response

Represents a category object - which contains metadata and category entity.

Status Code

  • The category has been retrieved successfully.

  • Unauthorized

  • Forbidden

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Deletes the category with a given guid

This method can be used to delete a category.
Note! The category must be empty. It can contain neither child categories nor artifacts.

DELETE /v3/categories/{category_id}

Request

Path Parameters

  • Artifact ID or global ID of the artifact

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Response

Glossary archive response object

Status Code

  • The category has been deleted successfully.

  • Bad Request

  • Unauthorized

  • Forbidden

  • The category with given {guid} does not exist in the glossary.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Retrieves category with given guid

This method can be used for retrieving details of a category.

GET /v3/categories/{category_id}

Request

Path Parameters

  • Artifact ID or global ID of the artifact

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Query Parameters

  • When set to true fetch category relationships user has access to. It returns at most 1000 relationships. If parameter is not set its default value is 'true'. This is deprecated and default will be change to 'false' in first major 2022 release.
    Deprecated, functionality will be replaced by new one introduced in the feature releases.

    Default: true

  • If this parameter is set to true, then all artifact custom attributes are returned. If parameter is not set its default value is 'true'. This is deprecated and default will be change to 'false' in first major 2022 release.

    Default: true

Response

Represents a category object - which contains metadata and category entity.

Status Code

  • The category has been retrieved successfully.

  • Unauthorized

  • Forbidden

  • The category with given {guid} does not exist in the glossary.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Updates category with given id

This method can be used to update a category with given id.
It may be an update of its name, description, etc..

PATCH /v3/categories/{category_id}

Request

Path Parameters

  • Artifact ID or global ID of the artifact

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

Category to be updated.
Fields omitted will be unchanged, and fields set to null explicitly will be nulled out.
For multi-valued attributes & relationships, the complete list will be replaced by the given list of values.
Additional Example:

{"description" : "short desc updated"}

Response

Represents a category object - which contains metadata and category entity.

Status Code

  • The category has been updated successfully.

  • Bad Request

  • Unauthorized

  • Forbidden

  • The category with given {guid} does not exist in the glossary.

  • The category was modified by another user.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Removes an artifact from its secondary category

It can be used to remove a secondary category assignment for an artifact. It does not allow to remove an artifact from a primary category as a primary category assignment is obligatory.

DELETE /v3/categories/{category_id}/artifacts/{artifact_id}

Request

Path Parameters

  • The artifact ID or the global ID of a category

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The artifact ID or the global ID of an artifact to be removed from a (secondary) category

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Response

Status Code

  • A secondary category assignment removed.

  • Attempt to remove an artifact from its primary category failed, because a primary category assignment is mandatory.

  • Unauthorized

  • The category with the given {category_id} does not exist in the glossary.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Adds an artifact to a category

It can be used to set a primary category for an artifact (replacing an old primary category assignment if existed) as well as to add an artifact to a secondary category.

PUT /v3/categories/{category_id}/artifacts/{artifact_id}

Request

Path Parameters

  • The artifact ID or the global ID of a category

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The artifact ID or the global ID of an artifact to be added to the category

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Assignment of an artifact to a category

Response

Assignment of an artifact to a category

Status Code

  • An existing category assignment updated (e.g. changed from secondary to primary).

  • A new category assignment created.

  • Unauthorized

  • The category with the given {category_id} or the artifact with the given {artifact_id} does not exist in the glossary.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Retrieves collaborators for given artifact id of a category

Single collaborator is an users with assigned roles in context of given category. A role comes with rights to access the category, its sub-categories and artifacts and potential responsibilities.

GET /v3/categories/{category_id}/collaborators

Request

Path Parameters

  • The artifact ID or the global ID of a category

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Query Parameters

  • If this parameter is true, the returned list contains collaborators not only for given category, but also for all parent categories, up to root category.

    Default: true

  • If set then the returned list will be reduced to collaborators with given roles only. Maximum allowed number of roles is 100

    Possible values: 1 ≤ length ≤ 100, Value must match regular expression .*

Response

Response returned on retrieving category permissions.

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • The category with given {guid} does not exist in the glossary.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Creates single collaborator for given category

To create collaborator one needs to provide id of the collaborating user and the name of the role he will be permitted. Collaborator is effective for given category and whole tree of its subcategories.

POST /v3/categories/{category_id}/collaborators

Request

Path Parameters

  • The artifact ID or the global ID of a category

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

New collaborator data representing user with assigned role. It will be created in the context of specific category.

Response

Category permission list for given category id

Status Code

  • The collaborator has been created successfully.

  • Bad Request

  • Unauthorized

  • UniqueConstraintViolation - collaborator with the same role and user id already exists for given category.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Deletes single collaborator

Collaborator represents single user together with single role that gives him certain privileges in context of given category.

DELETE /v3/categories/{category_id}/collaborators/{collaborator_id}

Request

Path Parameters

  • The artifact ID or the global ID of a category

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The id of the collaborator.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Response

Status Code

  • The collaborator has been deleted successfully.

  • Bad Request

  • Unauthorized

  • The collaborator with given id does not exist.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

List the relationships of the given type for the specified category

If the result set is larger than the limit parameter, it returns the first limit number of relationships.
To retrieve the next set of relationships, call the method again by using the URI in the property next returned by this method.

GET /v3/categories/{category_id}/relationships

Request

Path Parameters

  • The artifact ID of the category.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Query Parameters

  • Comma-separated list of relationship types.

    Available types:
    is_a_type_of_category
    has_types_category
    is_a_parent_category_for
    grouped_assets
    owned_by
    classifications
    custom
    all

    Note: all does not return category hierarchy.

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression ^(((is_a_type_of_category|has_types_category|is_a_parent_category_for|grouped_assets|owned_by|classifications|custom),?)+)|all$

  • Custom relationship definition Id.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • Is custom relationship reversed?

    Default: false

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

    Default: false

  • Retrieves target parent category name of the relationship entity.

    Default: false

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

    Default: 0

Response

Response that includes relationships to a managed object, like business term, data class, classification

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Remove a relationship from category

Currently we support a custom relationship removal from category by relationship ID.

DELETE /v3/categories/{category_id}/relationships/{relationship_id}

Request

Path Parameters

  • The artifact ID of the category to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The artifact ID of the relationship to be deleted.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Response

Status Code

  • A relationship has been removed.

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Get role usage statistics

Get list of roles assigned in glossary, along with number of categories where specific role is used.

GET /v3/category_role_statistics

Request

No Request Parameters

This method does not accept any request parameters.

Response

List of role usage summary

Status Code

  • Success

  • Unauthorized

  • Internal Server Error

Example responses
  • SUCCEEDED

    {
      "role_assignment_statistics": [
        {
          "role": "custom_role1",
          "number_of_categories": 1
        },
        {
          "role": "custom_role2",
          "number_of_categories": 2
        },
        {
          "role": "owner",
          "number_of_categories": 2
        },
        {
          "role": "viewer",
          "number_of_categories": 2
        }
      ]
    }

Returns list of categories which has specific role assigned, along with number of assignments for users and groups

Category statistics

GET /v3/category_statistics

Request

Query Parameters

  • Role for which statistics are to be retrieved

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

Response

List of category statistic items

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Internal Server Error

Example responses
  • SUCCEEDED

    {
      "offset": 0,
      "last": {
        "href": "v3/category_statistics?offset=0&role=custom_role2",
        "offset": 0
      },
      "set_uri": false,
      "resources": [
        {
          "category_artifact_id": "788e7609-5d1d-4f5f-a2e2-0011f8c726cf",
          "category_name": "Example category",
          "category_hierarchy_path": [
            {
              "artifact_id": "4562a011-563d-40c2-ae28-80f64cd8d934",
              "name": "Parent of example category",
              "user_access": true
            },
            {
              "artifact_id": "e6abcaba-203f-4f43-8bc3-f4f25aa96f19",
              "name": "Root category",
              "user_access": true
            }
          ],
          "users_assignments_count": 2,
          "groups_assignments_count": 1
        }
      ],
      "limit": 10,
      "count": 1,
      "first": {
        "href": "v3/category_statistics?offset=0&role=custom_role2",
        "offset": 0
      }
    }

Creates a classification in the glossary

This method is used to create a classification in the glossary.

POST /v3/classifications

Request

Query Parameters

  • If workflow template configuration permits, the artifact will be created in the published state by skipping the workflow. For details refer to documentation.

New classification entity

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Unique constraint violated because of optimistic locking or some other constraint.

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "href": "v3/reference_data/0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6/versions/4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "artifact_id": "0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "version_id": "4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "workflow_id": "56b82aa1-0f3c-4e2c-84bf-bee619c84c7f",
          "global_id": "867907bd-4c80-458d-9e75-c5683e013533_0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "entity_type": "reference_data"
        }
      ]
    }

Retrieves classification with given guid and status

This method can be used for retrieving details of an ACTIVE classification. Only ACTIVE is supported

GET /v3/classifications/{artifact_id}/versions

Request

Path Parameters

  • Artifact ID or global ID of the artifact

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Query Parameters

  • Filter by classification status.

    Available statuses:
    DRAFTartifacts which are being created or modified and not in use
    PUBLISHEDartifacts which are in published state (does not takes effective dates into account)
    ACTIVEartifacts which are published, and which effective date period includes current datetime

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Default: PUBLISHED

  • Comma-separated list of relationship types.

    Available types:
    is_a_type_of_classification
    has_types_classifications
    has_types_classifications_hierarchy
    categories
    parent_category
    terms
    data_classes
    policies
    rules
    reference_data
    related_categories
    custom
    all

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

  • If this parameter is set to true, then all artifact custom attributes are returned. If parameter is not set its default value is 'true'. This is deprecated and default will be change to 'false' in first major 2022 release.

    Default: true

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

Response

List of paginated artifacts

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Deletes a draft or published version of an artifact

If the artifact state is DRAFT, then the draft version is deleted.

If the artifact state is PUBLISHED, a draft version with marked_for_deletion is created .

If the artifact state is PUBLISHED and workflow is skipped, then the published version is deleted.

If a draft artifact already exists for deletion for a published artifact, then the draft artifact is simply skipped.

Administrator role is required.

DELETE /v3/classifications/{artifact_id}/versions/{version_id}

Request

Path Parameters

  • The guid of the classification to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the classification to delete.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If workflow template configuration permits, the published artifact will be deleted by skipping the workflow. For details refer to documentation.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • A draft version has been successfully created for deleting the published artifact.

  • The artifact has been deleted successfully.

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Retrieves classification with given guid

This method can be used for retrieving details of an ACTIVE or DRAFT classification.

GET /v3/classifications/{artifact_id}/versions/{version_id}

Request

Path Parameters

  • The artifact id of the classification to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the classification to fetch.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • Comma-separated list of relationship types.

    Available types:
    is_a_type_of_classification
    has_types_classifications
    has_types_classifications_hierarchy
    categories
    parent_category
    terms
    data_classes
    policies
    rules
    reference_data
    related_categories
    custom
    all

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

  • If this parameter is set to true, then all artifact custom attributes are returned. If parameter is not set its default value is 'true'. This is deprecated and default will be change to 'false' in first major 2022 release.

    Default: true

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

Response

Response classification object

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Updates a draft or published artifact

If a published version is updated, a draft version is created from the published version and the draft version is updated with the requested changes and returned.If any relationships of the artifact are updated, then the updated relationships are returned as a paginated list limited by the give limit parameter. The relationships that are not updated are not returned.

PATCH /v3/classifications/{artifact_id}/versions/{version_id}

Request

Path Parameters

  • The artifact id of the classification to be updated.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the classification to be updated.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If configuration permits, the published artifact will be updated by skipping the workflow. For details refer to documentation.

The classification to be updated.
Fields omitted will be unchanged, and fields set to null explicitly will be nulled out.
For multi-valued attributes & relationships, the complete list will be replaced by the given list of values.
Additional Example:

{"description" : "description updated"}

Response

Response classification object

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not found

  • Unique constraint violated because of optimistic locking or some other constraint.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

List the associations of the given type for the specified classification

If the result set is larger than the limit parameter, it returns the first limit number of relationships.
To retrieve the next set of relationships, call the method again by using the URI in the property next returned by this method.

GET /v3/classifications/{artifact_id}/versions/{version_id}/relationships

Request

Path Parameters

  • The artifactId of the classification

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The versionId of the classification

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • Comma-separated list of relationship types.

    Available types:
    is_a_type_of_classification
    has_types_classifications
    has_types_classifications_hierarchy
    categories
    parent_category
    terms
    data_classes
    policies
    rules
    reference_data
    related_categories
    custom
    all

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • Custom relationship definition Id.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • Is custom relationship reversed?

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

  • Retrieves target parent category name of the relationship entity.

  • The maximum number of associations to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

Response

Response that includes relationships to a managed object, like business term, data class, classification

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Create relationships for an artifact in the glossary

If it is a published version, it creates a draft from the published version and adds the relationship to the draft version. And, it returns the details of the draft version.

POST /v3/classifications/{artifact_id}/versions/{version_id}/relationships

Request

Path Parameters

  • The artifact id of the classification to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the classification to fetch.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If configuration permits, the published artifact will be updated by skipping the workflow. For details refer to documentation.

Relationships to be created.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Deletes relationships for an artifact in the glossary

If it is a published version, it creates a draft from the published version and deletes the relationship from the draft version. And, it returns the details of the draft version.

DELETE /v3/classifications/{artifact_id}/versions/{version_id}/relationships/{relationship_id}

Request

Path Parameters

  • The artifact id of the classification to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the classification to fetch.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

  • The artifact ID of the relationship to be deleted.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Query Parameters

  • If workflow template configuration permits, the published artifact will be deleted by skipping the workflow. For details refer to documentation.

Response

Glossary archive response object

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Retrieves the data classes matching specified parameters.

This method is used to retrieve the data classes that the user have permissions and they match specified parameters.

GET /v3/data_classes

Request

Custom Headers

  • Allowable values: [application/json,application/xml]

Query Parameters

  • Comma-separated list of dataclass statuses.

    Available statuses:
    PUBLISHEDartifacts which are in published state (does not takes effective dates into account)
    ACTIVEartifacts which are published, and which effective date period includes current datetime
    DELETEDartifacts which have been deleted

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

    Default: PUBLISHED

  • To filter data classes based on enabled property. The enabled query parameter accepts (Yes, No, Both) where Yes is the default value. This option is not applicable for format=xml.

    Default: Both

  • If this parameter is set to true, then Dataclass' xml definitions are returned. If parameter is not set its default value is 'true'

    Default: true

  • If this parameter is set to true, then all artifact custom attributes are returned. If parameter is not set its default value is 'false'.

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

  • A filter to artifacts that have been created / updated / deleted since the given timestamp in this format: [yyyy-MM-ddTHH:mm:ss.SSSZ]

    Possible values: length = 24, Value must match regular expression ^\d{4}(-\d\d(-\d\d(T\d\d:\d\d(:\d\d)?(\.\d+)?(([+-]\d\d:\d\d)|Z)?)?)?)?$

  • The maximum number of data_classes to return - must be at least 1 and cannot exceed 1000. The default value is 10.

    Possible values: 1 ≤ value ≤ 1000

    Default: 10

  • The index of the first matching data_class to include in the result.

Response

Presents a paginated list of DataClasses

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Creates a draft data class in the glossary

This method is used to create a draft data class in the glossary. If the effective start date of selected reference data set is a future date, then effective start date of data class will be same as that of selected reference data set effective start date.

POST /v3/data_classes

Request

Query Parameters

  • If workflow template configuration permits, the artifact will be created in the published state by skipping the workflow. For details refer to documentation.

Data class to be created.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Unique constraint violated because of optimistic locking or some other constraint.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Retrieves data class with given guid and status

This method can be used for retrieving details of an ACTIVE or DRAFT data class. Only ACTIVE is allowed as status right now

GET /v3/data_classes/{artifact_id}/versions

Request

Path Parameters

  • Artifact ID or global ID of the artifact

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Query Parameters

  • Filter by dataclass status.

    Available statuses:
    DRAFTartifacts which are being created or modified and not in use
    PUBLISHEDartifacts which are in published state (does not takes effective dates into account)
    ACTIVEartifacts which are published, and which effective date period includes current datetime

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Default: PUBLISHED

  • Comma-separated list of relationship types.

    Available types:
    is_a_type_of_data_class
    has_types_data_classes
    has_types_data_class_hierarchy
    parent_category
    categories
    terms
    classifications
    policies
    rules
    reference_data
    custom
    all

    Note: all does not return data class hierarchy.

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • If this parameter is set to true, then all artifact custom attributes are returned. If parameter is not set its default value is 'true'. This is deprecated and default will be change to 'false' in first major 2022 release.

    Default: true

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

Response

List of paginated artifacts

Status Code

  • The data class has been retrieved successfully.

  • Bad Request

  • Unauthorized

  • The data class with given {guid} does not exist in the glossary.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Deletes a draft or published version of an artifact

If the artifact state is DRAFT, then the draft version is deleted.

If the artifact state is PUBLISHED, a draft version with marked_for_deletion is created .

If the artifact state is PUBLISHED and workflow is skipped, then the published version is deleted.

If a draft artifact already exists for deletion for a published artifact, then the draft artifact is simply skipped.

Administrator role is required.

DELETE /v3/data_classes/{artifact_id}/versions/{version_id}

Request

Path Parameters

  • The artifact id of the dataclass to delete.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the dataclass to delete.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If workflow template configuration permits, the published artifact will be deleted by skipping the workflow. For details refer to documentation.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • A draft version has been successfully created for deleting the published artifact.

  • The artifact has been deleted successfully.

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Retrieves data class with given guid

This method can be used for retrieving details of an ACTIVE or DRAFT data class.

GET /v3/data_classes/{artifact_id}/versions/{version_id}

Request

Path Parameters

  • The artifact ID of the data class to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version ID of the data class to fetch.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • Comma-separated list of relationship types.

    Available types:
    is_a_type_of_data_class
    has_types_data_classes
    has_types_data_class_hierarchy
    parent_category
    categories
    terms
    classifications
    policies
    rules
    reference_data
    custom
    all

    Note: all does not return data class hierarchy.

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • If this parameter is set to true, then all artifact custom attributes are returned. If parameter is not set its default value is 'true'. This is deprecated and default will be change to 'false' in first major 2022 release.

    Default: true

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

Response

Dataclass object

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Updates a draft or published artifact

If a published version is updated, a draft version is created from the published version and the draft version is updated with the requested changes and returned.If any relationships of the artifact are updated, then the updated relationships are returned as a paginated list limited by the give limit parameter. The relationships that are not updated are not returned.

PATCH /v3/data_classes/{artifact_id}/versions/{version_id}

Request

Path Parameters

  • The artifact id of the data class to be updated.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the data class to be updated.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If configuration permits, the published artifact will be updated by skipping the workflow. For details refer to documentation.

The data class to be updated.
Fields omitted will be unchanged, and fields set to null explicitly will be nulled out.
For multi-valued attributes & relationships, the complete list will be replaced by the given list of values.
Additional Example:

{"description" : "description updated"}
If the effective start date of selected reference data set is a future date, then effective start date of data class will be same as that of selected reference data set effective start date.

Response

Dataclass object

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

List the relationships of the given type for the specified data class

If the result set is larger than the limit parameter, it returns the first limit number of relationships.
To retrieve the next set of relationships, call the method again by using the URI in the property next returned by this method.

GET /v3/data_classes/{artifact_id}/versions/{version_id}/relationships

Request

Path Parameters

  • The artifact ID of the data class to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version ID of the data class to fetch.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • Comma-separated list of relationship types.

    Available types:
    is_a_type_of_data_class
    has_types_data_classes
    has_types_data_class_hierarchy
    parent_category
    categories
    terms
    classifications
    policies
    rules
    reference_data
    custom
    all

    Note: all does not return data class hierarchy.

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • Custom relationship definition Id.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • Is custom relationship reversed?

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

  • Retrieves target parent category name of the relationship entity.

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

Response

Response that includes relationships to a managed object, like business term, data class, classification

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Create relationships for an artifact in the glossary

If it is a published version, it creates a draft from the published version and adds the relationship to the draft version. And, it returns the details of the draft version.

POST /v3/data_classes/{artifact_id}/versions/{version_id}/relationships

Request

Path Parameters

  • The artifact ID of the data class to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version ID of the data class to fetch.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If configuration permits, the published artifact will be updated by skipping the workflow. For details refer to documentation.

Relationships to be created.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Deletes relationships for an artifact in the glossary

If it is a published version, it creates a draft from the published version and deletes the relationship from the draft version. And, it returns the details of the draft version.

DELETE /v3/data_classes/{artifact_id}/versions/{version_id}/relationships/{relationship_id}

Request

Path Parameters

  • The artifact ID of the data class to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version ID of the data class to fetch.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

  • The artifact ID of the relationship to be deleted.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Query Parameters

  • If workflow template configuration permits, the published artifact will be deleted by skipping the workflow. For details refer to documentation.

Response

Glossary archive response object

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Business Glossary Heartbeat

Returns the build details and health of the dependent services

GET /v3/glossary_status/heartbeat

Request

No Request Parameters

This method does not accept any request parameters.

Response

Holds business glossary build information and DB2 connection status information

Status Code

  • Success

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Tenant init and status

Checks tenant init status (and initialize if necessary), blocks until init is done

POST /v3/glossary_status/tenant_init

Request

No Request Parameters

This method does not accept any request parameters.

Response

Status Code

  • Success

  • Requested data are not available, try again later.

No Sample Response

This method does not specify any sample responses.

Tenant init and status

Checks tenant init status, returns immediately (initialization if required is performed in background)

GET /v3/glossary_status/tenant_init_status

Request

No Request Parameters

This method does not accept any request parameters.

Response

Tenant init status

Status Code

  • Success

No Sample Response

This method does not specify any sample responses.

Creates draft terms in the glossary

If the unique constraint on the name or display name of the term is violated, the method fails with 409 Conflict response.

POST /v3/glossary_terms

Request

Query Parameters

  • If workflow template configuration permits, the artifact will be created in the published state by skipping the workflow. For details refer to documentation.

Terms to be created. The terms array must contain at least 1 term, and cannot exceed 100 terms.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Unique constraint violated because of optimistic locking or some other constraint.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Retrieves versions of a term for the given artifact_id and status

Retrieval of the versions of ACTIVE state is supported.

GET /v3/glossary_terms/{artifact_id}/versions

Request

Path Parameters

  • Artifact ID or global ID of the artifact

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Query Parameters

  • Filter by term status.

    Available statuses:
    DRAFTartifacts which are being created or modified and not in use
    PUBLISHEDartifacts which are in published state (does not takes effective dates into account)
    ACTIVEartifacts which are published, and which effective date period includes current datetime

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Default: PUBLISHED

  • Comma-separated list of relationship types.

    Available types:
    is_a_type_of_terms
    has_type_terms
    has_types_term_hierarchy
    synonym_terms
    related_terms
    data_classes
    is_of_terms
    has_terms
    categories
    parent_category
    classifications
    policies
    rules
    reference_data
    reference_data_values
    custom
    all

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • If this parameter is set to true, then all artifact custom attributes are returned. If parameter is not set its default value is 'true'. This is deprecated and default will be change to 'false' in first major 2022 release.

    Default: true

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

Response

List of paginated artifacts

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Deletes a draft or published version of an artifact

If the artifact state is DRAFT, then the draft version is deleted.

If the artifact state is PUBLISHED, a draft version with marked_for_deletion is created .

If the artifact state is PUBLISHED and workflow is skipped, then the published version is deleted.

If a draft artifact already exists for deletion for a published artifact, then the draft artifact is simply skipped.

Administrator role is required.

DELETE /v3/glossary_terms/{artifact_id}/versions/{version_id}

Request

Path Parameters

  • The artifact id of the term to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the term to delete.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If workflow template configuration permits, the published artifact will be deleted by skipping the workflow. For details refer to documentation.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • A draft version has been successfully created for deleting the published artifact.

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Gets the term in the glossary with a given version id

This method can be used for retrieving details of an ACTIVE or DRAFT term.

GET /v3/glossary_terms/{artifact_id}/versions/{version_id}

Request

Path Parameters

  • The artifact id of the term to fetch.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the term to fetch.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • Comma-separated list of relationship types.

    Available types:
    is_a_type_of_terms
    has_type_terms
    has_types_term_hierarchy
    synonym_terms
    related_terms
    data_classes
    is_of_terms
    has_terms
    categories
    parent_category
    classifications
    policies
    rules
    reference_data
    reference_data_values
    custom
    all

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • If this parameter is set to true, then all artifact custom attributes are returned. If parameter is not set its default value is 'true'. This is deprecated and default will be change to 'false' in first major 2022 release.

    Default: true

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

Response

Response glossary term object

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Updates a draft or published artifact

If a published version is updated, a draft version is created from the published version and the draft version is updated with the requested changes and returned.If any relationships of the artifact are updated, then the updated relationships are returned as a paginated list limited by the give limit parameter. The relationships that are not updated are not returned.

PATCH /v3/glossary_terms/{artifact_id}/versions/{version_id}

Request

Path Parameters

  • The artifact id of the term to be updated.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the term to be updated.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If configuration permits, the published artifact will be updated by skipping the workflow. For details refer to documentation.

The business term to be updated.
Fields omitted will be unchanged, and fields set to null explicitly will be nulled out. If a relationship of the term is updated, then the updated relationship as returned as a paginated list limited by the give limit parameter. Relationships that are not updated are not returned.

Response

Response glossary term object

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Unique constraint violated because of optimistic locking or some other constraint.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

List the relationships for the specified term

If the result set is larger than the limit parameter, it returns the first limit number of relationships.
To retrieve the next set of relationships, call the method again by using the URI in the property next returned by this method.

GET /v3/glossary_terms/{artifact_id}/versions/{version_id}/relationships

Request

Path Parameters

  • The guid of the Term

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The versionID of the Term

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • Comma-separated list of relationship types.

    Available types:
    is_a_type_of_terms
    has_type_terms
    has_types_term_hierarchy
    synonym_terms
    related_terms
    data_classes
    is_of_terms
    has_terms
    categories
    parent_category
    classifications
    policies
    rules
    reference_data
    reference_data_values
    custom
    all

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • Custom relationship definition Id.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • Is custom relationship reversed?

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

  • Retrieves target parent category name of the relationship entity.

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

Response

Response that includes relationships to a managed object, like business term, data class, classification

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Create relationships for an artifact in the glossary

If it is a published version, it creates a draft from the published version and adds the relationship to the draft version. And, it returns the details of the draft version.

POST /v3/glossary_terms/{artifact_id}/versions/{version_id}/relationships

Request

Path Parameters

  • The artifact ID of the term to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version ID of the term to fetch.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If configuration permits, the published artifact will be updated by skipping the workflow. For details refer to documentation.

Relationships to be created.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Unique constraint violated because of optimistic locking or some other constraint.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Deletes relationships for an artifact in the glossary

If it is a published version, it creates a draft from the published version and deletes the relationship from the draft version. And, it returns the details of the draft version.

DELETE /v3/glossary_terms/{artifact_id}/versions/{version_id}/relationships/{relationship_id}

Request

Path Parameters

  • The artifact ID of the term to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version ID of the term to fetch.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

  • The artifact ID of the relationship to be deleted.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Query Parameters

  • If workflow template configuration permits, the published artifact will be deleted by skipping the workflow. For details refer to documentation.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Exports custom attribute definitions to a json file

This method can be used to export custom attribute definitions to a json file.

POST /v3/governance_artifact_types/custom_attribute_definitions/export

Request

Query Parameters

  • The comma-separated list of supported custom attribute types. Allowed values are text, date, number, enum, relationship, all, all_without_relationship.

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

    Example: text,date

  • The artifact type which a custom attribute definition applies to. Allowed values are category, glossary_term, data_class, policy, rule, classification, reference_data

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term,policy

  • The related artifact type which a custom attribute definition for relationship applies to. Allowed values are category, glossary_term, data_class, policy, rule, classification, reference_data

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term,policy

The list of custom attribute definitions artifact ids to be exported.

Examples:

An example for resources with ids for custom attribute definitions

An example for resources with ids for custom attribute definitions

{
  "resources": [
    {
      "artifact_id": "455b7b78-3d64-48e6-a9b6-e02f4c32295f"
    }
  ]
}

Response

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Forbidden

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Import values for custom attribute definitions from specified json file

This method can be used to import values custom attribute definitions from specified json file.

POST /v3/governance_artifact_types/custom_attribute_definitions/import

Request

Query Parameters

  • Determines if only custom properties or custom relationships or both types will be imported. Allowed values: ALL, PROPERTY, RELATIONSHIP.

    Allowable values: [ALL,PROPERTY,RELATIONSHIP]

    Default: ALL

  • If async_mode is true, then the method starts an asynchronous process to execute the given action and returns with ACCEPTED 202 status code.

Form Parameters

  • File

    Possible values: 1 ≤ length ≤ 2147483647

Response

Glossary Import Status

Status Code

  • Import of assets has been completed

  • Import of assets has been started

  • Unauthorized

  • Unique constraint violated because of optimistic locking or some other constraint.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Export values of all supported types to a ZIP file

This method can be used to export values of all supported types to a ZIP file.

GET /v3/governance_artifact_types/export

Request

Query Parameters

  • This specifies if artifact ID numbers should be included in exported files, or not. Possible values: "always", artifact ID numbers are included for artifacts, and "never", not included at all.

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Default: always

    Example: always

  • The comma-separated list of supported artifact types. Allowed values are all, category, classification, data_class, glossary_term, policy, rule, reference_data and role_assignment.

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

    Default: all

    Example: category,glossary_term

  • The comma-separated list of categories ID numbers, or "all_top_level", which means all top-level categories.

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

    Default: all_top_level

    Example: e39ada11-8338-3704-90e3-681a71e7c839,c305c9fe-3223-48a0-b146-228a782bc7e4

  • If parameter "include_custom_attribute_definitions" is set to true, information about suitable custom attribute definitions will be included in zip

    Default: false

  • If parameter "include_development_log" is set to true, development log content will be included in zip

    Default: false

Response

Status Code

  • Success

  • Unauthorized

  • The category with given {guid} does not exist in the glossary.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Import values from specified ZIP file

This method can be used to import values from specified ZIP file.

POST /v3/governance_artifact_types/import

Request

Query Parameters

  • Import merge option, valid values:
    all - imported values will replace existing values in catalog
    specified - imported values that are not empty replace existing values in catalog
    empty - imported values replace only empty values in catalog.

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Default: specified

    Example: specified

Form Parameters

  • File

    Possible values: 1 ≤ length ≤ 2147483647

Response

Glossary Import Status

Status Code

  • Import of assets has been completed

  • Import of assets has been started

  • Unauthorized

  • Unique constraint violated because of optimistic locking or some other constraint.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Cleanup ZIP import process

This method can be used to cleanup specified stalled ZIP import process that crashed or hanged. Note: This feature is experimental - the API and scope are subject to change. Should not be used on imports that are alive or pending as it can lead to unpredictable results.

POST /v3/governance_artifact_types/import/cleanup/{process_id}

Request

Path Parameters

  • Import process id

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: 67c6dab6-c3ee-441e-8445-fff2f7259514

Response

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Import of assets status

Import of assets status

GET /v3/governance_artifact_types/import/status/{process_id}

Request

Path Parameters

  • Import process id

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

Query Parameters

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

    Default: 0

Response

Glossary Import Status

Status Code

  • Import status available

  • Unauthorized

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Get artifacts of given type that are either published or drafts matching specified criteria

This method can be used for retrieving artifacts of given type that are:

  • published,
  • drafts matching specified criteria (starts_with, substring, workflow_status, created_by, modified_by, enabled).

GET /v3/governance_artifact_types/{artifact_type}

Request

Path Parameters

  • The artifact type. Allowed values are all, glossary_term, classification, data_class, reference_data, policy, rule

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term

Query Parameters

  • First character of artifact, applicable only for draft artifact search.

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

    Example: Tes

  • Filter on substring, applicable only for draft artifact search.

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

    Example: est

  • Filter by workflow status.

    Available statuses (if no status is specified, all drafts are retrieved):
    published
    Publishing (applicable only for draft artifact search)
    Publish failed (applicable only for draft artifact search)
    Not started (applicable only for draft artifact search)

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

    Example: NOT_STARTED

  • Filter by creator of artifact, applicable only for draft artifact search.

    Possible values: 1 ≤ length ≤ 73, Value must match regular expression .*

    Example: IBMid-1234567ABC

  • Filter by editor of artifact, applicable only for draft artifact search.

    Possible values: 1 ≤ length ≤ 73, Value must match regular expression .*

    Example: IBMid-1234567ABC

  • Filter Results based on enabled flag for dataclass, yes will give enabled dataclass, no will give disabled and both shall return all, applicable only for draft artifact search.

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

    Example: yes

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

  • Value on which results need to be sorted, valid sort parameters are NAME, MODIFIED, CREATED, TYPE.Prefix hyphen (-) for descending order, applicable only for draft artifact search.

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

    Example: -NAME

Response

List of paginated workflow artifacts

Status Code

  • Artifacts have been retrieved successfully.

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Retrieves custom attribute definitions with given artifact type

This method can be used for retrieving details of custom attribute definitions.

GET /v3/governance_artifact_types/{artifact_type}/custom_attribute_definitions

Request

Path Parameters

  • The artifact type. Allowed values are all, category, glossary_term, classification, data_class, reference_data, policy, rule

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term

Query Parameters

  • Is the artifact type defined as related artifact type or not, in case of "RELATIONSHIP" type only!

Response

Used to facilitate serialization and correct swagger documentation.

Status Code

  • The custom attribute definitions have been retrieved successfully.

  • Unauthorized

  • The custom attribute definition with given {artifact_id} does not exist.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Creates custom attribute definition in the glossary

This method can be used to create custom attribute definition in the glossary.

POST /v3/governance_artifact_types/{artifact_type}/custom_attribute_definitions

Request

Path Parameters

  • The artifact type. Allowed values are all, category, glossary_term, classification, data_class, reference_data, policy, rule

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term

Custom attribute definition to be created.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • The custom attribute definition has been created successfully.

  • Bad Request

  • Unauthorized

  • UniqueConstraintViolation - custom attribute definition with given name already exists.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Deletes the custom attribute definition with a given artifact_id

This method is used to delete the custom attribute definition with a given artifact_id (guid).

DELETE /v3/governance_artifact_types/{artifact_type}/custom_attribute_definitions/{custom_attribute_definition_artifact_id}

Request

Path Parameters

  • The artifact type. Allowed values are all, category, glossary_term, classification, data_class, reference_data, policy, rule

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term

  • The artifact_id of the custom attribute definition to be purged.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: 990e33f5-3108-4d45-a530-030745831313

Response

Glossary archive response object

Status Code

  • The custom attribute definition has been deleted successfully.

  • Bad Request

  • Unauthorized

  • The custom attribute definition with given {artifact_id} does not exist.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Retrieves custom attribute definition with given artifact_id

This method can be used for retrieving details of a custom attribute definition.

GET /v3/governance_artifact_types/{artifact_type}/custom_attribute_definitions/{custom_attribute_definition_artifact_id}

Request

Path Parameters

  • The artifact type. Allowed values are all, category, glossary_term, classification, data_class, reference_data, policy, rule

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term

  • The artifact_id of the custom attribute definition to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: d4a5e6e1-a6c0-4580-afbb-6898303adf34

Response

Used to facilitate serialization and correct swagger documentation.

Status Code

  • The custom attribute definition has been retrieved successfully.

  • Unauthorized

  • The custom attribute definition with given {artifact_id} does not exist.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Updates custom attribute definition with given artifact_id

This method is used to update custom attribute definition with given artifact_id.

PATCH /v3/governance_artifact_types/{artifact_type}/custom_attribute_definitions/{custom_attribute_definition_artifact_id}

Request

Path Parameters

  • The artifact type. Allowed values are all, category, glossary_term, classification, data_class, reference_data, policy, rule

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term

  • The artifact_id of the custom attribute definition to be updated.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

Custom attribute definition to be updated.
Fields omitted will be unchanged, and fields set to null explicitly will be nulled out.
For multi-valued attributes & relationships, the complete list will be replaced by the given list of values.
Additional Example:

{"business_description" : "business desc updated"}

Response

Used to facilitate serialization and correct swagger documentation.

Status Code

  • The custom attribute definition has been updated successfully.

  • Bad Request

  • Unauthorized

  • Forbidden

  • The custom attribute definition with given {artifact_id} does not exist.

  • The custom attribute definition was modified by another user.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Delete a list of draft or published versions of given artifact_type

If the artifact state is DRAFT, then the draft version is deleted.

If the artifact state is PUBLISHED, a draft version with marked_for_deletion is created .

If the artifact state is PUBLISHED and workflow is skipped, then the published version is deleted.

If a draft artifact already exists for deletion for a published artifact, then the draft artifact is simply skipped.

Administrator role is required.

POST /v3/governance_artifact_types/{artifact_type}/delete

Request

Path Parameters

  • The artifact type. Allowed values are category, glossary_term, classification, data_class, reference_data, policy, rule

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term

Query Parameters

  • If async_mode is true, then the method starts an asynchronous process to execute the given action and returns with ACCEPTED 202 status code.

  • If workflow template configuration permits, the published artifact will be deleted by skipping the workflow. For details refer to documentation.

  • If someone has already created a draft for deleting or updating an artifact, then the artifact will be ignored.

  • If specified asset does does not exist, it is skipped.

    Default: false

The list of artifacts to be deleted. All the artifacts must be either in published state or draft state, but mix of draft and published state is not allowed.

Response

Status Code

  • A draft version has been successfully created for deleting the published artifact.

  • If async_mode is true, then the method starts an asynchronous process to execute the given action and returns with ACCEPTED 202 status code.

  • The artifacts have been deleted successfully.

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Exports values of a specified type to a csv file

This method can be used to export values of a specified type to a csv file.

GET /v3/governance_artifact_types/{artifact_type}/export

Request

Path Parameters

  • The artifact type. Allowed values are category, glossary_term, data_class, policy, rule, classification

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term

Query Parameters

  • The artifactId of the parent category

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: 990e33f5-3108-4d45-a530-0307458362d4

  • Whether to include the parent category. This applies to category (as asset type) export only, and is ignored for other asset types. The special [uncategorized] category is not included.

  • Whether to include assets from subcategories

Response

Status Code

  • Success

  • Unauthorized

  • The category with given {guid} does not exist in the glossary.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Import values from specified csv file

This method can be used to import values from specified csv file.

POST /v3/governance_artifact_types/{artifact_type}/import

Request

Path Parameters

  • The artifact type. Allowed values are category, glossary_term, classification, data_class, reference_data, policy, rule

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term

Query Parameters

  • Import merge option, valid values:
    all - imported values will replace existing values in catalog
    specified - imported values that are not empty replace existing values in catalog
    empty - imported values replace only empty values in catalog.

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Default: empty

    Example: all

  • If async_mode is true, then the method starts an asynchronous process to execute the given action and returns with ACCEPTED 202 status code.

Form Parameters

  • File

    Possible values: 1 ≤ length ≤ 2147483647

Response

Glossary Import Status

Status Code

  • Import of assets has been completed

  • Import of assets has been started

  • Unauthorized

  • Unique constraint violated because of optimistic locking or some other constraint.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Search for a list of drafts of given artifact_type

This method can be used for retrieving draft artifacts.

POST /v3/governance_artifact_types/{artifact_type}/search

Request

Path Parameters

  • The artifact type. Allowed values are category, glossary_term, classification, data_class, reference_data, policy, rule

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term

The list of draft artifacts to be retrieved. If drafts exist, then they are returned.

Response

Status Code

  • The drafts have been retrieved successfully.

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Get the latest published version of the specified artifact

This method can be used for getting the latest published version of the specified artifact.

GET /v3/governance_artifact_types/{artifact_type}/{artifact_id}

Request

Path Parameters

  • The artifact type. Allowed values are category, glossary_term, classification, data_class, reference_data, policy, rule

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term

  • Artifact ID or global ID of the artifact

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: 990e33f5-3108-4d45-a530-0307458362d4

Query Parameters

  • Comma-separated list of relationship types.

    Relationship TypesArtifact Types
    categoryclassificationdata_classglossary_termpolicyreference_datarule
    all+++++++
    categories-++++++
    child-----+-
    classifications+-+++++
    custom+++++++
    data_classes-+-++++
    data_location_rules----+--
    data_protection_rules----+--
    grouped_assets+------
    has_terms---+---
    has_type_terms---+---
    has_types_category+------
    has_types_classifications-+-----
    has_types_classifications_hierarchy-+-----
    has_types_data_class_hierarchy--+----
    has_types_data_classes--+----
    has_types_term_hierarchy---+---
    is_a_parent_category_for+------
    is_a_type_of_category+------
    is_a_type_of_classification-+-----
    is_a_type_of_data_class--+----
    is_a_type_of_terms---+---
    is_of_terms---+---
    multi_value_mappings-----+-
    owned_by+------
    parent-----+-
    parent_category-++++++
    parent_hierarchy-----+-
    parent_policy----+--
    policies-+++--+
    reference_data-+++--+
    reference_data_values---+---
    related_categories-+-----
    related_terms---+---
    replaced_by_terms---+---
    replaces_terms---+---
    rules-++++++
    single_value_mappings-----+-
    sub_policies----+--
    synonym_terms---+---
    terms-++-+++
    value_mappings-----+-

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • If this parameter is set to true, then all artifact custom attributes are returned. If parameter is not set its default value is 'false'.

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.
    This parameter is ignored when artifact type is category.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.
    This parameter is ignored when artifact type is category.

Response

Represents an object that we send back to the end user. It has two parts: entity and metadata.

Status Code

  • The latest published version of the specified artifact has been retrieved successfully.

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Changes the parent category of a published artifact with given id

This method can be used to change given artifact parent. Or make it root-level, in case of category.
Note: change of collaborators access may take longer to complete

POST /v3/governance_artifact_types/{artifact_type}/{artifact_id}/move

Request

Path Parameters

  • The artifact type. Allowed values are category, glossary_term, classification, data_class, reference_data, policy, rule

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term

  • Artifact ID or global ID of the artifact

    Possible values: 1 ≤ length ≤ 73, Value must match regular expression .*

Query Parameters

  • If configuration permits, the published artifact will be updated by skipping the workflow. For details refer to documentation.

Target category (to become a parent of this artifact)

Response

Represents an object that we send back to the end user. It has two parts: entity and metadata.

Status Code

  • The artifact has been moved successfully.

  • Bad Request

  • Unauthorized

  • Forbidden

  • Published artifact not found for given guid

  • Either the artifact was modified by another user, or the same artifact already exists with the same new parent category

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Get development logs & Comments for a draft artifact version

Get development logs & Comments for a draft artifact version

GET /v3/governance_artifact_types/{artifact_type}/{artifact_id}/versions/{version_id}/aggregated_logs

Request

Path Parameters

  • The artifact type. Allowed values are glossary_term, classification, data_class, reference_data, policy, rule

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term

  • The artifact id.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

  • Time zone offset based on which the day wise grouping is to be performed. The offset will be of format [+-]hh:mm where hh stands for hour digit and mm for minute digit.
    e.g. +05:30 indicates IST. If [+-] is not provided by default + will be appended. e.g 05:30 indicates +05:30.
    If hour digit is single like +h:mm provided, then it will be considered as +0h:mm. e.g. +5:30 indicates +05:30.
    The range of offsets is restricted to -17:59 to +17:59 inclusive.

    Possible values: 1 ≤ length ≤ 6, Value must match regular expression ^([+-]?)(0[0-9]|1[0-7]|[0-9]):([0-5][0-9])$

Response

List of paginated asset aggregated comments

Status Code

  • Development logs & Comments retrieved successfully

  • Bad Request

  • Unauthorized

  • Forbidden

  • Draft artifact version not found for given version_id

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Get development logs & Comments for a draft artifact version with development log id

Get development logs & Comments for a draft artifact version with development log id

GET /v3/governance_artifact_types/{artifact_type}/{artifact_id}/versions/{version_id}/aggregated_logs/{mod_id}

Request

Path Parameters

  • The artifact type. Allowed values are glossary_term, classification, data_class, reference_data, policy, rule

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term

  • The artifact id.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

  • The development log id.

    Possible values: 1 ≤ length ≤ 73, Value must match regular expression .*

Query Parameters

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

Response

Paginated asset comment modification details

Status Code

  • Development logs & Comments retrieved successfully

  • Bad Request

  • Unauthorized

  • Forbidden

  • Draft artifact version not found for given version_id

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Add a comment for a draft artifact version

Add a comment for a draft artifact version

POST /v3/governance_artifact_types/{artifact_type}/{artifact_id}/versions/{version_id}/comments

Request

Path Parameters

  • The artifact type. Allowed values are glossary_term, classification, data_class, reference_data, policy, rule

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term

  • The artifact id.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

The user comment.

Response

Comment By User

Status Code

  • Comment added successfully

  • Bad Request

  • Unauthorized

  • Forbidden

  • Draft artifact version not found for given version_id

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Delete a comment on a draft artifact version

Delete a comment on a draft artifact version

DELETE /v3/governance_artifact_types/{artifact_type}/{artifact_id}/versions/{version_id}/comments/{comment_id}

Request

Path Parameters

  • The artifact type. Allowed values are glossary_term, classification, data_class, reference_data, policy, rule

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term

  • The artifact id.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: 990e33f5-3108-4d45-a530-0307458362d4

  • The version id.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4

  • The comment id.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: 990e33f5-3108-4d45-a530-0307458362d4

Response

Status Code

  • Comment deleted successfully

  • Bad Request

  • Unauthorized

  • Draft artifact version not found for given version_id

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Update a comment on a draft artifact version

Update a comment on a draft artifact version

PATCH /v3/governance_artifact_types/{artifact_type}/{artifact_id}/versions/{version_id}/comments/{comment_id}

Request

Path Parameters

  • The artifact type. Allowed values are glossary_term, classification, data_class, reference_data, policy, rule

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term

  • The artifact id.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: 990e33f5-3108-4d45-a530-0307458362d4

  • The version id.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4

  • The comment id.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: 990e33f5-3108-4d45-a530-0307458362d4

The user comment.

Response

Comment By User

Status Code

  • Comment updated successfully

  • Bad Request

  • Unauthorized

  • Draft artifact version not found for given version_id

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Get development logs & Comments for a draft artifact version

Get development logs & Comments for a draft artifact version

GET /v3/governance_artifact_types/{artifact_type}/{artifact_id}/versions/{version_id}/logs

Request

Path Parameters

  • The artifact type. Allowed values are glossary_term, classification, data_class, reference_data, policy, rule

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Example: glossary_term

  • The artifact id.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

  • The version id.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

Query Parameters

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

Response

Paginated Asset Comment List

Status Code

  • Development logs & Comments retrieved successfully

  • Bad Request

  • Unauthorized

  • Forbidden

  • Draft artifact version not found for given version_id

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Creates a policy in the glossary

Creates a policy in the glossary

POST /v3/policies

Request

Query Parameters

  • If workflow template configuration permits, the artifact will be created in the published state by skipping the workflow. For details refer to documentation.

Represents a policy to be created, used for policy POST request.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • The policy has been created successfully.

  • Bad Request

  • Unauthorized

  • UniqueConstraintViolation - policy with given name already exists.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Retrieves versions of a policy for the given artifact_id and status

Retrieval of the versions of ACTIVE state is supported.

GET /v3/policies/{artifact_id}/versions

Request

Path Parameters

  • Artifact ID or global ID of the artifact

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Query Parameters

  • Filter by policy status.

    Available statuses:
    DRAFTartifacts which are being created or modified and not in use
    PUBLISHEDartifacts which are in published state (does not takes effective dates into account)
    ACTIVEartifacts which are published, and which effective date period includes current datetime

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Default: PUBLISHED

  • Comma-separated list of relationship types.

    Available types:
    parent_policy
    sub_policies
    parent_category
    categories
    terms
    classifications
    rules
    data_location_rules
    data_protection_rules
    custom
    all

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • If this parameter is set to true, then all artifact custom attributes are returned. If parameter is not set its default value is 'true'. This is deprecated and default will be change to 'false' in first major 2022 release.

    Default: true

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

Response

List of paginated artifacts

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Deletes a draft or published version of an artifact

If the artifact state is DRAFT, then the draft version is deleted.

If the artifact state is PUBLISHED, a draft version with marked_for_deletion is created .

If the artifact state is PUBLISHED and workflow is skipped, then the published version is deleted.

If a draft artifact already exists for deletion for a published artifact, then the draft artifact is simply skipped.

Administrator role is required.

DELETE /v3/policies/{artifact_id}/versions/{version_id}

Request

Path Parameters

  • The artifact ID of the policy.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the policy to delete or to create mark-for-delete draft copy.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If workflow template configuration permits, the published artifact will be deleted by skipping the workflow. For details refer to documentation.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • The artifact has been deleted successfully.

  • A draft version has been successfully created for deleting the published artifact.

  • Bad Request

  • Unauthorized

  • Policy with sub-policies cannot be deleted. Try again after re-parenting sub-policies.

  • Policy with given artifact and version ids does not exist in the glossary.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Retrieves versions of a policy for the given artifact_id and status

Retrieval of the versions of ACTIVE state is supported.

GET /v3/policies/{artifact_id}/versions/{version_id}

Request

Path Parameters

  • The artifact ID of the policy to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version ID of the policy to fetch.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • Comma-separated list of relationship types.

    Available types:
    parent_policy
    sub_policies
    parent_category
    categories
    terms
    classifications
    rules
    data_location_rules
    data_protection_rules
    custom
    all

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • If this parameter is set to true, then all artifact custom attributes are returned. If parameter is not set its default value is 'true'. This is deprecated and default will be change to 'false' in first major 2022 release.

    Default: true

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

Response

Policy returned by REST GET method that includes the relationships as paginated list.

Status Code

  • The policy has been retrieved successfully.

  • Unauthorized

  • The policy with given {guid} does not exist in the glossary.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Updates policy with given artifact id and version id

Updates policy with given artifact id and version id. If the policy is in published state then first creates a draft and applies the changes to the newly created draft.

PATCH /v3/policies/{artifact_id}/versions/{version_id}

Request

Path Parameters

  • The artifact id of the policy to be updated.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the policy to be updated.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If configuration permits, the published artifact will be updated by skipping the workflow. For details refer to documentation.

The policy to be updated.
Fields omitted will be unchanged, and fields set to null explicitly will be nulled out.
For multi-valued attributes & relationships, the complete list will be replaced by the given list of values.
Additional Example:

{"description" : "description updated"}

Response

Policy returned by REST GET method that includes the relationships as paginated list.

Status Code

  • The policy has been updated successfully.

  • Bad Request

  • Unauthorized

  • Forbidden

  • The policy with given {guid} does not exist in the glossary.

  • The policy was modified by another user.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Updates DPR rule relationships of a published policy using its artifact id and version id

Updates DPR rule relationships of a published policy using its artifact id and version id
Deprecated, functionality will be replaced by new one introduced in the feature releases.

PATCH /v3/policies/{artifact_id}/versions/{version_id}/data_protection_rules

Request

Path Parameters

  • The artifact id of the policy to be updated.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

  • The version id of the policy to be updated.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

The parent category of the artifact.

Response

Policy returned by REST GET method that includes the relationships as paginated list.

Status Code

  • The policy has been updated successfully.

  • Bad Request

  • Unauthorized

  • Forbidden

  • The policy with given {guid} does not exist in the glossary.

  • The policy was modified by another user.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

List the relationships for the specified policy

If the result set is larger than the limit parameter, it returns the first limit number of relationships.
To retrieve the next set of relationships, call the method again by using the URI in the property next returned by this method.

GET /v3/policies/{artifact_id}/versions/{version_id}/relationships

Request

Path Parameters

  • The guid of the Policy

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The versionID of the Policy

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • Comma-separated list of relationship types.

    Available types:
    parent_policy
    sub_policies
    parent_category
    categories
    terms
    classifications
    rules
    data_location_rules
    data_protection_rules
    custom
    all

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • Custom relationship definition Id.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • Is custom relationship reversed?

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

  • Retrieves target parent category name of the relationship entity.

Response

Response that includes relationships to a managed object, like business term, data class, classification

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Create relationships for an artifact in the glossary

If it is a published version, it creates a draft from the published version and adds the relationship to the draft version. And, it returns the details of the draft version.

POST /v3/policies/{artifact_id}/versions/{version_id}/relationships

Request

Path Parameters

  • The artifact ID of the term to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version ID of the term to fetch.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If configuration permits, the published artifact will be updated by skipping the workflow. For details refer to documentation.

Relationships to be created.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Unique constraint violated because of optimistic locking or some other constraint.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Deletes a relationship from a draft policy

Deletes a relationship from a draft policy

DELETE /v3/policies/{artifact_id}/versions/{version_id}/relationships/{relationship_id}

Request

Path Parameters

  • The artifact ID of the policy to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version ID of the policy to fetch.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

  • The artifact ID of the relationship to be deleted.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Query Parameters

  • If workflow template configuration permits, the published artifact will be deleted by skipping the workflow. For details refer to documentation.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Create a reference data set

Create a reference data set
Note: For Reference Data values, precision will be lost if long value has more than 15-16 digits as JSON parser will map to double type regardless of whether it is used for integer, long or floating-point numbers. To Preserve all digits pass the value as a string.

POST /v3/reference_data

Request

Query Parameters

  • If workflow template configuration permits, the artifact will be created in the published state by skipping the workflow. For details refer to documentation.

Represents a Reference Data Set to be created for RDS V3 API version.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • The reference data set has been created successfully.

  • Bad Request

  • Unauthorized

  • Reference data set with given name already exists.

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "href": "v3/reference_data/0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6/versions/4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "artifact_id": "0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "version_id": "4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "workflow_id": "56b82aa1-0f3c-4e2c-84bf-bee619c84c7f",
          "global_id": "867907bd-4c80-458d-9e75-c5683e013533_0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "entity_type": "reference_data"
        }
      ]
    }

Delete a list of Custom Column definitions with specified column_ids

Delete a list of Custom Column definitions with specified column_ids

DELETE /v3/reference_data/custom_columns

Request

Response

RDS custom columns delete response list

Status Code

  • List of Custom Column definitions has been deleted successfully.

  • Bad Request

  • Unauthorized

  • Forbidden

  • The Custom Column definition with given {column_id} does not exist.

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "id": "a98edac9-4953-431e-9f8e-d9f1507454d8",
          "name": "Custom_Column_Name",
          "description": "This is a Custom Column",
          "type": "TEXT"
        }
      ]
    }

Retrieve Custom Column definitions

Fetches Custom Column definitions.
Use filter_by_name to provide search criteria and sort_order=asc/desc to order result.By default order will be asc.

GET /v3/reference_data/custom_columns

Request

Query Parameters

  • Filter the Custom Column definitions by name.

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • Sort direction for Custom Column names.

    Allowable values: [ASC,DESC]

    Default: ASC

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

Response

Paginated Reference Data Set custom columns response list

Status Code

  • List of Custom Column definitions has been retrieved successfully.

  • Unauthorized

  • The Custom Column definition with given {column_id} does not exist.

  • Internal Server Error

Example responses
  • {
      "offset": 90,
      "last": {
        "href": "string",
        "offset": 270
      },
      "prev": {
        "href": "string",
        "offset": 60
      },
      "set_uri": true,
      "limit": 30,
      "count": 300,
      "first": {
        "href": "string",
        "offset": 0
      },
      "next": {
        "href": "string",
        "offset": 120
      },
      "resources": [
        {
          "metadata": {
            "id": "8b047b17-8e31-4382-be19-e873d46d32a8",
            "modified_by": "IBMid-1234567ABC",
            "modified_at": "2017-02-15T02:30:32Z",
            "created_at": "2017-02-15T02:30:32Z",
            "created_by": "IBMid-1234567ABC",
            "revision": "0"
          },
          "entity": {
            "id": "a98edac9-4953-431e-9f8e-d9f1507454d8",
            "revision": "0",
            "name": "Custom_Column_Name",
            "description": "This is a Custom Column",
            "type": "TEXT",
            "max_character_count": 2000,
            "mandatory": true,
            "composite_key": true,
            "owner_rds_id": "9ec35f22-db7f-56c9-8a05-25983e485adc",
            "validator_rds_id": "d58b8247-8f94-4c1f-8ea1-48f1cb55122a",
            "hidden": false
          }
        }
      ]
    }

Create Custom Column definitions

Create Custom Column definitions

  • Allowed Custom Column definitions types: NUMBER, TEXT, DATE.
  • If a column is a composite key, it must be mandatory.
  • For NUMBER and TEXT types the default values for max_characters_count:
    • for a composite key column: 200,
    • for a normal column: 2000.
  • validator_rds_id must be an artifact id of a published RDS.
POST /v3/reference_data/custom_columns

Request

RDS custom columns create request

Response

Custom column create response

Status Code

  • The Custom Column(s) have been created successfully.

  • Bad Request

  • Unauthorized

  • UniqueConstraintViolation - Custom Column definition with given name already exists.

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "id": "a98edac9-4953-431e-9f8e-d9f1507454d8",
          "revision": "0",
          "name": "Custom_Column_Name",
          "description": "This is a Custom Column",
          "type": "TEXT",
          "max_character_count": 2000,
          "mandatory": true,
          "composite_key": true,
          "owner_rds_id": "9ec35f22-db7f-56c9-8a05-25983e485adc",
          "validator_rds_id": "d58b8247-8f94-4c1f-8ea1-48f1cb55122a",
          "hidden": false
        }
      ]
    }

Delete a Custom Column definition by column_id

Delete a Custom Column definition by column_id

DELETE /v3/reference_data/custom_columns/{column_id}

Request

Path Parameters

  • The column id associated with Custom Column definition.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: 83a7a25a-4a51-4053-a6e7-4e374d26fe1a

Response

resources of custom columns.

Status Code

  • The Custom Column definition has been deleted successfully with specified column_id.

  • Bad Request

  • Unauthorized

  • Internal Server Error

Example responses
  • {
      "id": "a98edac9-4953-431e-9f8e-d9f1507454d8",
      "name": "Custom_Column_Name",
      "description": "This is a Custom Column",
      "type": "TEXT"
    }

Retrieve a Custom Column definition with given column_id

Retrieve a Custom Column definition with given column_id

GET /v3/reference_data/custom_columns/{column_id}

Request

Path Parameters

  • The guid of the Custom Column definition.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

Response

RDS Custom Columns Get Response

Status Code

  • Custom Column definition with given column_id has been retrieved successfully.

  • Unauthorized

  • The Custom Column definition with given {column_id} does not exist.

  • Internal Server Error

Example responses
  • {
      "metadata": {
        "id": "8b047b17-8e31-4382-be19-e873d46d32a8",
        "modified_by": "IBMid-1234567ABC",
        "modified_at": "2017-02-15T02:30:32Z",
        "created_at": "2017-02-15T02:30:32Z",
        "created_by": "IBMid-1234567ABC",
        "revision": "0"
      },
      "entity": {
        "id": "a98edac9-4953-431e-9f8e-d9f1507454d8",
        "revision": "0",
        "name": "Custom_Column_Name",
        "description": "This is a Custom Column",
        "type": "TEXT",
        "max_character_count": 2000,
        "mandatory": true,
        "composite_key": true,
        "owner_rds_id": "9ec35f22-db7f-56c9-8a05-25983e485adc",
        "validator_rds_id": "d58b8247-8f94-4c1f-8ea1-48f1cb55122a",
        "hidden": false
      }
    }

Update Custom Column properties with given column_id

Update Custom Column properties with given column_id

PATCH /v3/reference_data/custom_columns/{column_id}

Request

Path Parameters

  • The column id associated with Custom Column definition.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

Custom Column name/description to be updated.

Response

List of composite key members

Status Code

  • The Custom Column definition has been updated successfully.

  • Bad Request

  • Unauthorized

  • Forbidden

  • The Custom Column definition with given {column_id} does not exist.

  • The Custom Column was modified by another user.

  • Internal Server Error

Example responses
  • {
      "id": "a98edac9-4953-431e-9f8e-d9f1507454d8",
      "revision": "0",
      "name": "Custom_Column_Name",
      "description": "This is a Custom Column",
      "type": "TEXT",
      "max_character_count": 2000,
      "mandatory": true,
      "composite_key": true,
      "owner_rds_id": "9ec35f22-db7f-56c9-8a05-25983e485adc",
      "validator_rds_id": "d58b8247-8f94-4c1f-8ea1-48f1cb55122a",
      "hidden": false
    }

Retrieve a reference data set with given artifact_id and status

This method can be used for retrieving details of an ACTIVE, PUBLISHED or DRAFT reference data set.

GET /v3/reference_data/{artifact_id}/versions

Request

Path Parameters

  • Artifact ID or global ID of the artifact

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Query Parameters

  • Filter by reference data set status.

    Available statuses:
    DRAFTartifacts which are being created or modified and not in use
    PUBLISHEDartifacts which are in published state (does not takes effective dates into account)
    ACTIVEartifacts which are published, and which effective date period includes current datetime

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Default: PUBLISHED

  • Comma-separated list of relationship types.

    Available types:
    parent_category
    categories
    terms
    classifications
    data_classes
    rules
    child
    parent
    custom
    all

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • If this parameter is set to true, then all artifact custom attributes are returned. If parameter is not set its default value is 'true'. This is deprecated and default will be change to 'false' in first major 2022 release.

    Default: true

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

Response

List of paginated artifacts

Status Code

  • The reference data set has been retrieved successfully.

  • Bad Request

  • Unauthorized

  • The reference data set with given {guid} does not exist.

  • Internal Server Error

Example responses
  • {
      "offset": 90,
      "last": {
        "href": "string",
        "offset": 270
      },
      "prev": {
        "href": "string",
        "offset": 60
      },
      "set_uri": true,
      "limit": 30,
      "count": 300,
      "first": {
        "href": "string",
        "offset": 0
      },
      "next": {
        "href": "string",
        "offset": 120
      },
      "resources": [
        {
          "metadata": {
            "artifact_type": "glossary_term",
            "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
            "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
            "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
            "source_repository_name": "repository name",
            "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
            "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
            "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
            "effective_start_date": "2021-07-26T12:37:03.919Z",
            "effective_end_date": "2021-07-29T10:37:03.919Z",
            "created_by": "IBMid-1234567ABC",
            "created_at": "2017-02-15T02:30:32Z",
            "modified_by": "IBMid-1234567ABC",
            "modified_at": "2017-02-15T02:30:32Z",
            "revision": "0",
            "name": "artifact name",
            "state": "PUBLISHED",
            "tags": [
              "tag1",
              "tag2"
            ],
            "steward_ids": [
              "IBMid-1234567ABC"
            ],
            "workflow_state": "DRAFT",
            "read_only": false,
            "remove_start_date": false,
            "remove_end_date": false
          },
          "entity": {
            "type, rule_type, etc": "TEXT, Governance, etc",
            "long_description": "string",
            "is_removed_long_description": false,
            "state": "PUBLISHED",
            "default_locale_id": "en-US",
            "reference_copy": false,
            "custom_attributes": []
          }
        }
      ]
    }

Delete a reference data set with given artifact_id and version_id

Delete the reference data set with a given artifact_id and version_id. If the artifact is published then a workflow will be started with a draft created with label marked for deletion which on approval will result in a actual delete. If the artifact is a draft copy then the draft copy will be deleted from the system.

DELETE /v3/reference_data/{artifact_id}/versions/{version_id}

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify CURRENT to fetch from published active version.
    CURRENT is to be deprecated in next major release, please use /v3/governance_artifact_types/reference_data/{artifact_id} as a replacement.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If workflow template configuration permits, the published artifact will be deleted by skipping the workflow. For details refer to documentation.

  • specify parent/root/code

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • A draft version has been successfully created for deleting the published artifact.

  • The reference data set has been deleted successfully.

  • Bad Request

  • Unauthorized

  • The reference data set with given {guid} does not exist.

  • The reference data set is currently used in catalog assets, catalog asset columns, data governance rules or data governance policies.

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "href": "v3/reference_data/0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6/versions/4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "artifact_id": "0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "version_id": "4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "workflow_id": "56b82aa1-0f3c-4e2c-84bf-bee619c84c7f",
          "global_id": "867907bd-4c80-458d-9e75-c5683e013533_0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "entity_type": "reference_data"
        }
      ]
    }

Retrieve a reference data set with given artifact_id and version_id

This method will retrieve details of the specified reference data set.

GET /v3/reference_data/{artifact_id}/versions/{version_id}

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify CURRENT to fetch from published active version.
    CURRENT is to be deprecated in next major release, please use /v3/governance_artifact_types/reference_data/{artifact_id} as a replacement.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • Fetch reference data value by code or text value fragment

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • sort direction for code

    Allowable values: [ASC,DESC]

    Default: ASC

  • fetch children of specific code

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • fetch reference data value as flat list of values or in hierarchical manner one level at a time. Level is determined by the parameter parent_code which indicate root value of the level.

    Allowable values: [FLAT,HIERARCHICAL]

    Default: FLAT

  • Comma-separated list of relationship types for reference data value.

    Available types:
    terms
    parent_hierarchy
    child
    parent
    single_value_mappings
    multi_value_mappings
    value_mappings
    all

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • Fetch reference data value with given exact code

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • Comma-separated list of relationship types.

    Available types:
    parent_category
    categories
    terms
    classifications
    data_classes
    rules
    child
    parent
    custom
    all

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • Fetch Custom Column definition for reference dataset.

    Default: true

  • Fetch custom column values for reference data set values.

  • If this parameter is set to true, then all artifact custom attributes are returned. If parameter is not set its default value is 'true'. This is deprecated and default will be change to 'false' in first major 2022 release.

    Default: true

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

  • The maximum number of relationships to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • The index of the first matching relationship to include in the result.

  • The maximum number of reference data values to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • The index of the first matching value to include in the result.

Response

Response Reference Data Set

Status Code

  • The reference data set has been retrieved successfully.

  • Unauthorized

  • The reference data set with given {guid} does not exist.

  • Internal Server Error

Example responses
  • {
      "metadata": {
        "artifact_type": "glossary_term",
        "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
        "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
        "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
        "source_repository_name": "repository name",
        "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
        "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
        "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
        "effective_start_date": "2021-07-26T12:37:03.919Z",
        "effective_end_date": "2021-07-29T10:37:03.919Z",
        "created_by": "IBMid-1234567ABC",
        "created_at": "2017-02-15T02:30:32Z",
        "modified_by": "IBMid-1234567ABC",
        "modified_at": "2017-02-15T02:30:32Z",
        "revision": "0",
        "name": "artifact name",
        "state": "PUBLISHED",
        "tags": [
          "tag1",
          "tag2"
        ],
        "steward_ids": [
          "IBMid-1234567ABC"
        ],
        "workflow_state": "DRAFT",
        "read_only": false,
        "remove_start_date": false,
        "remove_end_date": false
      },
      "entity": {
        "terms": {
          "offset": 90,
          "last": {
            "href": "string",
            "offset": 270
          },
          "prev": {
            "href": "string",
            "offset": 60
          },
          "set_uri": true,
          "limit": 30,
          "count": 300,
          "first": {
            "href": "string",
            "offset": 0
          },
          "next": {
            "href": "string",
            "offset": 120
          },
          "resources": [
            {
              "metadata": {
                "artifact_type": "glossary_term",
                "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
                "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
                "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
                "source_repository_name": "repository name",
                "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
                "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
                "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
                "effective_start_date": "2021-07-26T12:37:03.919Z",
                "effective_end_date": "2021-07-29T10:37:03.919Z",
                "created_by": "IBMid-1234567ABC",
                "created_at": "2017-02-15T02:30:32Z",
                "modified_by": "IBMid-1234567ABC",
                "modified_at": "2017-02-15T02:30:32Z",
                "revision": "0",
                "name": "artifact name",
                "state": "PUBLISHED",
                "tags": [
                  "tag1",
                  "tag2"
                ],
                "steward_ids": [
                  "IBMid-1234567ABC"
                ],
                "workflow_state": "DRAFT",
                "read_only": false,
                "remove_start_date": false,
                "remove_end_date": false
              },
              "entity": {
                "target_id": "6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
                "target_global_id": "867907bd-4c80-458d-9e75-c5683e013533_6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
                "target_parent_category_id": "e39ada11-8338-3704-90e3-681a71e7c839",
                "target_parent_category_name": "parent_category_name_example",
                "target_name": "name_example",
                "target_effective_start_date": "2022-02-14T13:16:49.355Z",
                "target_effective_end_date": "2022-02-15T14:16:49.355Z",
                "source_id": "0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
                "source_global_id": "867907bd-4c80-458d-9e75-c5683e013533_0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
                "source_type": "reference_data,reference_data_value, etc",
                "target_type": "glossary_term, reference_data, category, etc",
                "description": "string",
                "relationship_type": "related, value_to_term, etc",
                "reference_copy": false
              }
            }
          ]
        },
        "classifications": {
          "offset": 90,
          "last": {
            "href": "string",
            "offset": 270
          },
          "prev": {
            "href": "string",
            "offset": 60
          },
          "set_uri": true,
          "limit": 30,
          "count": 300,
          "first": {
            "href": "string",
            "offset": 0
          },
          "next": {
            "href": "string",
            "offset": 120
          },
          "resources": [
            {
              "metadata": {
                "artifact_type": "glossary_term",
                "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
                "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
                "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
                "source_repository_name": "repository name",
                "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
                "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
                "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
                "effective_start_date": "2021-07-26T12:37:03.919Z",
                "effective_end_date": "2021-07-29T10:37:03.919Z",
                "created_by": "IBMid-1234567ABC",
                "created_at": "2017-02-15T02:30:32Z",
                "modified_by": "IBMid-1234567ABC",
                "modified_at": "2017-02-15T02:30:32Z",
                "revision": "0",
                "name": "artifact name",
                "state": "PUBLISHED",
                "tags": [
                  "tag1",
                  "tag2"
                ],
                "steward_ids": [
                  "IBMid-1234567ABC"
                ],
                "workflow_state": "DRAFT",
                "read_only": false,
                "remove_start_date": false,
                "remove_end_date": false
              },
              "entity": {
                "target_id": "6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
                "target_global_id": "867907bd-4c80-458d-9e75-c5683e013533_6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
                "target_parent_category_id": "e39ada11-8338-3704-90e3-681a71e7c839",
                "target_parent_category_name": "parent_category_name_example",
                "target_name": "name_example",
                "target_effective_start_date": "2022-02-14T13:16:49.355Z",
                "target_effective_end_date": "2022-02-15T14:16:49.355Z",
                "source_id": "0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
                "source_global_id": "867907bd-4c80-458d-9e75-c5683e013533_0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
                "source_type": "reference_data,reference_data_value, etc",
                "target_type": "glossary_term, reference_data, category, etc",
                "description": "string",
                "relationship_type": "related, value_to_term, etc",
                "reference_copy": false
              }
            }
          ]
        },
        "parent_category": {
          "offset": 90,
          "last": {
            "href": "string",
            "offset": 270
          },
          "prev": {
            "href": "string",
            "offset": 60
          },
          "set_uri": true,
          "limit": 30,
          "count": 300,
          "first": {
            "href": "string",
            "offset": 0
          },
          "next": {
            "href": "string",
            "offset": 120
          },
          "resources": [
            {
              "metadata": {
                "artifact_type": "glossary_term",
                "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
                "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
                "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
                "source_repository_name": "repository name",
                "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
                "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
                "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
                "effective_start_date": "2021-07-26T12:37:03.919Z",
                "effective_end_date": "2021-07-29T10:37:03.919Z",
                "created_by": "IBMid-1234567ABC",
                "created_at": "2017-02-15T02:30:32Z",
                "modified_by": "IBMid-1234567ABC",
                "modified_at": "2017-02-15T02:30:32Z",
                "revision": "0",
                "name": "artifact name",
                "state": "PUBLISHED",
                "tags": [
                  "tag1",
                  "tag2"
                ],
                "steward_ids": [
                  "IBMid-1234567ABC"
                ],
                "workflow_state": "DRAFT",
                "read_only": false,
                "remove_start_date": false,
                "remove_end_date": false
              },
              "entity": {
                "parent_id": "303ed1d2-0885-473e-9050-40f9223549d5",
                "parent_global_id": "TEMPLATE_303ed1d2-0885-473e-9050-40f9223549d5",
                "parent_name": "name_example",
                "parent_href": "/v3/categories/303ed1d2-0885-473e-9050-40f9223549d5",
                "parent_enabled": true,
                "child_id": "0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
                "child_global_id": "TEMPLATE_0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
                "child_category_id": "303ed1d2-0885-473e-9050-40f9223549d5",
                "child_name": "rds_name1",
                "child_href": "/v3/reference_data/0d6412d5-fce8-4bb7-90c9-891bc3de5c4b/versions?status=ACTIVE",
                "relationship_type": "parent_category",
                "source_type": "reference_data",
                "target_type": "category",
                "description": "parent example",
                "reference_copy": false
              }
            }
          ]
        },
        "categories": {
          "offset": 90,
          "last": {
            "href": "string",
            "offset": 270
          },
          "prev": {
            "href": "string",
            "offset": 60
          },
          "set_uri": true,
          "limit": 30,
          "count": 300,
          "first": {
            "href": "string",
            "offset": 0
          },
          "next": {
            "href": "string",
            "offset": 120
          },
          "resources": [
            {
              "metadata": {
                "artifact_type": "glossary_term",
                "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
                "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
                "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
                "source_repository_name": "repository name",
                "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
                "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
                "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
                "effective_start_date": "2021-07-26T12:37:03.919Z",
                "effective_end_date": "2021-07-29T10:37:03.919Z",
                "created_by": "IBMid-1234567ABC",
                "created_at": "2017-02-15T02:30:32Z",
                "modified_by": "IBMid-1234567ABC",
                "modified_at": "2017-02-15T02:30:32Z",
                "revision": "0",
                "name": "artifact name",
                "state": "PUBLISHED",
                "tags": [
                  "tag1",
                  "tag2"
                ],
                "steward_ids": [
                  "IBMid-1234567ABC"
                ],
                "workflow_state": "DRAFT",
                "read_only": false,
                "remove_start_date": false,
                "remove_end_date": false
              },
              "entity": {
                "target_id": "6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
                "target_global_id": "867907bd-4c80-458d-9e75-c5683e013533_6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
                "target_parent_category_id": "e39ada11-8338-3704-90e3-681a71e7c839",
                "target_parent_category_name": "parent_category_name_example",
                "target_name": "name_example",
                "target_effective_start_date": "2022-02-14T13:16:49.355Z",
                "target_effective_end_date": "2022-02-15T14:16:49.355Z",
                "source_id": "0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
                "source_global_id": "867907bd-4c80-458d-9e75-c5683e013533_0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
                "source_type": "reference_data,reference_data_value, etc",
                "target_type": "glossary_term, reference_data, category, etc",
                "description": "string",
                "relationship_type": "related, value_to_term, etc",
                "reference_copy": false
              }
            }
          ]
        },
        "parent": {
          "offset": 90,
          "last": {
            "href": "string",
            "offset": 270
          },
          "prev": {
            "href": "string",
            "offset": 60
          },
          "set_uri": true,
          "limit": 30,
          "count": 300,
          "first": {
            "href": "string",
            "offset": 0
          },
          "next": {
            "href": "string",
            "offset": 120
          },
          "resources": [
            {
              "metadata": {
                "artifact_type": "glossary_term",
                "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
                "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
                "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
                "source_repository_name": "repository name",
                "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
                "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
                "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
                "effective_start_date": "2021-07-26T12:37:03.919Z",
                "effective_end_date": "2021-07-29T10:37:03.919Z",
                "created_by": "IBMid-1234567ABC",
                "created_at": "2017-02-15T02:30:32Z",
                "modified_by": "IBMid-1234567ABC",
                "modified_at": "2017-02-15T02:30:32Z",
                "revision": "0",
                "name": "artifact name",
                "state": "PUBLISHED",
                "tags": [
                  "tag1",
                  "tag2"
                ],
                "steward_ids": [
                  "IBMid-1234567ABC"
                ],
                "workflow_state": "DRAFT",
                "read_only": false,
                "remove_start_date": false,
                "remove_end_date": false
              },
              "entity": {
                "target_id": "6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
                "target_global_id": "867907bd-4c80-458d-9e75-c5683e013533_6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
                "target_parent_category_id": "e39ada11-8338-3704-90e3-681a71e7c839",
                "target_parent_category_name": "parent_category_name_example",
                "target_name": "name_example",
                "target_effective_start_date": "2022-02-14T13:16:49.355Z",
                "target_effective_end_date": "2022-02-15T14:16:49.355Z",
                "source_id": "0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
                "source_global_id": "867907bd-4c80-458d-9e75-c5683e013533_0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
                "source_type": "reference_data,reference_data_value, etc",
                "target_type": "glossary_term, reference_data, category, etc",
                "description": "string",
                "relationship_type": "related, value_to_term, etc",
                "reference_copy": false
              }
            }
          ]
        },
        "child": {
          "offset": 90,
          "last": {
            "href": "string",
            "offset": 270
          },
          "prev": {
            "href": "string",
            "offset": 60
          },
          "set_uri": true,
          "limit": 30,
          "count": 300,
          "first": {
            "href": "string",
            "offset": 0
          },
          "next": {
            "href": "string",
            "offset": 120
          },
          "resources": [
            {
              "metadata": {
                "artifact_type": "glossary_term",
                "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
                "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
                "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
                "source_repository_name": "repository name",
                "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
                "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
                "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
                "effective_start_date": "2021-07-26T12:37:03.919Z",
                "effective_end_date": "2021-07-29T10:37:03.919Z",
                "created_by": "IBMid-1234567ABC",
                "created_at": "2017-02-15T02:30:32Z",
                "modified_by": "IBMid-1234567ABC",
                "modified_at": "2017-02-15T02:30:32Z",
                "revision": "0",
                "name": "artifact name",
                "state": "PUBLISHED",
                "tags": [
                  "tag1",
                  "tag2"
                ],
                "steward_ids": [
                  "IBMid-1234567ABC"
                ],
                "workflow_state": "DRAFT",
                "read_only": false,
                "remove_start_date": false,
                "remove_end_date": false
              },
              "entity": {
                "target_id": "6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
                "target_global_id": "867907bd-4c80-458d-9e75-c5683e013533_6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
                "target_parent_category_id": "e39ada11-8338-3704-90e3-681a71e7c839",
                "target_parent_category_name": "parent_category_name_example",
                "target_name": "name_example",
                "target_effective_start_date": "2022-02-14T13:16:49.355Z",
                "target_effective_end_date": "2022-02-15T14:16:49.355Z",
                "source_id": "0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
                "source_global_id": "867907bd-4c80-458d-9e75-c5683e013533_0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
                "source_type": "reference_data,reference_data_value, etc",
                "target_type": "glossary_term, reference_data, category, etc",
                "description": "string",
                "relationship_type": "related, value_to_term, etc",
                "reference_copy": false
              }
            }
          ]
        },
        "rds_values": {
          "offset": 90,
          "last": {
            "href": "string",
            "offset": 270
          },
          "prev": {
            "href": "string",
            "offset": 60
          },
          "set_uri": true,
          "limit": 30,
          "count": 300,
          "first": {
            "href": "string",
            "offset": 0
          },
          "next": {
            "href": "string",
            "offset": 120
          },
          "resources": [
            {
              "code": "CODE_EXAMPLE",
              "value": "string",
              "description": "This is an RDS Value example",
              "revision": "0"
            }
          ]
        },
        "custom_columns": [
          {
            "id": "a98edac9-4953-431e-9f8e-d9f1507454d8",
            "revision": "0",
            "name": "Custom_Column_Name",
            "description": "This is a Custom Column",
            "type": "TEXT",
            "max_character_count": 2000,
            "mandatory": true,
            "composite_key": true,
            "owner_rds_id": "9ec35f22-db7f-56c9-8a05-25983e485adc",
            "validator_rds_id": "d58b8247-8f94-4c1f-8ea1-48f1cb55122a",
            "hidden": false
          }
        ],
        "rds_values_total_counts": 1,
        "type, rule_type, etc": "TEXT, Governance, etc",
        "long_description": "string",
        "is_removed_long_description": false,
        "state": "PUBLISHED",
        "default_locale_id": "en-US",
        "reference_copy": false,
        "custom_attributes": []
      }
    }

Update a reference data set with given artifact id and version id

Update a reference data set with given artifact id and version id

PATCH /v3/reference_data/{artifact_id}/versions/{version_id}

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify CURRENT to fetch from published active version.
    CURRENT is to be deprecated in next major release, please use /v3/governance_artifact_types/reference_data/{artifact_id} as a replacement.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If configuration permits, the published artifact will be updated by skipping the workflow. For details refer to documentation.

The reference data set to be updated.
Fields omitted will be unchanged. For multi-valued attributes, like values and relationships, use the respective endpoints.

Response

Response Reference Data Set

Status Code

  • The reference data set has been updated successfully.

  • Bad Request

  • Unauthorized

  • Forbidden

  • The reference data set with given {guid} does not exist.

  • The reference data set was modified by another user.

  • Internal Server Error

Example responses
  • {
      "metadata": {
        "artifact_type": "glossary_term",
        "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
        "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
        "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
        "source_repository_name": "repository name",
        "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
        "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
        "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
        "effective_start_date": "2021-07-26T12:37:03.919Z",
        "effective_end_date": "2021-07-29T10:37:03.919Z",
        "created_by": "IBMid-1234567ABC",
        "created_at": "2017-02-15T02:30:32Z",
        "modified_by": "IBMid-1234567ABC",
        "modified_at": "2017-02-15T02:30:32Z",
        "revision": "0",
        "name": "artifact name",
        "state": "PUBLISHED",
        "tags": [
          "tag1",
          "tag2"
        ],
        "steward_ids": [
          "IBMid-1234567ABC"
        ],
        "workflow_state": "DRAFT",
        "read_only": false,
        "remove_start_date": false,
        "remove_end_date": false
      },
      "entity": {
        "rds_values": {
          "offset": 90,
          "last": {
            "href": "string",
            "offset": 270
          },
          "prev": {
            "href": "string",
            "offset": 60
          },
          "set_uri": true,
          "limit": 30,
          "count": 300,
          "first": {
            "href": "string",
            "offset": 0
          },
          "next": {
            "href": "string",
            "offset": 120
          },
          "resources": [
            {
              "code": "CODE_EXAMPLE",
              "value": "string",
              "description": "This is an RDS Value example",
              "revision": "0"
            }
          ]
        },
        "type, rule_type, etc": "TEXT, Governance, etc",
        "long_description": "string",
        "is_removed_long_description": false,
        "state": "PUBLISHED",
        "default_locale_id": "en-US",
        "reference_copy": false,
        "custom_attributes": []
      }
    }

Delete Custom Column definitions with specified column_ids associated with a reference data set

Delete Custom Column definitions with specified column_ids associated with a reference data set

DELETE /v3/reference_data/{artifact_id}/versions/{version_id}/custom_columns

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify ACTIVE (it represents a current active published version) or PUBLISHED (it represents a published version that is active now or will be active in the future).

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

The list of column_ids to be removed.

Response

Response Reference Data Set

Status Code

  • The Custom Column definition has been deleted successfully with specified column_id.

  • Bad Request

  • Unauthorized

  • Forbidden

  • The Custom Column definition with given {column_id} does not exist.

  • The Custom Column was modified by another user.

  • Internal Server Error

Example responses
  • {
      "metadata": {
        "artifact_type": "glossary_term",
        "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
        "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
        "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
        "source_repository_name": "repository name",
        "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
        "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
        "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
        "effective_start_date": "2021-07-26T12:37:03.919Z",
        "effective_end_date": "2021-07-29T10:37:03.919Z",
        "created_by": "IBMid-1234567ABC",
        "created_at": "2017-02-15T02:30:32Z",
        "modified_by": "IBMid-1234567ABC",
        "modified_at": "2017-02-15T02:30:32Z",
        "revision": "0",
        "name": "artifact name",
        "state": "PUBLISHED",
        "tags": [
          "tag1",
          "tag2"
        ],
        "steward_ids": [
          "IBMid-1234567ABC"
        ],
        "workflow_state": "DRAFT",
        "read_only": false,
        "remove_start_date": false,
        "remove_end_date": false
      },
      "entity": {
        "rds_values": {
          "offset": 90,
          "last": {
            "href": "string",
            "offset": 270
          },
          "prev": {
            "href": "string",
            "offset": 60
          },
          "set_uri": true,
          "limit": 30,
          "count": 300,
          "first": {
            "href": "string",
            "offset": 0
          },
          "next": {
            "href": "string",
            "offset": 120
          },
          "resources": [
            {
              "code": "CODE_EXAMPLE",
              "value": "string",
              "description": "This is an RDS Value example",
              "revision": "0"
            }
          ]
        },
        "custom_columns": [
          {
            "id": "a98edac9-4953-431e-9f8e-d9f1507454d8",
            "revision": "0",
            "name": "Custom_Column_Name",
            "description": "This is a Custom Column",
            "type": "TEXT",
            "max_character_count": 2000,
            "mandatory": true,
            "composite_key": true,
            "owner_rds_id": "9ec35f22-db7f-56c9-8a05-25983e485adc",
            "validator_rds_id": "d58b8247-8f94-4c1f-8ea1-48f1cb55122a",
            "hidden": false
          }
        ],
        "type, rule_type, etc": "TEXT, Governance, etc",
        "long_description": "string",
        "is_removed_long_description": false,
        "state": "PUBLISHED",
        "default_locale_id": "en-US",
        "reference_copy": false,
        "custom_attributes": []
      }
    }

Associate Custom Column definitions to a reference data set

Associate Custom Column definitions to a reference data set

PUT /v3/reference_data/{artifact_id}/versions/{version_id}/custom_columns

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify ACTIVE (it represents a current active published version) or PUBLISHED (it represents a published version that is active now or will be active in the future).

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Custom Column name/description to be updated.

Response

Response Reference Data Set

Status Code

  • The Custom Column definition has been updated successfully.

  • Bad Request

  • Unauthorized

  • Forbidden

  • The Custom Column definition with given {column_id} does not exist.

  • The Custom Column was modified by another user.

  • Internal Server Error

Example responses
  • {
      "metadata": {
        "artifact_type": "glossary_term",
        "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
        "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
        "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
        "source_repository_name": "repository name",
        "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
        "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
        "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
        "effective_start_date": "2021-07-26T12:37:03.919Z",
        "effective_end_date": "2021-07-29T10:37:03.919Z",
        "created_by": "IBMid-1234567ABC",
        "created_at": "2017-02-15T02:30:32Z",
        "modified_by": "IBMid-1234567ABC",
        "modified_at": "2017-02-15T02:30:32Z",
        "revision": "0",
        "name": "artifact name",
        "state": "PUBLISHED",
        "tags": [
          "tag1",
          "tag2"
        ],
        "steward_ids": [
          "IBMid-1234567ABC"
        ],
        "workflow_state": "DRAFT",
        "read_only": false,
        "remove_start_date": false,
        "remove_end_date": false
      },
      "entity": {
        "rds_values": {
          "offset": 90,
          "last": {
            "href": "string",
            "offset": 270
          },
          "prev": {
            "href": "string",
            "offset": 60
          },
          "set_uri": true,
          "limit": 30,
          "count": 300,
          "first": {
            "href": "string",
            "offset": 0
          },
          "next": {
            "href": "string",
            "offset": 120
          },
          "resources": [
            {
              "code": "CODE_EXAMPLE",
              "value": "string",
              "description": "This is an RDS Value example",
              "revision": "0"
            }
          ]
        },
        "custom_columns": [
          {
            "id": "a98edac9-4953-431e-9f8e-d9f1507454d8",
            "revision": "0",
            "name": "Custom_Column_Name",
            "description": "This is a Custom Column",
            "type": "TEXT",
            "max_character_count": 2000,
            "mandatory": true,
            "composite_key": true,
            "owner_rds_id": "9ec35f22-db7f-56c9-8a05-25983e485adc",
            "validator_rds_id": "d58b8247-8f94-4c1f-8ea1-48f1cb55122a",
            "hidden": false
          }
        ],
        "type, rule_type, etc": "TEXT, Governance, etc",
        "long_description": "string",
        "is_removed_long_description": false,
        "state": "PUBLISHED",
        "default_locale_id": "en-US",
        "reference_copy": false,
        "custom_attributes": []
      }
    }

List the relationships of the given type for the specified reference data set

If the result set is larger than the limit parameter, it returns the first limit number of relationships.
To retrieve the next set of relationships, call the method again by using the URI in the property next returned by this method.

GET /v3/reference_data/{artifact_id}/versions/{version_id}/relationships

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify CURRENT to fetch from published active version.
    CURRENT is to be deprecated in next major release, please use /v3/governance_artifact_types/reference_data/{artifact_id} as a replacement.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • Comma-separated list of relationship types.

    Available types:
    parent_category
    categories
    terms
    classifications
    data_classes
    rules
    child
    parent
    custom
    all

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • Custom relationship definition Id.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

  • Is custom relationship reversed?

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

  • Retrieves target parent category name of the relationship entity.

Response

Response that includes relationships to a managed object, like business term, data class, classification

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Internal Server Error

Example responses
  • {
      "terms": {
        "offset": 90,
        "last": {
          "href": "string",
          "offset": 270
        },
        "prev": {
          "href": "string",
          "offset": 60
        },
        "set_uri": true,
        "limit": 30,
        "count": 300,
        "first": {
          "href": "string",
          "offset": 0
        },
        "next": {
          "href": "string",
          "offset": 120
        },
        "resources": [
          {
            "metadata": {
              "artifact_type": "glossary_term",
              "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
              "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
              "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
              "source_repository_name": "repository name",
              "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
              "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
              "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
              "effective_start_date": "2021-07-26T12:37:03.919Z",
              "effective_end_date": "2021-07-29T10:37:03.919Z",
              "created_by": "IBMid-1234567ABC",
              "created_at": "2017-02-15T02:30:32Z",
              "modified_by": "IBMid-1234567ABC",
              "modified_at": "2017-02-15T02:30:32Z",
              "revision": "0",
              "name": "artifact name",
              "state": "PUBLISHED",
              "tags": [
                "tag1",
                "tag2"
              ],
              "steward_ids": [
                "IBMid-1234567ABC"
              ],
              "workflow_state": "DRAFT",
              "read_only": false,
              "remove_start_date": false,
              "remove_end_date": false
            },
            "entity": {
              "target_id": "6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
              "target_global_id": "867907bd-4c80-458d-9e75-c5683e013533_6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
              "target_parent_category_id": "e39ada11-8338-3704-90e3-681a71e7c839",
              "target_parent_category_name": "parent_category_name_example",
              "target_name": "name_example",
              "target_effective_start_date": "2022-02-14T13:16:49.355Z",
              "target_effective_end_date": "2022-02-15T14:16:49.355Z",
              "source_id": "0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
              "source_global_id": "867907bd-4c80-458d-9e75-c5683e013533_0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
              "source_type": "reference_data,reference_data_value, etc",
              "target_type": "glossary_term, reference_data, category, etc",
              "description": "string",
              "relationship_type": "related, value_to_term, etc",
              "reference_copy": false
            }
          }
        ]
      },
      "classifications": {
        "offset": 90,
        "last": {
          "href": "string",
          "offset": 270
        },
        "prev": {
          "href": "string",
          "offset": 60
        },
        "set_uri": true,
        "limit": 30,
        "count": 300,
        "first": {
          "href": "string",
          "offset": 0
        },
        "next": {
          "href": "string",
          "offset": 120
        },
        "resources": [
          {
            "metadata": {
              "artifact_type": "glossary_term",
              "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
              "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
              "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
              "source_repository_name": "repository name",
              "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
              "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
              "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
              "effective_start_date": "2021-07-26T12:37:03.919Z",
              "effective_end_date": "2021-07-29T10:37:03.919Z",
              "created_by": "IBMid-1234567ABC",
              "created_at": "2017-02-15T02:30:32Z",
              "modified_by": "IBMid-1234567ABC",
              "modified_at": "2017-02-15T02:30:32Z",
              "revision": "0",
              "name": "artifact name",
              "state": "PUBLISHED",
              "tags": [
                "tag1",
                "tag2"
              ],
              "steward_ids": [
                "IBMid-1234567ABC"
              ],
              "workflow_state": "DRAFT",
              "read_only": false,
              "remove_start_date": false,
              "remove_end_date": false
            },
            "entity": {
              "target_id": "6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
              "target_global_id": "867907bd-4c80-458d-9e75-c5683e013533_6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
              "target_parent_category_id": "e39ada11-8338-3704-90e3-681a71e7c839",
              "target_parent_category_name": "parent_category_name_example",
              "target_name": "name_example",
              "target_effective_start_date": "2022-02-14T13:16:49.355Z",
              "target_effective_end_date": "2022-02-15T14:16:49.355Z",
              "source_id": "0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
              "source_global_id": "867907bd-4c80-458d-9e75-c5683e013533_0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
              "source_type": "reference_data,reference_data_value, etc",
              "target_type": "glossary_term, reference_data, category, etc",
              "description": "string",
              "relationship_type": "related, value_to_term, etc",
              "reference_copy": false
            }
          }
        ]
      },
      "parent_category": {
        "offset": 90,
        "last": {
          "href": "string",
          "offset": 270
        },
        "prev": {
          "href": "string",
          "offset": 60
        },
        "set_uri": true,
        "limit": 30,
        "count": 300,
        "first": {
          "href": "string",
          "offset": 0
        },
        "next": {
          "href": "string",
          "offset": 120
        },
        "resources": [
          {
            "metadata": {
              "artifact_type": "glossary_term",
              "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
              "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
              "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
              "source_repository_name": "repository name",
              "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
              "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
              "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
              "effective_start_date": "2021-07-26T12:37:03.919Z",
              "effective_end_date": "2021-07-29T10:37:03.919Z",
              "created_by": "IBMid-1234567ABC",
              "created_at": "2017-02-15T02:30:32Z",
              "modified_by": "IBMid-1234567ABC",
              "modified_at": "2017-02-15T02:30:32Z",
              "revision": "0",
              "name": "artifact name",
              "state": "PUBLISHED",
              "tags": [
                "tag1",
                "tag2"
              ],
              "steward_ids": [
                "IBMid-1234567ABC"
              ],
              "workflow_state": "DRAFT",
              "read_only": false,
              "remove_start_date": false,
              "remove_end_date": false
            },
            "entity": {
              "parent_id": "303ed1d2-0885-473e-9050-40f9223549d5",
              "parent_global_id": "TEMPLATE_303ed1d2-0885-473e-9050-40f9223549d5",
              "parent_name": "name_example",
              "parent_href": "/v3/categories/303ed1d2-0885-473e-9050-40f9223549d5",
              "parent_enabled": true,
              "child_id": "0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
              "child_global_id": "TEMPLATE_0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
              "child_category_id": "303ed1d2-0885-473e-9050-40f9223549d5",
              "child_name": "rds_name1",
              "child_href": "/v3/reference_data/0d6412d5-fce8-4bb7-90c9-891bc3de5c4b/versions?status=ACTIVE",
              "relationship_type": "parent_category",
              "source_type": "reference_data",
              "target_type": "category",
              "description": "parent example",
              "reference_copy": false
            }
          }
        ]
      },
      "categories": {
        "offset": 90,
        "last": {
          "href": "string",
          "offset": 270
        },
        "prev": {
          "href": "string",
          "offset": 60
        },
        "set_uri": true,
        "limit": 30,
        "count": 300,
        "first": {
          "href": "string",
          "offset": 0
        },
        "next": {
          "href": "string",
          "offset": 120
        },
        "resources": [
          {
            "metadata": {
              "artifact_type": "glossary_term",
              "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
              "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
              "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
              "source_repository_name": "repository name",
              "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
              "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
              "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
              "effective_start_date": "2021-07-26T12:37:03.919Z",
              "effective_end_date": "2021-07-29T10:37:03.919Z",
              "created_by": "IBMid-1234567ABC",
              "created_at": "2017-02-15T02:30:32Z",
              "modified_by": "IBMid-1234567ABC",
              "modified_at": "2017-02-15T02:30:32Z",
              "revision": "0",
              "name": "artifact name",
              "state": "PUBLISHED",
              "tags": [
                "tag1",
                "tag2"
              ],
              "steward_ids": [
                "IBMid-1234567ABC"
              ],
              "workflow_state": "DRAFT",
              "read_only": false,
              "remove_start_date": false,
              "remove_end_date": false
            },
            "entity": {
              "target_id": "6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
              "target_global_id": "867907bd-4c80-458d-9e75-c5683e013533_6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
              "target_parent_category_id": "e39ada11-8338-3704-90e3-681a71e7c839",
              "target_parent_category_name": "parent_category_name_example",
              "target_name": "name_example",
              "target_effective_start_date": "2022-02-14T13:16:49.355Z",
              "target_effective_end_date": "2022-02-15T14:16:49.355Z",
              "source_id": "0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
              "source_global_id": "867907bd-4c80-458d-9e75-c5683e013533_0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
              "source_type": "reference_data,reference_data_value, etc",
              "target_type": "glossary_term, reference_data, category, etc",
              "description": "string",
              "relationship_type": "related, value_to_term, etc",
              "reference_copy": false
            }
          }
        ]
      },
      "parent": {
        "offset": 90,
        "last": {
          "href": "string",
          "offset": 270
        },
        "prev": {
          "href": "string",
          "offset": 60
        },
        "set_uri": true,
        "limit": 30,
        "count": 300,
        "first": {
          "href": "string",
          "offset": 0
        },
        "next": {
          "href": "string",
          "offset": 120
        },
        "resources": [
          {
            "metadata": {
              "artifact_type": "glossary_term",
              "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
              "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
              "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
              "source_repository_name": "repository name",
              "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
              "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
              "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
              "effective_start_date": "2021-07-26T12:37:03.919Z",
              "effective_end_date": "2021-07-29T10:37:03.919Z",
              "created_by": "IBMid-1234567ABC",
              "created_at": "2017-02-15T02:30:32Z",
              "modified_by": "IBMid-1234567ABC",
              "modified_at": "2017-02-15T02:30:32Z",
              "revision": "0",
              "name": "artifact name",
              "state": "PUBLISHED",
              "tags": [
                "tag1",
                "tag2"
              ],
              "steward_ids": [
                "IBMid-1234567ABC"
              ],
              "workflow_state": "DRAFT",
              "read_only": false,
              "remove_start_date": false,
              "remove_end_date": false
            },
            "entity": {
              "target_id": "6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
              "target_global_id": "867907bd-4c80-458d-9e75-c5683e013533_6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
              "target_parent_category_id": "e39ada11-8338-3704-90e3-681a71e7c839",
              "target_parent_category_name": "parent_category_name_example",
              "target_name": "name_example",
              "target_effective_start_date": "2022-02-14T13:16:49.355Z",
              "target_effective_end_date": "2022-02-15T14:16:49.355Z",
              "source_id": "0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
              "source_global_id": "867907bd-4c80-458d-9e75-c5683e013533_0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
              "source_type": "reference_data,reference_data_value, etc",
              "target_type": "glossary_term, reference_data, category, etc",
              "description": "string",
              "relationship_type": "related, value_to_term, etc",
              "reference_copy": false
            }
          }
        ]
      },
      "child": {
        "offset": 90,
        "last": {
          "href": "string",
          "offset": 270
        },
        "prev": {
          "href": "string",
          "offset": 60
        },
        "set_uri": true,
        "limit": 30,
        "count": 300,
        "first": {
          "href": "string",
          "offset": 0
        },
        "next": {
          "href": "string",
          "offset": 120
        },
        "resources": [
          {
            "metadata": {
              "artifact_type": "glossary_term",
              "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
              "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
              "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
              "source_repository_name": "repository name",
              "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
              "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
              "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
              "effective_start_date": "2021-07-26T12:37:03.919Z",
              "effective_end_date": "2021-07-29T10:37:03.919Z",
              "created_by": "IBMid-1234567ABC",
              "created_at": "2017-02-15T02:30:32Z",
              "modified_by": "IBMid-1234567ABC",
              "modified_at": "2017-02-15T02:30:32Z",
              "revision": "0",
              "name": "artifact name",
              "state": "PUBLISHED",
              "tags": [
                "tag1",
                "tag2"
              ],
              "steward_ids": [
                "IBMid-1234567ABC"
              ],
              "workflow_state": "DRAFT",
              "read_only": false,
              "remove_start_date": false,
              "remove_end_date": false
            },
            "entity": {
              "target_id": "6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
              "target_global_id": "867907bd-4c80-458d-9e75-c5683e013533_6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
              "target_parent_category_id": "e39ada11-8338-3704-90e3-681a71e7c839",
              "target_parent_category_name": "parent_category_name_example",
              "target_name": "name_example",
              "target_effective_start_date": "2022-02-14T13:16:49.355Z",
              "target_effective_end_date": "2022-02-15T14:16:49.355Z",
              "source_id": "0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
              "source_global_id": "867907bd-4c80-458d-9e75-c5683e013533_0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
              "source_type": "reference_data,reference_data_value, etc",
              "target_type": "glossary_term, reference_data, category, etc",
              "description": "string",
              "relationship_type": "related, value_to_term, etc",
              "reference_copy": false
            }
          }
        ]
      }
    }

Associate Reference data set identified by artifact_id and version_id with other governance artifacts

Associate Reference data set identified by artifact_id and version_id with other governance artifacts

POST /v3/reference_data/{artifact_id}/versions/{version_id}/relationships

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify CURRENT to fetch from published active version.
    CURRENT is to be deprecated in next major release, please use /v3/governance_artifact_types/reference_data/{artifact_id} as a replacement.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If configuration permits, the published artifact will be updated by skipping the workflow. For details refer to documentation.

list of relationships that need to created for reference data set

Response

Create relationship response

Status Code

  • Relationships created for reference data set

  • Bad Request

  • Unauthorized

  • Relationships conflicting for reference data set

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "terms": [
            {
              "relationship_id": "fdbf64ed-8d72-43b8-8752-8b765db51e01",
              "target_id": "4ce5b4d5-611e-4607-8e18-e2a7d9abbfe7"
            }
          ],
          "classifications": [],
          "categories": [
            {
              "relationship_id": "eca11f9e-ff14-4692-ad93-35eb364f9f23",
              "target_id": "166a5f6b-3f42-4706-b868-92f622d5094a"
            }
          ],
          "child": [
            {
              "relationship_id": "382c8bfa-5c2f-4daf-ac6e-b625119b1c6f",
              "target_id": "eec1c2a4-8bc1-40a6-a557-49af6ab2675d"
            }
          ],
          "parent": [],
          "parent_category": {
            "relationship_id": "18d9732c-f1b9-4325-bbf6-7d318e093263",
            "target_id": "4cdd7c5f-bc32-4d94-bb75-0344a6f93052"
          },
          "href": "string",
          "artifact_id": "0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
          "version_id": "cf6243fb-7d5c-4aba-9f50-887919bf08be",
          "workflow_id": "52f149f8-c15c-40a9-a7ec-7e1d2635a1a1",
          "global_id": "867907bd-4c80-458d-9e75-c5683e013533_0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
          "entity_type": "reference_data"
        }
      ]
    }

Delete the relationship associated to reference data set with specified artifact_id and version_id

Delete the relationship associated to reference data set with specified artifact_id and version_id

DELETE /v3/reference_data/{artifact_id}/versions/{version_id}/relationships/{relationship_id}

Request

Path Parameters

  • The guid of the reference data set from which relationship is to be deleted.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify CURRENT to fetch from published active version.
    CURRENT is to be deprecated in next major release, please use /v3/governance_artifact_types/reference_data/{artifact_id} as a replacement.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

  • The artifact ID of the relationship to be deleted.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: 990e33f5-3108-4d45-a530-0307458362d4

Query Parameters

  • If workflow template configuration permits, the published artifact will be deleted by skipping the workflow. For details refer to documentation.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • Deleted the relationship

  • Bad Request

  • Unauthorized

  • relationship not found

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "href": "v3/reference_data/0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6/versions/4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "artifact_id": "0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "version_id": "4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "workflow_id": "56b82aa1-0f3c-4e2c-84bf-bee619c84c7f",
          "global_id": "867907bd-4c80-458d-9e75-c5683e013533_0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "entity_type": "reference_data"
        }
      ]
    }

Delete the reference data value identified by code in the Reference Data Set with specified artifact_id and version_id

Delete the reference data value identified by code in the Reference Data Set with specified artifact_id and version_id. If the reference data set is published then a workflow will be started with a draft created from which the value will be deleted. If the artifact is a draft copy then the value from the draft copy will be removed.

DELETE /v3/reference_data/{artifact_id}/versions/{version_id}/values

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify CURRENT to fetch from published active version.
    CURRENT is to be deprecated in next major release, please use /v3/governance_artifact_types/reference_data/{artifact_id} as a replacement.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • specify parent/root/code

    Allowable values: [immediate_parent,root,code]

  • specify to_code

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • If workflow template configuration permits, the published artifact will be deleted by skipping the workflow. For details refer to documentation.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • The reference data value has been deleted successfully.

  • Bad Request

  • Unauthorized

  • The reference data value with given {guid} and {code} does not exist.

  • The reference data value is currently used in catalog assets, catalog asset columns, data governance rules or data governance policies.

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "href": "v3/reference_data/0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6/versions/4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "artifact_id": "0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "version_id": "4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "workflow_id": "56b82aa1-0f3c-4e2c-84bf-bee619c84c7f",
          "global_id": "867907bd-4c80-458d-9e75-c5683e013533_0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "entity_type": "reference_data"
        }
      ]
    }

Exports values of a specified reference data set with specified artifact_id and version_id to a csv file along with their term associations and value mappings

Exports values of a specified reference data set with specified artifact_id and version_id to a csv file along with their term associations and value mappings.To verify a successful download, user need to cross verify the csv file by comparing number of rows with the response header "total-values-count" which contains number of values present in the Reference DataSet.

GET /v3/reference_data/{artifact_id}/versions/{version_id}/values

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify CURRENT to fetch from published active version.
    CURRENT is to be deprecated in next major release, please use /v3/governance_artifact_types/reference_data/{artifact_id} as a replacement.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • Specify if only RDS code needs to be exported.

  • Include associated terms to a reference data value.

  • Include column mappings to a reference data value.

    Default: true

Response

Status Code

  • The reference data set has been retrieved successfully.

  • Unauthorized

  • The reference data set with given {guid} does not exist.

  • Internal Server Error

Example responses

Update the reference data values identified by code in the Reference Data Set with specified artifact_id and version_id

Update the reference data values identified by code in the Reference Data Set with specified artifact_id and version_id

PATCH /v3/reference_data/{artifact_id}/versions/{version_id}/values

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify CURRENT to fetch from published active version.
    CURRENT is to be deprecated in next major release, please use /v3/governance_artifact_types/reference_data/{artifact_id} as a replacement.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If configuration permits, the published artifact will be updated by skipping the workflow. For details refer to documentation.

Reference data values to be updated.
Note: Precision will be lost if long value has more than 15-16 digits as JSON parser will map to double type regardless of whether it is used for integer, long or floating-point numbers. To Preserve all digits pass the value as a string.

Response

Create RDV response

Status Code

  • The reference data set has been updated successfully.

  • Bad Request

  • Unauthorized

  • Forbidden

  • The reference data set with given {guid} does not exist.

  • The reference data set was modified by another user.

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "rds_values": [
            {
              "code": "CODE_EXAMPLE",
              "value": "string",
              "description": "This is an RDS Value example",
              "revision": "0"
            }
          ],
          "href": "string",
          "artifact_id": "0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "version_id": "4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "workflow_id": "56b82aa1-0f3c-4e2c-84bf-bee619c84c7f",
          "global_id": "867907bd-4c80-458d-9e75-c5683e013533_0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "entity_type": "reference_data"
        }
      ]
    }

Add reference data values to the specified reference data set

Add reference data values to the specified reference data set

PUT /v3/reference_data/{artifact_id}/versions/{version_id}/values

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify CURRENT to fetch from published active version.
    CURRENT is to be deprecated in next major release, please use /v3/governance_artifact_types/reference_data/{artifact_id} as a replacement.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If configuration permits, the published artifact will be updated by skipping the workflow. For details refer to documentation.

Reference Data Values List

Response

Create RDV response

Status Code

  • The reference data value(s) have been added successfully.

  • Bad Request

  • Unauthorized

  • Reference data value with given code already exists.

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "rds_values": [
            {
              "code": "CODE_EXAMPLE",
              "value": "string",
              "description": "This is an RDS Value example",
              "revision": "0"
            }
          ],
          "href": "string",
          "artifact_id": "0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "version_id": "4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "workflow_id": "56b82aa1-0f3c-4e2c-84bf-bee619c84c7f",
          "global_id": "867907bd-4c80-458d-9e75-c5683e013533_0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "entity_type": "reference_data"
        }
      ]
    }

Retrieves all reference data value codes for given set version_id

This method will retrieve all reference data value codes for specific reference data set

GET /v3/reference_data/{artifact_id}/versions/{version_id}/values/codes

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify ACTIVE (it represents a current active published version) or PUBLISHED (it represents a published version that is active now or will be active in the future).

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • The maximum number of reference data codes to return - must be at least 1 and cannot exceed 25000. The default value is 1000.

    Possible values: 1 ≤ value ≤ 25000

    Default: 1000

  • Last fetched CODE.

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

Response

Status Code

  • The reference data value codes have been retrieved successfully.

  • Unauthorized

  • The reference data set with given {versionId} does not exist.

  • Internal Server Error

Example responses
  • { 
      "set_uri": false,
      "limit": 100,
      "count": 2,
      "first": {
        "href": "string",
      },
      "next": {
        "href": "string",
        "offset": Argentina
      }, 
      "resources": [ 
        "Brasil", "Chile" 
      ] 
    }

Import reference data values from csv file to the reference data set with specified artifact_id and version_id

Import reference data values from csv file to the reference data set with specified artifact_id and version_id
To check the current status of the import please use the endpoint GET /v4/reference_data_sets/{artifact_id}/versions/{version_id}/value_imports/{import_id}.

PUT /v3/reference_data/{artifact_id}/versions/{version_id}/values/import

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify CURRENT to fetch from published active version.
    CURRENT is to be deprecated in next major release, please use /v3/governance_artifact_types/reference_data/{artifact_id} as a replacement.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • Column name(number if is_first_row_header is false) of the code field in CSV file.

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • Does the csv file have header as first record

    Default: true

  • Column name(number if is_first_row_header is false) of the value field in CSV file.

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • Column name(number if is_first_row_header is false) of the description field in CSV file.

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • Column name(number if is_first_row_header is false) of the parent field in CSV file.

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • Associate terms to a reference data value.

  • Import value mappings only to a reference data value.

  • Import parent relationship only to a reference data value.

  • Column name(number if is_first_row_header is false) of the related terms field in CSV file.
    If column name not provided, default column name related terms or related_terms either case will pick from the CSV file

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • If configuration permits, the published artifact will be updated by skipping the workflow. For details refer to documentation.

  • IGNORE/OVERWRITE/REJECT if a value already exists. default is OVERWRITE

    Allowable values: [OVERWRITE,IGNORE,REJECT]

    Default: OVERWRITE

  • Specify if to trim leading and trailing spaces for code, value & description.

Form Parameters

  • File name

    Possible values: 1 ≤ length ≤ 2147483647

  • Custom columns mappings as json {"custom_columns_map":[{"csv_column_name":"cc-from-csv","custom_column_name":"cc-name"}]}

    Possible values: 1 ≤ length ≤ 2147483647

Response

Create RDS Response

Status Code

  • The reference data values import has been initiated successfully.

  • Bad Request

  • Unauthorized

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "log": {
            "href": "string",
            "import_id": "39719288-2dd7-426e-be8b-f41bde3fbd3c",
            "import_state": "IN_PROGRESS",
            "import_message": "Import in progress",
            "values_count": 100,
            "values_processed": 0
          },
          "href": "string",
          "artifact_id": "0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "version_id": "4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "workflow_id": "56b82aa1-0f3c-4e2c-84bf-bee619c84c7f",
          "global_id": "867907bd-4c80-458d-9e75-c5683e013533_0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "entity_type": "reference_data"
        }
      ]
    }

Request cancellation of a ongoing reference data values import process with specified import_id

Request cancellation of a ongoing reference data values import process with specified import_id

DELETE /v3/reference_data/{artifact_id}/versions/{version_id}/values/import/{import_id}

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify CURRENT to fetch from published active version.
    CURRENT is to be deprecated in next major release, please use /v3/governance_artifact_types/reference_data/{artifact_id} as a replacement.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

  • The import id for the reference data values import process.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: 83a7a25a-4a51-4053-a6e7-4e374d26fe1a

Response

RDV Import Info Response

Status Code

  • Cancel Request Accepted

  • Bad Request

  • Unauthorized

  • Internal Server Error

Example responses
  • {
      "import_info": {
        "href": "Url value",
        "import_id": "d3516e0e-3775-498c-ba32-ce8fb0863376",
        "import_state": "SUCCEEDED, CANCELLED, IN_PROGRESS, etc",
        "import_message": "Import Completed, Import Cancelled, Import in progress, etc",
        "values_count": 1000,
        "values_processed": 1000,
        "values_skipped": 0,
        "values_inserted": 1000,
        "rels_values_processed": 1000,
        "rels_processed": 412,
        "rels_inserted": 400,
        "rels_skipped": 2,
        "rels_deleted": 10,
        "started_by": "IBMid-1234567ABC",
        "start_time": "2021-02-18T02:30:32Z",
        "warnings_count": 2,
        "warnings": [
          {
            "row": 3,
            "info": [
              "WKCBG3092E: Cannot create a relationship between reference data value with code IT           and artifactId ca72921f-1064-4aa4-b4bd-bc66405cdde4 that is associated with reference data set           with id e4256b89-dfc6-4b53-bffa-ee72f4c4a93d and reference data value represented by CAN           that is associated with reference data set with versionId e378b0cb-89cb-4b3b-a9aa-006c914ae427.           The latter reference data value does not exist."
            ]
          },
          {
            "row": 4,
            "info": [
              "WKCBG3092E: Cannot create a relationship between reference data value with code AUS           and artifactId 6e3fe150-c648-4d8f-8519-2298379ea777 that is associated with reference data set           with id e4256b89-dfc6-4b53-bffa-ee72f4c4a93d and reference data value represented by PAK           that is associated with reference data set with versionId e378b0cb-89cb-4b3b-a9aa-006c914ae427.           The latter reference data value does not exist."
            ]
          }
        ]
      }
    }

Get current state of reference data values import process with specified import_id

Get current state of reference data values import process with specified import_id

GET /v3/reference_data/{artifact_id}/versions/{version_id}/values/import/{import_id}

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify CURRENT to fetch from published active version.
    CURRENT is to be deprecated in next major release, please use /v3/governance_artifact_types/reference_data/{artifact_id} as a replacement.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

  • The import id for the reference data values import process.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: 83a7a25a-4a51-4053-a6e7-4e374d26fe1a

Response

RDV Import Info Response

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Internal Server Error

Example responses
  • {
      "import_info": {
        "href": "Url value",
        "import_id": "d3516e0e-3775-498c-ba32-ce8fb0863376",
        "import_state": "SUCCEEDED, CANCELLED, IN_PROGRESS, etc",
        "import_message": "Import Completed, Import Cancelled, Import in progress, etc",
        "values_count": 1000,
        "values_processed": 1000,
        "values_skipped": 0,
        "values_inserted": 1000,
        "rels_values_processed": 1000,
        "rels_processed": 412,
        "rels_inserted": 400,
        "rels_skipped": 2,
        "rels_deleted": 10,
        "started_by": "IBMid-1234567ABC",
        "start_time": "2021-02-18T02:30:32Z",
        "warnings_count": 2,
        "warnings": [
          {
            "row": 3,
            "info": [
              "WKCBG3092E: Cannot create a relationship between reference data value with code IT           and artifactId ca72921f-1064-4aa4-b4bd-bc66405cdde4 that is associated with reference data set           with id e4256b89-dfc6-4b53-bffa-ee72f4c4a93d and reference data value represented by CAN           that is associated with reference data set with versionId e378b0cb-89cb-4b3b-a9aa-006c914ae427.           The latter reference data value does not exist."
            ]
          },
          {
            "row": 4,
            "info": [
              "WKCBG3092E: Cannot create a relationship between reference data value with code AUS           and artifactId 6e3fe150-c648-4d8f-8519-2298379ea777 that is associated with reference data set           with id e4256b89-dfc6-4b53-bffa-ee72f4c4a93d and reference data value represented by PAK           that is associated with reference data set with versionId e378b0cb-89cb-4b3b-a9aa-006c914ae427.           The latter reference data value does not exist."
            ]
          }
        ]
      }
    }

Restart reference data values import process which was previously cancelled

Restart reference data values import process which was previously cancelled

POST /v3/reference_data/{artifact_id}/versions/{version_id}/values/import/{import_id}

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify ACTIVE (it represents a current active published version) or PUBLISHED (it represents a published version that is active now or will be active in the future).

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

  • Import id to for the specific import action

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: 990e33f5-3108-4d45-a530-0307458362d4

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • Import of values for given import Id is started

  • Bad Request

  • Unauthorized

  • Reference data set with given name already exists.

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "href": "v3/reference_data/0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6/versions/4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "artifact_id": "0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "version_id": "4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "workflow_id": "56b82aa1-0f3c-4e2c-84bf-bee619c84c7f",
          "global_id": "867907bd-4c80-458d-9e75-c5683e013533_0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "entity_type": "reference_data"
        }
      ]
    }

Delete Custom Column values associated with a reference data value

Delete Custom Column values associated with a reference data value

DELETE /v3/reference_data/{artifact_id}/versions/{version_id}/values/{code}/custom_columns

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify ACTIVE (it represents a current active published version) or PUBLISHED (it represents a published version that is active now or will be active in the future).

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

  • Code of reference data value

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

The list of column_ids to be removed.

Response

Create RDV response

Status Code

  • The Custom Column definition has been deleted successfully with specified column_id.

  • Bad Request

  • Unauthorized

  • Forbidden

  • The Custom Column definition with given {column_id} does not exist.

  • The Custom Column was modified by another user.

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "rds_values": [
            {
              "code": "CODE_EXAMPLE",
              "value": "string",
              "description": "This is an RDS Value example",
              "revision": "0"
            }
          ],
          "href": "string",
          "artifact_id": "0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "version_id": "4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "workflow_id": "56b82aa1-0f3c-4e2c-84bf-bee619c84c7f",
          "global_id": "867907bd-4c80-458d-9e75-c5683e013533_0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "entity_type": "reference_data"
        }
      ]
    }

List Custom Column values associated with a reference data value

If the result set is larger than the limit parameter, it returns the first limit number of Custom Column values.
To retrieve the next set of Custom Column values, call the method again by using the URI in PaginatedRDSCustomColumnsGetResponseList.next returned by this method.

GET /v3/reference_data/{artifact_id}/versions/{version_id}/values/{code}/custom_columns

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify ACTIVE (it represents a current active published version) or PUBLISHED (it represents a published version that is active now or will be active in the future).

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

  • Code of reference data value

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

Query Parameters

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

Response

Reference Data Value custom column response list

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Internal Server Error

Example responses
  • {
      "revision": "0",
      "offset": 90,
      "last": {
        "href": "string",
        "offset": 270
      },
      "prev": {
        "href": "string",
        "offset": 60
      },
      "set_uri": true,
      "limit": 30,
      "count": 300,
      "first": {
        "href": "string",
        "offset": 0
      },
      "next": {
        "href": "string",
        "offset": 120
      },
      "resources": [
        {
          "metadata": {
            "id": "64ca5e02-5887-4e33-81ef-da48fe34afd4",
            "name": "COLUMN_EXAMPLE_NAME",
            "type": "TEXT"
          },
          "entity": {
            "value": "string"
          }
        }
      ]
    }

Update Custom Column values associated with a reference data value

Update Custom Column values associated with a reference data value

PATCH /v3/reference_data/{artifact_id}/versions/{version_id}/values/{code}/custom_columns

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify ACTIVE (it represents a current active published version) or PUBLISHED (it represents a published version that is active now or will be active in the future).

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

  • Code of reference data value

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

Custom Column name/description to be updated.

Response

Create RDV response

Status Code

  • The Custom Column definition has been updated successfully.

  • Bad Request

  • Unauthorized

  • Forbidden

  • The Custom Column definition with given {column_id} does not exist.

  • The Custom Column was modified by another user.

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "rds_values": [
            {
              "code": "CODE_EXAMPLE",
              "value": "string",
              "description": "This is an RDS Value example",
              "revision": "0"
            }
          ],
          "href": "string",
          "artifact_id": "0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "version_id": "4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "workflow_id": "56b82aa1-0f3c-4e2c-84bf-bee619c84c7f",
          "global_id": "867907bd-4c80-458d-9e75-c5683e013533_0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "entity_type": "reference_data"
        }
      ]
    }

List the relationships of the given type for the specified reference data value

If the result set is larger than the limit parameter, it returns the first limit number of relationships.
To retrieve the next set of relationships, call the method again by using the URI in the property next returned by this method.

GET /v3/reference_data/{artifact_id}/versions/{version_id}/values/{code}/relationships

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify CURRENT to fetch from published active version.
    CURRENT is to be deprecated in next major release, please use /v3/governance_artifact_types/reference_data/{artifact_id} as a replacement.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

  • Code of reference data value

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

Query Parameters

  • Comma-separated list of relationship types for reference data value.

    Available types:
    terms
    parent_hierarchy
    child
    parent
    single_value_mappings
    multi_value_mappings
    value_mappings
    all

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

Response

Reference Data Value Relationship Response

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Internal Server Error

Example responses
  • {
      "value_mappings": {
        "offset": 90,
        "last": {
          "href": "string",
          "offset": 270
        },
        "prev": {
          "href": "string",
          "offset": 60
        },
        "set_uri": true,
        "limit": 30,
        "count": 300,
        "first": {
          "href": "string",
          "offset": 0
        },
        "next": {
          "href": "string",
          "offset": 120
        },
        "resources": [
          {
            "rds_id": "1a4db093-9305-433b-bc22-ca2373131acc",
            "rds_version_id": "86e9513a-c8ed-40a1-93d5-d6bbd32b1291",
            "rds_name": "rds_name_example",
            "codes": [
              {
                "metadata": {
                  "artifact_type": "glossary_term",
                  "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
                  "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
                  "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
                  "source_repository_name": "repository name",
                  "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
                  "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
                  "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
                  "effective_start_date": "2021-07-26T12:37:03.919Z",
                  "effective_end_date": "2021-07-29T10:37:03.919Z",
                  "created_by": "IBMid-1234567ABC",
                  "created_at": "2017-02-15T02:30:32Z",
                  "modified_by": "IBMid-1234567ABC",
                  "modified_at": "2017-02-15T02:30:32Z",
                  "revision": "0",
                  "name": "artifact name",
                  "state": "PUBLISHED",
                  "tags": [
                    "tag1",
                    "tag2"
                  ],
                  "steward_ids": [
                    "IBMid-1234567ABC"
                  ],
                  "workflow_state": "DRAFT",
                  "read_only": false,
                  "remove_start_date": false,
                  "remove_end_date": false
                },
                "entity": {
                  "target_id": "6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
                  "additional_info": {
                    "rds_id": "1a4db093-9305-433b-bc22-ca2373131acc",
                    "rds_value": "{string}",
                    "rds_version_id": "ac0543b3-4fd6-4480-8885-64471811ee1e",
                    "rds_value_description": "string"
                  },
                  "source_id": "b710c60f-4c29-5f48-bb99-431aad664cc3",
                  "relationship_type": "is_multi_mapped_to, is_single_mapped_to, is_child_of",
                  "source_type": "reference_data_value",
                  "target_type": "reference_data_value",
                  "reference_copy": false
                }
              }
            ]
          }
        ]
      },
      "parent": {
        "offset": 90,
        "last": {
          "href": "string",
          "offset": 270
        },
        "prev": {
          "href": "string",
          "offset": 60
        },
        "set_uri": true,
        "limit": 30,
        "count": 300,
        "first": {
          "href": "string",
          "offset": 0
        },
        "next": {
          "href": "string",
          "offset": 120
        },
        "resources": [
          {
            "metadata": {
              "artifact_type": "glossary_term",
              "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
              "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
              "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
              "source_repository_name": "repository name",
              "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
              "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
              "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
              "effective_start_date": "2021-07-26T12:37:03.919Z",
              "effective_end_date": "2021-07-29T10:37:03.919Z",
              "created_by": "IBMid-1234567ABC",
              "created_at": "2017-02-15T02:30:32Z",
              "modified_by": "IBMid-1234567ABC",
              "modified_at": "2017-02-15T02:30:32Z",
              "revision": "0",
              "name": "artifact name",
              "state": "PUBLISHED",
              "tags": [
                "tag1",
                "tag2"
              ],
              "steward_ids": [
                "IBMid-1234567ABC"
              ],
              "workflow_state": "DRAFT",
              "read_only": false,
              "remove_start_date": false,
              "remove_end_date": false
            },
            "entity": {
              "target_id": "6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
              "additional_info": {
                "rds_id": "1a4db093-9305-433b-bc22-ca2373131acc",
                "rds_value": "{string}",
                "rds_version_id": "ac0543b3-4fd6-4480-8885-64471811ee1e",
                "rds_value_description": "string"
              },
              "source_id": "b710c60f-4c29-5f48-bb99-431aad664cc3",
              "relationship_type": "is_multi_mapped_to, is_single_mapped_to, is_child_of",
              "source_type": "reference_data_value",
              "target_type": "reference_data_value",
              "reference_copy": false
            }
          }
        ]
      },
      "child": {
        "offset": 90,
        "last": {
          "href": "string",
          "offset": 270
        },
        "prev": {
          "href": "string",
          "offset": 60
        },
        "set_uri": true,
        "limit": 30,
        "count": 300,
        "first": {
          "href": "string",
          "offset": 0
        },
        "next": {
          "href": "string",
          "offset": 120
        },
        "resources": [
          {
            "metadata": {
              "artifact_type": "glossary_term",
              "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
              "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
              "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
              "source_repository_name": "repository name",
              "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
              "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
              "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
              "effective_start_date": "2021-07-26T12:37:03.919Z",
              "effective_end_date": "2021-07-29T10:37:03.919Z",
              "created_by": "IBMid-1234567ABC",
              "created_at": "2017-02-15T02:30:32Z",
              "modified_by": "IBMid-1234567ABC",
              "modified_at": "2017-02-15T02:30:32Z",
              "revision": "0",
              "name": "artifact name",
              "state": "PUBLISHED",
              "tags": [
                "tag1",
                "tag2"
              ],
              "steward_ids": [
                "IBMid-1234567ABC"
              ],
              "workflow_state": "DRAFT",
              "read_only": false,
              "remove_start_date": false,
              "remove_end_date": false
            },
            "entity": {
              "target_id": "6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
              "additional_info": {
                "rds_id": "1a4db093-9305-433b-bc22-ca2373131acc",
                "rds_value": "{string}",
                "rds_version_id": "ac0543b3-4fd6-4480-8885-64471811ee1e",
                "rds_value_description": "string"
              },
              "source_id": "b710c60f-4c29-5f48-bb99-431aad664cc3",
              "relationship_type": "is_multi_mapped_to, is_single_mapped_to, is_child_of",
              "source_type": "reference_data_value",
              "target_type": "reference_data_value",
              "reference_copy": false
            }
          }
        ]
      },
      "parent_hierarchy": {
        "offset": 90,
        "last": {
          "href": "string",
          "offset": 270
        },
        "prev": {
          "href": "string",
          "offset": 60
        },
        "set_uri": true,
        "limit": 30,
        "count": 300,
        "first": {
          "href": "string",
          "offset": 0
        },
        "next": {
          "href": "string",
          "offset": 120
        },
        "resources": [
          {
            "metadata": {
              "artifact_type": "glossary_term",
              "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
              "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
              "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
              "source_repository_name": "repository name",
              "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
              "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
              "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
              "effective_start_date": "2021-07-26T12:37:03.919Z",
              "effective_end_date": "2021-07-29T10:37:03.919Z",
              "created_by": "IBMid-1234567ABC",
              "created_at": "2017-02-15T02:30:32Z",
              "modified_by": "IBMid-1234567ABC",
              "modified_at": "2017-02-15T02:30:32Z",
              "revision": "0",
              "name": "artifact name",
              "state": "PUBLISHED",
              "tags": [
                "tag1",
                "tag2"
              ],
              "steward_ids": [
                "IBMid-1234567ABC"
              ],
              "workflow_state": "DRAFT",
              "read_only": false,
              "remove_start_date": false,
              "remove_end_date": false
            },
            "entity": {
              "target_id": "6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
              "additional_info": {
                "rds_id": "1a4db093-9305-433b-bc22-ca2373131acc",
                "rds_value": "{string}",
                "rds_version_id": "ac0543b3-4fd6-4480-8885-64471811ee1e",
                "rds_value_description": "string"
              },
              "source_id": "b710c60f-4c29-5f48-bb99-431aad664cc3",
              "relationship_type": "is_multi_mapped_to, is_single_mapped_to, is_child_of",
              "source_type": "reference_data_value",
              "target_type": "reference_data_value",
              "reference_copy": false
            }
          }
        ]
      },
      "terms": {
        "offset": 90,
        "last": {
          "href": "string",
          "offset": 270
        },
        "prev": {
          "href": "string",
          "offset": 60
        },
        "set_uri": true,
        "limit": 30,
        "count": 300,
        "first": {
          "href": "string",
          "offset": 0
        },
        "next": {
          "href": "string",
          "offset": 120
        },
        "resources": [
          {
            "metadata": {
              "artifact_type": "glossary_term",
              "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
              "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
              "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
              "source_repository_name": "repository name",
              "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
              "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
              "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
              "effective_start_date": "2021-07-26T12:37:03.919Z",
              "effective_end_date": "2021-07-29T10:37:03.919Z",
              "created_by": "IBMid-1234567ABC",
              "created_at": "2017-02-15T02:30:32Z",
              "modified_by": "IBMid-1234567ABC",
              "modified_at": "2017-02-15T02:30:32Z",
              "revision": "0",
              "name": "artifact name",
              "state": "PUBLISHED",
              "tags": [
                "tag1",
                "tag2"
              ],
              "steward_ids": [
                "IBMid-1234567ABC"
              ],
              "workflow_state": "DRAFT",
              "read_only": false,
              "remove_start_date": false,
              "remove_end_date": false
            },
            "entity": {
              "target_id": "6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
              "target_global_id": "867907bd-4c80-458d-9e75-c5683e013533_6d5b4c71-18f5-416f-bb4f-4929d2d48c4f",
              "target_parent_category_id": "e39ada11-8338-3704-90e3-681a71e7c839",
              "target_parent_category_name": "parent_category_name_example",
              "target_name": "name_example",
              "target_effective_start_date": "2022-02-14T13:16:49.355Z",
              "target_effective_end_date": "2022-02-15T14:16:49.355Z",
              "source_id": "0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
              "source_global_id": "867907bd-4c80-458d-9e75-c5683e013533_0d6412d5-fce8-4bb7-90c9-891bc3de5c4b",
              "source_type": "reference_data,reference_data_value, etc",
              "target_type": "glossary_term, reference_data, category, etc",
              "description": "string",
              "relationship_type": "related, value_to_term, etc",
              "reference_copy": false
            }
          }
        ]
      }
    }

Creates relationships for reference data value

Creates relationships for reference data value

POST /v3/reference_data/{artifact_id}/versions/{version_id}/values/{code}/relationships

Request

Path Parameters

  • The artifact id of the reference data set.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify CURRENT to fetch from published active version.
    CURRENT is to be deprecated in next major release, please use /v3/governance_artifact_types/reference_data/{artifact_id} as a replacement.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

  • Code of reference data value for which terms are to be assigned

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

Query Parameters

  • If workflow template configuration permits, the artifact will be created in the published state by skipping the workflow. For details refer to documentation.

Reference Data Value Relationships

Response

create value relationship response

Status Code

  • Relationships created for reference data set

  • Bad Request

  • Unauthorized

  • Relationships conflicting for reference data set

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "rds_values": [
            {
              "code": "CODE_EXAMPLE",
              "terms": [
                {
                  "relationship_id": "d5e5ba23-ee69-47f1-beb3-b09d29374455",
                  "target_id": "6a8f8630-5cff-4c42-a8f9-1f24371ad80c"
                }
              ],
              "child": [
                {
                  "relationship_id": "c2a28f38-6a96-4aca-8daf-c1e09cd402ad",
                  "target_id": "b710c60f-4c29-5f48-bb99-431aad664cc3"
                }
              ],
              "parent": {
                "relationship_id": "ab8efc36-ddaf-4d81-8fcb-819d63cbdcea",
                "target_id": "b710c60f-4c29-5f48-bb99-431aad664cc3"
              }
            }
          ],
          "href": "string",
          "artifact_id": "0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "version_id": "4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "workflow_id": "56b82aa1-0f3c-4e2c-84bf-bee619c84c7f",
          "global_id": "867907bd-4c80-458d-9e75-c5683e013533_0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "entity_type": "reference_data"
        }
      ]
    }

Delete the relationship associated to reference data value identified by code in the Reference Data Set with specified artifact_id and version_id

Delete the relationship associated to reference data value identified by code in the Reference Data Set with specified artifact_id and version_id

DELETE /v3/reference_data/{artifact_id}/versions/{version_id}/values/{code}/relationships/{relationship_id}

Request

Path Parameters

  • The artifact_id of the reference data set from which relationship is to be deleted.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the reference data set or specify CURRENT to fetch from published active version.
    CURRENT is to be deprecated in next major release, please use /v3/governance_artifact_types/reference_data/{artifact_id} as a replacement.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

  • The code of data value from which to delete relationship.

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • The artifact ID of the relationship to be deleted.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Query Parameters

  • If workflow template configuration permits, the published artifact will be deleted by skipping the workflow. For details refer to documentation.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • Deleted the relationship

  • Bad Request

  • Unauthorized

  • relationship not found

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "href": "v3/reference_data/0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6/versions/4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "artifact_id": "0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "version_id": "4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "workflow_id": "56b82aa1-0f3c-4e2c-84bf-bee619c84c7f",
          "global_id": "867907bd-4c80-458d-9e75-c5683e013533_0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "entity_type": "reference_data"
        }
      ]
    }

Retrieves relationships for a given artifact type, artifact_id and artifact version_id

For a given artifact type, a set of predefined relationship attributes with associated artifacts are included for every relationship.

GET /v3/relationships

Request

Query Parameters

  • The artifact type. Allowed values are category, glossary_term, classification, data_class, reference_data, policy, rule

    Example: glossary_term

  • The id of artifact that is a part of the requested relationship.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of artifact that is a part of the requested relationship.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

  • Comma-separated list of relationship types.

    Relationship TypesArtifact Types
    categoryclassificationdata_classglossary_termpolicyreference_datarule
    all+++++++
    categories-++++++
    child-----+-
    classifications+-+++++
    custom+++++++
    data_classes-+-++++
    data_location_rules----+--
    data_protection_rules----+--
    grouped_assets+------
    has_terms---+---
    has_type_terms---+---
    has_types_category+------
    has_types_classifications-+-----
    has_types_classifications_hierarchy-+-----
    has_types_data_class_hierarchy--+----
    has_types_data_classes--+----
    has_types_term_hierarchy---+---
    is_a_parent_category_for+------
    is_a_type_of_category+------
    is_a_type_of_classification-+-----
    is_a_type_of_data_class--+----
    is_a_type_of_terms---+---
    is_of_terms---+---
    multi_value_mappings-----+-
    owned_by+------
    parent-----+-
    parent_category-++++++
    parent_hierarchy-----+-
    parent_policy----+--
    policies-+++--+
    reference_data-+++--+
    reference_data_values---+---
    related_categories-+-----
    related_terms---+---
    replaced_by_terms---+---
    replaces_terms---+---
    rules-++++++
    single_value_mappings-----+-
    sub_policies----+--
    synonym_terms---+---
    terms-++-+++
    value_mappings-----+-

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • A filter to artifacts that have been created / updated / deleted since the given timestamp in this format: [yyyy-MM-ddTHH:mm:ss.SSSZ]

    Possible values: length = 24, Value must match regular expression ^\d{4}(-\d\d(-\d\d(T\d\d:\d\d(:\d\d)?(\.\d+)?(([+-]\d\d:\d\d)|Z)?)?)?)?$

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

Response

Paginated lightweight search artifact list

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Creates a rule in the glossary

This method is used to create a new rule.

POST /v3/rules

Request

Query Parameters

  • If workflow template configuration permits, the artifact will be created in the published state by skipping the workflow. For details refer to documentation.

Rule to be created.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • The rule has been created successfully.

  • Bad Request

  • Unauthorized

  • UniqueConstraintViolation - rule with given name already exists.

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "href": "v3/reference_data/0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6/versions/4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "artifact_id": "0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "version_id": "4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "workflow_id": "56b82aa1-0f3c-4e2c-84bf-bee619c84c7f",
          "global_id": "867907bd-4c80-458d-9e75-c5683e013533_0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "entity_type": "reference_data"
        }
      ]
    }

Retrieves rule with given artifact_id and status

This method can be used for retrieving details of an ACTIVE, PUBLISHED or DRAFT rule.

GET /v3/rules/{artifact_id}/versions

Request

Path Parameters

  • Artifact ID or global ID of the artifact

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Query Parameters

  • Filter by rule status.

    Available statuses:
    DRAFTartifacts which are being created or modified and not in use
    PUBLISHEDartifacts which are in published state (does not takes effective dates into account)
    ACTIVEartifacts which are published, and which effective date period includes current datetime

    Possible values: 1 ≤ length ≤ 32, Value must match regular expression .*

    Default: PUBLISHED

  • Comma-separated list of relationship types.

    Available types:
    parent_category
    categories
    terms
    rules
    reference_data
    policies
    classifications
    data_classes
    custom
    all

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • If this parameter is set to true, then all artifact custom attributes are returned. If parameter is not set its default value is 'true'. This is deprecated and default will be change to 'false' in first major 2022 release.

    Default: true

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

Response

List of paginated artifacts

Status Code

  • The rule has been retrieved successfully.

  • Bad Request

  • Unauthorized

  • The rule with given {guid} does not exist in the glossary.

  • Internal Server Error

Example responses
  • {
      "offset": 90,
      "last": {
        "href": "string",
        "offset": 270
      },
      "prev": {
        "href": "string",
        "offset": 60
      },
      "set_uri": true,
      "limit": 30,
      "count": 300,
      "first": {
        "href": "string",
        "offset": 0
      },
      "next": {
        "href": "string",
        "offset": 120
      },
      "resources": [
        {
          "metadata": {
            "artifact_type": "glossary_term",
            "artifact_id": "d109503d-06c3-46b2-b1e7-95482a143d0a",
            "version_id": "58cfecc6-7182-4665-9dc5-4f030238c106_0",
            "source_repository_id": "867907bd-4c80-458d-9e75-c5683e013533",
            "source_repository_name": "repository name",
            "global_id": "867907bd-4c80-458d-9e75-c5683e013533_d109503d-06c3-46b2-b1e7-95482a143d0a",
            "workflow_id": "d3a36017-f4b3-4488-b49c-85b08fdce499",
            "draft_ancestor_id": "971798d5-7d11-4b4f-833c-f1dbac63b126",
            "effective_start_date": "2021-07-26T12:37:03.919Z",
            "effective_end_date": "2021-07-29T10:37:03.919Z",
            "created_by": "IBMid-1234567ABC",
            "created_at": "2017-02-15T02:30:32Z",
            "modified_by": "IBMid-1234567ABC",
            "modified_at": "2017-02-15T02:30:32Z",
            "revision": "0",
            "name": "artifact name",
            "state": "PUBLISHED",
            "tags": [
              "tag1",
              "tag2"
            ],
            "steward_ids": [
              "IBMid-1234567ABC"
            ],
            "workflow_state": "DRAFT",
            "read_only": false,
            "remove_start_date": false,
            "remove_end_date": false
          },
          "entity": {
            "type, rule_type, etc": "TEXT, Governance, etc",
            "long_description": "string",
            "is_removed_long_description": false,
            "state": "PUBLISHED",
            "default_locale_id": "en-US",
            "reference_copy": false,
            "custom_attributes": []
          }
        }
      ]
    }

Deletes a draft or published version of an artifact

If the artifact state is DRAFT, then the draft version is deleted.

If the artifact state is PUBLISHED, a draft version with marked_for_deletion is created .

If the artifact state is PUBLISHED and workflow is skipped, then the published version is deleted.

If a draft artifact already exists for deletion for a published artifact, then the draft artifact is simply skipped.

Administrator role is required.

DELETE /v3/rules/{artifact_id}/versions/{version_id}

Request

Path Parameters

  • The artifact id of the rule to delete.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the rule to delete.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If workflow template configuration permits, the published artifact will be deleted by skipping the workflow. For details refer to documentation.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • A draft version has been successfully created for deleting the published artifact.

  • The artifact has been deleted successfully.

  • Bad Request

  • Unauthorized

  • Draft version for the given version ID does not exist in the glossary.

  • Internal Server Error

Example responses
  • {
      "resources": [
        {
          "href": "v3/reference_data/0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6/versions/4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "artifact_id": "0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "version_id": "4fb86a70-7035-4b3e-8825-137c7b9b1687",
          "workflow_id": "56b82aa1-0f3c-4e2c-84bf-bee619c84c7f",
          "global_id": "867907bd-4c80-458d-9e75-c5683e013533_0da59a9d-3a5a-4e1d-aa0c-e67ac8bfbbb6",
          "entity_type": "reference_data"
        }
      ]
    }

Retrieves rule with given guid

This method can be used for retrieving details of an PUBLISHED or DRAFT rule.

GET /v3/rules/{artifact_id}/versions/{version_id}

Request

Path Parameters

  • The artifact ID of the rule to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version ID of the rule to fetch.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • Comma-separated list of relationship types.

    Available types:
    parent_category
    categories
    terms
    rules
    reference_data
    policies
    classifications
    data_classes
    custom
    all

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression ^(parent_category|categories|terms|classifications|data_classes|reference_data|policies|rules|custom|all)(,(parent_category|categories|terms|classifications|data_classes|reference_data|policies|rules|custom|all))*$

  • If this parameter is set to true, then all artifact custom attributes are returned. If parameter is not set its default value is 'true'. This is deprecated and default will be change to 'false' in first major 2022 release.

    Default: true

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

Response

Rule returned by REST GET method that includes the relationships as paginated list.

Status Code

  • The rule has been retrieved successfully.

  • Unauthorized

  • The rule with given {guid} does not exist in the glossary.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Updates rule with given id

This method is used to update rule with given id.

PATCH /v3/rules/{artifact_id}/versions/{version_id}

Request

Path Parameters

  • The artifact id of the rule to be updated.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version id of the rule to be updated.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If configuration permits, the published artifact will be updated by skipping the workflow. For details refer to documentation.

The rule to be updated.
Fields omitted will be unchanged, and fields set to null explicitly will be nulled out.
For multi-valued attributes & relationships, the complete list will be replaced by the given list of values.
Additional Example:

{"description" : "description updated"}

Response

Rule returned by REST GET method that includes the relationships as paginated list.

Status Code

  • The rule has been updated successfully.

  • Bad Request

  • Unauthorized

  • Forbidden

  • The rule with given {guid} does not exist in the glossary.

  • The rule was modified by another user.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

List the relationships of the given type for the specified rule

If the result set is larger than the limit parameter, it returns the first limit number of relationships.
To retrieve the next set of relationships, call the method again by using the URI in the property next returned by this method.

GET /v3/rules/{artifact_id}/versions/{version_id}/relationships

Request

Path Parameters

  • The artifact ID of the rule to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version ID of the rule to fetch.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • Comma-separated list of relationship types.

    Available types:
    parent_category
    categories
    terms
    rules
    reference_data
    policies
    classifications
    data_classes
    custom
    all

    Possible values: 1 ≤ length ≤ 255, Value must match regular expression .*

  • Custom relationship definition Id.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • Is custom relationship reversed?

  • If this parameter is set, then all ancestors in the hierarchy are returned. You can use this parameter to build complete ancestor path.

  • Retrieves target parent category name of the relationship entity.

  • The maximum number of relationship to return - must be at least 1 and cannot exceed 200. The default value is 10.

    Possible values: 1 ≤ value ≤ 200

    Default: 10

  • Index of the beginning of the page. The offset value can be 0 (zero) or a multiple of limit value.

Response

Response that includes relationships to a managed object, like business term, data class, classification

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Create relationships for an artifact in the glossary

If it is a published version, it creates a draft from the published version and adds the relationship to the draft version. And, it returns the details of the draft version.

POST /v3/rules/{artifact_id}/versions/{version_id}/relationships

Request

Path Parameters

  • The artifact ID of the rule to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version ID of the rule to fetch.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

Query Parameters

  • If configuration permits, the published artifact will be updated by skipping the workflow. For details refer to documentation.

Relationships to be created.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • The relationship(s) have been created successfully.

  • Bad Request

  • Unauthorized

  • UniqueConstraintViolation - This Relationships is already exist

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Deletes a relationship of a rule artifact

This method can be used for deleting a relationship of a rule artifact.

DELETE /v3/rules/{artifact_id}/versions/{version_id}/relationships/{relationship_id}

Request

Path Parameters

  • The artifact ID of the rule to fetch.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

  • The version ID of the rule to fetch.

    Possible values: 1 ≤ length ≤ 40, Value must match regular expression .*

    Example: 990e33f5-3108-4d45-a530-0307458362d4_0

  • The artifact ID of the relationship to be deleted.

    Possible values: length = 36, Value must match regular expression ([A-Za-z0-9]{8}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{4}-[A-Za-z0-9]{12})

    Example: aa0e33f5-3108-4d45-a530-0307458362d4

Query Parameters

  • If workflow template configuration permits, the published artifact will be deleted by skipping the workflow. For details refer to documentation.

Response

Create response object returned on creating a resource such as a Term, Category, Classification, DataClass, Policy.

Status Code

  • The relationship of the rule artifact was successfully deleted.

  • Bad Request

  • Unauthorized

  • The relationship for the given GUID does not exist in the glossary.

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Get Registration with synchronization status for reporting service

Get Registration with synchronization status for reporting service.

GET /v3/reporting/{tenant_id}/register

Request

Path Parameters

  • Tenant Id

    Possible values: 3 ≤ length ≤ 32, Value must match regular expression ^(999|[a-zA-Z0-9]{32})$

Response

Registration details

Status Code

  • Get Registration with synchronization status for reporting service

  • Bad Request

  • Unauthorized

  • IKC BiData Reporting Service is not available now please try after some time

Example responses
  • {
      "platform_asset_catalog_id": "5dd5161a-5345-4486-a374-2f614d9f5839",
      "platform_asset_connection_id": "ac88d75a-478e-44b7-bd90-58862138cdb1",
      "global_schema_name": "BITNT1DBypqa1",
      "status": "ACTIVE",
      "last_crawl_started_at": "2024-09-19T02:24:19.557Z",
      "last_updated_at": "2024-09-19T02:24:36.498Z",
      "init_sync_state": {
        "status": "SYNCHRONIZING",
        "percent": 40,
        "current_action": "PROCESSING",
        "action_target": "catalogs",
        "action_target_count": 1,
        "action_target_total_count": 1,
        "action_target_id": "a10ef7ed-98e4-4d3d-9d17-83a2370bd066",
        "action_target_name": "Bi-Data-Catalog-ITQ-Test1726712242715",
        "current_retry": 0,
        "max_retry": 4
      },
      "sync_state": {
        "status": "ACTIVE",
        "message": "ACTIVE",
        "current_cached_items": 0
      },
      "options": {
        "catalog_auto_register": false,
        "project_auto_register": false
      },
      "global": {
        "data_protection_rules": {
          "active": {
            "enabled": true,
            "status": "ACTIVE",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0,
            "count_updated_at": "NA"
          },
          "awating_commit": {}
        },
        "workflows": {
          "active": {
            "enabled": false,
            "status": "DISABLED",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0
          },
          "awating_commit": {}
        },
        "user_profiles": {
          "active": {
            "enabled": false,
            "status": "DISABLED",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0
          },
          "awating_commit": {}
        }
      },
      "schema_zone_mapping": {
        "active": [
          {
            "schema_name": "BITNT1DBypqa1",
            "catalogs": [
              {
                "id": "a10ef7ed-98e4-4d3d-9d17-83a2370bd066",
                "status": "INITIAL SYNC IN PROGRESS",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ],
            "projects": [],
            "categories": []
          },
          {
            "schema_name": "BITNT1DBypqa3",
            "catalogs": [],
            "projects": [],
            "categories": [
              {
                "id": "4390ec59-f349-43ad-a63b-a3f7401beab8",
                "status": "ACTIVE",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ]
          },
          {
            "schema_name": "BITNT1DBypqa2",
            "catalogs": [],
            "projects": [
              {
                "id": "0b50bb90-ee53-4abe-8c4b-5f0654331313",
                "status": "IN QUEUE",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ],
            "categories": []
          }
        ],
        "awating_commit": []
      }
    }

Register for reporting service

Register the tenant for reporting service. Register tenant has two key properties: 1) platform catlog_id and connection_id which should have database details to store tenant data for reporting purpose, and 2) schema zoning information which specifies tenant reporting data zoning information.

POST /v3/reporting/{tenant_id}/register

Request

Path Parameters

  • Tenant Id

    Possible values: 3 ≤ length ≤ 32, Value must match regular expression ^(999|[a-zA-Z0-9]{32})$

connection details platform_catalog_id, platform_connection_id, global schema and zoned schema

Response

Registration details

Status Code

  • Registered tenant for reporting service

  • Bad Request

  • Unauthorized

  • IKC BiData Reporting Service is not available now please try after some time

Example responses
  • {
      "platform_asset_catalog_id": "5dd5161a-5345-4486-a374-2f614d9f5839",
      "platform_asset_connection_id": "ac88d75a-478e-44b7-bd90-58862138cdb1",
      "global_schema_name": "BITNT1DBypqa1",
      "status": "ACTIVE",
      "last_crawl_started_at": "2024-09-19T02:24:19.557Z",
      "last_updated_at": "2024-09-19T02:24:36.498Z",
      "init_sync_state": {
        "status": "SYNCHRONIZING",
        "percent": 40,
        "current_action": "PROCESSING",
        "action_target": "catalogs",
        "action_target_count": 1,
        "action_target_total_count": 1,
        "action_target_id": "a10ef7ed-98e4-4d3d-9d17-83a2370bd066",
        "action_target_name": "Bi-Data-Catalog-ITQ-Test1726712242715",
        "current_retry": 0,
        "max_retry": 4
      },
      "sync_state": {
        "status": "ACTIVE",
        "message": "ACTIVE",
        "current_cached_items": 0
      },
      "options": {
        "catalog_auto_register": false,
        "project_auto_register": false
      },
      "global": {
        "data_protection_rules": {
          "active": {
            "enabled": true,
            "status": "ACTIVE",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0,
            "count_updated_at": "NA"
          },
          "awating_commit": {}
        },
        "workflows": {
          "active": {
            "enabled": false,
            "status": "DISABLED",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0
          },
          "awating_commit": {}
        },
        "user_profiles": {
          "active": {
            "enabled": false,
            "status": "DISABLED",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0
          },
          "awating_commit": {}
        }
      },
      "schema_zone_mapping": {
        "active": [
          {
            "schema_name": "BITNT1DBypqa1",
            "catalogs": [
              {
                "id": "a10ef7ed-98e4-4d3d-9d17-83a2370bd066",
                "status": "INITIAL SYNC IN PROGRESS",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ],
            "projects": [],
            "categories": []
          },
          {
            "schema_name": "BITNT1DBypqa3",
            "catalogs": [],
            "projects": [],
            "categories": [
              {
                "id": "4390ec59-f349-43ad-a63b-a3f7401beab8",
                "status": "ACTIVE",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ]
          },
          {
            "schema_name": "BITNT1DBypqa2",
            "catalogs": [],
            "projects": [
              {
                "id": "0b50bb90-ee53-4abe-8c4b-5f0654331313",
                "status": "IN QUEUE",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ],
            "categories": []
          }
        ],
        "awating_commit": []
      }
    }

Delete Registration for reporting service (if synchronization not started)

Delete Registration for reporting service (if synchronization not started) This action will delete registration only for IKC artifacts which were registered recently (via POST or PATCH) and have not been started yet.

DELETE /v3/reporting/{tenant_id}/register

Request

Path Parameters

  • Tenant Id

    Possible values: 3 ≤ length ≤ 32, Value must match regular expression ^(999|[a-zA-Z0-9]{32})$

Response

Registration details

Status Code

  • Delete/Reset draft registration of the IKC tenant for synchronization

  • Bad Request

  • Unauthorized

  • IKC BiData Reporting Service is not available now please try after some time

Example responses
  • {
      "platform_asset_catalog_id": "5dd5161a-5345-4486-a374-2f614d9f5839",
      "platform_asset_connection_id": "ac88d75a-478e-44b7-bd90-58862138cdb1",
      "global_schema_name": "BITNT1DBypqa1",
      "status": "ACTIVE",
      "last_crawl_started_at": "2024-09-19T02:24:19.557Z",
      "last_updated_at": "2024-09-19T02:24:36.498Z",
      "init_sync_state": {
        "status": "SYNCHRONIZING",
        "percent": 40,
        "current_action": "PROCESSING",
        "action_target": "catalogs",
        "action_target_count": 1,
        "action_target_total_count": 1,
        "action_target_id": "a10ef7ed-98e4-4d3d-9d17-83a2370bd066",
        "action_target_name": "Bi-Data-Catalog-ITQ-Test1726712242715",
        "current_retry": 0,
        "max_retry": 4
      },
      "sync_state": {
        "status": "ACTIVE",
        "message": "ACTIVE",
        "current_cached_items": 0
      },
      "options": {
        "catalog_auto_register": false,
        "project_auto_register": false
      },
      "global": {
        "data_protection_rules": {
          "active": {
            "enabled": true,
            "status": "ACTIVE",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0,
            "count_updated_at": "NA"
          },
          "awating_commit": {}
        },
        "workflows": {
          "active": {
            "enabled": false,
            "status": "DISABLED",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0
          },
          "awating_commit": {}
        },
        "user_profiles": {
          "active": {
            "enabled": false,
            "status": "DISABLED",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0
          },
          "awating_commit": {}
        }
      },
      "schema_zone_mapping": {
        "active": [
          {
            "schema_name": "BITNT1DBypqa1",
            "catalogs": [
              {
                "id": "a10ef7ed-98e4-4d3d-9d17-83a2370bd066",
                "status": "INITIAL SYNC IN PROGRESS",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ],
            "projects": [],
            "categories": []
          },
          {
            "schema_name": "BITNT1DBypqa3",
            "catalogs": [],
            "projects": [],
            "categories": [
              {
                "id": "4390ec59-f349-43ad-a63b-a3f7401beab8",
                "status": "ACTIVE",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ]
          },
          {
            "schema_name": "BITNT1DBypqa2",
            "catalogs": [],
            "projects": [
              {
                "id": "0b50bb90-ee53-4abe-8c4b-5f0654331313",
                "status": "IN QUEUE",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ],
            "categories": []
          }
        ],
        "awating_commit": []
      }
    }

Update Registration for reporting service

update the catalog_ids, categories, project_ids. Update the registered tenant for reporting service with new catalog_ids, categories, project_ids.

PATCH /v3/reporting/{tenant_id}/register

Request

Path Parameters

  • Tenant Id

    Possible values: 3 ≤ length ≤ 32, Value must match regular expression ^(999|[a-zA-Z0-9]{32})$

Patch registration inputs

Response

Registration details

Status Code

  • Updated registered tenant details for reporting service

  • Bad Request

  • Unauthorized

  • IKC BiData Reporting Service is not available now please try after some time

Example responses
  • {
      "platform_asset_catalog_id": "5dd5161a-5345-4486-a374-2f614d9f5839",
      "platform_asset_connection_id": "ac88d75a-478e-44b7-bd90-58862138cdb1",
      "global_schema_name": "BITNT1DBypqa1",
      "status": "ACTIVE",
      "last_crawl_started_at": "2024-09-19T02:24:19.557Z",
      "last_updated_at": "2024-09-19T02:24:36.498Z",
      "init_sync_state": {
        "status": "SYNCHRONIZING",
        "percent": 40,
        "current_action": "PROCESSING",
        "action_target": "catalogs",
        "action_target_count": 1,
        "action_target_total_count": 1,
        "action_target_id": "a10ef7ed-98e4-4d3d-9d17-83a2370bd066",
        "action_target_name": "Bi-Data-Catalog-ITQ-Test1726712242715",
        "current_retry": 0,
        "max_retry": 4
      },
      "sync_state": {
        "status": "ACTIVE",
        "message": "ACTIVE",
        "current_cached_items": 0
      },
      "options": {
        "catalog_auto_register": false,
        "project_auto_register": false
      },
      "global": {
        "data_protection_rules": {
          "active": {
            "enabled": true,
            "status": "ACTIVE",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0,
            "count_updated_at": "NA"
          },
          "awating_commit": {}
        },
        "workflows": {
          "active": {
            "enabled": false,
            "status": "DISABLED",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0
          },
          "awating_commit": {}
        },
        "user_profiles": {
          "active": {
            "enabled": false,
            "status": "DISABLED",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0
          },
          "awating_commit": {}
        }
      },
      "schema_zone_mapping": {
        "active": [
          {
            "schema_name": "BITNT1DBypqa1",
            "catalogs": [
              {
                "id": "a10ef7ed-98e4-4d3d-9d17-83a2370bd066",
                "status": "INITIAL SYNC IN PROGRESS",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ],
            "projects": [],
            "categories": []
          },
          {
            "schema_name": "BITNT1DBypqa3",
            "catalogs": [],
            "projects": [],
            "categories": [
              {
                "id": "4390ec59-f349-43ad-a63b-a3f7401beab8",
                "status": "ACTIVE",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ]
          },
          {
            "schema_name": "BITNT1DBypqa2",
            "catalogs": [],
            "projects": [
              {
                "id": "0b50bb90-ee53-4abe-8c4b-5f0654331313",
                "status": "IN QUEUE",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ],
            "categories": []
          }
        ],
        "awating_commit": []
      }
    }

Start synchronization of IKC data into reporting database

Start synchronization of IKC data from IKC to reporting database for given tenant_id. This action will start initial crawl only for IKC artifacts which were registered recently (via POST or PATCH) and have not been started yet.

POST /v3/reporting/{tenant_id}/start

Request

Path Parameters

  • Tenant Id

    Possible values: 3 ≤ length ≤ 32, Value must match regular expression ^(999|[a-zA-Z0-9]{32})$

Query Parameters

  • Soft Restart

    Allowable values: [true,false]

    Example: false

  • Soft Restart - Only failed zones

    Allowable values: [true,false]

    Example: true

  • Soft Restart - All failed zones Plus a list of successfull Zone Ids (,separated) - catalog_id,project_id,category_id,data_protection_rules,user_profiles,workflows

    Possible values: 1 ≤ length ≤ 1024, Value must match regular expression ^[a-zA-Z_][a-zA-Z0-9_\-,]*$

Response

Registration details

Status Code

  • Sync Initiated for given tenant_id.

  • Bad Request

  • Unauthorized

  • IKC BiData Reporting Service is not available now please try after some time

Example responses
  • {
      "platform_asset_catalog_id": "5dd5161a-5345-4486-a374-2f614d9f5839",
      "platform_asset_connection_id": "ac88d75a-478e-44b7-bd90-58862138cdb1",
      "global_schema_name": "BITNT1DBypqa1",
      "status": "ACTIVE",
      "last_crawl_started_at": "2024-09-19T02:24:19.557Z",
      "last_updated_at": "2024-09-19T02:24:36.498Z",
      "init_sync_state": {
        "status": "SYNCHRONIZING",
        "percent": 40,
        "current_action": "PROCESSING",
        "action_target": "catalogs",
        "action_target_count": 1,
        "action_target_total_count": 1,
        "action_target_id": "a10ef7ed-98e4-4d3d-9d17-83a2370bd066",
        "action_target_name": "Bi-Data-Catalog-ITQ-Test1726712242715",
        "current_retry": 0,
        "max_retry": 4
      },
      "sync_state": {
        "status": "ACTIVE",
        "message": "ACTIVE",
        "current_cached_items": 0
      },
      "options": {
        "catalog_auto_register": false,
        "project_auto_register": false
      },
      "global": {
        "data_protection_rules": {
          "active": {
            "enabled": true,
            "status": "ACTIVE",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0,
            "count_updated_at": "NA"
          },
          "awating_commit": {}
        },
        "workflows": {
          "active": {
            "enabled": false,
            "status": "DISABLED",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0
          },
          "awating_commit": {}
        },
        "user_profiles": {
          "active": {
            "enabled": false,
            "status": "DISABLED",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0
          },
          "awating_commit": {}
        }
      },
      "schema_zone_mapping": {
        "active": [
          {
            "schema_name": "BITNT1DBypqa1",
            "catalogs": [
              {
                "id": "a10ef7ed-98e4-4d3d-9d17-83a2370bd066",
                "status": "INITIAL SYNC IN PROGRESS",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ],
            "projects": [],
            "categories": []
          },
          {
            "schema_name": "BITNT1DBypqa3",
            "catalogs": [],
            "projects": [],
            "categories": [
              {
                "id": "4390ec59-f349-43ad-a63b-a3f7401beab8",
                "status": "ACTIVE",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ]
          },
          {
            "schema_name": "BITNT1DBypqa2",
            "catalogs": [],
            "projects": [
              {
                "id": "0b50bb90-ee53-4abe-8c4b-5f0654331313",
                "status": "IN QUEUE",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ],
            "categories": []
          }
        ],
        "awating_commit": []
      }
    }

Pause synchronization of IKC data into reporting database

Pause synchronization of IKC data into reporting database for given tenant_id.

POST /v3/reporting/{tenant_id}/pause

Request

Path Parameters

  • Tenant Id

    Possible values: 3 ≤ length ≤ 32, Value must match regular expression ^(999|[a-zA-Z0-9]{32})$

Response

Registration details

Status Code

  • Pause Sync request accepted for given tenant_id.

  • Bad Request

  • Unauthorized

  • IKC BiData Reporting Service is not available now please try after some time

Example responses
  • {
      "platform_asset_catalog_id": "5dd5161a-5345-4486-a374-2f614d9f5839",
      "platform_asset_connection_id": "ac88d75a-478e-44b7-bd90-58862138cdb1",
      "global_schema_name": "BITNT1DBypqa1",
      "status": "ACTIVE",
      "last_crawl_started_at": "2024-09-19T02:24:19.557Z",
      "last_updated_at": "2024-09-19T02:24:36.498Z",
      "init_sync_state": {
        "status": "SYNCHRONIZING",
        "percent": 40,
        "current_action": "PROCESSING",
        "action_target": "catalogs",
        "action_target_count": 1,
        "action_target_total_count": 1,
        "action_target_id": "a10ef7ed-98e4-4d3d-9d17-83a2370bd066",
        "action_target_name": "Bi-Data-Catalog-ITQ-Test1726712242715",
        "current_retry": 0,
        "max_retry": 4
      },
      "sync_state": {
        "status": "ACTIVE",
        "message": "ACTIVE",
        "current_cached_items": 0
      },
      "options": {
        "catalog_auto_register": false,
        "project_auto_register": false
      },
      "global": {
        "data_protection_rules": {
          "active": {
            "enabled": true,
            "status": "ACTIVE",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0,
            "count_updated_at": "NA"
          },
          "awating_commit": {}
        },
        "workflows": {
          "active": {
            "enabled": false,
            "status": "DISABLED",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0
          },
          "awating_commit": {}
        },
        "user_profiles": {
          "active": {
            "enabled": false,
            "status": "DISABLED",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0
          },
          "awating_commit": {}
        }
      },
      "schema_zone_mapping": {
        "active": [
          {
            "schema_name": "BITNT1DBypqa1",
            "catalogs": [
              {
                "id": "a10ef7ed-98e4-4d3d-9d17-83a2370bd066",
                "status": "INITIAL SYNC IN PROGRESS",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ],
            "projects": [],
            "categories": []
          },
          {
            "schema_name": "BITNT1DBypqa3",
            "catalogs": [],
            "projects": [],
            "categories": [
              {
                "id": "4390ec59-f349-43ad-a63b-a3f7401beab8",
                "status": "ACTIVE",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ]
          },
          {
            "schema_name": "BITNT1DBypqa2",
            "catalogs": [],
            "projects": [
              {
                "id": "0b50bb90-ee53-4abe-8c4b-5f0654331313",
                "status": "IN QUEUE",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ],
            "categories": []
          }
        ],
        "awating_commit": []
      }
    }

Resume synchronization of IKC data into reporting database

Resume synchronization of IKC data into reporting database for given tenant_id after it was paused.

POST /v3/reporting/{tenant_id}/resume

Request

Path Parameters

  • Tenant Id

    Possible values: 3 ≤ length ≤ 32, Value must match regular expression ^(999|[a-zA-Z0-9]{32})$

Response

Registration details

Status Code

  • Resume Sync request accepted for given tenant_id.

  • Bad Request

  • Unauthorized

  • IKC BiData Reporting Service is not available now please try after some time

Example responses
  • {
      "platform_asset_catalog_id": "5dd5161a-5345-4486-a374-2f614d9f5839",
      "platform_asset_connection_id": "ac88d75a-478e-44b7-bd90-58862138cdb1",
      "global_schema_name": "BITNT1DBypqa1",
      "status": "ACTIVE",
      "last_crawl_started_at": "2024-09-19T02:24:19.557Z",
      "last_updated_at": "2024-09-19T02:24:36.498Z",
      "init_sync_state": {
        "status": "SYNCHRONIZING",
        "percent": 40,
        "current_action": "PROCESSING",
        "action_target": "catalogs",
        "action_target_count": 1,
        "action_target_total_count": 1,
        "action_target_id": "a10ef7ed-98e4-4d3d-9d17-83a2370bd066",
        "action_target_name": "Bi-Data-Catalog-ITQ-Test1726712242715",
        "current_retry": 0,
        "max_retry": 4
      },
      "sync_state": {
        "status": "ACTIVE",
        "message": "ACTIVE",
        "current_cached_items": 0
      },
      "options": {
        "catalog_auto_register": false,
        "project_auto_register": false
      },
      "global": {
        "data_protection_rules": {
          "active": {
            "enabled": true,
            "status": "ACTIVE",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0,
            "count_updated_at": "NA"
          },
          "awating_commit": {}
        },
        "workflows": {
          "active": {
            "enabled": false,
            "status": "DISABLED",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0
          },
          "awating_commit": {}
        },
        "user_profiles": {
          "active": {
            "enabled": false,
            "status": "DISABLED",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0
          },
          "awating_commit": {}
        }
      },
      "schema_zone_mapping": {
        "active": [
          {
            "schema_name": "BITNT1DBypqa1",
            "catalogs": [
              {
                "id": "a10ef7ed-98e4-4d3d-9d17-83a2370bd066",
                "status": "INITIAL SYNC IN PROGRESS",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ],
            "projects": [],
            "categories": []
          },
          {
            "schema_name": "BITNT1DBypqa3",
            "catalogs": [],
            "projects": [],
            "categories": [
              {
                "id": "4390ec59-f349-43ad-a63b-a3f7401beab8",
                "status": "ACTIVE",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ]
          },
          {
            "schema_name": "BITNT1DBypqa2",
            "catalogs": [],
            "projects": [
              {
                "id": "0b50bb90-ee53-4abe-8c4b-5f0654331313",
                "status": "IN QUEUE",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ],
            "categories": []
          }
        ],
        "awating_commit": []
      }
    }

Stop synchronization of IKC data into reporting database

Stop synchronization of IKC data into reporting database and reset the status of all the process to AWAITING START for given tenant_id.

POST /v3/reporting/{tenant_id}/stop

Request

Path Parameters

  • Tenant Id

    Possible values: 3 ≤ length ≤ 32, Value must match regular expression ^(999|[a-zA-Z0-9]{32})$

Response

Registration details

Status Code

  • Stop Sync request accepted for given tenant_id.

  • Bad Request

  • Unauthorized

  • IKC BiData Reporting Service is not available now please try after some time

Example responses
  • {
      "platform_asset_catalog_id": "5dd5161a-5345-4486-a374-2f614d9f5839",
      "platform_asset_connection_id": "ac88d75a-478e-44b7-bd90-58862138cdb1",
      "global_schema_name": "BITNT1DBypqa1",
      "status": "ACTIVE",
      "last_crawl_started_at": "2024-09-19T02:24:19.557Z",
      "last_updated_at": "2024-09-19T02:24:36.498Z",
      "init_sync_state": {
        "status": "SYNCHRONIZING",
        "percent": 40,
        "current_action": "PROCESSING",
        "action_target": "catalogs",
        "action_target_count": 1,
        "action_target_total_count": 1,
        "action_target_id": "a10ef7ed-98e4-4d3d-9d17-83a2370bd066",
        "action_target_name": "Bi-Data-Catalog-ITQ-Test1726712242715",
        "current_retry": 0,
        "max_retry": 4
      },
      "sync_state": {
        "status": "ACTIVE",
        "message": "ACTIVE",
        "current_cached_items": 0
      },
      "options": {
        "catalog_auto_register": false,
        "project_auto_register": false
      },
      "global": {
        "data_protection_rules": {
          "active": {
            "enabled": true,
            "status": "ACTIVE",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0,
            "count_updated_at": "NA"
          },
          "awating_commit": {}
        },
        "workflows": {
          "active": {
            "enabled": false,
            "status": "DISABLED",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0
          },
          "awating_commit": {}
        },
        "user_profiles": {
          "active": {
            "enabled": false,
            "status": "DISABLED",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0
          },
          "awating_commit": {}
        }
      },
      "schema_zone_mapping": {
        "active": [
          {
            "schema_name": "BITNT1DBypqa1",
            "catalogs": [
              {
                "id": "a10ef7ed-98e4-4d3d-9d17-83a2370bd066",
                "status": "INITIAL SYNC IN PROGRESS",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ],
            "projects": [],
            "categories": []
          },
          {
            "schema_name": "BITNT1DBypqa3",
            "catalogs": [],
            "projects": [],
            "categories": [
              {
                "id": "4390ec59-f349-43ad-a63b-a3f7401beab8",
                "status": "ACTIVE",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ]
          },
          {
            "schema_name": "BITNT1DBypqa2",
            "catalogs": [],
            "projects": [
              {
                "id": "0b50bb90-ee53-4abe-8c4b-5f0654331313",
                "status": "IN QUEUE",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ],
            "categories": []
          }
        ],
        "awating_commit": []
      }
    }

Reset Registration for reporting service (Stop Sync and Delete Registration)

Reset IKC tenant registeration for synchronization of IKC data into reporting database for given tenant_id.

POST /v3/reporting/{tenant_id}/reset

Request

Path Parameters

  • Tenant Id

    Possible values: 3 ≤ length ≤ 32, Value must match regular expression ^(999|[a-zA-Z0-9]{32})$

Response

Registration details

Status Code

  • Reset Sync request accepted for given tenant_id.

  • Bad Request

  • Unauthorized

  • IKC BiData Reporting Service is not available now please try after some time

Example responses
  • {
      "platform_asset_catalog_id": "5dd5161a-5345-4486-a374-2f614d9f5839",
      "platform_asset_connection_id": "ac88d75a-478e-44b7-bd90-58862138cdb1",
      "global_schema_name": "BITNT1DBypqa1",
      "status": "ACTIVE",
      "last_crawl_started_at": "2024-09-19T02:24:19.557Z",
      "last_updated_at": "2024-09-19T02:24:36.498Z",
      "init_sync_state": {
        "status": "SYNCHRONIZING",
        "percent": 40,
        "current_action": "PROCESSING",
        "action_target": "catalogs",
        "action_target_count": 1,
        "action_target_total_count": 1,
        "action_target_id": "a10ef7ed-98e4-4d3d-9d17-83a2370bd066",
        "action_target_name": "Bi-Data-Catalog-ITQ-Test1726712242715",
        "current_retry": 0,
        "max_retry": 4
      },
      "sync_state": {
        "status": "ACTIVE",
        "message": "ACTIVE",
        "current_cached_items": 0
      },
      "options": {
        "catalog_auto_register": false,
        "project_auto_register": false
      },
      "global": {
        "data_protection_rules": {
          "active": {
            "enabled": true,
            "status": "ACTIVE",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0,
            "count_updated_at": "NA"
          },
          "awating_commit": {}
        },
        "workflows": {
          "active": {
            "enabled": false,
            "status": "DISABLED",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0
          },
          "awating_commit": {}
        },
        "user_profiles": {
          "active": {
            "enabled": false,
            "status": "DISABLED",
            "processed": 0,
            "skipped": 0,
            "wkc_count": 0
          },
          "awating_commit": {}
        }
      },
      "schema_zone_mapping": {
        "active": [
          {
            "schema_name": "BITNT1DBypqa1",
            "catalogs": [
              {
                "id": "a10ef7ed-98e4-4d3d-9d17-83a2370bd066",
                "status": "INITIAL SYNC IN PROGRESS",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ],
            "projects": [],
            "categories": []
          },
          {
            "schema_name": "BITNT1DBypqa3",
            "catalogs": [],
            "projects": [],
            "categories": [
              {
                "id": "4390ec59-f349-43ad-a63b-a3f7401beab8",
                "status": "ACTIVE",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ]
          },
          {
            "schema_name": "BITNT1DBypqa2",
            "catalogs": [],
            "projects": [
              {
                "id": "0b50bb90-ee53-4abe-8c4b-5f0654331313",
                "status": "IN QUEUE",
                "processed": 0,
                "skipped": 0,
                "wkc_count": 0,
                "count_updated_at": "NA"
              }
            ],
            "categories": []
          }
        ],
        "awating_commit": []
      }
    }

Get list of sample queries

Get list of sample queries

GET /v3/reporting/{tenant_id}/samples

Request

Path Parameters

  • Tenant Id

    Possible values: 3 ≤ length ≤ 32, Value must match regular expression ^(999|[a-zA-Z0-9]{32})$

Query Parameters

  • Sample Type

    Allowable values: [documented,all]

Response

Samples / Example Queries

Status Code

  • Get list of sample queries

  • Bad Request

  • Unauthorized

  • IKC BiData Reporting Service is not available now please try after some time

Example responses
  • {
      "examples": [
        {
          "text": "Number of catalog assets grouped by type",
          "sql": "SELECT ASSET_TYPE, COUNT(*) AS TOTAL FROM zoneschema.CONTAINER_ASSETS GROUP BY ASSET_TYPE"
        },
        {
          "text": "Get the number of connections created since specific time",
          "sql": "SELECT CONTAINER_TYPE, COUNT(*) FROM zoneschema.CONTAINER_ASSETS WHERE ASSET_TYPE = 'connection' AND CREATED_ON >= TO_TIMESTAMP('2022-01-01', 'YYYY-MM-DD') GROUP BY CONTAINER_TYPE"
        }
      ]
    }

Copy Knowledge Accelerator items into project

Copy the specified Knowledge Accelerator items into specified IKC project.

POST /v1/knowledge_accelerators/{ka_id}/copy_items

Request

Path Parameters

  • The Knowledge Accelerator id

    Possible values: 4 ≤ length ≤ 7

Query Parameters

  • A comma separated list of the item ids of the Knowledge Accelerator to copy.

    Possible values: 2 ≤ length ≤ 200

  • The id of the project where the items are copied to

    Possible values: 10 ≤ length ≤ 100

  • curl -k -X POST 'https://{cpd_cluster_host}/v1/knowledge_accelerators/{ka_id}/copy_items?ids={ids}&project_id={project_id}' -H 'accept: application/json' -H 'Authorization: Bearer {token}' -d ''

Response

Response information related to copying Knowledge Accelerator items into a project.

Status Code

  • Success

  • Bad Request

  • Unauthorized

  • Not found

Example responses
  • {"message":"The copy has been executed, please check details below for status","knowledge_accelerator":"https://api.dataplatform.cloud.ibm.com/v1/knowledge_accelerators/kaeu20","items":[{"item_id":"base","data_assets":[{"name":"kaeu20-base-2.0.20230726.zip","url":"https://api.dataplatform.cloud.ibm.com/v2/data_assets/b43ddf6d-bb52-4df2-9d55-c7713a2bbadd?project_id=e304ce63-8e2a-4597-8251-0876d20c2a24","status":"copied"}]}]}

Get a specific Knowledge Accelerator

Supply a Knowledge Accelerator id, in order to get detailed information, including contained items that can be imported, statistics and dependencies

GET /v1/knowledge_accelerators/{id}

Request

Path Parameters

  • The Knowledge Accelerator id

    Possible values: 4 ≤ length ≤ 7

  • curl -k -X GET 'https://{cpd_cluster_host}/v1/knowledge_accelerators/{ka_id}' -H 'accept: application/json' -H 'Authorization: Bearer {token}'

Response

A KAArtifact can represent a Knowledge Accelerator or a Knowledge Accelerator item. A knowledge accelerator can contain many knowledge accelerator items, which can be for example, many sub parts of a large IKC glossary. A knowledge accelerator item can depend on other items.

Status Code

  • Success

  • Unauthorized

  • Not found

Example responses
  • {"id":"kaeu20","name":"Knowledge Accelerators","definition":"A category that ..etc.","type":"knowledge_accelerator","format":"wkc_glossary","version":"2.0.20231004","stats":{"terms":11425,"categories":502,"policy":57,"rule":30,"reference_data":297,"reference_data_value":2292,"data_class":284}}

Import specified Knowledge Accelerator items into the glossary

Import the specified Knowledge Accelerator items into glossary. By default this will import all dependent items

POST /v1/knowledge_accelerators/{ka_id}/import_items

Request

Path Parameters

  • The Knowledge Accelerator id

    Possible values: 4 ≤ length ≤ 7

Query Parameters

  • The ids of the Knowledge Accelerator items to import, for example 'base'. Use the comma delimiter when listing multiple item ids, for example 'ccpa,gdpr'. Only one item allowed if item is of type glossary_scope

    Possible values: 2 ≤ length ≤ 200

  • The merge option to be used when importing into the glossary, valid values:

    all - imported values will replace existing values in catalog
    specified - imported values that are not empty replace existing values in catalog
    empty - imported values replace only empty values in catalog

    Possible values: 3 ≤ length ≤ 12

  • Indicates which dependencies of the item ids specified should also be imported, valid values:

    all - imports the specified items that the user selects, imports all the items that the selected item depends on, irrespective of whether they already exist in glossary (Note, this may overwrite user made changes in the glossary).
    necessary - imports specified items that the user selects, imports items that are considered mandatory for the specified item, and imports other related items the specified items depend on that are not already imported.
    mandatory - imports the specified items that the user selects, and items that are considered mandatory for the specified item.

    Possible values: 3 ≤ length ≤ 12

    Default: necessary

  • Indicates whether the import should be done, valid values:

    false - will do all the logic checking and indicate what is going to be imported, useful for checking in advance of actually doing the import
    true - at the end of logic checking will trigger the import and return a process id to the user

    Default: false

  • curl -k -X POST 'https://{cpd_cluster_host}/v1/knowledge_accelerators/{ka_id}/import_items?ids={ids}&merge_option={merge_option}&dependencies={dependencies}&do_import={do_import}' -H 'accept: application/json' -H 'Authorization: Bearer {token}' -d ''

Response

An import response holds information related to an attempted or dry run of import of Knowledge Accelerator content. In a dry run scenario there will be no process id, as the import was not actually triggered.

Status Code

  • Accepted

  • Bad Request

  • Unauthorized

  • Not found

Example responses
  • {"message":"The import has been submitted. To check the status ...","process_id":"b3ae3db2-6da1-447d-aaf7-4dde46dcbd1d","import_evaluation":{"knowledge_accelerator":"kain20","items":[{"id":"base","evaluation":"import","reason":"user_selected"}]}}

Get what Knowledge Accelerator items are currently imported into glossary

Information on what Knowledge Accelerator items are imported into glossary if any; this will include information as to whether imported version is current

GET /v1/knowledge_accelerators/import_items

Request

No Request Parameters

This method does not accept any request parameters.

  • curl -k -X GET 'https://{cpd_cluster_host}/v1/knowledge_accelerators/import_items' -H 'accept: application/json' -H 'Authorization: Bearer {token}'

Response

Represents information as to what Knowledge Accelerators and associated items are installed in the IKC glossary.

Status Code

  • Success

  • Unauthorized

Example responses
  • {"message":"KA008I: The following knowledge accelerator items are imported","import_evaluation":[{"knowledge_accelerator":"kain20","items":[{"id":"base","evaluation":"imported"}]}]}

Get all Knowledge Accelerators

Detailed information on each Knowledge Accelerator, including contained items that can be imported, statistics and dependencies

GET /v1/knowledge_accelerators

Request

No Request Parameters

This method does not accept any request parameters.

  • curl -k -X GET 'https://{cpd_cluster_host}/v1/knowledge_accelerators' -H 'accept: application/json' -H 'Authorization: Bearer {token}'

Response

A listing of the Knowledge Accelerators

Status Code

  • Success

  • Unauthorized

Example responses
  • {"count":1,"knowledge_accelerators":[{"id":"kahc20","name":"Knowledge Accelerator for Healthcare","definition":"IBM Knowledge Accelerator for ...etc..","type":"knowledge_accelerator","format":"wkc_glossary","version":"2.0.20230726","stats":{"terms":22385,"categories":1071,"policy":32,"rule":10,"reference_data":1169,"reference_data_value":22624,"data_class":208}}]}

Get asset lineage

Returns lineage of the asset identified by asset_id. The lineage includes a list of events associated with the asset. A different list of events are returned based on the value of lineage_type query parameter.

  • lineage_type = default | partial - The event generating the asset, the events happening on the asset and the events using the asset to generate other assets.
  • lineage_type = forward - The event generating the asset and the events using the asset directly or indirectly to generate other assets.
  • lineage_type = forward_hop - The event generating the asset and the events using the asset directly or indirectly to generate other assets. The number of events returned is controlled by hop_count and event_count parameters.
  • lineage_type = backward - All the direct and indirect events responsible for generating the asset.
GET /v2/asset_lineages/{asset_id}

Request

Path Parameters

  • Asset ID

Query Parameters

  • The type of the asset. The value can be one of dataset, model. If the seed asset ID is supplied, then the value supplied should be the type of the seed asset.

  • The maximum number of events returned. The default value is 50.

  • The index of the first matching event to be included in the result. The default value is 0.

  • The type of lineage to be returned. The default value is partial

    Allowable values: [forward,forward_hop,backward,partial]

  • The type of event classification. By default, the events are not classfied.

    Allowable values: [timelines]

  • If the asset is a catalog-asset, specify the ID of the catalog. If the seed asset ID is supplied, then the value supplied should be the catalog ID of the seed asset.

  • If the asset is a project-asset, specify the ID of the project. If the seed asset ID is supplied, then the value supplied should be the project ID of the seed asset.

  • If the asset is a space-asset, specify the ID of the space. If the seed asset ID is supplied, then the value supplied should be the project ID of the seed asset.

  • If the asset is a model, specify the ID of the associated WML service instance. If the seed asset ID is supplied, then the value supplied should be the WML service instance ID of the seed asset.

  • The time after which the events have to be fetched. The format should be yyyy-MM-dd'T'HH:mm:ss.SSSX. The default value is 1970-01-01T00:00:00.000Z.

  • Used to control the number of events returned when lineage_type is forward_hop. The events returned will belong to a maximum of N other assets directly or indirectly generated using the asset where N is equal to hop_count. The default value is 4.

  • Used to control the number of events returned when lineage_type is forward_hop. The maxiumum number of events of each other asset generated directly or indirectly using the asset. The default value is 10.

  • The seed asset ID. The request will not be authorized if the lineage of the asset is not part of the lineage of the seed asset.

Response

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not Found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Get asset lineage summary

Returns lineage summary of the asset identified by asset_id.

GET /v2/asset_lineages/{asset_id}/summary

Request

Path Parameters

  • Asset ID

Query Parameters

  • The type of the asset. The value can be one of dataset, model.

  • If the asset is a catalog-asset, specify the ID of the catalog.

  • If the asset is a project-asset, specify the ID of the project.

  • If the asset is a space-asset, specify the ID of the space.

  • If the asset is a model, specify the ID of the associated WML service instance.

Response

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not Found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Returns the event identified by event_id.

Get lineage event

GET /v2/lineage_events/{event_id}

Request

Path Parameters

  • Event ID

Response

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not Found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Publishes lineage event.

Publish lineage event

POST /v2/lineage_events

Request

Response

Status Code

  • Accepted

  • No Content

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not Found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

Get summary statistics of activities on a project/catalog/space asset

Returns summary statistics of the asset identified by asset_id and request type.

GET /v2/asset_statistics/{asset_id}/statistics

Request

Path Parameters

  • Asset ID

Query Parameters

  • The type of the request. The value can be one of edits, downloads, publish_to_catalog or clone_to_project.

    Allowable values: [EDITS,DOWNLOADS,PUBLISH_TO_CATALOG,CLONE_TO_PROJECT,PROMOTE_TO_SPACE]

  • If the asset is a catalog-asset, specify the ID of the catalog.

  • If the asset is a project-asset, specify the ID of the project.

  • If the asset is a space-asset, specify the ID of the space

Response

Response for the /v2/asset_statistics/{asset_id}/statistics API

Status Code

  • OK

  • Bad Request

  • Unauthorized

  • Forbidden

  • Not Found

  • Internal Server Error

No Sample Response

This method does not specify any sample responses.

id=curlclassName=tab-item-selected