Overview

Install and manage Cloudera Machine Learning applications.

Version information

Version : 0.9.109

License information

URI scheme

Schemes : HTTPS

Consumes

  • application/json

Produces

  • application/json

Paths

Backup a workspace.

POST /api/v1/ml/backupWorkspace

Description

Backup a workspace.

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.

Creates a new model registry.

POST /api/v1/ml/createModelRegistry

Description

Create a new model registry by creating a new workspace and install model registry on it.

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.

Create a Cloudera Machine Learning workspace.

POST /api/v1/ml/createWorkspace

Description

Provision a Kubernetes cluster and install the Cloudera Machine Learning application in it.

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.

Deletes a backup snapshot.

POST /api/v1/ml/deleteBackup

Description

Deletes a Cloudera Machine Learning workspace backup.

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.

Deletes an instance group from the cluster.

POST /api/v1/ml/deleteInstanceGroup

Description

Deletes an instance group from a Cloudera Machine Learning workspace.

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.

Deletes a model registry.

POST /api/v1/ml/deleteModelRegistry

Description

Delete a model registry.

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.

Delete Cloudera Machine Learning Workspace.

POST /api/v1/ml/deleteWorkspace

Description

Deletes a Cloudera Machine Learning workspace.

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.

Describe Cloudera Machine Learning Model Registry.

POST /api/v1/ml/describeModelRegistry

Description

Describes a Cloudera Machine Learning Model Registry.

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.

Describe Cloudera Machine Learning Workspace.

POST /api/v1/ml/describeWorkspace

Description

Describes a Cloudera Machine Learning workspace.

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.

Gets all the events belong to a workspace crn.

POST /api/v1/ml/getAuditEvents

Description

Gets all the events belong to a workspace crn.

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.

ListWorkspaceAccess Cloudera Machine Learning Workspace.

POST /api/v1/ml/getKubeconfig

Description

Lists users that can perform Kubernetes operations on a Cloudera Machine Learning workspace via EKS.

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.

GetLatestWorkspaceVersion Cloudera Machine Learning Workspace.

POST /api/v1/ml/getLatestWorkspaceVersion

Description

Retrieves the latest version that Cloudera Machine Learning deploys to workspaces.

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.

Gets all the logs belong to a request id.

POST /api/v1/ml/getLogs

Description

Gets all the logs belong to a request id.

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.

GetModelRegistryKubeconfig returns kube config for model registry.

POST /api/v1/ml/getModelRegistryKubeconfig

Description

Gets the Kubeconfig of the model registry cluster.

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.

GrantModelRegistryAccess Cloudera Machine Learning Model Registry.

POST /api/v1/ml/grantModelRegistryAccess

Description

Grants an AWS user to perform Kubernetes operations on a Cloudera Machine Learning model registry via EKS.

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.

GrantWorkspaceAccess Cloudera Machine Learning Workspace.

POST /api/v1/ml/grantWorkspaceAccess

Description

Grants an AWS user to perform Kubernetes operations on a Cloudera Machine Learning workspace via EKS.

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.

Lists all model registries.

POST /api/v1/ml/listModelRegistries

Description

List all model registries.

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.

ListWorkspaceAccess Cloudera Machine Learning Model Registry.

POST /api/v1/ml/listModelRegistryAccess

Description

Lists users that can perform Kubernetes operations on a Cloudera Machine Learning model registry via EKS.

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.

ListWorkspaceAccess Cloudera Machine Learning Workspace.

POST /api/v1/ml/listWorkspaceAccess

Description

Lists users that can perform Kubernetes operations on a Cloudera Machine Learning workspace via EKS.

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 backup snapshots of a workspace.

POST /api/v1/ml/listWorkspaceBackups

Description

List backup snapshots of a workspace.

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 Cloudera Machine Learning workspaces.

POST /api/v1/ml/listWorkspaces

Description

List Cloudera Machine Learning workspaces.

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.

Modify Cloudera Machine Learning workspace cluster instance group.

POST /api/v1/ml/modifyClusterInstanceGroup

Description

Modify a Cloudera Machine Learning workspace cluster instance group.

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.

Modify Cloudera Machine Learning workspace cluster security.

POST /api/v1/ml/modifyClusterSecurity

Description

Modify a Cloudera Machine Learning workspace cluster security.

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.

Modify Cloudera Machine Learning workspace loadbalancer.

POST /api/v1/ml/modifyWorkspaceLoadBalancer

Description

Modify a Cloudera Machine Learning workspace loadbalancer.

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.

Refreshes the model registry configmap of the workspace.

POST /api/v1/ml/refreshModelRegistryConfigmap

Description

Refreshes the model registry configmap of the workspace from the control plane.

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.

Request a workflow cancellation.

POST /api/v1/ml/requestWorkflowCancellation

Description

Request a long running workflow cancellation by resource ID and workflow type.

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.

Restore a Cloudera Machine Learning workspace.

POST /api/v1/ml/restoreWorkspace

Description

Create a new workspace based on an existing workspace backup snapshot.

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.

Resume Cloudera Machine Learning workspace.

POST /api/v1/ml/resumeWorkspace

Description

Resume a Cloudera Machine Learnings workspace.

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.

RevokeModelRegistryAccess Cloudera Machine Learning Model Registry.

POST /api/v1/ml/revokeModelRegistryAccess

Description

Revokes an AWS user to perform Kubernetes operations on a Cloudera Machine Learning model registry via EKS.

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.

RevokeWorkspaceAccess Cloudera Machine Learning Workspace.

POST /api/v1/ml/revokeWorkspaceAccess

Description

Revokes an AWS user to perform Kubernetes operations on a Cloudera Machine Learning workspace via EKS.

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.

Suspend Cloudera Machine Learning workspace.

POST /api/v1/ml/suspendWorkspace

Description

Suspend a Cloudera Machine Learning workspace.

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.

Upgrade Cloudera Machine Learning workspace.

POST /api/v1/ml/upgradeWorkspace

Description

Upgrades a Cloudera Machine Learning workspace to the latest available version.

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.

Definitions

AuditEvent

Audit event descibes an performed or performing in a given workspace.

Name Description Schema

action
required

Action the user has generated.

string

createdDate
required

Time at creation of event.

string (date-time)

requestID
required

Unique request ID to keep track of event.

string

userCrn
required

UserCrn to track which user has caused the event.

string

workspaceCrn
required

Workspace crn where the event observed.

string

AuditEvents

AuditEvents contains all the audit events for a given workspace crn.

Name Description Schema

events
required

AuditEvent belong to the workspace crn.

< AuditEvent > array

workspaceCrn
required

Workspace crn unique for the set of audit events.

string

AuditLog

Audit log represents an individual log.

Name Description Schema

createdDate
required

Time at which the log is created.

string (date-time)

log
required

Log description.

string

AuditLogs

AuditLogs contains all the logs for a given request id.

Name Description Schema

count
required

Total number of logs associated with the request id.

integer (int32)

logs
required

Contains all the logs for a given request id.

< AuditLog > array

requestID
required

The request ID associated with a long-running operation to fetch the logs for.

string

Autoscaling

Configuration for instance auto scaling.

Name Description Schema

enabled
optional

The boolean flag to enable the auto scaling.

boolean

maxInstances
required

The maximum number of instance for auto scaling.

integer (int32)

minInstances
required

The minimum number of instance for auto scaling.

integer (int32)

BackupDetail

Backup Detail response object for listing backups.

Name Description Schema

backupCrn
optional

The CRN of the backup snapshot.

string

backupName
optional

The name of the backup snapshot.

string

backupStatus
optional

The status of the backup.

string

createdAt
optional

The creation time of the backup snapshot.

string (date-time)

creatorCrn
optional

The CRN of the creator.

string

workspaceVersionAtBackup
optional

The version of the backed-up workspace at the time of backup.

string

BackupMetadata

Backup metadata response object for the workspace summary.

Name Description Schema

backupVaultName
optional

The backup vault name.

string

isSuccessfulBackupAvailable
optional

Whether successful backups are available for the workspace.

boolean

lastBackupStatus
optional

The status of the last backup initiated.

string

lastSuccessfulBackupTime
optional

The time when the last successful backup was taken.

string (date-time)

numberOfAvailableBackups
optional

The number of backups available.

integer (int64)

BackupWorkspaceRequest

The request object for workspace backup.

Name Description Schema

backupJobTimeoutMinutes
optional

The timeout(in minutes) to use for the execution of the backup jobs.

integer (int32)

backupName
required

Backup name.

string

skipValidation
optional

Skip pre-flight validations if requested.

boolean

workspaceCrn
required

CRN of the workspace to backup.

string

BackupWorkspaceResponse

The response object for workspace backup.

Name Description Schema

backupCrn
optional

CRN of the backup generated.

string

vaultName
optional

Name of the vault where backup related volumes are stored.

string

CreateModelRegistryRequest

Request object for creating model registry.

Name Description Schema

backupCrn
optional

The CRN of the backup that this model registry is created from.

string

creatorCrn
optional

The creator of model registry.

string

environmentCrn
optional

The environment CRN of model registry.

string

environmentName
optional

The environment for the model registry to create.

string

namespace
optional

The namespace of the model registry.

string

outboundTypes
optional

Outbound Types provided for the cluster.

< OutboundTypes > array

privateCluster
optional

Whether to create a private cluster.

boolean

provisionK8sRequest
optional

The request for Kubernetes cluster provision. Required in public cloud.

s3AccessKey
optional

The S3 access key of Ozone.

string

s3Bucket
optional

The s3Bucket of Ozone.

string

s3Endpoint
optional

The endpoint of Ozone.

string

s3SecretKey
optional

The S3 secret key of Ozone.

string

skipValidation
optional

Skip pre-flight validations if requested.

boolean

subnetsForLoadBalancers
optional

The list of subnets used for the load balancer that CML creates.

< string > array

usePublicLoadBalancer
optional

The boolean flag to request a public load balancer. By default, a private load balancer is used.

boolean

CreateModelRegistryResponse

Response for creating model registry request.

Type : object

CreateWorkspaceRequest

Request object for the CreateWorkspace method.

Name Description Schema

authorizedIPRanges
optional

The whitelist of CIDR blocks which can access the API server.

< string > array

cdswMigrationMode
optional

Toggle for cdsw migration preflight validation

string

disableTLS
optional

The boolean flag to disable TLS setup for workspace. By default, the TLS is enabled.

boolean

enableGovernance
optional

Enables Cloudera Machine Learning governance by integrating with Cloudera Atlas. By default, this flag is disabled.

boolean

enableModelMetrics
optional

Enables the model metrics service for exporting metrics for models to a metrics store.

boolean

enableMonitoring
optional

The boolean flag is used to enable monitoring. By default, monitoring is disabled.

boolean

environmentName
required

The environment for the workspace to create.

string

existingDatabaseConfig
optional

Optional configurations for an existing Postgres to export model metrics to.

existingNFS
optional

Optionally use an existing NFS by providing the hostname and desired path (Azure and Private Cloud only).

string

loadBalancerIPWhitelists
optional

The whitelist of IPs for load balancer.

< string > array

mlVersion
optional

The version of ML workload app to install.

string

nfsVersion
optional

The NFS Protocol version of the NFS server we are using for Azure and Private Cloud.

string

outboundTypes
optional

Outbound Types provided for the workspace.

< OutboundTypes > array

privateCluster
optional

Whether to create a private cluster.

boolean

provisionK8sRequest
optional

The request for Kubernetes workspace provision. Required in public cloud.

skipValidation
optional

Skip pre-flight validations if requested

boolean

staticSubdomain
optional

The static subdomain to be used for the workspace.

string

subnetsForLoadBalancers
optional

The list of subnets used for the load balancer that CML creates.

< string > array

usePublicLoadBalancer
optional

The boolean flag to request public load balancer. By default, private load balancer is used.

boolean

whitelistAuthorizedIPRanges
optional

Whether to whitelist only 'authorizedIPRanges' given or all public IPs.

boolean

workspaceName
required

The name of the workspace to create.

string

CreateWorkspaceResponse

Response object for the CreateWorkspace method.

Type : object

DeleteBackupRequest

The request object for DeleteBackup operation.

Name Description Schema

backupCrn
required

The CRN of the backup to be deleted.

string

skipValidation
optional

Skip pre-flight validations if requested.

boolean

DeleteBackupResponse

The response object for DeleteBackup operation.

Name Description Schema

workflowId
optional

The ID of the delete-backup workflow.

string

DeleteInstanceGroupRequest

Request object for the DeleteInstanceGroup method.

Name Description Schema

instanceGroupName
required

The instance group that we want to delete from the workspace.

string

workspaceCrn
required

The CRN of the workspace from which instance group is to be deleted.

string

DeleteInstanceGroupResponse

Response object for the DeleteInstanceGroup method.

Type : object

DeleteModelRegistryRequest

Request for deleting model registry.

Name Description Schema

force
optional

Force delete a model registry workspace even if errors occur during deletion. Force delete removes the guarantee that resources in your cloud account will be cleaned up. By default, force is set to false.

boolean

id
optional

Deprecated, please use modelRegistryCrn. The environment CRN of the model registry.

string

modelRegistryCrn
optional

CRN of the model registry to be deleted.

string

workspaceCrn
optional

Deprecated. The workspace CRN of the model registry (Public cloud only).

string

DeleteModelRegistryResponse

Delete model registry response.

Type : object

DeleteWorkspaceRequest

Request object for the DeleteWorkspace method.

Name Description Schema

environmentName
optional

The environment for the workspace to delete.

string

force
required

Force delete a workspace even if errors occur during deletion. Force delete removes the guarantee that resources in your cloud account will be cleaned up.

boolean

removeStorage
optional

The remove storage flag indicates weather to keep the backing workspace filesystem storage or remove it during delete.

boolean

workspaceCrn
optional

The CRN of the workspace to delete. If CRN is specified only the CRN is used for identifying the workspace, environment and name arguments are ignored.

string

workspaceName
optional

The name of the workspace to delete.

string

DeleteWorkspaceResponse

Response object for the DeleteWorkspace method.

Type : object

DescribeModelRegistryRequest

Request object for the DescribeModelRegistry method.

Name Description Schema

modelRegistryCrn
required

The CRN of the Model Registry to describe.

string

DescribeModelRegistryResponse

Response object for the DescribeModelRegistry method.

Name Description Schema

modelRegistry
required

The workspace.

DescribeWorkspaceRequest

Request object for the DescribeWorkspace method.

Name Description Schema

environmentName
optional

The environment for the workspace to describe.

string

workspaceCrn
optional

The CRN of the workspace to describe. If CRN is specified only the CRN is used for identifying the workspace, environment and name arguments are ignored.

string

workspaceName
optional

The name of the workspace to describe.

string

DescribeWorkspaceResponse

Response object for the DescribeWorkspace method.

Name Description Schema

workspace
required

The workspace.

Error

An object returned on an error.

Name Description Schema

code
optional

The error code.

string

message
optional

The error message.

string

ExistingDatabaseConfig

Configurations for bringing an existing database for model metrics

Name Description Schema

existingDatabaseHost
optional

Optionally provide a Postgresql database host to export model metrics to.

string

existingDatabaseName
optional

Optionally provide a Postgresql database name to export model metrics to.

string

existingDatabasePassword
optional

Optionally provide a Postgresql database password to use when exporting model metrics.

string

existingDatabasePort
optional

Optionally provide a Postgresql database port to export model metrics to.

string

existingDatabaseUser
optional

Optionally provide a Postgresql database user to use when exporting model metrics.

string

GetAuditEventsRequest

GetAuditEventsRequest to get all audit events for a given workspace crn.

Name Description Schema

resourceCrn
optional

Resource crn for which audit events to be fetched. Resource can be workspace or model registry.

string

workspaceCrn
optional

Deprecated, please begin to use Resource crn, as this will soon be unsupported.

string

GetAuditEventsResponse

GetAuditEventsResponse containes all the audit events for a given workspace crn.

Name Description Schema

auditEvents
required

Contains all the audit events for a given workspace crn.

GetKubeconfigRequest

Request object for the GetKubeconfig method.

Name Description Schema

environmentName
optional

The environment that the workspace is a member of.

string

workspaceCrn
optional

The CRN of the workspace to list access.

string

workspaceName
optional

The name of the workspace to list access.

string

GetKubeconfigResponse

Response object for the GetKubeconfig method.

Name Description Schema

kubeconfig
required

The list of users that have access.

string

GetLatestWorkspaceVersionRequest

Request object for GetLatestWorkspaceVersion.

Type : object

GetLatestWorkspaceVersionResponse

Response object for GetLatestWorkspaceVersion.

Name Description Schema

version
required

The latest version of a workspace that is used when deploying Cloudera Machine Learning workspaces.

string

GetLogsRequest

GetLogsRequest for getting logs for a request ID.

Name Description Schema

fetchAll
optional

Flag to fetch all logs.

boolean

offset
optional

offset from which the logs should be fetched.

integer (int32)

pageSize
optional

Limit the number of logs.

integer (int32)

requestID
required

Unique Key to identify a set of logs.

string

workspaceCrn
optional

Deprecated. Please begin to use resourceCrn, as this will soon be unsupported

string

GetLogsResponse

GetLogsResponse contains all the logs for a given request id.

Name Description Schema

auditLogs
required

Contains all the logs for a given request id.

GetModelRegistryKubeconfigRequest

Request object for GetModelRegistryKubeconfig.

Name Description Schema

modelRegistryCrn
optional

CRN of the Model Registry

string

GetModelRegistryKubeconfigResponse

GetModelRegistryKubeconfigResponse response provides model registry kube config.

Name Description Schema

kubeConfig
optional

KubeConfig of the model registry cluster

string

GrantModelRegistryAccessRequest

Request object for the GrantModelRegistryAccess method.

Name Description Schema

identifier
optional

The cloud provider user id, such as ARN, which will be granted access to the model registry’s Kubernetes cluster.

string

resourceCrn
optional

The CRN of the Model Registry to grant access to.

string

GrantModelRegistryAccessResponse

Response object for the GrantModelRegistryAccess method.

Name Description Schema

kubeconfig
required

The Kubernetes config file

string

GrantWorkspaceAccessRequest

Request object for the GrantWorkspaceAccess method.

Name Description Schema

arn
optional

The aws user ARN to grant access to the corresponding EKS cluster. (Deprecated: Use identifier instead).

string

environmentName
optional

The environment that the workspace is a member of.

string

identifier
optional

The cloud provider user id which will be granted access to the workspace’s Kubernetes cluster.

string

workspaceCrn
optional

The CRN of the workspace to grant access to. If CRN is specified only the CRN is used for identifying the workspace, environment and name arguments are ignored.

string

workspaceName
optional

The name of the workspace to grant access to.

string

GrantWorkspaceAccessResponse

Response object for the GrantWorkspaceAccess method.

Name Description Schema

kubeconfig
required

The Kubernetes config file

string

HealthInfo

Healthinfo object contains the health information of a resource.

Name Description Schema

details
required

The detail of the health info.

< string > array

isHealthy
required

The boolean that indicates the health status.

boolean

message
required

The message to show for the health info.

string

resourceName
required

The resource name being checked.

string

updatedAt
required

The timestamp for the heartbeat.

string (date-time)

Instance

Represents each instance in an instance group.

Name Description Schema

availabilityZone
required

Availability zone the instance belongs to.

string

instanceId
required

Unique instance Id generated by the cloud provider.

string

InstanceGroup

Contains the necessary info for an instance group.

Name Description Schema

autoscaling
optional

The auto scaling configuration.

ingressRules
optional

The networking rules for the ingress.

< string > array

instanceCount
optional

The initial number of instance node.

integer (int32)

instanceTier
optional

The tier of the instance i.e. on-demand/spot.

string

instanceType
required

The cloud provider instance type for the node instance.

string

name
optional

The unique name of the instance group.

string

rootVolume
optional

The root volume of the instance.

ListModelRegistriesRequest

Request object for deleting model registry.

Type : object

ListModelRegistriesResponse

List of all available model registries.

Name Description Schema

modelRegistries
optional

The list of model registry.

< ModelRegistry > array

ListModelRegistryAccessRequest

Request object for the ListModelRegistryAccess method.

Name Description Schema

resourceCrn
optional

The CRN of the Model Registry to list access.

string

ListModelRegistryAccessResponse

Response object for the ListModelRegistryAccess method.

Name Description Schema

users
required

The list of users that have access.

< string > array

ListWorkspaceAccessRequest

Request object for the ListWorkspace method.

Name Description Schema

environmentName
optional

The environment that the workspace is a member of.

string

workspaceCrn
optional

The CRN of the workspace to list access. If CRN is specified only the CRN is used for identifying the workspace, environment and name arguments are ignored.

string

workspaceName
optional

The name of the workspace to list access.

string

ListWorkspaceAccessResponse

Response object for the ListWorkspaceAccess method.

Name Description Schema

users
required

The list of users that have access.

< string > array

ListWorkspaceBackupsQueryOptions

Query options object for ListWorkspaceBackups method.

Name Description Schema

expandEnvironmentMetadata
optional

When set to true, will return the metadata of the environment where the backed-up workspace is/was present.

boolean

ListWorkspaceBackupsRequest

Request object for ListWorkspaceBackups method.

Name Description Schema

environmentName
optional

The environment for the workspace to list backups for.

string

queryOptions
optional

Additional query options to enhance/mutate the API response.

workspaceCrn
optional

The CRN of the workspace to list backups for. If this field is specified, environmentName and workspaceName are ignored.

string

workspaceName
optional

The name of the workspace to list backups for.

string

ListWorkspaceBackupsResponse

Response object for ListWorkspaceBackups method.

Name Description Schema

backups
optional

The list of backups along with their details.

< BackupDetail > array

ListWorkspacesRequest

Request object for the ListWorkspaces method.

Name Description Schema

queryOptions
optional

Additional query options.

< string > array

ListWorkspacesResponse

Response object for the ListWorkspaces method.

Name Description Schema

workspaces
optional

The list of workspaces.

< WorkspaceSummary > array

ModelRegistry

Model registry object

Name Description Schema

createdAt
optional

The creation time of model registry.

string (date-time)

creator
optional

The creator of model registry.

string

crn
optional

ModelRegistry CRN.

string

environmentCrn
optional

The environment CRN of model registry.

string

environmentName
optional

Environment name.

string

id
optional

The id of model registry.

integer (int64)

machineUserCrn
optional

The machine user CRN of the model registry.

string

namespace
optional

The namespace of model registry.

string

s3Bucket
optional

The s3 bucket of model registry.

string

s3Endpoint
optional

The Ozone endpoint of model registry.

string

serviceName
optional

The service name of model registry.

string

status
optional

The status of model registry.

string

workspaceCrn
optional

Deprecated. WorkSpace CRN. This field is no longer used.

string

workspaceName
optional

Deprecated, please refer to serviceName. Workspace name.

string

ModelRegistryProvisionK8sRequest

Request object for provisioning model registry.

Name Description Schema

network
optional

The overlay network for an AWS Kubernetes cluster’s CNI.

tags
optional

Tags to add to the cloud provider resources created. This is in addition to any tags added by Cloudera.

< ProvisionTag > array

ModifyClusterInstanceGroupRequest

Request object for ModifyClusterInstanceGroup.

Name Description Schema

instanceGroupName
required

The name of the instance group of the workspace cluster to modify.

string

instanceType
required

The desired instance type of the workspace cluster instance group.

string

max
required

The desired autoscaling min of the workspace cluster instance group.

integer (int32)

min
required

The desired autoscaling min of the workspace cluster instance group.

integer (int32)

workspaceCrn
required

The CRN of the workspace cluster to modify.

string

ModifyClusterInstanceGroupResponse

Response object for ModifyClusterInstanceGroup.

Type : object

ModifyClusterSecurityRequest

Request object for ModifyClusterSecurity.

Name Description Schema

allowlistAuthorizedIPRanges
required

Whether to allow only authorized IP ranges given or all public IPs.

boolean

authorizedIPRanges
required

The allowlist of CIDR blocks which can access the API server.

< string > array

workspaceCrn
required

The CRN of the workspace cluster to modify.

string

ModifyClusterSecurityResponse

Response object for ModifyClusterSecurity.

Type : object

ModifyWorkspaceLoadBalancerRequest

Request object for ModifyWorkspaceLoadBalancer.

Name Description Schema

loadBalancerIPAllowLists
required

The allowlist of CIDR blocks which can access the loadbalancer.

< string > array

workspaceCrn
required

The CRN of the workspace cluster to modify.

string

ModifyWorkspaceLoadBalancerResponse

Response object for ModifyWorkspaceLoadBalancer.

Type : object

OutboundTypes

List of possible Outbound types.

Type : enum (UNKNOWN, OUTBOUND_TYPE_UDR)

OverlayNetwork

Contains the information about overlay network.

Name Description Schema

plugin
optional

The plugin specifies specific cni vendor, ex: calico, weave etc.

string

topology
optional

The options for overlay topology.

ProvisionK8sRequest

Request object for workspace provision.

Name Description Schema

environmentName
required

The name of the environment for the workspace to create.

string

instanceGroups
required

The instance groups.

< InstanceGroup > array

network
optional

The overlay network for an AWS Kubernetes cluster’s CNI.

tags
optional

Tags to add to the cloud provider resources created. This is in addition to any tags added by Cloudera.

< ProvisionTag > array

ProvisionTag

Contains a single tag entry that will be configured on cloud resources associated with a workspace.

Name Description Schema

key
required

The name for the tag.

string

value
required

The value for the tag.

string

RefreshModelRegistryConfigmapRequest

Request for refreshing workspace’s model registry configmap.

Name Description Schema

workspaceCrn
optional

Workspace CRN.

string

RefreshModelRegistryConfigmapResponse

Response for refreshing workspace’s model registry configmap.

Type : object

RequestWorkflowCancellationRequest

Request object for RequestWorkflowCancellation.

Name Description Schema

resourceId
optional

The unique identifier of the resource.

string

workflowType
optional

The workflow type.

string

RequestWorkflowCancellationResponse

Response object for RequestWorkflowCancellation.

Name Description Schema

workflowMetadata
optional

The list of workflow metedata for cancelled workflows.

< WorkflowMetadata > array

RestoreWorkspaceRequest

Request object for RestoreWorkspace method.

Name Description Schema

backupCrn
optional

The CRN of the backup snapshot to used for restoring.

string

newWorkspaceParameters
optional

The parameters required for a new Cloudera Machine Learning workspace.

restoreJobTimeoutMinutes
optional

The timeout to restore the backup snapshots, in minutes.

integer (int32)

useStaticSubdomain
optional

A boolean value to check if subdomain must be used or not.

boolean

RestoreWorkspaceResponse

Response object for the RestoreWorkspace method.

Name Description Schema

workspaceCrn
optional

The CRN of the Cloudera Machine Learning workspace being provisioned.

string

ResumeWorkspaceRequest

Request object for ResumeWorkspace.

Name Description Schema

workspaceCrn
required

The CRN of the workspace to resume.

string

ResumeWorkspaceResponse

Response object for ResumeWorkspace.

Type : object

RevokeModelRegistryAccessRequest

Request object for the RevokeModelRegistry method.

Name Description Schema

identifier
optional

The cloud provider user id, such as ARN, which will be granted access to the model registry’s Kubernetes cluster.

string

resourceCrn
optional

The CRN of the Model Registry to grant access to.

string

RevokeModelRegistryAccessResponse

Response object for the RevokeModelRegistryAccess method.

Type : object

RevokeWorkspaceAccessRequest

Request object for the RevokeWorkspace method.

Name Description Schema

arn
optional

The aws user ARN to revoke access to the corresponding EKS cluster. (Deprecated: Use identifier instead).

string

environmentName
optional

The environment that the workspace is a member of.

string

identifier
optional

The cloud provider user id which will be granted access to the workspace’s Kubernetes cluster.

string

workspaceCrn
optional

The CRN of the workspace to revoke access to. If CRN is specified only the CRN is used for identifying the workspace, environment and name arguments are ignored.

string

workspaceName
optional

The name of the workspace to revoke access to.

string

RevokeWorkspaceAccessResponse

Response object for the RevokeWorkspaceAccess method.

Type : object

RootVolume

Configuration for instance root device volume.

Name Description Schema

size
required

The volume size in GB.

integer (int64)

SuspendWorkspaceRequest

Request object for SuspendWorkspace.

Name Description Schema

workspaceCrn
required

The CRN of the workspace to suspend.

string

SuspendWorkspaceResponse

Response object for SuspendWorkspace.

Type : object

Tag

Contains a single tag entry associated with a workspace.

Name Description Schema

key
required

The name for the tag.

string

value
required

The value for the tag.

string

Topology

Contains the information about topology.

Name Description Schema

subnets
optional

The options for subnets.

< string > array

UpgradeState

Response object for the workspace summary.

Name Description Schema

reason
optional

The reason for the current state.

string

state
optional

The current upgrade state of the workspace.

string

UpgradeWorkspaceRequest

Request object for the UpgradeWorkspace method.

Name Description Schema

environmentName
optional

The environment of the workspace.

string

mlVersion
optional

The version of workspace to upgrade to.

string

workspaceCrn
optional

The CRN of the workspace. If CRN is specified only the CRN is used for identifying the workspace, environment and name arguments are ignored.

string

workspaceName
optional

The name of the workspace.

string

UpgradeWorkspaceResponse

Response object for the UpgradeWorkspace method.

Type : object

WorkflowMetadata

The workflow metadata.

Name Description Schema

lastKnownStatus
optional

The last known status of the workflow.

string

resourceId
optional

The unique identifier of the resource.

string

workflowId
optional

The workflow identifier.

string

workflowIndex
optional

The workflow index. Monotonically increases for each subsequent workflow for a resource.

integer (int64)

workflowType
optional

The workflow type.

string

Workspace

A ML workspace, which includes the cluster and storage.

Name Description Schema

authorizedIPRanges
optional

The whitelist of CIDR blocks which can access the API server.

< string > array

backupMetadata
optional

The Backup MetaData for this Workspace

cloudPlatform
required

The cloud platform of the environment that was used to create this workspace.

string

clusterBaseDomain
optional

The basedomain of the cluster.

string

clusterID
optional

The Cluster ID for the workspace.

string

creationDate
optional

Creation date of workspace.

string (date-time)

creatorCrn
required

The CRN of the creator of the workspace.

string

crn
required

The CRN of the workspace.

string

endpointPublicAccess
required

To check if the cluster is publicly accessible or not.

boolean

environmentCrn
required

CRN of the environment.

string

environmentName
required

The name of the workspace’s environment.

string

failureMessage
optional

Failure message from the most recent failure that has occurred during workspace provisioning.

string

filesystemID
required

filesystemID used by the workspace

string

governanceEnabled
optional

Whether governance is enabled.

boolean

healthInfoLists
optional

The health info information of the workspace.

< HealthInfo > array

httpsEnabled
required

To Display if Https is enabled or not.

boolean

instanceGroups
required

The instance groups.

instanceName
required

The name of the workspace.

string

instanceStatus
required

The workspace’s current status.

string

instanceUrl
required

URL of the workspace’s user interface.

string

isPrivate
optional

The value to indicate if the cluster is private or not.

boolean

isRestored
optional

The value to indicate if the workspace is restored one or not

boolean

k8sClusterName
required

The Kubernetes cluster name.

string

loadBalancerIPWhitelists
optional

IP whitelist for loadBalancer.

< string > array

modelMetricsEnabled
optional

Whether model metrics is enabled.

boolean

monitoringEnabled
required

If usage monitoring is enabled or not on this workspace.

boolean

nfsVersion
optional

NFS Version of the filesystem.

string

subnets
optional

The subnets of the workspace.

< string > array

subnetsForLoadBalancers
optional

The list of subnets used for the load balancer that CML creates.

< string > array

tags
required

Tags provided by the user at the time of workspace creation.

< Tag > array

upgradeState
optional

The upgrade state contains the workspace upgrade information.

version
required

The version of Cloudera Machine Learning that was installed on the workspace.

string

whitelistAuthorizedIPRanges
optional

Whether to whitelist only 'authorizedIPRanges' given or all public IPs.

boolean

WorkspaceInstanceGroup

Instance group information to show in workspace details.

Name Description Schema

instanceCount
required

The initial number of instance node.

integer (int32)

instanceGroupName
required

The unique name of the instance group.

string

instanceType
required

The cloud provider instance type for the node instance.

string

instances
required

Instances in the instance group.

< Instance > array

maxInstances
required

The maximum number of instances that can be deployed to this instance group.

integer (int32)

minInstances
required

The minimum number of instances that can be deployed to this instance group. If the value is 0, the group might be empty.

integer (int32)

tags
required

Tags are key/value pairs that are applied to all tag-able resources deployed in the workspace’s cloud environment.

< Tag > array

WorkspaceSummary

A Cloudera Machine Learning workspace which includes the deployed configuration details.

Name Description Schema

backupMetadata
optional

The Backup Metadata for the workspace.

cloudPlatform
required

The cloud platform of the environment that was used to create this workspace.

string

clusterID
optional

The Cluster ID for the workspace.

string

creationDate
optional

Creation date of workspace.

string (date-time)

creatorCrn
required

The CRN of the creator of the workspace.

string

crn
required

The CRN of the workspace.

string

environmentCrn
required

CRN of the environment.

string

environmentName
required

The name of the workspace’s environment.

string

failureMessage
optional

Failure message from the most recent failure that has occurred during workspace provisioning.

string

filesystemID
required

A filesystem ID referencing the filesystem that was created on the cloud provider environment that this workspace uses.

string

healthInfoLists
optional

The health info information of the workspace.

< HealthInfo > array

httpsEnabled
required

Indicates if HTTPs communication was enabled on this workspace when provisioned.

boolean

instanceName
required

The name of the workspace.

string

instanceStatus
required

The workspace’s current status.

string

instanceUrl
required

URL of the workspace’s user interface.

string

isPrivate
optional

The value to indicate if the cluster is private or not.

boolean

isRestored
optional

The value to indicate if the workspace is restored one or not

boolean

k8sClusterName
required

The Kubernetes cluster name.

string

loadBalancerIPWhitelists
optional

The whitelist of IPs for load balancer.

< string > array

monitoringEnabled
required

If usage monitoring is enabled or not on this workspace.

boolean

nfsVersion
optional

NFS Version of the filesystem.

string

upgradeState
optional

The upgrade state contains the workspace upgrade information.

version
required

The version of Cloudera Machine Learning that was installed on the workspace.

string


Copyright © 2024 Cloudera, Inc. All rights reserved.