# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Cloudera Lakehouse Optimizer Service Lakehouseopt API version: 1.0.0 extends: openapi/cloudera-lakehouseopt-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: 30 - target: $.paths['/api/v1/lakehouseopt/getHealth'].post update: x-apievangelist-phrasing: intent: Check health of Lakehouse Optimizer components effect: read questions: - Are the Lakehouse Optimizer scheduler, dispatcher and DAO services healthy? - Can I limit a CLO health check to a specific scope? instructions: - text: Run a health check on the Lakehouse Optimizer for Data Hub {datahubCrn}. slots: datahubCrn: requestBody.datahubCrn - text: Check CLO component health for {datahubCrn} with scope {scope}. slots: datahubCrn: requestBody.datahubCrn scope: requestBody.scope method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/listEnvironments'].post update: x-apievangelist-phrasing: intent: List environments with their CLO Data Hub effect: read questions: - Which of my environments have a Lakehouse Optimizer Data Hub enabled? - Can I page through the environments known to Lakehouse Optimizer? instructions: - text: List my environments along with their Lakehouse Optimizer Data Hub details. - text: List Lakehouse Optimizer environments, {pageSize} per page. slots: pageSize: requestBody.pageSize method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/getDatahubCrn'].post update: x-apievangelist-phrasing: intent: Look up the Data Hub CRN for an environment effect: read questions: - What is the Data Hub CRN I should use for Lakehouse Optimizer calls in my environment? - Can I resolve an environment CRN to its Data Hub CRN? instructions: - text: Get the Data Hub CRN for environment {environmentCrn}. slots: environmentCrn: requestBody.environmentCrn - text: Resolve environment {environmentCrn} to its Data Hub CRN only. slots: environmentCrn: requestBody.environmentCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/getCloDatahub'].post update: x-apievangelist-phrasing: intent: Get the CLO Data Hub for an environment effect: read questions: - Which Data Hub runs Lakehouse Optimizer in a given environment, and what are its details? - Can I fetch the full CLO Data Hub record for one environment? instructions: - text: Fetch the Lakehouse Optimizer Data Hub record for environment {environmentCrn}. slots: environmentCrn: requestBody.environmentCrn - text: Show the CLO Data Hub details in environment {environmentCrn}. slots: environmentCrn: requestBody.environmentCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/listPolicies'].post update: x-apievangelist-phrasing: intent: List table maintenance policies effect: read questions: - What maintenance policies are defined in Lakehouse Optimizer? - Can I list only the policies that apply to one namespace? instructions: - text: List all Lakehouse Optimizer policies on Data Hub {datahubCrn}. slots: datahubCrn: requestBody.datahubCrn - text: List the policies with full details in namespace {namespace} on {datahubCrn}. slots: namespace: requestBody.namespace datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/getPolicy'].post update: x-apievangelist-phrasing: intent: Get details of a maintenance policy effect: read questions: - What actions, scope, versions and status does a particular policy have? - Can I see which tables a single named policy is associated with? instructions: - text: Get the details of policy {policyName} on Data Hub {datahubCrn}. slots: policyName: requestBody.policyName datahubCrn: requestBody.datahubCrn - text: Show version IDs and actions for policy {policyName} on {datahubCrn}. slots: policyName: requestBody.policyName datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/downloadPolicy'].post update: x-apievangelist-phrasing: intent: Download a policy version's definition effect: read questions: - How do I get the scripts and arguments behind a specific policy version? - Can I export the definition of an older version of a policy? instructions: - text: Download version {policyVersion} of policy {policyName} from {datahubCrn}. slots: policyVersion: requestBody.policyVersion policyName: requestBody.policyName datahubCrn: requestBody.datahubCrn - text: Export the scripts for policy {policyName} version {policyVersion} on Data Hub {datahubCrn}. slots: policyName: requestBody.policyName policyVersion: requestBody.policyVersion datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/getNamespaces'].post update: x-apievangelist-phrasing: intent: List namespaces in the catalog effect: read questions: - Which namespaces exist in the catalog Lakehouse Optimizer manages? - What databases can I target with optimization policies? instructions: - text: List all namespaces in the catalog for Data Hub {datahubCrn}. slots: datahubCrn: requestBody.datahubCrn - text: Show me every namespace Lakehouse Optimizer sees on {datahubCrn}. slots: datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/getTableNames'].post update: x-apievangelist-phrasing: intent: Get just the table names in a namespace effect: read questions: - What are the names of the tables in a given namespace? - Can I get a plain list of table names without the extra table details? instructions: - text: Get the table names in namespace {namespace} on Data Hub {datahubCrn}. slots: namespace: requestBody.namespace datahubCrn: requestBody.datahubCrn - text: Give me only the names of tables in {namespace} on {datahubCrn}. slots: namespace: requestBody.namespace datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/listTables'].post update: x-apievangelist-phrasing: intent: List tables in a namespace with details effect: read questions: - Which tables in a namespace does Lakehouse Optimizer track, with their details? - Can I list the table records in one namespace? instructions: - text: List the tables with their details in namespace {namespace} on {datahubCrn}. slots: namespace: requestBody.namespace datahubCrn: requestBody.datahubCrn - text: Show the table entries for namespace {namespace} on Data Hub {datahubCrn}. slots: namespace: requestBody.namespace datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/getTablePolicies'].post update: x-apievangelist-phrasing: intent: Get policies applied to a table effect: read questions: - Which maintenance policies are applied to a particular table? - Can I check what policies run against one table in a namespace? instructions: - text: Get the policies on table {tableName} in namespace {namespace} on {datahubCrn}. slots: tableName: requestBody.tableName namespace: requestBody.namespace datahubCrn: requestBody.datahubCrn - text: Show which policies cover table {namespace}.{tableName} on Data Hub {datahubCrn}. slots: namespace: requestBody.namespace tableName: requestBody.tableName datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/getPolicyNames'].post update: x-apievangelist-phrasing: intent: Get policy names linked to a namespace effect: read questions: - What policy names are associated with a namespace? - Can I get just the names of policies tied to one database? instructions: - text: Get the policy names associated with namespace {namespace} on {datahubCrn}. slots: namespace: requestBody.namespace datahubCrn: requestBody.datahubCrn - text: List only the names of policies linked to {namespace} on Data Hub {datahubCrn}. slots: namespace: requestBody.namespace datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/createTablePoliciesAssociations'].post update: x-apievangelist-phrasing: intent: Attach policies to a table effect: write questions: - How do I attach several maintenance policies to one table at once? - Can I associate a table with a list of policies? instructions: - text: Associate table {tableName} in {namespace} on {datahubCrn} with policies {policies}. slots: tableName: requestBody.tableName namespace: requestBody.namespace datahubCrn: requestBody.datahubCrn policies: requestBody.policies - text: Attach policies {policies} to table {namespace}.{tableName} on Data Hub {datahubCrn}. slots: policies: requestBody.policies namespace: requestBody.namespace tableName: requestBody.tableName datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/getScripts'].post update: x-apievangelist-phrasing: intent: List default and catalog-level scripts effect: read questions: - Which maintenance scripts are available to build policies from? - What default or catalog-defined scripts does Lakehouse Optimizer provide? instructions: - text: Get the available policy scripts on Data Hub {datahubCrn}. slots: datahubCrn: requestBody.datahubCrn - text: List the default and catalog-level scripts for {datahubCrn}. slots: datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/getAssociations'].post update: x-apievangelist-phrasing: intent: Get tables associated with a policy effect: read questions: - Which tables, grouped by namespace, is a policy currently associated with? - Can I see the current table associations for a single policy? instructions: - text: Get the table associations for policy {policyName} on {datahubCrn}. slots: policyName: requestBody.policyName datahubCrn: requestBody.datahubCrn - text: Show the tables per namespace currently bound to policy {policyName} on Data Hub {datahubCrn}. slots: policyName: requestBody.policyName datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/createAssociations'].post update: x-apievangelist-phrasing: intent: Associate tables with a policy effect: write questions: - How do I apply one policy to a set of tables across namespaces? - Can I bind many tables to a single policy in one call? instructions: - text: Associate policy {policyName} with tables {associations} on {datahubCrn}. slots: policyName: requestBody.policyName associations: requestBody.associations datahubCrn: requestBody.datahubCrn - text: Bind the table set {associations} to policy {policyName} on Data Hub {datahubCrn}. slots: associations: requestBody.associations policyName: requestBody.policyName datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/createPolicy'].post update: x-apievangelist-phrasing: intent: Create a table maintenance policy effect: write questions: - How do I define a new optimization policy in Lakehouse Optimizer? - What resources do I need to supply when creating a policy? instructions: - text: Create policy {policyName} with resources {resources} on Data Hub {datahubCrn}. slots: policyName: requestBody.policyName resources: requestBody.resources datahubCrn: requestBody.datahubCrn - text: Define a new Lakehouse Optimizer policy named {policyName} on {datahubCrn} using {resources}. slots: policyName: requestBody.policyName datahubCrn: requestBody.datahubCrn resources: requestBody.resources method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/updatePolicy'].post update: x-apievangelist-phrasing: intent: Update an existing maintenance policy effect: write questions: - Can I change the resources of a policy that already exists? - What do I send to modify an existing optimization policy? instructions: - text: Update existing policy {policyName} on {datahubCrn} with resources {resources}. slots: policyName: requestBody.policyName datahubCrn: requestBody.datahubCrn resources: requestBody.resources - text: Replace the resources of policy {policyName} on Data Hub {datahubCrn} with {resources}. slots: policyName: requestBody.policyName datahubCrn: requestBody.datahubCrn resources: requestBody.resources method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/unsubscribePolicy'].post update: x-apievangelist-phrasing: intent: Remove a policy from a table effect: destructive questions: - How do I stop a single policy from applying to one table? - Can I unsubscribe one table from a policy without deleting the policy? instructions: - text: Unsubscribe policy {policyName} from table {tableName} in {namespace} on {datahubCrn}. slots: policyName: requestBody.policyName tableName: requestBody.tableName namespace: requestBody.namespace datahubCrn: requestBody.datahubCrn - text: Detach policy {policyName} from {namespace}.{tableName} on Data Hub {datahubCrn}. slots: policyName: requestBody.policyName namespace: requestBody.namespace tableName: requestBody.tableName datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/pauseTable'].post update: x-apievangelist-phrasing: intent: Pause maintenance on a table effect: write questions: - Can I temporarily stop all maintenance actions on a table? - How do I put optimization of one table on hold? instructions: - text: Pause maintenance on table {tableName} in {namespace} on {datahubCrn}. slots: tableName: requestBody.tableName namespace: requestBody.namespace datahubCrn: requestBody.datahubCrn - text: Put all maintenance actions for {namespace}.{tableName} on hold on Data Hub {datahubCrn}. slots: namespace: requestBody.namespace tableName: requestBody.tableName datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/unpauseTable'].post update: x-apievangelist-phrasing: intent: Resume maintenance on a paused table effect: write questions: - How do I restart maintenance on a table I paused earlier? - Can I unpause a table so its policies run again? instructions: - text: Unpause table {tableName} in {namespace} on {datahubCrn}. slots: tableName: requestBody.tableName namespace: requestBody.namespace datahubCrn: requestBody.datahubCrn - text: Resume maintenance actions on paused table {namespace}.{tableName} on Data Hub {datahubCrn}. slots: namespace: requestBody.namespace tableName: requestBody.tableName datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/listTasks'].post update: x-apievangelist-phrasing: intent: List maintenance tasks in a namespace effect: read questions: - What maintenance tasks has Lakehouse Optimizer run in a namespace? - Can I page through CLO tasks for one namespace? instructions: - text: List maintenance tasks for namespace {namespace} on {datahubCrn}. slots: namespace: requestBody.namespace datahubCrn: requestBody.datahubCrn - text: Show {pageSize} CLO maintenance tasks at a time for {namespace} on Data Hub {datahubCrn}. slots: pageSize: requestBody.pageSize namespace: requestBody.namespace datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/changeTablePolicy'].post update: x-apievangelist-phrasing: intent: Add, remove or replace policies on a table effect: write questions: - Can I swap the policies on a table for a different set? - Which operations can I perform to change a table's policies? instructions: - text: Run the {operation} policy change with {policies} on table {tableName} in {namespace} on {datahubCrn}. slots: operation: requestBody.operation policies: requestBody.policies tableName: requestBody.tableName namespace: requestBody.namespace datahubCrn: requestBody.datahubCrn - text: Replace the policies on {namespace}.{tableName} with {policies} using operation {operation} on Data Hub {datahubCrn}. slots: namespace: requestBody.namespace tableName: requestBody.tableName policies: requestBody.policies operation: requestBody.operation datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/deletePolicy'].post update: x-apievangelist-phrasing: intent: Delete a policy definition for a resource effect: destructive questions: - How do I delete a policy definition for a namespace or table? - What happens if I use a wildcard namespace when deleting a policy? instructions: - text: Delete policy {policyName} for resource scope {resourceScope} on {datahubCrn}. slots: policyName: requestBody.policyName resourceScope: requestBody.resourceScope datahubCrn: requestBody.datahubCrn - text: Remove the definition of policy {policyName} on Data Hub {datahubCrn} for {resourceScope}. slots: policyName: requestBody.policyName datahubCrn: requestBody.datahubCrn resourceScope: requestBody.resourceScope method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/getTimezones'].post update: x-apievangelist-phrasing: intent: List supported policy schedule timezones effect: read questions: - Which timezones can I use when scheduling a policy? - What timezone values does Lakehouse Optimizer accept for schedules? instructions: - text: List the supported timezones for policy schedules. - text: Show every timezone I can schedule a Lakehouse Optimizer policy in. method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/getAssociatedTables'].post update: x-apievangelist-phrasing: intent: Show all tables flagged by policy association effect: read questions: - For a policy, which tables are associated and which are not? - Can I see every table with a flag showing whether a policy covers it? instructions: - text: Show all tables with an association flag for policy {policyName} on {datahubCrn}. slots: policyName: requestBody.policyName datahubCrn: requestBody.datahubCrn - text: List every table and whether policy {policyName} applies to it on Data Hub {datahubCrn}. slots: policyName: requestBody.policyName datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/getAssociatedNamespaces'].post update: x-apievangelist-phrasing: intent: Show namespaces flagged by policy association effect: read questions: - Which namespaces is a policy associated with, and which are left out? - Can I get all namespaces with a flag for a given policy? instructions: - text: Show all namespaces with an association flag for policy {policyName} on {datahubCrn}. slots: policyName: requestBody.policyName datahubCrn: requestBody.datahubCrn - text: List each namespace and whether it is tied to policy {policyName} on Data Hub {datahubCrn}. slots: policyName: requestBody.policyName datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/getTableStatusDetails'].post update: x-apievangelist-phrasing: intent: Get a table's current policy status details effect: read questions: - Why is a table showing a particular status for one of its policies? - Can I drill into the current status of a table under a given policy? instructions: - text: Get status {status} details for table {tableName} in {namespace} under policy {policyName} on {datahubCrn}. slots: status: requestBody.status tableName: requestBody.tableName namespace: requestBody.namespace policyName: requestBody.policyName datahubCrn: requestBody.datahubCrn - text: Explain the {status} status of {namespace}.{tableName} for policy {policyName} on Data Hub {datahubCrn}. slots: status: requestBody.status namespace: requestBody.namespace tableName: requestBody.tableName policyName: requestBody.policyName datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/executePolicy'].post update: x-apievangelist-phrasing: intent: Run a policy on a table now effect: write questions: - Can I trigger a maintenance policy on a table right away instead of waiting for its schedule? - Is there a dry-run mode to evaluate a policy without changing the table? instructions: - text: Execute policy {policyName} on table {tableName} in {namespace} on {datahubCrn}. slots: policyName: requestBody.policyName tableName: requestBody.tableName namespace: requestBody.namespace datahubCrn: requestBody.datahubCrn - text: Dry-run policy {policyName} against {namespace}.{tableName} on Data Hub {datahubCrn} without changing anything. slots: policyName: requestBody.policyName namespace: requestBody.namespace tableName: requestBody.tableName datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01' - target: $.paths['/api/v1/lakehouseopt/getAssociationDetails'].post update: x-apievangelist-phrasing: intent: Get direct and wildcard policy association details effect: read questions: - Which policies are associated directly versus through a wildcard association? - Can I get an overview of all policy associations on my Data Hub? instructions: - text: Get the direct and star policy association details for Data Hub {datahubCrn}. slots: datahubCrn: requestBody.datahubCrn - text: Summarize every policy association on {datahubCrn}. slots: datahubCrn: requestBody.datahubCrn method: generated generated: '2026-10-01'