# 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 Servers API
  version: 1.0.0
extends: openapi/microsoft-azure-servers-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: 25
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/{clusterName}/servers'].get
  update:
    x-apievangelist-phrasing:
      intent: List the servers in a Cosmos DB for PostgreSQL cluster
      effect: read
      questions:
      - Which nodes make up my Cosmos DB for PostgreSQL cluster?
      - How can I see every server that belongs to a PostgreSQL cluster in serverGroupsv2?
      instructions:
      - text: List the servers in PostgreSQL cluster {clusterName}.
        slots:
          clusterName: path.clusterName
      - text: Show me all coordinator and worker servers for cluster {clusterName}.
        slots:
          clusterName: path.clusterName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/{clusterName}/servers/{serverName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one server in a Cosmos DB for PostgreSQL cluster
      effect: read
      questions:
      - What are the details of a single node in my Cosmos DB for PostgreSQL cluster?
      - Can I look up one server by name inside a PostgreSQL cluster (the cluster API, not server groups)?
      instructions:
      - text: Get server {serverName} in PostgreSQL cluster {clusterName}.
        slots:
          serverName: path.serverName
          clusterName: path.clusterName
      - text: Show the configuration of node {serverName} from cluster {clusterName}.
        slots:
          serverName: path.serverName
          clusterName: path.clusterName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/usages'].get
  update:
    x-apievangelist-phrasing:
      intent: Show usage metrics for an Azure SQL server
      effect: read
      questions:
      - How much of its quota is my Azure SQL logical server using?
      - Where do I check database and DTU usage totals for a SQL server?
      instructions:
      - text: Show usage figures for SQL server {serverName}.
        slots:
          serverName: path.serverName
      - text: Report current quota usage on Azure SQL server {serverName}.
        slots:
          serverName: path.serverName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AnalysisServices/servers/{serverName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Analysis Services server
      effect: read
      questions:
      - What SKU and state is my Analysis Services server in right now?
      - How do I fetch the full details of one Azure Analysis Services server?
      instructions:
      - text: Get Analysis Services server {serverName} in resource group {resourceGroupName}.
        slots:
          serverName: path.serverName
          resourceGroupName: path.resourceGroupName
      - text: Show the details of Analysis Services server {serverName} in subscription {subscriptionId}.
        slots:
          serverName: path.serverName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AnalysisServices/servers/{serverName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Provision an Analysis Services server
      effect: write
      questions:
      - How do I provision a new Azure Analysis Services server?
      - Which SKU and location must I pass when creating an Analysis Services server?
      instructions:
      - text: Provision Analysis Services server {serverName} in {location} with SKU {sku}.
        slots:
          serverName: path.serverName
          location: requestBody.location
          sku: requestBody.sku
      - text: Create an Analysis Services server named {serverName} in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          serverName: path.serverName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AnalysisServices/servers/{serverName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Analysis Services server
      effect: destructive
      questions:
      - How do I remove an Analysis Services server I no longer need?
      - Can I delete an Azure Analysis Services instance through the API?
      instructions:
      - text: Delete Analysis Services server {serverName} in subscription {subscriptionId}.
        slots:
          serverName: path.serverName
          subscriptionId: path.subscriptionId
      - text: Remove Analysis Services server {serverName} from resource group {resourceGroupName}.
        slots:
          serverName: path.serverName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AnalysisServices/servers/{serverName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an Analysis Services server
      effect: write
      questions:
      - Can I scale an existing Analysis Services server to a different SKU?
      - How do I change the tags on an Analysis Services server?
      instructions:
      - text: Change the SKU of Analysis Services server {serverName} to {sku}.
        slots:
          serverName: path.serverName
          sku: requestBody.sku
      - text: Set tags {tags} on Analysis Services server {serverName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          tags: requestBody.tags
          serverName: path.serverName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AnalysisServices/servers/{serverName}/suspend'].post
  update:
    x-apievangelist-phrasing:
      intent: Pause an Analysis Services server
      effect: write
      questions:
      - Can I pause an Analysis Services server to stop paying for compute?
      - How do I suspend an Analysis Services instance overnight?
      instructions:
      - text: Suspend Analysis Services server {serverName} in subscription {subscriptionId}.
        slots:
          serverName: path.serverName
          subscriptionId: path.subscriptionId
      - text: Pause server {serverName} in resource group {resourceGroupName}.
        slots:
          serverName: path.serverName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AnalysisServices/servers/{serverName}/resume'].post
  update:
    x-apievangelist-phrasing:
      intent: Resume a paused Analysis Services server
      effect: write
      questions:
      - How do I bring a suspended Analysis Services server back online?
      - What call restarts an Analysis Services server that I paused?
      instructions:
      - text: Resume Analysis Services server {serverName} in subscription {subscriptionId}.
        slots:
          serverName: path.serverName
          subscriptionId: path.subscriptionId
      - text: Start the paused server {serverName} in {resourceGroupName} again.
        slots:
          serverName: path.serverName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AnalysisServices/servers'].get
  update:
    x-apievangelist-phrasing:
      intent: List Analysis Services servers in a resource group
      effect: read
      questions:
      - Which Analysis Services servers live in one resource group?
      - How can I enumerate Analysis Services instances scoped to a single resource group?
      instructions:
      - text: List Analysis Services servers in resource group {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      - text: Show every Analysis Services instance under {resourceGroupName} in subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.AnalysisServices/servers'].get
  update:
    x-apievangelist-phrasing:
      intent: List all Analysis Services servers in a subscription
      effect: read
      questions:
      - How many Analysis Services servers do I have across my whole subscription?
      - Is there a subscription-wide inventory of Analysis Services instances?
      instructions:
      - text: List every Analysis Services server in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Give me a subscription-wide inventory of Analysis Services servers for {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AnalysisServices/servers/{serverName}/skus'].get
  update:
    x-apievangelist-phrasing:
      intent: List SKUs an Analysis Services server can move to
      effect: read
      questions:
      - Which pricing tiers can my existing Analysis Services server be scaled to?
      - What SKUs are eligible for an Analysis Services server I already run?
      instructions:
      - text: List eligible SKUs for Analysis Services server {serverName} in subscription {subscriptionId}.
        slots:
          serverName: path.serverName
          subscriptionId: path.subscriptionId
      - text: Show which tiers server {serverName} in {resourceGroupName} can be resized to.
        slots:
          serverName: path.serverName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AnalysisServices/servers/{serverName}/listGatewayStatus'].post
  update:
    x-apievangelist-phrasing:
      intent: Check an Analysis Services server's gateway status
      effect: read
      questions:
      - Is the on-premises data gateway for my Analysis Services server healthy?
      - How do I check the gateway status of an Analysis Services instance?
      instructions:
      - text: Get the gateway status for Analysis Services server {serverName} in {resourceGroupName}.
        slots:
          serverName: path.serverName
          resourceGroupName: path.resourceGroupName
      - text: Check whether server {serverName} in subscription {subscriptionId} can reach its data gateway.
        slots:
          serverName: path.serverName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AnalysisServices/servers/{serverName}/dissociateGateway'].post
  update:
    x-apievangelist-phrasing:
      intent: Detach the gateway from an Analysis Services server
      effect: destructive
      questions:
      - How do I unlink a Unified Gateway from my Analysis Services server?
      - Can I dissociate the data gateway an Analysis Services server is using?
      instructions:
      - text: Dissociate the gateway from Analysis Services server {serverName} in subscription {subscriptionId}.
        slots:
          serverName: path.serverName
          subscriptionId: path.subscriptionId
      - text: Unlink the Unified Gateway on server {serverName} in {resourceGroupName}.
        slots:
          serverName: path.serverName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.AnalysisServices/locations/{location}/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check if an Analysis Services server name is free
      effect: read
      questions:
      - Is a given Analysis Services server name already taken in a region?
      - Can I verify a server name is available before provisioning Analysis Services?
      instructions:
      - text: Check whether Analysis Services name {name} is available in {location}.
        slots:
          name: requestBody.name
          location: path.location
      - text: Tell me if I can use {name} for a new Analysis Services server in {location} under subscription {subscriptionId}.
        slots:
          name: requestBody.name
          location: path.location
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.AnalysisServices/locations/{location}/operationresults/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the result of an Analysis Services operation
      effect: read
      questions:
      - Where do I fetch the outcome of a long-running Analysis Services operation?
      - How can I see the final result of an Analysis Services async request?
      instructions:
      - text: Get the result of Analysis Services operation {operationId} in {location}.
        slots:
          operationId: path.operationId
          location: path.location
      - text: Fetch the operation result for {operationId} in region {location}, subscription {subscriptionId}.
        slots:
          operationId: path.operationId
          location: path.location
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.AnalysisServices/locations/{location}/operationstatuses/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Poll the status of an Analysis Services operation
      effect: read
      questions:
      - Is my Analysis Services provisioning operation still in progress?
      - What status is an Analysis Services async operation reporting?
      instructions:
      - text: Check the status of Analysis Services operation {operationId} in {location}.
        slots:
          operationId: path.operationId
          location: path.location
      - text: Poll progress for operation {operationId} in region {location}, subscription {subscriptionId}.
        slots:
          operationId: path.operationId
          location: path.location
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/serverGroupsv2/{serverGroupName}/servers'].get
  update:
    x-apievangelist-phrasing:
      intent: List the servers in a PostgreSQL server group
      effect: read
      questions:
      - Which servers belong to my Hyperscale (Citus) server group?
      - How do I list nodes in a PostgreSQL server group?
      instructions:
      - text: List the servers in PostgreSQL server group {serverGroupName}.
        slots:
          serverGroupName: path.serverGroupName
      - text: Show all nodes of Hyperscale server group {serverGroupName}.
        slots:
          serverGroupName: path.serverGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/serverGroupsv2/{serverGroupName}/servers/{serverName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one server in a PostgreSQL server group
      effect: read
      questions:
      - How do I inspect a single node of a Hyperscale (Citus) server group?
      - What does one server inside a PostgreSQL server group look like?
      instructions:
      - text: Get server {serverName} in PostgreSQL server group {serverGroupName}.
        slots:
          serverName: path.serverName
          serverGroupName: path.serverGroupName
      - text: Show details for node {serverName} of Hyperscale server group {serverGroupName}.
        slots:
          serverName: path.serverName
          serverGroupName: path.serverGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a MariaDB server
      effect: read
      questions:
      - What version and SKU is my Azure Database for MariaDB server running?
      - How do I look up one MariaDB server's properties?
      instructions:
      - text: Get MariaDB server {serverName} in resource group {resourceGroupName}.
        slots:
          serverName: path.serverName
          resourceGroupName: path.resourceGroupName
      - text: Show the details of MariaDB server {serverName} in subscription {subscriptionId}.
        slots:
          serverName: path.serverName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or overwrite a MariaDB server
      effect: write
      questions:
      - How do I create a new Azure Database for MariaDB server?
      - Does re-creating a MariaDB server with the same name overwrite the existing one?
      instructions:
      - text: Create MariaDB server {serverName} in {location} with properties {properties}.
        slots:
          serverName: path.serverName
          location: requestBody.location
          properties: requestBody.properties
      - text: Provision a MariaDB server named {serverName} in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          serverName: path.serverName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a MariaDB server
      effect: destructive
      questions:
      - How do I delete an Azure Database for MariaDB server?
      - Can I tear down a MariaDB server I'm done with via the API?
      instructions:
      - text: Delete MariaDB server {serverName} in subscription {subscriptionId}.
        slots:
          serverName: path.serverName
          subscriptionId: path.subscriptionId
      - text: Remove MariaDB server {serverName} from {resourceGroupName}.
        slots:
          serverName: path.serverName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update settings on a MariaDB server
      effect: write
      questions:
      - Can I change just one property of a MariaDB server without redefining it?
      - How do I scale the SKU of an existing MariaDB server?
      instructions:
      - text: Change the SKU of MariaDB server {serverName} in {resourceGroupName} to {sku}.
        slots:
          serverName: path.serverName
          resourceGroupName: path.resourceGroupName
          sku: requestBody.sku
      - text: Update tags on MariaDB server {serverName} in subscription {subscriptionId} to {tags}.
        slots:
          serverName: path.serverName
          subscriptionId: path.subscriptionId
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers'].get
  update:
    x-apievangelist-phrasing:
      intent: List MariaDB servers in a resource group
      effect: read
      questions:
      - Which MariaDB servers are in one of my resource groups?
      - How do I list MariaDB databases servers for just one resource group?
      instructions:
      - text: List MariaDB servers in resource group {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      - text: Show every MariaDB server under {resourceGroupName} in subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DBforMariaDB/servers'].get
  update:
    x-apievangelist-phrasing:
      intent: List all MariaDB servers in a subscription
      effect: read
      questions:
      - What MariaDB servers exist anywhere in my subscription?
      - Is there one call that inventories MariaDB servers subscription-wide?
      instructions:
      - text: List every MariaDB server in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Inventory all Azure Database for MariaDB servers across resource groups in {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'