# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Cloudera Data hub Service Datahub API version: 1.0.0 extends: openapi/cloudera-data-hub-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-10-01' generator: build-phrasing.py label: Generated by API Evangelist operations: 75 - target: $.paths['/api/v1/datahub/deleteInstances'].post update: x-apievangelist-phrasing: intent: Delete specific instances from a cluster effect: destructive questions: - Can I remove particular VM instances from a Data Hub cluster by id? - Is there a way to force-delete instances that won't terminate cleanly? instructions: - text: Delete instances {instanceIds} from Data Hub cluster {clusterName}. slots: instanceIds: requestBody.instanceIds clusterName: requestBody.clusterName - text: Force delete instances {instanceIds} on cluster {clusterName}. slots: instanceIds: requestBody.instanceIds clusterName: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/listClusters'].post update: x-apievangelist-phrasing: intent: List Data Hub workload clusters effect: read questions: - Which Data Hub clusters do I have? - Can I list only the workload clusters in one environment? instructions: - text: List all my Data Hub workload clusters. - text: List the Data Hub clusters in environment {environmentName}. slots: environmentName: requestBody.environmentName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/listScalingActivities'].post update: x-apievangelist-phrasing: intent: List scaling activities for a cluster effect: read questions: - What scaling activity has happened on my Data Hub cluster recently? - Can I see only the failed scaling activities within a time window? instructions: - text: List scaling activities for Data Hub cluster {cluster}. slots: cluster: requestBody.cluster - text: List failed scaling activities on {cluster} between {startTime} and {endTime}. slots: cluster: requestBody.cluster startTime: requestBody.startTime endTime: requestBody.endTime method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/describeScalingActivity'].post update: x-apievangelist-phrasing: intent: Get details of one scaling activity effect: read questions: - What happened during a specific scaling operation on my cluster? - Can I look up a scaling activity by its operation id? instructions: - text: Describe scaling activity {operationId} on cluster {cluster}. slots: operationId: requestBody.operationId cluster: requestBody.cluster - text: Show details of the scaling operation {operationId} for Data Hub {cluster}. slots: operationId: requestBody.operationId cluster: requestBody.cluster method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/listClusterLifecycleEvents'].post update: x-apievangelist-phrasing: intent: List lifecycle events of a cluster effect: read questions: - What lifecycle events has my Data Hub cluster gone through? - Can I page through the event history of a workload cluster? instructions: - text: List lifecycle events for Data Hub cluster {cluster}. slots: cluster: requestBody.cluster - text: Show the event history of cluster {cluster}, {pageSize} events per page. slots: cluster: requestBody.cluster pageSize: requestBody.pageSize method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/createAWSCluster'].post update: x-apievangelist-phrasing: intent: Create a Data Hub cluster on AWS effect: write questions: - How do I spin up a new Data Hub cluster on AWS? - Can I enable multi-AZ or a load balancer on an AWS workload cluster? instructions: - text: Create AWS Data Hub cluster {clusterName} in environment {environmentName} from definition {clusterDefinitionName}. slots: clusterName: requestBody.clusterName environmentName: requestBody.environmentName clusterDefinitionName: requestBody.clusterDefinitionName - text: Create AWS cluster {clusterName} in {environmentName} using template {clusterTemplateName} on {architecture} with Java {javaVersion}. slots: clusterName: requestBody.clusterName environmentName: requestBody.environmentName clusterTemplateName: requestBody.clusterTemplateName architecture: requestBody.architecture javaVersion: requestBody.javaVersion method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/createAWSGovCloudCluster'].post update: x-apievangelist-phrasing: intent: Create a Data Hub cluster on AWS GovCloud effect: write questions: - Can I create a Data Hub cluster in AWS GovCloud? - What's needed to launch a GovCloud workload cluster with multi-AZ? instructions: - text: Create GovCloud Data Hub cluster {clusterName} in environment {environment} from definition {clusterDefinition}. slots: clusterName: requestBody.clusterName environment: requestBody.environment clusterDefinition: requestBody.clusterDefinition - text: Launch AWS GovCloud cluster {clusterName} in {environment} with subnets {subnetIds} across multiple AZs. slots: clusterName: requestBody.clusterName environment: requestBody.environment subnetIds: requestBody.subnetIds method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/createAzureCluster'].post update: x-apievangelist-phrasing: intent: Create a Data Hub cluster on Azure effect: write questions: - How do I create a Data Hub cluster in an Azure environment? - Can I choose the load balancer SKU or a flexible server database for an Azure cluster? instructions: - text: Create Azure Data Hub cluster {clusterName} in environment {environmentName} from definition {clusterDefinitionName}. slots: clusterName: requestBody.clusterName environmentName: requestBody.environmentName clusterDefinitionName: requestBody.clusterDefinitionName - text: Create Azure cluster {clusterName} in {environmentName} with load balancer SKU {loadBalancerSku} and database type {databaseType}. slots: clusterName: requestBody.clusterName environmentName: requestBody.environmentName loadBalancerSku: requestBody.loadBalancerSku databaseType: requestBody.databaseType method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/createGCPCluster'].post update: x-apievangelist-phrasing: intent: Create a Data Hub cluster on Google Cloud effect: write questions: - Can I launch a Data Hub workload cluster on GCP? - Which subnet and template settings does a Google Cloud Data Hub cluster take? instructions: - text: Create GCP Data Hub cluster {clusterName} in environment {environmentName} from definition {clusterDefinitionName}. slots: clusterName: requestBody.clusterName environmentName: requestBody.environmentName clusterDefinitionName: requestBody.clusterDefinitionName - text: Create Google Cloud cluster {clusterName} in {environmentName} on subnet {subnetName} using template {clusterTemplateName}. slots: clusterName: requestBody.clusterName environmentName: requestBody.environmentName subnetName: requestBody.subnetName clusterTemplateName: requestBody.clusterTemplateName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/deleteCluster'].post update: x-apievangelist-phrasing: intent: Delete a Data Hub cluster effect: destructive questions: - How do I tear down a Data Hub cluster I no longer need? - Can I force-delete a workload cluster that is stuck? instructions: - text: Delete Data Hub cluster {clusterName}. slots: clusterName: requestBody.clusterName - text: Force delete the workload cluster {clusterName}. slots: clusterName: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/describeCluster'].post update: x-apievangelist-phrasing: intent: Get details of a Data Hub cluster effect: read questions: - What is the configuration and state of one of my Data Hub clusters? - Can I look up a workload cluster's details by name? instructions: - text: Describe Data Hub cluster {clusterName}. slots: clusterName: requestBody.clusterName - text: Show me the full details of workload cluster {clusterName}. slots: clusterName: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/getClusterServiceStatus'].post update: x-apievangelist-phrasing: intent: Check status of services in a cluster effect: read questions: - Are all the services in my Data Hub cluster running? - Which cluster services are unhealthy right now? instructions: - text: Get the service status for Data Hub cluster {clusterName}. slots: clusterName: requestBody.clusterName - text: Check which services are healthy on cluster {clusterName}. slots: clusterName: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/getClusterHostStatus'].post update: x-apievangelist-phrasing: intent: Check status of hosts in a cluster effect: read questions: - Are any hosts in my Data Hub cluster down? - What state is each host in a workload cluster in? instructions: - text: Get the host status for Data Hub cluster {clusterName}. slots: clusterName: requestBody.clusterName - text: Check the health of every host on cluster {clusterName}. slots: clusterName: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/stopCluster'].post update: x-apievangelist-phrasing: intent: Stop a Data Hub cluster effect: write questions: - Can I stop a Data Hub cluster to give its VMs back to the cloud provider? - What happens to the VMs when a workload cluster is stopped? instructions: - text: Stop Data Hub cluster {clusterName}. slots: clusterName: requestBody.clusterName - text: Shut down workload cluster {clusterName} and release its VMs. slots: clusterName: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/startCluster'].post update: x-apievangelist-phrasing: intent: Start a stopped Data Hub cluster effect: write questions: - How do I bring a stopped Data Hub cluster back up? - Will starting a stopped cluster provision new VMs? instructions: - text: Start the stopped Data Hub cluster {clusterName}. slots: clusterName: requestBody.clusterName - text: Bring workload cluster {clusterName} back online. slots: clusterName: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/retryCluster'].post update: x-apievangelist-phrasing: intent: Retry a failed cluster creation effect: write questions: - My Data Hub cluster creation failed — can I resume from the last failed step? - Is there a way to retry provisioning without recreating the whole cluster? instructions: - text: Retry creation of failed Data Hub cluster {clusterName}. slots: clusterName: requestBody.clusterName - text: Resume provisioning of {clusterName} from the last failed step. slots: clusterName: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/renewCertificate'].post update: x-apievangelist-phrasing: intent: Renew a cluster certificate (deprecated) effect: write questions: - Is the older renew-certificate call for Data Hub still available? - Which deprecated endpoint renews a cluster certificate by name? instructions: - text: Renew the certificate on Data Hub {clusterName} using the deprecated renew-certificate call. slots: clusterName: requestBody.clusterName - text: Use the legacy certificate renewal for cluster {clusterName}. slots: clusterName: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/renewPublicCertificate'].post update: x-apievangelist-phrasing: intent: Renew a Data Hub's public certificate effect: write questions: - How do I renew the public TLS certificate on a Data Hub cluster? - My Data Hub's public certificate is about to expire — can I renew it? instructions: - text: Renew the public certificate on Data Hub {datahub}. slots: datahub: requestBody.datahub - text: Refresh the expiring public certificate for {datahub}. slots: datahub: requestBody.datahub method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/repairCluster'].post update: x-apievangelist-phrasing: intent: Repair failed nodes in a cluster effect: write questions: - Can I repair unhealthy nodes in my Data Hub cluster? - Is it possible to repair just one instance group, or only remove the bad nodes? instructions: - text: Repair Data Hub cluster {clusterName}. slots: clusterName: requestBody.clusterName - text: Repair instance groups {instanceGroupNames} on cluster {clusterName}. slots: instanceGroupNames: requestBody.instanceGroupNames clusterName: requestBody.clusterName - text: Repair instances {instances} on {clusterName} by removing them only. slots: instances: requestBody.instances clusterName: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/restartClusterInstances'].post update: x-apievangelist-phrasing: intent: Restart cluster instances on the cloud provider effect: write questions: - Can I reboot specific VMs of a Data Hub cluster? - What's the way to restart instances at the cloud-provider level? instructions: - text: Restart instances {instances} of Data Hub cluster {cluster}. slots: instances: requestBody.instances cluster: requestBody.cluster - text: Reboot VMs {instances} in {cluster} on the cloud provider. slots: instances: requestBody.instances cluster: requestBody.cluster method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/rotateDbCertificate'].post update: x-apievangelist-phrasing: intent: Rotate a Data Hub's database SSL certificate effect: write questions: - How do I rotate the database SSL certificate for a Data Hub? - Can I refresh the SSL cert used by a Data Hub's database? instructions: - text: Rotate the database SSL certificate for Data Hub {datahubName}. slots: datahubName: requestBody.datahubName - text: Refresh the DB SSL cert on {datahubName}. slots: datahubName: requestBody.datahubName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/syncCluster'].post update: x-apievangelist-phrasing: intent: Sync cluster state with cloud and Cloudera Manager effect: write questions: - My cluster state looks out of date — can I resync it with the cloud provider? - Is there a way to reconcile a Data Hub with Cloudera Manager's view? instructions: - text: Sync Data Hub cluster {clusterName} with the cloud provider and Cloudera Manager. slots: clusterName: requestBody.clusterName - text: Reconcile the state of {clusterName}. slots: clusterName: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/scaleCluster'].post update: x-apievangelist-phrasing: intent: Scale nodes in a cluster instance group effect: write questions: - How do I add or remove nodes from a Data Hub instance group? - Can I prefer certain subnets or zones when scaling out? instructions: - text: Scale instance group {instanceGroupName} on cluster {clusterName} to {instanceGroupDesiredCount} nodes. slots: instanceGroupName: requestBody.instanceGroupName clusterName: requestBody.clusterName instanceGroupDesiredCount: requestBody.instanceGroupDesiredCount - text: Resize {instanceGroupName} in {clusterName} to {instanceGroupDesiredCount} nodes, preferring zones {preferredZones}. slots: instanceGroupName: requestBody.instanceGroupName clusterName: requestBody.clusterName instanceGroupDesiredCount: requestBody.instanceGroupDesiredCount preferredZones: requestBody.preferredZones method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/listRecipes'].post update: x-apievangelist-phrasing: intent: List cluster recipes effect: read questions: - What recipe scripts have been registered for Data Hub clusters? - Which recipes are available to run on instance groups? instructions: - text: List all Data Hub recipes. - text: Show me the recipe scripts I can attach to instance groups. method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/deleteRecipes'].post update: x-apievangelist-phrasing: intent: Delete recipes effect: destructive questions: - Can I delete several recipes at once? - How do I remove recipe scripts I no longer use? instructions: - text: Delete recipes {recipeNames}. slots: recipeNames: requestBody.recipeNames - text: Remove the recipe scripts named {recipeNames}. slots: recipeNames: requestBody.recipeNames method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/createRecipe'].post update: x-apievangelist-phrasing: intent: Create a recipe script effect: write questions: - Can I register a custom script to run on all nodes of an instance group? - What recipe types can I create for a cluster? instructions: - text: Create recipe {recipeName} of type {type} with script {recipeContent}. slots: recipeName: requestBody.recipeName type: requestBody.type recipeContent: requestBody.recipeContent - text: Register a {type} recipe called {recipeName} running {recipeContent}, described as {description}. slots: type: requestBody.type recipeName: requestBody.recipeName recipeContent: requestBody.recipeContent description: requestBody.description method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/describeRecipe'].post update: x-apievangelist-phrasing: intent: Get details of a recipe effect: read questions: - What does a particular recipe script contain? - Can I view one recipe's type and content by name? instructions: - text: Describe recipe {recipeName}. slots: recipeName: requestBody.recipeName - text: Show the script content of recipe {recipeName}. slots: recipeName: requestBody.recipeName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/replaceRecipes'].post update: x-apievangelist-phrasing: intent: Replace recipes on a Data Hub's instance groups effect: write questions: - Can I swap the recipes attached to instance groups on an existing Data Hub? - How do I change which recipes run on each host group of a running cluster? instructions: - text: Replace recipes on Data Hub {datahub} with {instanceGroupRecipes}. slots: datahub: requestBody.datahub instanceGroupRecipes: requestBody.instanceGroupRecipes - text: Set the instance group recipes of {datahub} to {instanceGroupRecipes}. slots: datahub: requestBody.datahub instanceGroupRecipes: requestBody.instanceGroupRecipes method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/listClusterDefinitions'].post update: x-apievangelist-phrasing: intent: List cluster definitions effect: read questions: - Which cluster definitions can I use to create Data Hub clusters? - What reusable cluster definitions exist in my account? instructions: - text: List all Data Hub cluster definitions. - text: Show the reusable cluster definitions available to me. method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/deleteClusterDefinitions'].post update: x-apievangelist-phrasing: intent: Delete cluster definitions effect: destructive questions: - Can I delete cluster definitions I no longer need? - Is it possible to remove several cluster definitions in one request? instructions: - text: Delete cluster definitions {clusterDefinitionNames}. slots: clusterDefinitionNames: requestBody.clusterDefinitionNames - text: Remove the Data Hub cluster definitions named {clusterDefinitionNames}. slots: clusterDefinitionNames: requestBody.clusterDefinitionNames method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/createClusterDefinition'].post update: x-apievangelist-phrasing: intent: Create a cluster definition effect: write questions: - How do I save a reusable cluster definition for creating identical Data Hubs? - What workload template does a new cluster definition need? instructions: - text: Create cluster definition {clusterDefinitionName} from workload template {workloadTemplate}. slots: clusterDefinitionName: requestBody.clusterDefinitionName workloadTemplate: requestBody.workloadTemplate - text: Save a cluster definition called {clusterDefinitionName} using {workloadTemplate} with description {description}. slots: clusterDefinitionName: requestBody.clusterDefinitionName workloadTemplate: requestBody.workloadTemplate description: requestBody.description method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/describeClusterDefinition'].post update: x-apievangelist-phrasing: intent: Get details of a cluster definition effect: read questions: - What's inside a particular cluster definition? - Can I view one cluster definition's JSON by name? instructions: - text: Describe cluster definition {clusterDefinitionName}. slots: clusterDefinitionName: requestBody.clusterDefinitionName - text: Show the JSON of cluster definition {clusterDefinitionName}. slots: clusterDefinitionName: requestBody.clusterDefinitionName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/listClusterTemplates'].post update: x-apievangelist-phrasing: intent: List cluster templates effect: read questions: - Which cluster templates are available for Data Hub? - What service layouts can I pick from when building a cluster? instructions: - text: List all Data Hub cluster templates. - text: Show me the cluster templates I can create clusters from. method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/deleteClusterTemplates'].post update: x-apievangelist-phrasing: intent: Delete cluster templates effect: destructive questions: - Can I delete cluster templates that are no longer used? - Is it possible to remove multiple cluster templates at once? instructions: - text: Delete cluster templates {clusterTemplateNames}. slots: clusterTemplateNames: requestBody.clusterTemplateNames - text: Remove the Data Hub cluster templates named {clusterTemplateNames}. slots: clusterTemplateNames: requestBody.clusterTemplateNames method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/createClusterTemplate'].post update: x-apievangelist-phrasing: intent: Create a cluster template effect: write questions: - Can I upload my own cluster template JSON for Data Hub? - Is it possible to tag a new cluster template? instructions: - text: Create cluster template {clusterTemplateName} with content {clusterTemplateContent}. slots: clusterTemplateName: requestBody.clusterTemplateName clusterTemplateContent: requestBody.clusterTemplateContent - text: Add cluster template {clusterTemplateName} from {clusterTemplateContent} tagged {tags}. slots: clusterTemplateName: requestBody.clusterTemplateName clusterTemplateContent: requestBody.clusterTemplateContent tags: requestBody.tags method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/describeClusterTemplate'].post update: x-apievangelist-phrasing: intent: Get details of a cluster template effect: read questions: - Which services does a particular cluster template include? - Can I view a cluster template's content by name? instructions: - text: Describe cluster template {clusterTemplateName}. slots: clusterTemplateName: requestBody.clusterTemplateName - text: Show the content of cluster template {clusterTemplateName}. slots: clusterTemplateName: requestBody.clusterTemplateName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/createCustomConfigurations'].post update: x-apievangelist-phrasing: intent: Create custom service configurations effect: write questions: - Can I define custom service properties to apply when a Data Hub is created? - Is it possible to tie custom configurations to a specific runtime version? instructions: - text: Create custom configurations {customConfigurationsName} with properties {configurations}. slots: customConfigurationsName: requestBody.customConfigurationsName configurations: requestBody.configurations - text: Create custom configurations {customConfigurationsName} with {configurations} for runtime {runtimeVersion}. slots: customConfigurationsName: requestBody.customConfigurationsName configurations: requestBody.configurations runtimeVersion: requestBody.runtimeVersion method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/deleteCustomConfigurations'].post update: x-apievangelist-phrasing: intent: Delete custom configurations effect: destructive questions: - Can I delete a set of custom configurations? - What do I need to remove custom service properties I created? instructions: - text: Delete custom configurations {customConfigurations}. slots: customConfigurations: requestBody.customConfigurations - text: Remove the custom configuration set {customConfigurations}. slots: customConfigurations: requestBody.customConfigurations method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/describeCustomConfigurations'].post update: x-apievangelist-phrasing: intent: Get details of custom configurations effect: read questions: - Which property values are in a given custom configuration set? - Can I view one set of custom configurations by name or CRN? instructions: - text: Describe custom configurations {customConfigurations}. slots: customConfigurations: requestBody.customConfigurations - text: Show the properties defined in custom configurations {customConfigurations}. slots: customConfigurations: requestBody.customConfigurations method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/listCustomConfigurations'].post update: x-apievangelist-phrasing: intent: List custom configurations effect: read questions: - Which custom configuration sets exist for my Data Hub clusters? - Can I page through all custom configurations? instructions: - text: List all custom configurations. - text: List custom configurations, {pageSize} per page. slots: pageSize: requestBody.pageSize method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/migrateZookeeperToKraft'].post update: x-apievangelist-phrasing: intent: Start Kafka migration from ZooKeeper to KRaft effect: write questions: - How do I move my Kafka cluster off ZooKeeper onto KRaft? - Can I start a ZooKeeper-to-KRaft broker migration on a Data Hub? instructions: - text: Start the ZooKeeper to KRaft migration on cluster {crn}. slots: crn: requestBody.crn - text: Begin migrating Kafka brokers on {crn} from ZooKeeper to KRaft. slots: crn: requestBody.crn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/finalizeZookeeperToKraftMigration'].post update: x-apievangelist-phrasing: intent: Finalize the ZooKeeper to KRaft migration effect: destructive questions: - Once the KRaft migration looks good, how do I complete it? - What's the final step to commit a ZooKeeper-to-KRaft migration? instructions: - text: Finalize the ZooKeeper to KRaft migration on cluster {crn}. slots: crn: requestBody.crn - text: Complete and commit the KRaft migration for {crn}. slots: crn: requestBody.crn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/rollbackZookeeperToKraftMigration'].post update: x-apievangelist-phrasing: intent: Roll back the ZooKeeper to KRaft migration effect: write questions: - Can I undo a ZooKeeper-to-KRaft migration that's in progress? - What happens if I roll back the KRaft migration? instructions: - text: Roll back the ZooKeeper to KRaft migration on cluster {crn}. slots: crn: requestBody.crn - text: Revert Kafka on {crn} to ZooKeeper. slots: crn: requestBody.crn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/createAutoScaleRules'].post update: x-apievangelist-phrasing: intent: Create autoscaling rules for a cluster effect: write questions: - How do I set up autoscaling for a Data Hub cluster? - Can I create autoscale policies but leave them disabled for now? instructions: - text: Create autoscaling rules {autoScalePolicies} for Data Hub {clusterName}. slots: autoScalePolicies: requestBody.autoScalePolicies clusterName: requestBody.clusterName - text: Add autoscale policies {autoScalePolicies} to {clusterName} with enabled set to {enabled}. slots: autoScalePolicies: requestBody.autoScalePolicies clusterName: requestBody.clusterName enabled: requestBody.enabled method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/updateAutoScaleRules'].post update: x-apievangelist-phrasing: intent: Modify a cluster's autoscaling rules effect: write questions: - Can I turn autoscaling off on a Data Hub without deleting its rules? - What do I send to change existing autoscale policies? instructions: - text: Update the existing autoscaling rules on {clusterName} to {autoScalePolicies}. slots: clusterName: requestBody.clusterName autoScalePolicies: requestBody.autoScalePolicies - text: Set autoscaling enabled to {enabled} on Data Hub {clusterName}. slots: enabled: requestBody.enabled clusterName: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/describeAutoScaleRules'].post update: x-apievangelist-phrasing: intent: Get a cluster's autoscaling policies effect: read questions: - What autoscaling policies are configured on my Data Hub? - Is autoscaling currently enabled for a given cluster? instructions: - text: Describe the autoscaling rules for Data Hub {clusterName}. slots: clusterName: requestBody.clusterName - text: Show the autoscale policies on {clusterName}. slots: clusterName: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/deleteAutoScaleRules'].post update: x-apievangelist-phrasing: intent: Delete a cluster's autoscaling policies effect: destructive questions: - Can I remove all autoscaling policies from a Data Hub cluster? - What happens to autoscaling when its rules are deleted? instructions: - text: Delete the autoscaling rules on Data Hub {clusterName}. slots: clusterName: requestBody.clusterName - text: Remove every autoscale policy from {clusterName}. slots: clusterName: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/listAutoScaleHistory'].post update: x-apievangelist-phrasing: intent: List autoscaling history for a cluster effect: read questions: - When did autoscaling last add or remove nodes on my Data Hub? - Can I limit how many autoscale history entries come back? instructions: - text: List the autoscale history for Data Hub {clusterName}. slots: clusterName: requestBody.clusterName - text: Show the last {count} autoscaling actions on {clusterName}. slots: count: requestBody.count clusterName: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/getDatahubLogDescriptors'].post update: x-apievangelist-phrasing: intent: List log descriptors for diagnostics effect: read questions: - Which logs can be included in a Data Hub diagnostics bundle? - What log descriptors are available for diagnostics collection? instructions: - text: List the log descriptors used for Data Hub diagnostics collection. - text: Show which log types I can add to a diagnostics bundle. method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/collectDatahubDiagnostics'].post update: x-apievangelist-phrasing: intent: Start a Data Hub diagnostics collection effect: write questions: - How do I gather diagnostic logs from a Data Hub for a support case? - Can I restrict a diagnostics bundle to certain hosts or a date range? instructions: - text: Collect diagnostics for Data Hub {crn} to {destination} described as {description}. slots: crn: requestBody.crn destination: requestBody.destination description: requestBody.description - text: Collect diagnostics on {crn} to {destination} for support case {caseNumber}, described as {description}. slots: crn: requestBody.crn destination: requestBody.destination caseNumber: requestBody.caseNumber description: requestBody.description method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/listDatahubDiagnostics'].post update: x-apievangelist-phrasing: intent: List recent diagnostics collections effect: read questions: - Which diagnostics collections have run recently on my Data Hub? - Is my diagnostics bundle still being collected? instructions: - text: List recent diagnostics collections for Data Hub {crn}. slots: crn: requestBody.crn - text: Show the status of diagnostics runs on {crn}. slots: crn: requestBody.crn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/cancelDatahubDiagnostics'].post update: x-apievangelist-phrasing: intent: Cancel running diagnostics collections effect: destructive questions: - Can I stop a diagnostics collection that is still running? - What do I do if a diagnostics bundle is taking too long? instructions: - text: Cancel running diagnostics collections on Data Hub {crn}. slots: crn: requestBody.crn - text: Abort the in-progress diagnostics bundle for {crn}. slots: crn: requestBody.crn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/collectCmDiagnostics'].post update: x-apievangelist-phrasing: intent: Start a Cloudera Manager diagnostics collection effect: write questions: - Can I collect a Cloudera Manager based diagnostics bundle from a Data Hub? - Is it possible to cap the bundle size or filter by CM roles? instructions: - text: Collect Cloudera Manager diagnostics for Data Hub {crn} to {destination}. slots: crn: requestBody.crn destination: requestBody.destination - text: Collect CM diagnostics on {crn} to {destination} for roles {roles} with a bundle limit of {bundleSizeLimit}. slots: crn: requestBody.crn destination: requestBody.destination roles: requestBody.roles bundleSizeLimit: requestBody.bundleSizeLimit method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/getCmRoles'].post update: x-apievangelist-phrasing: intent: List Cloudera Manager roles for diagnostics effect: read questions: - Which Cloudera Manager roles can I filter a CM diagnostics bundle by? - What CM roles exist on my Data Hub for diagnostics? instructions: - text: Get the Cloudera Manager roles on Data Hub {crn}. slots: crn: requestBody.crn - text: List CM roles I can use to filter diagnostics on {crn}. slots: crn: requestBody.crn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/rotateSecrets'].post update: x-apievangelist-phrasing: intent: Rotate secrets on a Data Hub effect: write questions: - How do I rotate passwords and other secrets on a Data Hub? - Can I choose which secret types get rotated? instructions: - text: Rotate secrets {secretTypes} on Data Hub {datahub}. slots: secretTypes: requestBody.secretTypes datahub: requestBody.datahub - text: Rotate the {secretTypes} secret types for {datahub}. slots: secretTypes: requestBody.secretTypes datahub: requestBody.datahub method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/listDatahubSecretTypes'].post update: x-apievangelist-phrasing: intent: List secret types for a Data Hub effect: read questions: - Which secret types can be rotated on my Data Hub? - What kinds of secrets does a Data Hub instance hold? instructions: - text: List the secret types for Data Hub {datahub}. slots: datahub: requestBody.datahub - text: Show which secrets on {datahub} are rotatable. slots: datahub: requestBody.datahub method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/rotateAutoTlsCertificates'].post update: x-apievangelist-phrasing: intent: Rotate AutoTLS certificates (deprecated) effect: write questions: - Is the older AutoTLS certificate rotation still supported on Data Hub? - Which deprecated call rotates AutoTLS certs on a Data Hub's hosts? instructions: - text: Rotate AutoTLS certificates on Data Hub {datahubName} using the deprecated call. slots: datahubName: requestBody.datahubName - text: Use the legacy AutoTLS rotation on {datahubName}. slots: datahubName: requestBody.datahubName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/rotatePrivateCertificates'].post update: x-apievangelist-phrasing: intent: Rotate private certificates on Data Hub hosts effect: write questions: - How do I rotate the private host certificates on a Data Hub? - Can I refresh the internal TLS certificates on every node? instructions: - text: Rotate private certificates on Data Hub {datahub}. slots: datahub: requestBody.datahub - text: Refresh the internal host certificates for {datahub}. slots: datahub: requestBody.datahub method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/upgradeCluster'].post update: x-apievangelist-phrasing: intent: Upgrade a Data Hub's OS or runtime effect: write questions: - How do I upgrade the runtime or OS image on a Data Hub cluster? - Can I see the available upgrade images or run a dry run first? - Is a rolling upgrade supported for Data Hub clusters? instructions: - text: Upgrade Data Hub {clusterName} to image {imageId}. slots: clusterName: requestBody.clusterName imageId: requestBody.imageId - text: Upgrade cluster {clusterName} to runtime {runtime} as a rolling upgrade. slots: clusterName: requestBody.clusterName runtime: requestBody.runtime - text: Show the images {clusterName} could be upgraded to. slots: clusterName: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/startClusterVerticalScaling'].post update: x-apievangelist-phrasing: intent: Vertically scale a Data Hub host group effect: write questions: - Can I change the instance type of a Data Hub host group? - Is it possible to resize the disks on a group instead of the VM size? instructions: - text: Vertically scale group {group} on Data Hub {datahub} to instance template {instanceTemplate}. slots: group: requestBody.group datahub: requestBody.datahub instanceTemplate: requestBody.instanceTemplate - text: Change the disks of group {group} on {datahub} using {diskOptions}. slots: group: requestBody.group datahub: requestBody.datahub diskOptions: requestBody.diskOptions method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/prepareClusterUpgrade'].post update: x-apievangelist-phrasing: intent: Validate and stage parcels before an upgrade effect: write questions: - Can I run upgrade checks and pre-download parcels before upgrading a Data Hub? - What does the upgrade preparation phase do? instructions: - text: Prepare Data Hub {cluster} for an upgrade to runtime {runtime}. slots: cluster: requestBody.cluster runtime: requestBody.runtime - text: Run upgrade validations and stage parcels on {cluster} for image {imageId}. slots: cluster: requestBody.cluster imageId: requestBody.imageId method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/startDatabaseUpgrade'].post update: x-apievangelist-phrasing: intent: Upgrade a Data Hub's database effect: write questions: - How do I upgrade the database behind a Data Hub cluster? - Can I pick the target database version? instructions: - text: Upgrade the database of Data Hub {cluster}. slots: cluster: requestBody.cluster - text: Upgrade the database on {cluster} to version {targetVersion}. slots: cluster: requestBody.cluster targetVersion: requestBody.targetVersion method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/setCatalog'].post update: x-apievangelist-phrasing: intent: Set the catalog for a Data Hub effect: write questions: - Can I point a Data Hub at a different catalog? - What do I need to assign a catalog to a Data Hub cluster? instructions: - text: Set catalog {catalogName} on Data Hub {cluster}. slots: catalogName: requestBody.catalogName cluster: requestBody.cluster - text: Assign the {catalogName} catalog to {cluster}. slots: catalogName: requestBody.catalogName cluster: requestBody.cluster method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/syncComponentVersionsFromCm'].post update: x-apievangelist-phrasing: intent: Sync component versions from Cloudera Manager effect: write questions: - After a failed upgrade, can I resync component versions from Cloudera Manager? - My Data Hub shows the wrong component versions after an upgrade — how do I fix that? instructions: - text: Sync component versions from Cloudera Manager for Data Hub {datahubName}. slots: datahubName: requestBody.datahubName - text: Refresh {datahubName}'s component versions from CM after the failed upgrade. slots: datahubName: requestBody.datahubName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/getOperation'].post update: x-apievangelist-phrasing: intent: Get the latest operation on a Data Hub effect: read questions: - What operation is currently running or last finished on my Data Hub? - Can I check the progress of a specific Data Hub operation id? instructions: - text: Get the latest operation for Data Hub {clusterName}. slots: clusterName: requestBody.clusterName - text: Check Data Hub operation {operationId} on {crn}. slots: operationId: requestBody.operationId crn: requestBody.crn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/getVmTypes'].post update: x-apievangelist-phrasing: intent: Recommend VM types for a cluster template effect: read questions: - Which VM instance types are recommended for my cluster template in a region? - Can I get VM type suggestions for a specific availability zone? instructions: - text: Recommend VM types for template {clusterTemplate} using credential {credential} in region {region}. slots: clusterTemplate: requestBody.clusterTemplate credential: requestBody.credential region: requestBody.region - text: Suggest instance types for {clusterTemplate} in {region} zone {availabilityZone} with credential {credential}. slots: clusterTemplate: requestBody.clusterTemplate region: requestBody.region availabilityZone: requestBody.availabilityZone credential: requestBody.credential method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/startInstances'].post update: x-apievangelist-phrasing: intent: Start stopped instances in a host group effect: write questions: - Can I start some stopped instances in one Data Hub host group? - Is it possible to choose how many instances to bring back? instructions: - text: Start instances in host group {hostGroup} of Data Hub {cluster}. slots: hostGroup: requestBody.hostGroup cluster: requestBody.cluster - text: Start {instanceCount} instances in {hostGroup} on {cluster}. slots: instanceCount: requestBody.instanceCount hostGroup: requestBody.hostGroup cluster: requestBody.cluster method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/stopInstances'].post update: x-apievangelist-phrasing: intent: Stop specific instances in a cluster effect: write questions: - Can I stop individual instances of a Data Hub without stopping the whole cluster? - Is there a forced option for stopping instances? instructions: - text: Stop instances {instanceIds} on Data Hub {cluster}. slots: instanceIds: requestBody.instanceIds cluster: requestBody.cluster - text: Force stop instances {instanceIds} in {cluster}. slots: instanceIds: requestBody.instanceIds cluster: requestBody.cluster method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/rotateSaltPassword'].post update: x-apievangelist-phrasing: intent: Rotate the SaltStack password (deprecated) effect: write questions: - Is there still a dedicated call to rotate the SaltStack user password on Data Hub? - Which deprecated endpoint rotates the Salt password on cluster instances? instructions: - text: Rotate the SaltStack user password on Data Hub {cluster} with the deprecated call. slots: cluster: requestBody.cluster - text: Use the legacy Salt password rotation for {cluster}. slots: cluster: requestBody.cluster method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/updateOrchestratorState'].post update: x-apievangelist-phrasing: intent: Run an orchestrator state update effect: write questions: - Can I re-apply the orchestrator engine state on a Data Hub cluster? - What triggers an orchestrator state update on a cluster? instructions: - text: Run an orchestrator state update on Data Hub {clusterCrn}. slots: clusterCrn: requestBody.clusterCrn - text: Re-apply the orchestrator engine state on {clusterCrn}. slots: clusterCrn: requestBody.clusterCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/updateToAwsImdsV2'].post update: x-apievangelist-phrasing: intent: Switch an AWS Data Hub to IMDSv2 effect: write questions: - How do I make my AWS Data Hub use IMDSv2? - Can I enforce the more secure instance metadata service on a cluster? instructions: - text: Update AWS Data Hub {crn} to use IMDSv2. slots: crn: requestBody.crn - text: Switch instance metadata on {crn} to IMDSv2. slots: crn: requestBody.crn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/updateToAwsImdsV1'].post update: x-apievangelist-phrasing: intent: Switch an AWS Data Hub back to IMDSv1 effect: write questions: - Can I revert an AWS Data Hub cluster to IMDSv1? - Is it possible to go back to the older instance metadata service version? instructions: - text: Update AWS Data Hub {crn} to use IMDSv1. slots: crn: requestBody.crn - text: Revert instance metadata on {crn} to IMDSv1. slots: crn: requestBody.crn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/setDefaultJavaVersion'].post update: x-apievangelist-phrasing: intent: Set the default Java version on a Data Hub effect: write questions: - How do I change the default Java version on a Data Hub cluster? - Will changing Java restart services, and can I do it as a rolling restart? instructions: - text: Set the default Java version on Data Hub {clusterCrn} to {javaVersion}. slots: clusterCrn: requestBody.clusterCrn javaVersion: requestBody.javaVersion - text: Switch {clusterCrn} to Java {javaVersion} with a rolling restart. slots: clusterCrn: requestBody.clusterCrn javaVersion: requestBody.javaVersion method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/migrateSkus'].post update: x-apievangelist-phrasing: intent: Migrate a Data Hub cluster's SKUs effect: write questions: - Can I migrate the SKUs used by a Data Hub cluster? - Is there a force option for a cluster SKU migration? instructions: - text: Migrate the SKUs of Data Hub cluster {clusterName}. slots: clusterName: requestBody.clusterName - text: Force the SKU migration on {clusterName}. slots: clusterName: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datahub/updatePublicDnsEntries'].post update: x-apievangelist-phrasing: intent: Update a Data Hub's public DNS entries effect: write questions: - How do I refresh the public DNS records for a Data Hub? - My Data Hub endpoints don't resolve — can I update the public DNS entries? instructions: - text: Update the public DNS entries of Data Hub {datahub}. slots: datahub: requestBody.datahub - text: Refresh public DNS records for {datahub}. slots: datahub: requestBody.datahub method: generated generated: '2026-10-01'