Overview

Cloudera DataCatalog Service is a web service, using this service a user can execute operations like launching profilers in DataCatalog.

Version information

Version : 0.9.157

License information

License : Apache 2.0
Terms of service : null

URI scheme

Schemes : HTTPS

Consumes

  • application/json

Produces

  • application/json

Paths

Add assets to an existing Data Share.

POST /api/v1/datacatalog/addAssetsToDataShare

Description

Add assets to an existing Data Share. The status of the Data Share must be changed to Not Shared before adding assets.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Response of adding assets to Data Share.

default

The default response on an error.

Create a Data Share for Data Sharing.

POST /api/v1/datacatalog/createDataShare

Description

Create a Data Share to enable sharing of data both within and outside of Cloudera environments.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Data Share creation response.

default

The default response on an error.

Create external users for Data Sharing.

POST /api/v1/datacatalog/createExternalUsers

Description

Create external users who are outside of the Cloudera ecosystem and will be able to access Data Shares.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

External users creation response.

default

The default response on an error.

Delete a Data Share by its ID.

POST /api/v1/datacatalog/deleteDataShare

Description

Permanently deletes a Data Share using its unique identifier. The status of the Data Share must be changed to Not Shared before deletion.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Data Share deletion response.

default

The default response on an error.

Delete an external user.

POST /api/v1/datacatalog/deleteExternalUser

Description

Permanently deletes an external user. This action is irreversible and will remove the user’s access to all Data Shares.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

External user deletion response.

default

The default response on an error.

Get a Data Share by its ID.

POST /api/v1/datacatalog/getDataShare

Description

Retrieve detailed information about a Data Share including its metadata, assets, external users, and configuration settings.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Data Share details response.

default

The default response on an error.

Get Suggested tags by the Data Compliance profiler.

POST /api/v1/datacatalog/getSuggestedTags

Description

Get the tags suggested by the Data Compliance profiler.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

List of suggested tags.

default

The default response on an error.

Grant access to external users on a Data Share.

POST /api/v1/datacatalog/grantAccessToExternalUsersOnDataShare

Description

Grants access to a Data Share for one or more external users, optionally setting an expiration for their access.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Response of adding access of external users on Data Share.

default

The default response on an error.

Launches DataCatalog profilers in a given datalake.

POST /api/v1/datacatalog/launchProfilers

Description

Launches DataCatalog profilers in a given datalake.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Expected response to a valid request.

default

The default response on an error.

List Data Shares.

POST /api/v1/datacatalog/listDataShares

Description

Lists all available Data Shares within a specified Data Lake.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Data Shares list response.

default

The default response on an error.

List external users for Data Sharing.

POST /api/v1/datacatalog/listExternalUsers

Description

List external users registered in Cloudera, who are outside of the Cloudera ecosystem.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

External users listing response.

default

The default response on an error.

Regenerate credentials for an external user.

POST /api/v1/datacatalog/regenerateExternalUserCredentials

Description

Regenerate credentials for an external user. This action invalidates the user’s old credentials.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

External user credentials regeneration response.

default

The default response on an error.

Remove access of external users on a Data Share.

POST /api/v1/datacatalog/removeAccessOfExternalUsersOnDataShare

Description

Removes one or more external users' access from a specific Data Share. The status of the Data Share must be changed to Not Shared before removing access.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Response of removing access of external users on Data Share.

default

The default response on an error.

Remove assets from an existing Data Share.

POST /api/v1/datacatalog/removeAssetsFromDataShare

Description

Remove assets from an existing Data Share. The status of the Data Share must be changed to Not Shared before removing assets.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Response of removing assets from Data Share.

default

The default response on an error.

Review tags suggested by Data Compliance Profiler

POST /api/v1/datacatalog/reviewSuggestedTags

Description

Review the tags suggested by the Data Compliance profiler.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Accept or Reject tags suggested by Data Compliance Profiler.

default

The default response on an error.

Revoke credentials for an external user.

POST /api/v1/datacatalog/revokeExternalUserCredentials

Description

Revoke credentials for an external user. The user will immediately lose access to the Data Shares.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

External user credentials revocation response.

default

The default response on an error.

Share the Data Share for external users.

POST /api/v1/datacatalog/shareDataShare

Description

Changes the status of a Data Share to Shared, making its assets available to the assigned external users.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Share the Data Share sharing response.

default

The default response on an error.

Unshare the Data Share for external users.

POST /api/v1/datacatalog/unshareDataShare

Description

Changes the status of a Data Share to Not Shared, making its assets temporarily unavailable to the assigned external users.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Unshare Data Share sharing response.

default

The default response on an error.

Update access of external users on a Data Share.

POST /api/v1/datacatalog/updateAccessOfExternalUsersOnDataShare

Description

Adds external users to a Data Share or updates their access expiration time.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Response of adding or updating access of external users on Data Share.

default

The default response on an error.

Update the Data Share.

POST /api/v1/datacatalog/updateDataShare

Description

Update the Data Share metadata and properties including name, keywords, expiration time, summary, and terms of use.

Parameters

Type Name Schema

Body

input
required

Responses

HTTP Code Description Schema

200

Data Share update response.

default

The default response on an error.

Definitions

AddAssetsToDataShareRequest

Add assets to Data Share request.

Name Description Schema

assets
required

List of assets to be added to the Data Share.

< AssetRequest > array

dataShareId
required

The unique identifier of the Data Share to which assets will be added.

string

datalakeCrn
required

The CRN of the Data Lake where the Data Share is located.

string

environmentCrn
required

The CRN of the Environment where the Data Share is located.

string

AddAssetsToDataShareResponse

Response of the Add assets to Data Share operation.

Name Description Schema

assets
optional

List of assets added to the Data Share.

< AssetResponse > array

AssetRequest

Details of an asset to be included in the Data Share.

Name Description Schema

columns
optional

List of columns in the asset (default all is included).

< string > array

databaseName
required

The name of the database containing the asset.

string

guid
optional

The unique identifier of the asset (asset guid from the Atlas).

string

tableName
required

The name of the table containing the asset.

string

AssetResponse

Details of an asset to be included in the Data Share.

Name Description Schema

columns
optional

List of columns in the asset (default all is included).

< string > array

createTime
optional

The date and time when the asset was created.

string (date-time)

createdBy
optional

The user who created the asset.

string

databaseName
optional

The name of the database containing the asset.

string

guid
optional

The unique identifier of the asset (asset guid from the Atlas).

string

resourceId
optional

The unique identifier of the resource.

string

tableName
optional

The name of the table containing the asset.

string

updateTime
optional

The date and time when the asset was last updated.

string (date-time)

updatedBy
optional

The user who last updated the asset.

string

AssetsToReviewRequest

Asset details for which tags are being reviewed.

Name Description Schema

qualifiedName
required

The fully qualified name of the asset.

string

tags
required

List of tags to be reviewed.

< string > array

Cluster

Information about a cluster.

Name Description Schema

cloudPlatform
optional

The cloud platform.

string

clusterName
optional

The name of the cluster.

string

clusterStatus
optional

The status of the cluster.

string

clusterTemplateCrn
optional

The CRN of the cluster template used for the cluster creation.

string

creationDate
optional

The date when the cluster was created.

string (date-time)

credentialCrn
optional

The CRN of the credential.

string

crn
optional

The CRN of the cluster.

string

datalakeCrn
optional

The CRN of the attached datalake.

string

environmentCrn
optional

The CRN of the environment.

string

imageDetails
optional

The image details.

nodeCount
optional

The cluster node count.

integer (int32)

workloadType
optional

The workload type for the cluster.

string

CreateDataShareRequest

Create Data Share request.

Name Description Schema

assets
required

List of assets to be included in the Data Share.

< AssetRequest > array

dataShareName
required

The name of the Data Share to be created (Max length is 512 characters).
Maximal length : 512

string

datalakeCrn
required

The CRN of the Data Lake where the Data Share will be created.

string

environmentCrn
required

The CRN of the Environment where the Data Share will be created.

string

expiryTime
optional

The date and time when the Data Share will expire.

string (date-time)

externalUsers
optional

List of external users to be granted access to the Data Share.

keywords
optional

List of keywords associated with the Data Share.

< string > array

summary
optional

A brief summary of the Data Share.

string

termsOfUse
optional

The terms of use for the Data Share.

string

CreateDataShareResponse

Response of the Create Data Share operation.

Name Description Schema

dataShareId
optional

The unique identifier of the created Data Share.

string

dataShareName
optional

The name of the created Data Share.

string

datalakeCrn
optional

The CRN of the Data Lake where the Data Share was created.

string

CreateExternalUser

Details of an External user.

Name Description Schema

companyName
required

The company name of the External user.

string

email
required

The email address of the External user.

string

username
required

The username of the External user.

string

CreateExternalUsersRequest

Create external users request.

Name Description Schema

datalakeCrn
required

The CRN of the Data lake where the external users will be created.

string

environmentCrn
required

The CRN of the Environment where the external users will be created.

string

externalUsers
required

List of external users to be created.

< CreateExternalUser > array

CreateExternalUsersResponse

Response of the Create external users operation.

Name Description Schema

externalUsers
optional

List of external users created.

< ExternalUser > array

DataShareExternalUser

Details of an external user with access to a Data Share.

Name Description Schema

clientId
optional

The Client ID of the external user that will be used for authentication.

string

companyName
optional

The company name of the external user.

string

permissions
optional

List of permissions granted to the external user for the Data Share.

< string > array

sharedOn
optional

The date and time when the Data Share was shared with the external user.

string (date-time)

userId
optional

The unique identifier of the external user.

integer (int64)

username
optional

The username of the external user.

string

validTill
optional

The date and time when the access of Data Share will expire for the external user.

string (date-time)

DataShareResponse

Data Share response.

Name Description Schema

createdAt
optional

The date and time when the Data Share was created.

string (date-time)

createdBy
optional

The CDP user who created the Data Share.

string

dataShareId
optional

The unique identifier of the Data Share.

string

dataShareName
optional

The name of the Data Share.

string

expiryTime
optional

The date and time when the Data Share will expire.

string (date-time)

isShared
optional

Indicates whether the Data Share is in Shared state or not.

boolean

keywords
optional

List of keywords associated with the Data Share.

< string > array

DeleteDataShareRequest

Delete Data Share request.

Name Description Schema

dataShareId
required

The unique identifier of the Data Share to be deleted.

string

datalakeCrn
required

The CRN of the Data Lake where the Data Share is located.

string

environmentCrn
required

The CRN of the Environment where the Data Share is located.

string

DeleteDataShareResponse

Response of the Delete Data Share operation.

Type : object

DeleteExternalUserRequest

Delete external user request.

Name Description Schema

datalakeCrn
required

The CRN of the Data Lake where the external user will be deleted.

string

environmentCrn
required

The CRN of the Environment where the external user will be deleted.

string

externalUserId
required

The unique identifier of the external user to be deleted.

integer (int64)

DeleteExternalUserResponse

Response of the Delete external user operation.

Name Description Schema

success
optional

Indicates whether the external user was successfully deleted.

boolean

Error

An object returned on an error.

Name Description Schema

code
optional

The error code.

string

message
optional

The error message.

string

ExternalUser

Details of an External user.

Name Description Schema

clientId
optional

The Client ID of the external user that will be used for authentication.

string

companyName
optional

The company name of the external user.

string

createdAt
optional

The date and time when the external user was created.

string (date-time)

email
optional

The email address of the external user.

string

error
optional

Error message if any occurred during the creation of the external user.

string

expiryTime
optional

The date and time when the external user will expire.

string (date-time)

secret
optional

The Secret of the external user that will be used for authentication to external services.

string

userId
optional

The unique identifier of the external user.

integer (int64)

username
optional

The username of the external user.

string

ExternalUserAccessUpdate

Specifies the updated access expiration time for an external user on a specific Data Share.

Name Description Schema

expiryTime
optional

The date and time when the access of Data Share will expire for the external user.

string (date-time)

externalUserId
optional

The unique identifier of the external user.

integer (int64)

ExternalUserListItem

Details of an external user in a list response.

Name Description Schema

clientId
optional

The Client ID of the external user that will be used for authentication.

string

companyName
optional

The company name of the external user.

string

createdAt
optional

The date and time when the external user was created.

string (date-time)

email
optional

The email address of the external user.

string

isActive
optional

Indicates whether the external user’s credentials are revoked or not.

boolean

userId
optional

The unique identifier of the external user.

integer (int64)

username
optional

The username of the external user.

string

GetDataShareRequest

Get Data Share request.

Name Description Schema

dataShareId
required

The unique identifier of the Data Share to be retrieved.

string

datalakeCrn
required

The CRN of the Data Lake where the Data Share is located.

string

environmentCrn
required

The CRN of the Environment where the Data Share is located.

string

GetDataShareResponse

Response of the Get Data Share operation.

Name Description Schema

assets
optional

List of assets included in the Data Share.

< AssetResponse > array

createdAt
optional

The date and time when the Data Share was created.

string (date-time)

createdBy
optional

The CDP user who created the Data Share.

string

dataShareId
optional

The unique identifier of the Data Share.

string

dataShareName
optional

The name of the Data Share.

string

expiryTime
optional

The date and time when the Data Share will expire.

string (date-time)

externalUsers
optional

List of external users granted access to the Data Share.

isShared
optional

Indicates whether the Data Share is in Shared state or not.

boolean

keywords
optional

List of keywords associated with the Data Share.

< string > array

summary
optional

A brief summary of the Data Share.

string

tags
optional

List of the Atlas tags associated with the Data Share.

< string > array

termsOfUse
optional

The terms of use for the Data Share.

string

updatedAt
optional

The date and time when the Data Share was last updated.

string (date-time)

GetSuggestedTagsRequest

Get the tags suggested by the Data Compliance Profiler.

Name Description Schema

columnFQN
optional

The fully qualified name of the column.

string

datalakeCrn
required

The CRN of the Datalake.

string

profiledSince
optional

Tags suggested by the profiler since this date.

string (date-time)

tableFQN
optional

The fully qualified name of the table.

string

GetSuggestedTagsResponse

Tags suggested by the Data Compliance Profiler.

Name Description Schema

suggestedTags
optional

List of suggested tags.

< suggestedTags > array

suggestedTags

Name Description Schema

qualifiedName
optional

The fully qualified name of the asset.

string

tags
optional

List of suggested tags.

< string > array

GrantAccessToExternalUsersOnDataShareRequest

Grant access to external users on Data Share request.

Name Description Schema

dataShareId
required

The unique identifier of the Data Share for which external user access will be updated.

string

datalakeCrn
required

The CRN of the Data Lake where the Data Share is located.

string

environmentCrn
required

The CRN of the Environment where the Data Share is located.

string

externalUsers
required

List of external users with updated access permissions.

GrantAccessToExternalUsersOnDataShareResponse

Response of the Grant access to external users on Data Share operation.

Type : object

ImageDetails

The details of the image used for cluster instances.

Name Description Schema

catalogName
optional

The image catalog name.

string

catalogUrl
optional

The image catalog URL.

string

id
optional

The ID of the image used for cluster instances. This is internally generated by the cloud provider to uniquely identify the image.

string

name
optional

The name of the image used for cluster instances.

string

LaunchProfilersRequest

Launch Profilers request.

Name Description Schema

datalake
required

The CRN of the Datalake.

string

enableHA
optional

Enables High Availability (HA) for datacatalog profilers (default value is false). The High Availability (HA) Profiler cluster provides failure resilience and scalability but incurs additional cost.

boolean

instanceTypes
optional

List of instance types to be used for the auto-scaling node group setup (Applicable only for compute cluster enabled environments).

< string > array

maxNodes
optional

Maximum number of nodes that can be spawned inside the auto-scaling node group, in the range of 30 to 100 (both inclusive). (Applicable only for compute cluster enabled environments).

integer (int64)

profilers
optional

List of profiler names that need to be launched. (Applicable only for compute cluster enabled environments).

< string > array

LaunchProfilersResponse

Profiler launch operation response.

Name Description Schema

datahubCluster
optional

Datahub cluster details.

ListDataSharesRequest

List Data Shares request.

Name Description Schema

datalakeCrn
required

The CRN of the Data Lake where the Data Share is located.

string

environmentCrn
required

The CRN of the Environment where the Data Share is located.

string

name
optional

The name of the Data Share.

string

pageSize
optional

The size of each page.
Minimum value : 1
Maximum value : 100

integer (int32)

startingToken
optional

A token to specify where to start paginating. This is the nextToken from a previously truncated response.

string

ListDataSharesResponse

List Data Shares response.

Name Description Schema

dataShares
optional

List of Data Shares.

< DataShareResponse > array

nextToken
optional

The token to use when requesting the next set of results. If there are no additional results, the string is empty.

string

ListExternalUsersRequest

List external users request.

Name Description Schema

datalakeCrn
required

The CRN of the Data Lake where the external users need to be listed.

string

environmentCrn
required

The CRN of the Environment where the external users need to be listed.

string

pageSize
optional

The size of each page.
Minimum value : 1
Maximum value : 100

integer (int32)

searchTerm
optional

A search term to filter the external users by username or email or companyName.

string

startingToken
optional

A token to specify where to start paginating. This is the nextToken from a previously truncated response.

string

ListExternalUsersResponse

Response of the List external users operation.

Name Description Schema

externalUsers
optional

List of external users.

nextToken
optional

The token to use when requesting the next set of results. If there are no additional results, the string is empty.

string

RegenerateExternalUserCredentialsRequest

Regenerate external user credentials request.

Name Description Schema

datalakeCrn
required

The CRN of the Data Lake where the external user credentials will be regenerated.

string

environmentCrn
required

The CRN of the Environment where the external user credentials will be regenerated.

string

externalUserId
required

The unique identifier of the external user whose credentials are to be regenerated.

integer (int64)

RegenerateExternalUserCredentialsResponse

Response of the Regenerate external user credentials operation.

Name Description Schema

externalUser
optional

The external user with regenerated credentials.

RemoveAccessOfExternalUsersOnDataShareRequest

Remove access of external users on Data Share request.

Name Description Schema

dataShareId
required

The unique identifier of the Data Share from which external user access will be removed.

string

datalakeCrn
required

The CRN of the Data Lake where the Data Share is located.

string

environmentCrn
required

The CRN of the Environment where the Data Share is located.

string

externalUserIds
required

List of external user Ids whose access will be removed.

< integer (int64) > array

RemoveAccessOfExternalUsersOnDataShareResponse

Response of the Remove access of external users on Data Share operation.

Type : object

RemoveAssetsFromDataShareRequest

Remove assets from Data Share request.

Name Description Schema

dataShareId
required

The unique identifier of the Data Share from which assets will be removed.

string

datalakeCrn
required

The CRN of the Data Lake where the Data Share is located.

string

environmentCrn
required

The CRN of the Environment where the Data Share is located.

string

resourceIds
required

List of asset resource IDs to be removed from the Data Share.

< string > array

RemoveAssetsFromDataShareResponse

Response of the Remove assets from Data Share operation.

Type : object

ReviewSuggestedTagsRequest

Request to review suggested tags.

Name Description Schema

action
required

Action to be taken on the suggested tags. (ACCEPT, REJECT)

enum (ACCEPT, REJECT)

assets
required

List of assets for which tags are being reviewed.

datalakeCrn
required

The CRN of the Datalake.

string

ReviewSuggestedTagsResponse

Review suggested tags response.

Name Description Schema

reviewedTags
optional

List of reviewed tags.

< reviewedTags > array

reviewedTags

Name Description Schema

qualifiedName
optional

The fully qualified name of the asset.

string

status
optional

The current status of the tags. (ACCEPTED, REJECTED, FAILED)

enum (ACCEPTED, REJECTED, FAILED)

tagsUpdated
optional

List of tags on which have been reviewed.

< string > array

RevokeExternalUserCredentialsRequest

Revoke external user credentials request.

Name Description Schema

datalakeCrn
required

The CRN of the Data Lake where the external user credentials will be revoked.

string

environmentCrn
required

The CRN of the Environment where the external user credentials will be revoked.

string

externalUserId
required

The unique identifier of the external user whose credentials are to be revoked.

integer (int64)

RevokeExternalUserCredentialsResponse

Response of the Revoke external user credentials operation.

Name Description Schema

success
optional

Indicates whether the external user credentials were successfully revoked.

boolean

ShareDataShareRequest

Share the Data Share request.

Name Description Schema

dataShareId
required

The unique identifier of the Data Share to be shared.

string

datalakeCrn
required

The CRN of the Data Lake where the Data Share is located.

string

environmentCrn
required

The CRN of the Environment where the Data Share is located.

string

ShareDataShareResponse

Response of the Share Data Share operation.

Name Description Schema

success
optional

Indicates whether the Data Share was successfully shared with external users.

boolean

UnshareDataShareRequest

Unshare the Data Share request.

Name Description Schema

dataShareId
required

The unique identifier of the Data Share to be shared.

string

datalakeCrn
required

The CRN of the Data Lake where the Data Share is located.

string

environmentCrn
required

The CRN of the Environment where the Data Share is located.

string

UnshareDataShareResponse

Response of the Unshare Data Share operation.

Type : object

UpdateAccessOfExternalUsersOnDataShareRequest

Update access of external users on Data Share request.

Name Description Schema

dataShareId
required

The unique identifier of the Data Share for which external user access will be updated.

string

datalakeCrn
required

The CRN of the Data Lake where the Data Share is located.

string

environmentCrn
required

The CRN of the Environment where the Data Share is located.

string

externalUsers
required

List of external users with updated access permissions.

UpdateAccessOfExternalUsersOnDataShareResponse

Response of the Update access of external users on Data Share operation.

Type : object

UpdateDataShareRequest

Update Data Share request.

Name Description Schema

dataShareId
required

The unique identifier of the Data Share to be updated.

string

dataShareName
optional

The name of the Data Share.

string

datalakeCrn
required

The CRN of the Data Lake where the Data Share is located.

string

environmentCrn
required

The CRN of the Environment where the Data Share is located.

string

expiryTime
optional

The date and time when the Data Share will expire.

string (date-time)

keywords
optional

List of keywords associated with the Data Share.

< string > array

summary
optional

A brief summary of the Data Share.

string

termsOfUse
optional

The terms of use for the Data Share.

string

UpdateDataShareResponse

Response of the Update Data Share operation.

Type : object


Copyright © 2026 Cloudera, Inc. All rights reserved.