# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Cloudera Service Datalake API version: 1.0.0 extends: openapi/cloudera-datalake-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: 56 - target: $.paths['/api/v1/datalake/listRuntimes'].post update: x-apievangelist-phrasing: intent: List available Data Lake runtime versions effect: read questions: - Which Cloudera Runtime versions can I create a Data Lake with? - What datalake runtime versions are currently available? instructions: - text: List the available Data Lake runtime versions. - text: Show me which runtimes a new datalake can use. method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/createAWSDatalake'].post update: x-apievangelist-phrasing: intent: Create a Data Lake on AWS effect: write questions: - How do I create a Data Lake in a commercial AWS environment? - Can I enable Ranger RAZ and multi-AZ on a new AWS datalake? - Is it possible to choose the CPU architecture for an AWS Data Lake? instructions: - text: Create AWS datalake {name} in environment {environment} with cloud configuration {config}. slots: name: requestBody.datalakeName environment: requestBody.environmentName config: requestBody.cloudProviderConfiguration - text: Create AWS datalake {name} at scale {scale} on runtime {runtime}. slots: name: requestBody.datalakeName scale: requestBody.scale runtime: requestBody.runtime - text: Create AWS datalake {name} on the {architecture} architecture. slots: name: requestBody.datalakeName architecture: requestBody.architecture method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/createAWSGovCloudDatalake'].post update: x-apievangelist-phrasing: intent: Create a Data Lake on AWS GovCloud effect: write questions: - What is needed to stand up a Data Lake in a US government (GovCloud) region? - Can a GovCloud datalake run across multiple availability zones? instructions: - text: Create GovCloud datalake {name} in environment {environment} with cloud configuration {config}. slots: name: requestBody.datalakeName environment: requestBody.environmentName config: requestBody.cloudProviderConfiguration - text: Create an AWS GovCloud Data Lake {name} at scale {scale}. slots: name: requestBody.datalakeName scale: requestBody.scale method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/createAzureDatalake'].post update: x-apievangelist-phrasing: intent: Create a Data Lake on Azure effect: write questions: - How do I create a Data Lake in an Azure environment? - Can I use a flexible server delegated subnet for an Azure datalake's database? - Which load balancer SKU can I set on an Azure Data Lake? instructions: - text: Create Azure datalake {name} in environment {environment} with cloud configuration {config}. slots: name: requestBody.datalakeName environment: requestBody.environmentName config: requestBody.cloudProviderConfiguration - text: Create Azure datalake {name} using database type {dbType} and subnet {subnet}. slots: name: requestBody.datalakeName dbType: requestBody.databaseType subnet: requestBody.flexibleServerDelegatedSubnetId method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/createGCPDatalake'].post update: x-apievangelist-phrasing: intent: Create a Data Lake on Google Cloud effect: write questions: - How do I create a Data Lake in a GCP environment? - Can I add recipes and tags to a new Google Cloud datalake? instructions: - text: Create GCP datalake {name} in environment {environment} with cloud configuration {config}. slots: name: requestBody.datalakeName environment: requestBody.environmentName config: requestBody.cloudProviderConfiguration - text: Create a Google Cloud Data Lake {name} on runtime {runtime}. slots: name: requestBody.datalakeName runtime: requestBody.runtime method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/listDatalakes'].post update: x-apievangelist-phrasing: intent: List Data Lakes effect: read questions: - Which datalakes exist across my CDP environments? - Can I list only the Data Lakes in one environment? instructions: - text: List all my datalakes. - text: List datalakes in environment {environment}. slots: environment: requestBody.environmentName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/deleteDatalake'].post update: x-apievangelist-phrasing: intent: Delete a Data Lake effect: destructive questions: - How do I delete a Data Lake? - Can I force-delete a datalake that is stuck? instructions: - text: Delete datalake {name}. slots: name: requestBody.datalakeName - text: Force delete datalake {name} ({force}). slots: name: requestBody.datalakeName force: requestBody.force method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/retryDatalake'].post update: x-apievangelist-phrasing: intent: Retry a Data Lake's last failed operation effect: write questions: - Can I retry the operation that just failed on my datalake? - What do I do when a Data Lake operation fails partway through? instructions: - text: Retry the last failed operation on datalake {name}. slots: name: requestBody.datalakeName - text: Rerun the failed step on Data Lake {name}. slots: name: requestBody.datalakeName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/startDatalakeVerticalScaling'].post update: x-apievangelist-phrasing: intent: Vertically scale a Data Lake instance group effect: write questions: - Can I change the instance type of a Data Lake host group? - How do I modify the disks of one Data Lake instance group? instructions: - text: Vertically scale group {group} of datalake {datalake} to instance template {template}. slots: group: requestBody.group datalake: requestBody.datalake template: requestBody.instanceTemplate - text: Change the disks of group {group} on Data Lake {datalake} to {disks}. slots: group: requestBody.group datalake: requestBody.datalake disks: requestBody.diskOptions method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/describeDatalake'].post update: x-apievangelist-phrasing: intent: Describe a Data Lake effect: read questions: - What is the status and configuration of one datalake? - Can I get full details for a Data Lake by name? instructions: - text: Describe datalake {name}. slots: name: requestBody.datalakeName - text: Show me the details of Data Lake {name}. slots: name: requestBody.datalakeName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/renewCertificate'].post update: x-apievangelist-phrasing: intent: Renew a Data Lake certificate (deprecated) effect: write questions: - Is there an older call for renewing a datalake's certificate? - Which deprecated endpoint renews a Data Lake certificate? instructions: - text: Renew the certificate on datalake {name} using the deprecated renew-certificate call. slots: name: requestBody.datalakeName - text: Use the legacy certificate renewal on Data Lake {name}. slots: name: requestBody.datalakeName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/renewPublicCertificate'].post update: x-apievangelist-phrasing: intent: Renew a Data Lake's public certificate effect: write questions: - How do I renew the public certificate on my Data Lake before it expires? - Can I renew a datalake public certificate by CRN? instructions: - text: Renew the public certificate on datalake {datalake}. slots: datalake: requestBody.datalake - text: Refresh the public TLS certificate for Data Lake {datalake}. slots: datalake: requestBody.datalake method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/repairDatalake'].post update: x-apievangelist-phrasing: intent: Repair a Data Lake effect: write questions: - How do I repair unhealthy nodes in a Data Lake? - Can I repair only specific instance groups or instances of a datalake? instructions: - text: Repair datalake {name}. slots: name: requestBody.datalakeName - text: Repair instance groups {groups} on datalake {name}. slots: groups: requestBody.instanceGroupNames name: requestBody.datalakeName - text: Repair instances {instances} of Data Lake {name}. slots: instances: requestBody.instances name: requestBody.datalakeName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/restartDatalakeInstances'].post update: x-apievangelist-phrasing: intent: Restart Data Lake instances on the cloud provider effect: write questions: - Can I reboot specific Data Lake VMs on the cloud provider? - How do I restart individual instances of a datalake? instructions: - text: Restart instances {instances} of datalake {name}. slots: instances: requestBody.instances name: requestBody.datalakeName - text: Reboot the cloud VMs {instances} behind Data Lake {name}. slots: instances: requestBody.instances name: requestBody.datalakeName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/getClusterServiceStatus'].post update: x-apievangelist-phrasing: intent: Get service status of a Data Lake cluster effect: read questions: - Are all the services in my Data Lake cluster healthy? - Which services in a datalake cluster are failing? instructions: - text: Get the service status of cluster {cluster}. slots: cluster: requestBody.clusterName - text: Check which services are down on Data Lake cluster {cluster}. slots: cluster: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/getClusterHostStatus'].post update: x-apievangelist-phrasing: intent: Get host status of a Data Lake cluster effect: read questions: - Are all the hosts in my Data Lake cluster up? - Which hosts in a datalake cluster are unhealthy? instructions: - text: Get the host status of cluster {cluster}. slots: cluster: requestBody.clusterName - text: Check the health of every host in Data Lake cluster {cluster}. slots: cluster: requestBody.clusterName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/upgradeDatalake'].post update: x-apievangelist-phrasing: intent: Upgrade a Data Lake's OS or runtime effect: write questions: - How do I upgrade my Data Lake to a newer runtime or OS image? - Can I do a dry run of a datalake upgrade first? - Is a rolling upgrade possible for a Data Lake, and can I skip the backup? instructions: - text: Upgrade datalake {name} to runtime {runtime}. slots: name: requestBody.datalakeName runtime: requestBody.runtime - text: Upgrade datalake {name} to image {image} as a dry run ({dryRun}). slots: name: requestBody.datalakeName image: requestBody.imageId dryRun: requestBody.dryRun - text: Show available upgrade images for datalake {name} ({show}). slots: name: requestBody.datalakeName show: requestBody.showAvailableImages method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/prepareDatalakeUpgrade'].post update: x-apievangelist-phrasing: intent: Prepare a Data Lake for an upgrade effect: write questions: - Can I run upgrade validations and download parcels before upgrading a Data Lake? - How do I reduce the chance of a datalake upgrade failing? instructions: - text: Prepare datalake {datalake} for upgrade to runtime {runtime}. slots: datalake: requestBody.datalake runtime: requestBody.runtime - text: Run upgrade preparation on Data Lake {datalake} for image {image}. slots: datalake: requestBody.datalake image: requestBody.imageId method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/startDatabaseUpgrade'].post update: x-apievangelist-phrasing: intent: Upgrade a Data Lake's database effect: write questions: - How do I upgrade the database behind my Data Lake? - Can I choose the target database version for a datalake? instructions: - text: Upgrade the database of datalake {datalake} to version {version}. slots: datalake: requestBody.datalake version: requestBody.targetVersion - text: Start a database upgrade on Data Lake {datalake}. slots: datalake: requestBody.datalake method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/startDatalake'].post update: x-apievangelist-phrasing: intent: Start a Data Lake (deprecated) effect: write questions: - Is there still a direct call to start a stopped Data Lake? - What replaced the deprecated start-datalake command? instructions: - text: Start datalake {name} using the deprecated start call. slots: name: requestBody.datalakeName - text: Bring stopped Data Lake {name} back up. slots: name: requestBody.datalakeName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/stopDatalake'].post update: x-apievangelist-phrasing: intent: Stop a Data Lake (deprecated) effect: write questions: - Is there still a direct call to stop a running Data Lake? - What replaced the deprecated stop-datalake command? instructions: - text: Stop datalake {name} using the deprecated stop call. slots: name: requestBody.datalakeName - text: Shut down running Data Lake {name}. slots: name: requestBody.datalakeName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/backupDatalake'].post update: x-apievangelist-phrasing: intent: Back up a Data Lake effect: write questions: - How do I take a backup of all the data in my Data Lake? - Can I skip Atlas metadata or Ranger audits when backing up a datalake? - Is there a validation-only mode for a datalake backup? instructions: - text: Back up datalake {name} to {location}. slots: name: requestBody.datalakeName location: requestBody.backupLocation - text: Take backup {backup} of datalake {name}, skipping Ranger audits ({skipAudits}). slots: backup: requestBody.backupName name: requestBody.datalakeName skipAudits: requestBody.skipRangerAudits method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/backupDatalakeStatus'].post update: x-apievangelist-phrasing: intent: Check a Data Lake backup's status effect: read questions: - Has my datalake backup finished yet? - Can I check a backup's progress by its name or ID? instructions: - text: Check the status of backup {backupId} on datalake {name}. slots: backupId: requestBody.backupId name: requestBody.datalakeName - text: Get the status of backup named {backup} for Data Lake {name}. slots: backup: requestBody.backupName name: requestBody.datalakeName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/restoreDatalake'].post update: x-apievangelist-phrasing: intent: Restore a Data Lake from a backup effect: write questions: - How do I restore my Data Lake from a backup I took earlier? - Can I include the database when restoring a datalake? - Is it possible to override the backup location during a restore? instructions: - text: Restore datalake {name} from backup {backupId}. slots: name: requestBody.datalakeName backupId: requestBody.backupId - text: Restore datalake {name} from backup named {backup} using location {location}. slots: name: requestBody.datalakeName backup: requestBody.backupName location: requestBody.backupLocationOverride method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/restoreDatalakeStatus'].post update: x-apievangelist-phrasing: intent: Check a Data Lake restore's status effect: read questions: - Has my datalake restore completed? - Can I check a restore's progress by its restore ID? instructions: - text: Check the status of restore {restoreId} on datalake {name}. slots: restoreId: requestBody.restoreId name: requestBody.datalakeName - text: Get the latest restore status for Data Lake {name}. slots: name: requestBody.datalakeName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/listDatalakeBackups'].post update: x-apievangelist-phrasing: intent: List a Data Lake's backups effect: read questions: - Which backups have been taken of my datalake? - Can I see the history of backup operations on a Data Lake? instructions: - text: List backups of datalake {name}. slots: name: requestBody.datalakeName - text: Show every backup operation run on Data Lake {name}. slots: name: requestBody.datalakeName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/cancelBackup'].post update: x-apievangelist-phrasing: intent: Cancel a running Data Lake backup effect: destructive questions: - Can I cancel a datalake backup that is still in progress? - What happens to pending steps when I cancel a backup? instructions: - text: Cancel backup {backupId}. slots: backupId: requestBody.backupId - text: Force cancel running backup {backupId} ({force}). slots: backupId: requestBody.backupId force: requestBody.force method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/cancelRestore'].post update: x-apievangelist-phrasing: intent: Cancel a running Data Lake restore effect: destructive questions: - Can I stop a datalake restore that is in progress? - Which states must a restore be in before I can cancel it? instructions: - text: Cancel restore {restoreId}. slots: restoreId: requestBody.restoreId - text: Force cancel running restore {restoreId} ({force}). slots: restoreId: requestBody.restoreId force: requestBody.force method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/replaceRecipes'].post update: x-apievangelist-phrasing: intent: Replace recipes on Data Lake instance groups effect: write questions: - How do I swap the recipes attached to my Data Lake's instance groups? - Can I change which scripts run on a datalake host group? instructions: - text: Replace recipes on datalake {datalake} with {recipes}. slots: datalake: requestBody.datalake recipes: requestBody.instanceGroupRecipes - text: Set instance group recipes {recipes} on Data Lake {datalake}. slots: recipes: requestBody.instanceGroupRecipes datalake: requestBody.datalake method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/rotateSecrets'].post update: x-apievangelist-phrasing: intent: Rotate secrets on a Data Lake effect: write questions: - How do I rotate specific secret types on my Data Lake? - Can I rotate the SaltStack password through the general secret rotation call? instructions: - text: Rotate secrets {types} on datalake {datalake}. slots: types: requestBody.secretTypes datalake: requestBody.datalake - text: Rotate the {types} secrets for Data Lake {datalake}. slots: types: requestBody.secretTypes datalake: requestBody.datalake method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/rotateDbCertificate'].post update: x-apievangelist-phrasing: intent: Rotate a Data Lake's database SSL certificate effect: write questions: - How do I rotate the database SSL certificate on my Data Lake? - Can I refresh the DB TLS cert of a datalake? instructions: - text: Rotate the database SSL certificate on datalake {name}. slots: name: requestBody.datalakeName - text: Replace the DB certificate of Data Lake {name}. slots: name: requestBody.datalakeName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/listDatalakeSecretTypes'].post update: x-apievangelist-phrasing: intent: List secret types for a Data Lake effect: read questions: - Which secret types can I rotate on a Data Lake? - What secrets does my datalake have? instructions: - text: List secret types for datalake {datalake}. slots: datalake: requestBody.datalake - text: Show rotatable secret types on Data Lake {datalake}. slots: datalake: requestBody.datalake method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/getDatalakeLogDescriptors'].post update: x-apievangelist-phrasing: intent: List log descriptors for diagnostics effect: read questions: - Which log descriptors can I include in a Data Lake diagnostics collection? - What logs are available when gathering datalake diagnostics? instructions: - text: Get the log descriptors used for Data Lake diagnostics collection. - text: List the logs I can add to a datalake diagnostics bundle. method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/collectDatalakeDiagnostics'].post update: x-apievangelist-phrasing: intent: Start a Data Lake diagnostics collection effect: write questions: - How do I collect diagnostic logs from my Data Lake for a support case? - Can I limit a diagnostics collection to a date range or certain hosts? instructions: - text: Collect diagnostics for datalake {crn} to {destination} with description {description}. slots: crn: requestBody.crn destination: requestBody.destination description: requestBody.description - text: Collect datalake {crn} diagnostics for support case {case} from {start} to {end}. slots: crn: requestBody.crn case: requestBody.caseNumber start: requestBody.startDate end: requestBody.endDate method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/listDatalakeDiagnostics'].post update: x-apievangelist-phrasing: intent: List recent Data Lake diagnostics collections effect: read questions: - Which diagnostics collections have run on my Data Lake recently? - Can I see the status of past datalake diagnostics bundles? instructions: - text: List recent diagnostics collections for datalake {crn}. slots: crn: requestBody.crn - text: Show diagnostics bundle history for Data Lake {crn}. slots: crn: requestBody.crn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/cancelDatalakeDiagnostics'].post update: x-apievangelist-phrasing: intent: Cancel running Data Lake diagnostics effect: destructive questions: - Can I stop a diagnostics collection that is still running on my datalake? - How do I abort a Data Lake log collection? instructions: - text: Cancel running diagnostics collections on datalake {crn}. slots: crn: requestBody.crn - text: Abort the diagnostics bundle in progress for Data Lake {crn}. slots: crn: requestBody.crn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/collectCmDiagnostics'].post update: x-apievangelist-phrasing: intent: Start Cloudera Manager diagnostics for a Data Lake effect: write questions: - How do I collect Cloudera Manager based diagnostics from a Data Lake? - Can I filter CM diagnostics by role and cap the bundle size? instructions: - text: Collect Cloudera Manager diagnostics for datalake {crn} to {destination}. slots: crn: requestBody.crn destination: requestBody.destination - text: Collect CM diagnostics for datalake {crn} limited to roles {roles} with size limit {limit}. slots: crn: requestBody.crn roles: requestBody.roles limit: requestBody.bundleSizeLimit method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/getCmRoles'].post update: x-apievangelist-phrasing: intent: List Cloudera Manager roles for diagnostics filtering effect: read questions: - Which Cloudera Manager roles can I filter a CM diagnostics bundle by? - What CM roles are running on my Data Lake? instructions: - text: Get the Cloudera Manager roles for datalake {crn}. slots: crn: requestBody.crn - text: List CM roles I can use to filter diagnostics on Data Lake {crn}. slots: crn: requestBody.crn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/getOperation'].post update: x-apievangelist-phrasing: intent: Get the status of a Data Lake operation effect: read questions: - What is the status of the most recent operation on my datalake? - Can I look up a specific historical Data Lake operation by its ID? instructions: - text: Get the latest operation status for datalake {name}. slots: name: requestBody.datalakeName - text: Show details of operation {operation} on Data Lake {crn}. slots: operation: requestBody.operationId crn: requestBody.crn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/rotateAutoTlsCertificates'].post update: x-apievangelist-phrasing: intent: Rotate AutoTLS certificates (deprecated) effect: write questions: - Is there an older call to rotate AutoTLS certificates on datalake hosts? - Which deprecated endpoint rotates autotls certs? instructions: - text: Rotate AutoTLS certificates on datalake {name} using the deprecated call. slots: name: requestBody.datalakeName - text: Use the legacy autotls rotation on Data Lake {name}. slots: name: requestBody.datalakeName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/rotatePrivateCertificates'].post update: x-apievangelist-phrasing: intent: Rotate private certificates on Data Lake hosts effect: write questions: - How do I rotate the private host certificates on my Data Lake? - Can I renew internal TLS certificates across datalake hosts? instructions: - text: Rotate private certificates on datalake {datalake}. slots: datalake: requestBody.datalake - text: Renew the internal host certificates of Data Lake {datalake}. slots: datalake: requestBody.datalake method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/describeDatabaseServer'].post update: x-apievangelist-phrasing: intent: Get a Data Lake's external database server effect: read questions: - What external database server is my Data Lake using? - Can I see the database server details for a datalake cluster CRN? instructions: - text: Describe the database server for datalake cluster {cluster}. slots: cluster: requestBody.clusterCrn - text: Show external database details of Data Lake cluster {cluster}. slots: cluster: requestBody.clusterCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/validateAwsCloudStorage'].post update: x-apievangelist-phrasing: intent: Validate AWS cloud storage for a Data Lake effect: read questions: - Are my S3 storage location and IAM roles set up correctly for a Data Lake? - Can I check the data access and Ranger audit roles before creating an AWS datalake? instructions: - text: Validate AWS storage {location} for cluster {cluster} with data access role {dataRole} and Ranger audit role {auditRole}. slots: location: requestBody.storageLocation cluster: requestBody.clusterName dataRole: requestBody.dataAccessRole auditRole: requestBody.rangerAuditRole - text: Check instance profile {profile} and credential {credential} against AWS storage {location}. slots: profile: requestBody.instanceProfile credential: requestBody.credentialCrn location: requestBody.storageLocation method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/validateAzureCloudStorage'].post update: x-apievangelist-phrasing: intent: Validate Azure cloud storage for a Data Lake effect: read questions: - Is my ADLS storage location configured correctly for a Data Lake? - Can I validate Azure storage using a managed identity before creating a datalake? instructions: - text: Validate Azure storage {location} for cluster {cluster} with data access role {dataRole} and Ranger audit role {auditRole}. slots: location: requestBody.storageLocation cluster: requestBody.clusterName dataRole: requestBody.dataAccessRole auditRole: requestBody.rangerAuditRole - text: Check Azure storage {location} using managed identity {identity}. slots: location: requestBody.storageLocation identity: requestBody.managedIdentity method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/resizeDatalake'].post update: x-apievangelist-phrasing: intent: Resize a Data Lake to a new shape effect: write questions: - How do I resize my Data Lake from light duty to a larger shape? - Can I make a datalake multi-AZ as part of a resize? instructions: - text: Resize datalake {name} to {size}. slots: name: requestBody.datalakeName size: requestBody.targetSize - text: Validate only a resize of datalake {name} to {size} ({validationOnly}). slots: name: requestBody.datalakeName size: requestBody.targetSize validationOnly: requestBody.validationOnly method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/scaleHorizontally'].post update: x-apievangelist-phrasing: intent: Add nodes to a Data Lake host group effect: write questions: - How do I add more compute nodes to a Data Lake host group? - Which Data Lake instance groups can be scaled out horizontally? instructions: - text: Scale group {group} of datalake {name} out to {count} nodes. slots: group: requestBody.instanceGroupName name: requestBody.datalakeName count: requestBody.instanceGroupDesiredCount - text: Set the node count of Data Lake {name} group {group} to {count}. slots: name: requestBody.datalakeName group: requestBody.instanceGroupName count: requestBody.instanceGroupDesiredCount method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/recoverDatalake'].post update: x-apievangelist-phrasing: intent: Recover a Data Lake after a failed upgrade effect: write questions: - My datalake upgrade failed, can I roll it back to the original version? - Which recovery types exist for a failed Data Lake upgrade? instructions: - text: Recover datalake {name} to its original version. slots: name: requestBody.datalakeName - text: Recover Data Lake {name} using recovery type {type}. slots: name: requestBody.datalakeName type: requestBody.recoveryType method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/setCatalog'].post update: x-apievangelist-phrasing: intent: Set a catalog on a Data Lake effect: write questions: - How do I assign a catalog to my Data Lake? - Can I change which catalog a datalake uses? instructions: - text: Set catalog {catalog} on datalake {datalake}. slots: catalog: requestBody.catalogName datalake: requestBody.datalake - text: Point Data Lake {datalake} at catalog {catalog}. slots: datalake: requestBody.datalake catalog: requestBody.catalogName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/syncComponentVersionsFromCm'].post update: x-apievangelist-phrasing: intent: Sync component versions from Cloudera Manager effect: write questions: - After a failed upgrade, how do I sync my Data Lake's component versions from Cloudera Manager? - Can I fix mismatched component versions on a datalake? instructions: - text: Sync component versions from CM for datalake {name}. slots: name: requestBody.datalakeName - text: Reconcile Data Lake {name}'s component versions with Cloudera Manager. slots: name: requestBody.datalakeName method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/rotateSaltPassword'].post update: x-apievangelist-phrasing: intent: Rotate the SaltStack password (deprecated) effect: write questions: - Is there a dedicated call to rotate the SaltStack user password on Data Lake instances? - Which deprecated endpoint changes the Salt password on a datalake? instructions: - text: Rotate the SaltStack password on datalake {datalake} using the deprecated call. slots: datalake: requestBody.datalake - text: Change the Salt user password on Data Lake {datalake} instances. slots: datalake: requestBody.datalake method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/updateOrchestratorState'].post update: x-apievangelist-phrasing: intent: Run an orchestrator state update on a Data Lake effect: write questions: - How do I re-apply the orchestrator engine state on my Data Lake cluster? - Can I refresh the Salt orchestrator state on a datalake? instructions: - text: Run an orchestrator state update on datalake cluster {cluster}. slots: cluster: requestBody.clusterCrn - text: Reapply orchestrator state to Data Lake cluster {cluster}. slots: cluster: requestBody.clusterCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/updateToAwsImdsV2'].post update: x-apievangelist-phrasing: intent: Switch an AWS Data Lake to IMDSv2 effect: write questions: - How do I move my AWS Data Lake to IMDSv2? - Can a datalake be required to use the session-based instance metadata service? instructions: - text: Update datalake {crn} to use IMDSv2. slots: crn: requestBody.crn - text: Enforce instance metadata v2 on AWS Data Lake {crn}. slots: crn: requestBody.crn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/updateToAwsImdsV1'].post update: x-apievangelist-phrasing: intent: Switch an AWS Data Lake back to IMDSv1 effect: write questions: - Can I revert my AWS Data Lake to IMDSv1? - What call moves a datalake back to the older instance metadata version? instructions: - text: Update datalake {crn} to use IMDSv1. slots: crn: requestBody.crn - text: Roll AWS Data Lake {crn} back to instance metadata v1. slots: crn: requestBody.crn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/setDefaultJavaVersion'].post update: x-apievangelist-phrasing: intent: Set a Data Lake's default Java version effect: write questions: - How do I change the default Java version on my Data Lake? - Will changing a datalake's Java version restart services, and can it be rolling? instructions: - text: Set the default Java version of datalake {crn} to {java}. slots: crn: requestBody.crn java: requestBody.javaVersion - text: Switch Data Lake {crn} to Java {java} with a rolling restart ({rolling}). slots: crn: requestBody.crn java: requestBody.javaVersion rolling: requestBody.rollingRestart method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/migrateSkus'].post update: x-apievangelist-phrasing: intent: Migrate a Data Lake to a new SKU effect: write questions: - How do I migrate my Data Lake to a new SKU? - Can I force a datalake SKU migration? instructions: - text: Migrate datalake {name} to the new SKU. slots: name: requestBody.datalakeName - text: Force the SKU migration of Data Lake {name} ({force}). slots: name: requestBody.datalakeName force: requestBody.force method: generated generated: '2026-10-01' - target: $.paths['/api/v1/datalake/updatePublicDnsEntries'].post update: x-apievangelist-phrasing: intent: Update a Data Lake's public DNS entries effect: write questions: - How do I refresh the public DNS records of my Data Lake cluster? - Can I update datalake DNS entries by name or CRN? instructions: - text: Update the public DNS entries of datalake {datalake}. slots: datalake: requestBody.datalake - text: Refresh public DNS records for Data Lake {datalake}. slots: datalake: requestBody.datalake method: generated generated: '2026-10-01'