# 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 ManagedApplicationClient Appliance…
  version: 1.0.0
extends: openapi/microsoft-azure-appliancedefinitions-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: 7
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/applianceDefinitions/{applianceDefinitionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a managed application appliance definition
      effect: read
      questions:
      - Where can I see an appliance definition's details in a resource group?
      - What package and authorizations does a managed application definition hold?
      instructions:
      - text: Get appliance definition {definition} in resource group {group}.
        slots:
          definition: path.applianceDefinitionName
          group: path.resourceGroupName
      - text: Show appliance definition {definition} from {group} in subscription {sub}.
        slots:
          definition: path.applianceDefinitionName
          group: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/applianceDefinitions/{applianceDefinitionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an appliance definition by name
      effect: write
      questions:
      - How do I publish a new managed application appliance definition in a resource group?
      - Can I set a SKU and identity when creating an appliance definition by name?
      instructions:
      - text: Create appliance definition {definition} in {group} with properties {properties}.
        slots:
          definition: path.applianceDefinitionName
          group: path.resourceGroupName
          properties: requestBody.properties
      - text: Create appliance definition {definition} in subscription {sub}, group {group}, using properties {properties} and SKU {sku}.
        slots:
          definition: path.applianceDefinitionName
          sub: path.subscriptionId
          group: path.resourceGroupName
          properties: requestBody.properties
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/applianceDefinitions/{applianceDefinitionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an appliance definition by name
      effect: destructive
      questions:
      - How do I remove an appliance definition from a resource group by its name?
      - Can I retire a managed application definition I published in a resource group?
      instructions:
      - text: Delete appliance definition {definition} in resource group {group}.
        slots:
          definition: path.applianceDefinitionName
          group: path.resourceGroupName
      - text: Remove appliance definition {definition} from {group} in subscription {sub}.
        slots:
          definition: path.applianceDefinitionName
          group: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Solutions/applianceDefinitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List appliance definitions in a resource group
      effect: read
      questions:
      - Which appliance definitions are published in my resource group?
      - Can I inventory every managed application definition in one resource group?
      instructions:
      - text: List the appliance definitions in resource group {group}.
        slots:
          group: path.resourceGroupName
      - text: Show all managed application definitions under {group} in subscription {sub}.
        slots:
          group: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{applianceDefinitionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an appliance definition by full resource ID
      effect: read
      questions:
      - Can I fetch an appliance definition using its full resource ID instead of name and group?
      - What does the by-ID lookup of an appliance definition return?
      instructions:
      - text: Get the appliance definition with resource ID {id}.
        slots:
          id: path.applianceDefinitionId
      - text: Fetch appliance definition by fully qualified ID {id}.
        slots:
          id: path.applianceDefinitionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{applianceDefinitionId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an appliance definition by full resource ID
      effect: write
      questions:
      - How do I create an appliance definition when I only have its full resource ID?
      - Can I create a managed application definition by ID with a managed-by reference?
      instructions:
      - text: Create the appliance definition at resource ID {id} with properties {properties}.
        slots:
          id: path.applianceDefinitionId
          properties: requestBody.properties
      - text: Create appliance definition by ID {id} using properties {properties}, managed by {managedBy}.
        slots:
          id: path.applianceDefinitionId
          properties: requestBody.properties
          managedBy: requestBody.managedBy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{applianceDefinitionId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an appliance definition by full resource ID
      effect: destructive
      questions:
      - Can I delete an appliance definition using its full resource ID?
      - Is there a way to remove a managed application definition by ID rather than by name?
      instructions:
      - text: Delete the appliance definition with resource ID {id}.
        slots:
          id: path.applianceDefinitionId
      - text: Remove appliance definition by fully qualified ID {id}.
        slots:
          id: path.applianceDefinitionId
      method: generated
      generated: '2026-09-26'