# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Microsoft Azure Databases API version: 1.0.0 extends: openapi/microsoft-azure-databases-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-26' generator: build-phrasing.py label: Generated by API Evangelist operations: 29 - target: $.paths['/dbs'].get update: x-apievangelist-phrasing: intent: List databases in a Cosmos DB account effect: read questions: - Which databases exist in my Cosmos DB database account? - Can I page through the databases in my account with a continuation token? instructions: - text: List every database in my Cosmos DB account. - text: List up to {maxItems} databases in the database account. slots: maxItems: header.x-ms-max-item-count - text: Continue listing account databases from continuation token {token}. slots: token: header.x-ms-continuation method: generated generated: '2026-09-26' - target: $.paths['/dbs'].post update: x-apievangelist-phrasing: intent: Create a database in a Cosmos DB account effect: write questions: - How do I create a new database in my Cosmos DB account through the REST API? - What do I have to supply to add a database to a database account? instructions: - text: Create a Cosmos DB database with id {id}. slots: id: requestBody.id - text: Add a new database named {id} to my database account. slots: id: requestBody.id method: generated generated: '2026-09-26' - target: $.paths['/dbs/{databaseId}'].get update: x-apievangelist-phrasing: intent: Get a Cosmos DB database by ID effect: read questions: - How can I look up one Cosmos DB database by its ID? - Does a database with a given ID exist in my database account? instructions: - text: Get the Cosmos DB database {databaseId}. slots: databaseId: path.databaseId - text: Show me the resource details for account database {databaseId}. slots: databaseId: path.databaseId method: generated generated: '2026-09-26' - target: $.paths['/dbs/{databaseId}'].delete update: x-apievangelist-phrasing: intent: Delete a Cosmos DB database and its contents effect: destructive questions: - What happens to containers and items when I delete a Cosmos DB database? - Can I remove a whole database from my database account in one call? instructions: - text: Delete the Cosmos DB database {databaseId} and everything in it. slots: databaseId: path.databaseId - text: Remove account database {databaseId}, including its containers and items. slots: databaseId: path.databaseId method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/usages'].get update: x-apievangelist-phrasing: intent: Get usage metrics for an Azure SQL database effect: read questions: - How much of its quotas is my Azure SQL database using? - Where can I see the usage figures for a single SQL database? instructions: - text: Show usages for SQL database {databaseName} on server {serverName}. slots: databaseName: path.databaseName serverName: path.serverName - text: Get the database usage report for {databaseName} on SQL server {serverName}. slots: databaseName: path.databaseName serverName: path.serverName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/checkNameAvailability'].post update: x-apievangelist-phrasing: intent: Check if a Kusto database name is available effect: read questions: - Is a database name already taken in my Kusto cluster? - Can I validate a database name before creating it in Azure Data Explorer? instructions: - text: Check whether database name {name} of type {type} is free on cluster {clusterName} (group {resourceGroupName}, subscription {subscriptionId}). slots: name: requestBody.name type: requestBody.type clusterName: path.clusterName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId - text: Validate that {name} is an unused database name in Kusto cluster {clusterName}. slots: name: requestBody.name clusterName: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/databases'].get update: x-apievangelist-phrasing: intent: List databases in a Kusto cluster effect: read questions: - Which databases are in my Azure Data Explorer cluster? - How do I list all databases of a Kusto cluster? instructions: - text: List all databases on cluster {clusterName} (group {resourceGroupName}, subscription {subscriptionId}). slots: clusterName: path.clusterName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId - text: Show the databases in Data Explorer cluster {clusterName}. slots: clusterName: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/databases/{databaseName}'].get update: x-apievangelist-phrasing: intent: Get a Kusto cluster database effect: read questions: - How can I read the settings of one database in my Kusto cluster? - What properties does a Data Explorer database return? instructions: - text: Get Kusto database {databaseName} on cluster {clusterName} (group {resourceGroupName}, subscription {subscriptionId}). slots: databaseName: path.databaseName clusterName: path.clusterName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId - text: Show Data Explorer database {databaseName} from cluster {clusterName}. slots: databaseName: path.databaseName clusterName: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/databases/{databaseName}'].put update: x-apievangelist-phrasing: intent: Create or update a Kusto database effect: write questions: - How do I create a database inside an Azure Data Explorer cluster? - Can I set properties like retention when provisioning a Kusto database? instructions: - text: Create or update Kusto database {databaseName} on cluster {clusterName} (group {resourceGroupName}, subscription {subscriptionId}). slots: databaseName: path.databaseName clusterName: path.clusterName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId - text: Provision Data Explorer database {databaseName} in cluster {clusterName} with properties {properties}. slots: databaseName: path.databaseName clusterName: path.clusterName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/databases/{databaseName}'].delete update: x-apievangelist-phrasing: intent: Delete a Kusto database effect: destructive questions: - Can I drop a database from my Azure Data Explorer cluster? - What is the call to remove a Kusto database by name? instructions: - text: Delete Kusto database {databaseName} on cluster {clusterName} (group {resourceGroupName}, subscription {subscriptionId}). slots: databaseName: path.databaseName clusterName: path.clusterName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId - text: Drop Data Explorer database {databaseName} from cluster {clusterName}. slots: databaseName: path.databaseName clusterName: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/databases/{databaseName}'].patch update: x-apievangelist-phrasing: intent: Update a Kusto database's properties effect: write questions: - How do I change properties on an existing Kusto database without recreating it? - Can I patch the location or properties of a Data Explorer database? instructions: - text: Patch Kusto database {databaseName} on cluster {clusterName} (group {resourceGroupName}, subscription {subscriptionId}) with properties {properties}. slots: databaseName: path.databaseName clusterName: path.clusterName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId properties: requestBody.properties - text: Update existing Data Explorer database {databaseName} in cluster {clusterName}. slots: databaseName: path.databaseName clusterName: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/databases/{databaseName}/listPrincipals'].post update: x-apievangelist-phrasing: intent: List principals with access to a Kusto database effect: read questions: - Who has permissions on my Kusto database? - Which users and apps are principals of a Data Explorer database? instructions: - text: List the principals of Kusto database {databaseName} on cluster {clusterName} (group {resourceGroupName}, subscription {subscriptionId}). slots: databaseName: path.databaseName clusterName: path.clusterName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId - text: Show who has access to Data Explorer database {databaseName} in cluster {clusterName}. slots: databaseName: path.databaseName clusterName: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/databases/{databaseName}/addPrincipals'].post update: x-apievangelist-phrasing: intent: Grant principals access to a Kusto database effect: write questions: - How do I give a user permissions on a Kusto database? - Can I add several principals to a Data Explorer database at once? instructions: - text: Add principals {principals} to Kusto database {databaseName} on cluster {clusterName} (group {resourceGroupName}, subscription {subscriptionId}). slots: principals: requestBody.value databaseName: path.databaseName clusterName: path.clusterName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId - text: Grant database permissions on {databaseName} in cluster {clusterName} to {principals}. slots: databaseName: path.databaseName clusterName: path.clusterName principals: requestBody.value method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/databases/{databaseName}/removePrincipals'].post update: x-apievangelist-phrasing: intent: Revoke principals' access to a Kusto database effect: destructive questions: - How do I take away someone's permissions on a Kusto database? - Can I remove principals from a Data Explorer database? instructions: - text: Remove principals {principals} from Kusto database {databaseName} on cluster {clusterName} (group {resourceGroupName}, subscription {subscriptionId}). slots: principals: requestBody.value databaseName: path.databaseName clusterName: path.clusterName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId - text: Revoke access for {principals} on Data Explorer database {databaseName} in cluster {clusterName}. slots: principals: requestBody.value databaseName: path.databaseName clusterName: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}/databases/{databaseName}'].get update: x-apievangelist-phrasing: intent: Get a database on a MariaDB server effect: read questions: - How can I see details of one database on my Azure Database for MariaDB server? - What charset and collation does a MariaDB database use? instructions: - text: Get MariaDB database {databaseName} on MariaDB server {serverName} in resource group {resourceGroupName}, subscription {subscriptionId}. slots: databaseName: path.databaseName serverName: path.serverName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId - text: Show information about database {databaseName} on MariaDB server {serverName}. slots: databaseName: path.databaseName serverName: path.serverName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}/databases/{databaseName}'].put update: x-apievangelist-phrasing: intent: Create or update a MariaDB database effect: write questions: - How do I create a new database on an Azure Database for MariaDB server? - Can I change the charset of an existing MariaDB database? instructions: - text: Create or update MariaDB database {databaseName} on MariaDB server {serverName} in resource group {resourceGroupName}, subscription {subscriptionId}. slots: databaseName: path.databaseName serverName: path.serverName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId - text: Create database {databaseName} on MariaDB server {serverName} with properties {properties}. slots: databaseName: path.databaseName serverName: path.serverName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}/databases/{databaseName}'].delete update: x-apievangelist-phrasing: intent: Delete a MariaDB database effect: destructive questions: - Can I drop a database from my MariaDB server through the management API? - What removes a single database from an Azure MariaDB server? instructions: - text: Delete MariaDB database {databaseName} on MariaDB server {serverName} in resource group {resourceGroupName}, subscription {subscriptionId}. slots: databaseName: path.databaseName serverName: path.serverName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId - text: Drop database {databaseName} from MariaDB server {serverName}. slots: databaseName: path.databaseName serverName: path.serverName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}/databases'].get update: x-apievangelist-phrasing: intent: List databases on a MariaDB server effect: read questions: - Which databases are on my Azure Database for MariaDB server? - How do I list every database a MariaDB server hosts? instructions: - text: List all databases on MariaDB server {serverName} in resource group {resourceGroupName}, subscription {subscriptionId}. slots: serverName: path.serverName resourceGroupName: path.resourceGroupName subscriptionId: path.subscriptionId - text: Show the databases hosted by MariaDB server {serverName}. slots: serverName: path.serverName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases'].get update: x-apievangelist-phrasing: intent: List databases in a Redis Enterprise cluster effect: read questions: - Which databases are in my Azure Cache for Redis Enterprise cluster? - How do I enumerate the databases of a RedisEnterprise cluster? instructions: - text: List all databases in Redis Enterprise cluster {clusterName}. slots: clusterName: path.clusterName - text: Show every database of RedisEnterprise cluster {clusterName}. slots: clusterName: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}'].get update: x-apievangelist-phrasing: intent: Get a Redis Enterprise database effect: read questions: - How can I read the configuration of a Redis Enterprise database? - What does a RedisEnterprise database report about itself? instructions: - text: Get Redis Enterprise database {databaseName} in cluster {clusterName}. slots: databaseName: path.databaseName clusterName: path.clusterName - text: Show details of RedisEnterprise database {databaseName} on {clusterName}. slots: databaseName: path.databaseName clusterName: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}'].put update: x-apievangelist-phrasing: intent: Create a Redis Enterprise database effect: write questions: - How do I add a database to a Redis Enterprise cluster? - Can I set clustering or eviction properties when creating a RedisEnterprise database? instructions: - text: Create Redis Enterprise database {databaseName} in cluster {clusterName}. slots: databaseName: path.databaseName clusterName: path.clusterName - text: Create RedisEnterprise database {databaseName} on {clusterName} with properties {properties}. slots: databaseName: path.databaseName clusterName: path.clusterName properties: requestBody.properties method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}'].delete update: x-apievangelist-phrasing: intent: Delete a Redis Enterprise database effect: destructive questions: - Can I delete one database from my Redis Enterprise cluster? - What removes a single RedisEnterprise database? instructions: - text: Delete Redis Enterprise database {databaseName} from cluster {clusterName}. slots: databaseName: path.databaseName clusterName: path.clusterName - text: Remove RedisEnterprise database {databaseName} on {clusterName}. slots: databaseName: path.databaseName clusterName: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}'].patch update: x-apievangelist-phrasing: intent: Update a Redis Enterprise database effect: write questions: - How do I change settings on an existing Redis Enterprise database? - Can I patch properties of a RedisEnterprise database in place? instructions: - text: Update Redis Enterprise database {databaseName} in cluster {clusterName} with properties {properties}. slots: databaseName: path.databaseName clusterName: path.clusterName properties: requestBody.properties - text: Patch existing RedisEnterprise database {databaseName} on {clusterName}. slots: databaseName: path.databaseName clusterName: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}/listKeys'].post update: x-apievangelist-phrasing: intent: Get the access keys for a Redis Enterprise database effect: read questions: - Where do I get the access keys to connect to my Redis Enterprise database? - Can I retrieve the primary and secondary keys of a RedisEnterprise database? instructions: - text: Get the access keys for Redis Enterprise database {databaseName} in cluster {clusterName}. slots: databaseName: path.databaseName clusterName: path.clusterName - text: Retrieve connection keys of RedisEnterprise database {databaseName} on {clusterName}. slots: databaseName: path.databaseName clusterName: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}/regenerateKey'].post update: x-apievangelist-phrasing: intent: Regenerate a Redis Enterprise database access key effect: write questions: - How do I rotate an access key on my Redis Enterprise database? - Can I regenerate just the primary or just the secondary key? instructions: - text: Regenerate the {keyType} access key of Redis Enterprise database {databaseName} in cluster {clusterName}. slots: keyType: requestBody.keyType databaseName: path.databaseName clusterName: path.clusterName - text: Rotate the {keyType} key for RedisEnterprise database {databaseName} on {clusterName}. slots: keyType: requestBody.keyType databaseName: path.databaseName clusterName: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}/import'].post update: x-apievangelist-phrasing: intent: Import data files into a Redis Enterprise database effect: write questions: - How do I load RDB files from blob storage into a Redis Enterprise database? - Can I import several database files at once using SAS URIs? instructions: - text: Import files {sasUris} into Redis Enterprise database {databaseName} in cluster {clusterName}. slots: sasUris: requestBody.sasUris databaseName: path.databaseName clusterName: path.clusterName - text: Load the blobs at {sasUris} into RedisEnterprise database {databaseName} on {clusterName}. slots: sasUris: requestBody.sasUris databaseName: path.databaseName clusterName: path.clusterName method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}/export'].post update: x-apievangelist-phrasing: intent: Export a Redis Enterprise database to storage effect: write questions: - How do I export my Redis Enterprise database to a storage container? - Can I dump a RedisEnterprise database to a SAS URI for backup? instructions: - text: Export Redis Enterprise database {databaseName} in cluster {clusterName} to {sasUri}. slots: databaseName: path.databaseName clusterName: path.clusterName sasUri: requestBody.sasUri - text: Write a database file of RedisEnterprise database {databaseName} on {clusterName} to container {sasUri}. slots: databaseName: path.databaseName clusterName: path.clusterName sasUri: requestBody.sasUri method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}/forceUnlink'].post update: x-apievangelist-phrasing: intent: Force-unlink a Redis Enterprise geo-replicated database effect: destructive questions: - How do I forcibly remove a linked database from a Redis Enterprise geo-replication group? - Can I break the link to an unreachable linked RedisEnterprise database? instructions: - text: Force-unlink databases {ids} from Redis Enterprise database {databaseName} in cluster {clusterName}. slots: ids: requestBody.ids databaseName: path.databaseName clusterName: path.clusterName - text: Forcibly remove the link from RedisEnterprise database {databaseName} on {clusterName} to linked database {ids}. slots: databaseName: path.databaseName clusterName: path.clusterName ids: requestBody.ids method: generated generated: '2026-09-26' - target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}/databases/{databaseName}/flush'].post update: x-apievangelist-phrasing: intent: Flush all keys from a Redis Enterprise database effect: destructive questions: - How do I wipe every key from my Redis Enterprise database? - Does flushing a RedisEnterprise database also clear its linked databases? instructions: - text: Flush all keys in Redis Enterprise database {databaseName} in cluster {clusterName}. slots: databaseName: path.databaseName clusterName: path.clusterName - text: Flush RedisEnterprise database {databaseName} on {clusterName} and its linked databases {ids}. slots: databaseName: path.databaseName clusterName: path.clusterName ids: requestBody.ids method: generated generated: '2026-09-26'