# 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 Appliances API
  version: 1.0.0
extends: openapi/microsoft-azure-appliances-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: 20
- target: $.paths['/providers/Microsoft.ResourceConnector/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Resource Connector API operations
      effect: read
      questions:
      - What operations does the Azure Resource Connector provider expose?
      - Which actions can I call against Resource Connector appliances?
      instructions:
      - text: List every operation the Resource Connector provider supports.
      - text: Show me the available Resource Connector API operations.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ResourceConnector/appliances'].get
  update:
    x-apievangelist-phrasing:
      intent: List Resource Connector appliances in a subscription
      effect: read
      questions:
      - Which Resource Connector appliances exist across my whole subscription?
      - Can I see every Arc resource bridge appliance in my subscription at once?
      instructions:
      - text: List all Resource Connector appliances in my subscription.
      - text: Show every Resource Connector appliance I have, across all resource groups.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceConnector/appliances'].get
  update:
    x-apievangelist-phrasing:
      intent: List Resource Connector appliances in a resource group
      effect: read
      questions:
      - What Resource Connector appliances are in one resource group?
      - Is there a way to list only the Resource Connector appliances in a single resource group?
      instructions:
      - text: List the Resource Connector appliances in this resource group.
      - text: Show Resource Connector appliances scoped to one resource group, with their properties.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceConnector/appliances/{resourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Resource Connector appliance
      effect: read
      questions:
      - How do I look up the details of one Resource Connector appliance by name?
      - What properties does a Resource Connector appliance report?
      instructions:
      - text: Get Resource Connector appliance {resourceName}.
        slots:
          resourceName: path.resourceName
      - text: Show me the details of Resource Connector appliance {resourceName}.
        slots:
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceConnector/appliances/{resourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Resource Connector appliance
      effect: write
      questions:
      - Can I create a new Resource Connector appliance with a managed identity?
      - How do I register or reconfigure a Resource Connector appliance?
      instructions:
      - text: Create Resource Connector appliance {resourceName}.
        slots:
          resourceName: path.resourceName
      - text: Create or update Resource Connector appliance {resourceName} with properties {properties}.
        slots:
          resourceName: path.resourceName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceConnector/appliances/{resourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Resource Connector appliance
      effect: destructive
      questions:
      - How do I remove a Resource Connector appliance from my resource group?
      - Can I delete an Arc resource bridge appliance I no longer use?
      instructions:
      - text: Delete Resource Connector appliance {resourceName}.
        slots:
          resourceName: path.resourceName
      - text: Remove the Resource Connector appliance named {resourceName}.
        slots:
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceConnector/appliances/{resourceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a Resource Connector appliance
      effect: write
      questions:
      - Can I change the tags on an existing Resource Connector appliance?
      - What can be patched on a Resource Connector appliance after it is created?
      instructions:
      - text: Set tags {tags} on Resource Connector appliance {resourceName}.
        slots:
          tags: requestBody.tags
          resourceName: path.resourceName
      - text: Patch Resource Connector appliance {resourceName} with new tags {tags}.
        slots:
          resourceName: path.resourceName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceConnector/appliances/{resourceName}/listClusterCustomerUserCredential'].post
  update:
    x-apievangelist-phrasing:
      intent: Get cluster customer user credentials for an appliance
      effect: read
      questions:
      - Where do I get the cluster customer user credential for a dedicated appliance?
      - Can I retrieve the customer-facing cluster credential of a Resource Connector appliance?
      instructions:
      - text: Fetch the customer-facing cluster credential of appliance {resourceName}.
        slots:
          resourceName: path.resourceName
      - text: Return the customer user kubeconfig credential of appliance {resourceName}.
        slots:
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceConnector/appliances/{resourceName}/listClusterUserCredential'].post
  update:
    x-apievangelist-phrasing:
      intent: Get cluster user credentials for an appliance
      effect: read
      questions:
      - How can I fetch the cluster user credential of a dedicated appliance?
      - Which call returns the cluster user credentials for a Resource Connector appliance?
      instructions:
      - text: Return the cluster user credential, not the customer one, for appliance {resourceName}.
        slots:
          resourceName: path.resourceName
      - text: List cluster user credentials of Resource Connector appliance {resourceName}.
        slots:
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceConnector/appliances/{resourceName}/upgradeGraphs/{upgradeGraph}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an appliance upgrade graph for a release train
      effect: read
      questions:
      - What upgrade path is available for my Resource Connector appliance on a release train?
      - Can I see the upgrade graph of an appliance for a specific release train?
      instructions:
      - text: Get upgrade graph {upgradeGraph} for appliance {resourceName}.
        slots:
          upgradeGraph: path.upgradeGraph
          resourceName: path.resourceName
      - text: Show the {upgradeGraph} release train upgrade graph of appliance {resourceName}.
        slots:
          upgradeGraph: path.upgradeGraph
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/appliances/{applianceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a managed application appliance
      effect: read
      questions:
      - How do I read a Microsoft.Solutions managed application appliance by name?
      - What does a managed application appliance look like in a resource group?
      instructions:
      - text: Get managed application appliance {applianceName} in resource group {resourceGroupName}.
        slots:
          applianceName: path.applianceName
          resourceGroupName: path.resourceGroupName
      - text: Show the Microsoft.Solutions appliance {applianceName}.
        slots:
          applianceName: path.applianceName
      - text: Fetch appliance {applianceName} from resource group {resourceGroupName} in subscription {subscriptionId}.
        slots:
          applianceName: path.applianceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/appliances/{applianceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a managed application appliance
      effect: write
      questions:
      - Can I create a Microsoft.Solutions appliance with a plan and SKU?
      - What do I send to create a managed application appliance by resource group and name?
      instructions:
      - text: Create managed application appliance {applianceName} in {resourceGroupName} of kind {kind}.
        slots:
          applianceName: path.applianceName
          resourceGroupName: path.resourceGroupName
          kind: requestBody.kind
      - text: Create Microsoft.Solutions appliance {applianceName} managed by {managedBy}.
        slots:
          applianceName: path.applianceName
          managedBy: requestBody.managedBy
      - text: Provision appliance {applianceName} in {resourceGroupName} under subscription {subscriptionId}.
        slots:
          applianceName: path.applianceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/appliances/{applianceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a managed application appliance
      effect: destructive
      questions:
      - How do I delete a Microsoft.Solutions appliance by its resource group and name?
      - Can I remove a managed application appliance I deployed?
      instructions:
      - text: Delete managed application appliance {applianceName} from {resourceGroupName}.
        slots:
          applianceName: path.applianceName
          resourceGroupName: path.resourceGroupName
      - text: Remove Microsoft.Solutions appliance {applianceName}.
        slots:
          applianceName: path.applianceName
      - text: Delete appliance {applianceName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          applianceName: path.applianceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/appliances/{applianceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a managed application appliance
      effect: write
      questions:
      - What can I change on a managed application appliance with PATCH?
      - Is it only tags that can be updated on a Microsoft.Solutions appliance?
      instructions:
      - text: Update the tags on managed application appliance {applianceName} in {resourceGroupName}.
        slots:
          applianceName: path.applianceName
          resourceGroupName: path.resourceGroupName
      - text: Patch Microsoft.Solutions appliance {applianceName}.
        slots:
          applianceName: path.applianceName
      - text: Retag appliance {applianceName} in {resourceGroupName} for subscription {subscriptionId}.
        slots:
          applianceName: path.applianceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/appliances'].get
  update:
    x-apievangelist-phrasing:
      intent: List managed application appliances in a resource group
      effect: read
      questions:
      - Which managed application appliances live in one resource group?
      - Can I list Microsoft.Solutions appliances for a single resource group?
      instructions:
      - text: List managed application appliances in resource group {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      - text: Show all Microsoft.Solutions appliances in {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      - text: List managed appliances in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Solutions/appliances'].get
  update:
    x-apievangelist-phrasing:
      intent: List managed application appliances in a subscription
      effect: read
      questions:
      - What managed application appliances exist anywhere in my subscription?
      - Is there a subscription-wide list of Microsoft.Solutions appliances?
      instructions:
      - text: List all managed application appliances in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show every Microsoft.Solutions appliance in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{applianceId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a managed application appliance by resource ID
      effect: read
      questions:
      - Can I fetch a managed application appliance using its full resource ID?
      - How do I read an appliance when I only have its resource ID?
      instructions:
      - text: Get the appliance with resource ID {applianceId}.
        slots:
          applianceId: path.applianceId
      - text: Look up appliance {applianceId} by its fully qualified ID.
        slots:
          applianceId: path.applianceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{applianceId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a managed application appliance by resource ID
      effect: write
      questions:
      - Is it possible to create an appliance by passing its full resource ID?
      - What body do I send to create an appliance addressed by resource ID?
      instructions:
      - text: Create an appliance at resource ID {applianceId}.
        slots:
          applianceId: path.applianceId
      - text: Create appliance {applianceId} with SKU {sku} and plan {plan}.
        slots:
          applianceId: path.applianceId
          sku: requestBody.sku
          plan: requestBody.plan
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{applianceId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a managed application appliance by resource ID
      effect: destructive
      questions:
      - How do I delete an appliance using its resource ID instead of its name?
      - Can I remove an appliance when all I have is the resource ID?
      instructions:
      - text: Delete the appliance with resource ID {applianceId}.
        slots:
          applianceId: path.applianceId
      - text: Remove appliance {applianceId} by its fully qualified ID.
        slots:
          applianceId: path.applianceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{applianceId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update appliance tags by resource ID
      effect: write
      questions:
      - Can I patch an appliance's tags using its resource ID?
      - What fields are updatable when patching an appliance by ID?
      instructions:
      - text: Update the tags on appliance {applianceId}.
        slots:
          applianceId: path.applianceId
      - text: Patch the appliance at resource ID {applianceId}.
        slots:
          applianceId: path.applianceId
      method: generated
      generated: '2026-09-26'