API Evangelist conversational phrasing for Cloudera Service Datalake API

# 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'


# --- truncated at 32 KB (40 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cloudera/refs/heads/main/overlays/cloudera-datalake-api-phrasing-overlay.yaml