# 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 Clusters API
  version: 1.0.0
extends: openapi/microsoft-azure-clusters-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: 28
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/clusters/{clusterName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Arc-enabled vSphere cluster
      effect: read
      questions:
      - What details can I see for a VMware vSphere cluster connected through Azure Arc?
      - Can I look up one Arc-enabled vCenter cluster by its name and resource group?
      instructions:
      - text: Show me the Arc-enabled vSphere cluster {cluster} in resource group {rg} of subscription {sub}.
        slots:
          sub: path.subscriptionId
          cluster: path.clusterName
          rg: path.resourceGroupName
      - text: Fetch the vSphere cluster resource {cluster} from {rg}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/clusters/{clusterName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an Arc-enabled vSphere cluster
      effect: write
      questions:
      - How do I register a VMware vSphere cluster as an Azure resource through Arc?
      - Which fields are required to create a connected vSphere cluster resource?
      instructions:
      - text: Create the Arc-enabled vSphere cluster {cluster} in {rg} of subscription {sub} in region {location}.
        slots:
          sub: path.subscriptionId
          cluster: path.clusterName
          rg: path.resourceGroupName
          location: requestBody.location
      - text: Register vSphere cluster {cluster} in {rg} with properties {properties} and location {location}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
          properties: requestBody.properties
          location: requestBody.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/clusters/{clusterName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Arc-enabled vSphere cluster
      effect: destructive
      questions:
      - Can I force-remove a connected vSphere cluster resource from Azure?
      - What happens when I delete an Arc-enabled vCenter cluster resource?
      instructions:
      - text: Delete the Arc-enabled vSphere cluster {cluster} from {rg}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
      - text: Force delete vSphere cluster resource {cluster} in {rg} of subscription {sub}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/clusters/{clusterName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on an Arc-enabled vSphere cluster
      effect: write
      questions:
      - Can I change the tags on a connected vSphere cluster without recreating it?
      - Which properties of an Arc-enabled vSphere cluster can be patched?
      instructions:
      - text: Set tags {tags} on the Arc-enabled vSphere cluster {cluster} in {rg} of subscription {sub}.
        slots:
          sub: path.subscriptionId
          tags: requestBody.tags
          cluster: path.clusterName
          rg: path.resourceGroupName
      - text: Retag vSphere cluster {cluster} in resource group {rg}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ConnectedVMwarevSphere/clusters'].get
  update:
    x-apievangelist-phrasing:
      intent: List Arc-enabled vSphere clusters in a subscription
      effect: read
      questions:
      - Which VMware vSphere clusters are connected through Arc across my whole subscription?
      - Can I see every Arc-enabled vCenter cluster I have in Azure?
      instructions:
      - text: List all Arc-enabled vSphere clusters in subscription {sub}.
        slots:
          sub: path.subscriptionId
      - text: Show every connected vSphere cluster across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/clusters'].get
  update:
    x-apievangelist-phrasing:
      intent: List Arc-enabled vSphere clusters in a resource group
      effect: read
      questions:
      - What vSphere clusters connected through Arc live in one resource group?
      - Can I narrow the Arc-enabled vSphere cluster list to a single resource group?
      instructions:
      - text: List the Arc-enabled vSphere clusters in resource group {rg} of subscription {sub}.
        slots:
          sub: path.subscriptionId
          rg: path.resourceGroupName
      - text: Show connected vSphere clusters in {rg}.
        slots:
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DBforPostgreSQL/serverGroupsv2'].get
  update:
    x-apievangelist-phrasing:
      intent: List Cosmos DB for PostgreSQL clusters in a subscription
      effect: read
      questions:
      - Which Azure Cosmos DB for PostgreSQL clusters do I have across my subscription?
      - Can I list all my distributed Postgres server groups in one call?
      instructions:
      - text: List all Cosmos DB for PostgreSQL clusters in my subscription.
      - text: Show every PostgreSQL server group v2 cluster across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/serverGroupsv2'].get
  update:
    x-apievangelist-phrasing:
      intent: List Cosmos DB for PostgreSQL clusters in a resource group
      effect: read
      questions:
      - What Cosmos DB for PostgreSQL clusters sit in a particular resource group?
      - Can I see only the distributed Postgres clusters within one resource group?
      instructions:
      - text: List the Cosmos DB for PostgreSQL clusters in my resource group.
      - text: Show PostgreSQL server group clusters scoped to the current resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/{clusterName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Cosmos DB for PostgreSQL cluster
      effect: read
      questions:
      - What compute and storage configuration does my Cosmos DB for PostgreSQL cluster have?
      - When was a given distributed Postgres cluster created?
      instructions:
      - text: Get the Cosmos DB for PostgreSQL cluster {cluster}.
        slots:
          cluster: path.clusterName
      - text: Show compute, storage and lifecycle details for Postgres cluster {cluster}.
        slots:
          cluster: path.clusterName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/{clusterName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Cosmos DB for PostgreSQL cluster
      effect: write
      questions:
      - How do I create a new Cosmos DB for PostgreSQL cluster with servers?
      - Can I define the node configuration when provisioning a distributed Postgres cluster?
      instructions:
      - text: Create a Cosmos DB for PostgreSQL cluster named {cluster}.
        slots:
          cluster: path.clusterName
      - text: Provision Postgres cluster {cluster} with properties {properties}.
        slots:
          cluster: path.clusterName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/{clusterName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Cosmos DB for PostgreSQL cluster
      effect: destructive
      questions:
      - Does deleting a Cosmos DB for PostgreSQL cluster also remove its servers?
      - Can I tear down a distributed Postgres cluster completely?
      instructions:
      - text: Delete the Cosmos DB for PostgreSQL cluster {cluster} and its servers.
        slots:
          cluster: path.clusterName
      - text: Tear down Postgres cluster {cluster}.
        slots:
          cluster: path.clusterName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/{clusterName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Cosmos DB for PostgreSQL cluster
      effect: write
      questions:
      - Can I change just one or two properties of an existing Cosmos DB for PostgreSQL cluster?
      - What can I patch on a distributed Postgres cluster after it is created?
      instructions:
      - text: Update Cosmos DB for PostgreSQL cluster {cluster} with properties {properties}.
        slots:
          cluster: path.clusterName
          properties: requestBody.properties
      - text: Change the tags on Postgres cluster {cluster} to {tags}.
        slots:
          cluster: path.clusterName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DBforPostgreSQL/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a Cosmos DB for PostgreSQL cluster name
      effect: read
      questions:
      - Is a cluster name still free for a new Cosmos DB for PostgreSQL cluster?
      - What naming rules apply to distributed Postgres cluster names?
      instructions:
      - text: Check whether {name} is available as a Cosmos DB for PostgreSQL cluster name of type {type}.
        slots:
          name: requestBody.name
          type: requestBody.type
      - text: See if the Postgres cluster name {name} is globally unique.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/clusters'].get
  update:
    x-apievangelist-phrasing:
      intent: List clusters in an Azure VMware Solution private cloud
      effect: read
      questions:
      - Which clusters are running in my Azure VMware Solution private cloud?
      - Can I see all the host clusters inside one AVS private cloud?
      instructions:
      - text: List the clusters in AVS private cloud {cloud}.
        slots:
          cloud: path.privateCloudName
      - text: Show all clusters in the Azure VMware Solution private cloud {cloud}.
        slots:
          cloud: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/clusters/{clusterName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a cluster in an AVS private cloud
      effect: read
      questions:
      - What does a specific cluster in my Azure VMware Solution private cloud look like?
      - Can I check one AVS cluster's details by name?
      instructions:
      - text: Get cluster {cluster} in AVS private cloud {cloud}.
        slots:
          cluster: path.clusterName
          cloud: path.privateCloudName
      - text: Show the Azure VMware Solution cluster {cluster} of private cloud {cloud}.
        slots:
          cluster: path.clusterName
          cloud: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/clusters/{clusterName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a cluster in an AVS private cloud
      effect: write
      questions:
      - How do I add a new cluster to an Azure VMware Solution private cloud?
      - Which SKU do I have to pick when creating an AVS cluster?
      instructions:
      - text: Add cluster {cluster} with SKU {sku} to AVS private cloud {cloud}.
        slots:
          cluster: path.clusterName
          sku: requestBody.sku
          cloud: path.privateCloudName
      - text: Create or replace Azure VMware Solution cluster {cluster} in {cloud}.
        slots:
          cluster: path.clusterName
          cloud: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/clusters/{clusterName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a cluster from an AVS private cloud
      effect: destructive
      questions:
      - Can I remove a cluster from my Azure VMware Solution private cloud?
      - What is lost when I delete an AVS cluster?
      instructions:
      - text: Delete cluster {cluster} from AVS private cloud {cloud}.
        slots:
          cluster: path.clusterName
          cloud: path.privateCloudName
      - text: Remove the Azure VMware Solution cluster {cluster} in {cloud}.
        slots:
          cluster: path.clusterName
          cloud: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/clusters/{clusterName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a cluster in an AVS private cloud
      effect: write
      questions:
      - Can I change the properties of an existing AVS private cloud cluster, like its size?
      - Is it possible to patch an Azure VMware Solution cluster in place?
      instructions:
      - text: Update AVS cluster {cluster} in private cloud {cloud} with properties {properties}.
        slots:
          cluster: path.clusterName
          cloud: path.privateCloudName
          properties: requestBody.properties
      - text: Patch the Azure VMware Solution cluster {cluster} of {cloud}.
        slots:
          cluster: path.clusterName
          cloud: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Azure Data Explorer (Kusto) cluster
      effect: read
      questions:
      - What is the current configuration of my Azure Data Explorer cluster?
      - Can I look up a Kusto cluster by name in a resource group?
      instructions:
      - text: Get the Kusto cluster {cluster} in {rg} of subscription {sub}.
        slots:
          sub: path.subscriptionId
          cluster: path.clusterName
          rg: path.resourceGroupName
      - text: Show Azure Data Explorer cluster {cluster} from resource group {rg}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an Azure Data Explorer cluster
      effect: write
      questions:
      - How do I provision a new Azure Data Explorer (Kusto) cluster?
      - Which SKU must I choose when creating a Kusto cluster?
      instructions:
      - text: Create Kusto cluster {cluster} in {rg} of subscription {sub} with SKU {sku}.
        slots:
          sub: path.subscriptionId
          cluster: path.clusterName
          rg: path.resourceGroupName
          sku: requestBody.sku
      - text: Create or replace Azure Data Explorer cluster {cluster} in {rg} using properties {properties}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Azure Data Explorer cluster
      effect: destructive
      questions:
      - Can I delete a Kusto cluster I no longer need?
      - What happens to an Azure Data Explorer cluster when I remove it?
      instructions:
      - text: Delete the Kusto cluster {cluster} in {rg} of subscription {sub}.
        slots:
          sub: path.subscriptionId
          cluster: path.clusterName
          rg: path.resourceGroupName
      - text: Remove Azure Data Explorer cluster {cluster} from {rg}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an Azure Data Explorer cluster
      effect: write
      questions:
      - Can I resize a Kusto cluster by changing its SKU after creation?
      - Which Azure Data Explorer cluster settings can I patch in place?
      instructions:
      - text: Change the SKU of Kusto cluster {cluster} in {rg} of subscription {sub} to {sku}.
        slots:
          sub: path.subscriptionId
          cluster: path.clusterName
          rg: path.resourceGroupName
          sku: requestBody.sku
      - text: Update tags on Azure Data Explorer cluster {cluster} in {rg} to {tags}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop an Azure Data Explorer cluster
      effect: write
      questions:
      - Can I pause a Kusto cluster to save money when it is idle?
      - How do I stop an Azure Data Explorer cluster?
      instructions:
      - text: Stop the Kusto cluster {cluster} in {rg} of subscription {sub}.
        slots:
          sub: path.subscriptionId
          cluster: path.clusterName
          rg: path.resourceGroupName
      - text: Shut down Azure Data Explorer cluster {cluster} in resource group {rg}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an Azure Data Explorer cluster
      effect: write
      questions:
      - How do I bring a stopped Kusto cluster back online?
      - Can I restart an Azure Data Explorer cluster that I paused earlier?
      instructions:
      - text: Start the Kusto cluster {cluster} in {rg} of subscription {sub}.
        slots:
          sub: path.subscriptionId
          cluster: path.clusterName
          rg: path.resourceGroupName
      - text: Resume stopped Azure Data Explorer cluster {cluster} in {rg}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure Data Explorer clusters in a resource group
      effect: read
      questions:
      - Which Kusto clusters are in one of my resource groups?
      - Can I list Azure Data Explorer clusters scoped to a single resource group?
      instructions:
      - text: List the Kusto clusters in resource group {rg} of subscription {sub}.
        slots:
          sub: path.subscriptionId
          rg: path.resourceGroupName
      - text: Show Azure Data Explorer clusters in {rg}.
        slots:
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Kusto/clusters'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure Data Explorer clusters in a subscription
      effect: read
      questions:
      - What Kusto clusters exist across my entire Azure subscription?
      - Can I get every Azure Data Explorer cluster I own in one list?
      instructions:
      - text: List all Kusto clusters in subscription {sub}.
        slots:
          sub: path.subscriptionId
      - text: Show every Azure Data Explorer cluster across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Kusto/locations/{location}/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check an Azure Data Explorer cluster name
      effect: read
      questions:
      - Is a Kusto cluster name valid and not already taken in a region?
      - Can I test a proposed Azure Data Explorer cluster name before creating it?
      instructions:
      - text: Check whether {name} of type {type} is available as a Kusto cluster name in {location} for subscription {sub}.
        slots:
          sub: path.subscriptionId
          name: requestBody.name
          type: requestBody.type
          location: path.location
      - text: See if the Azure Data Explorer cluster name {name} is free in region {location}.
        slots:
          name: requestBody.name
          location: path.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/skus'].get
  update:
    x-apievangelist-phrasing:
      intent: List SKUs available for an existing Kusto cluster
      effect: read
      questions:
      - Which SKUs can my existing Azure Data Explorer cluster be moved to?
      - What sizes are available to scale an existing Kusto cluster?
      instructions:
      - text: List the SKUs available for Kusto cluster {cluster} in {rg} of subscription {sub}.
        slots:
          sub: path.subscriptionId
          cluster: path.clusterName
          rg: path.resourceGroupName
      - text: Show resize options for Azure Data Explorer cluster {cluster} in {rg}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'