# 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 Addons API
  version: 1.0.0
extends: openapi/microsoft-azure-add-ons-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 8
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/addons'].get
  update:
    x-apievangelist-phrasing:
      intent: List addons in an AVS private cloud
      effect: read
      questions:
      - Which addons are installed in my Azure VMware Solution private cloud?
      - Can I see every addon enabled on one VMware private cloud?
      instructions:
      - text: List the addons in private cloud {cloud}.
        slots:
          cloud: path.privateCloudName
      - text: Show what addons private cloud {cloud} has turned on.
        slots:
          cloud: path.privateCloudName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/addons/{addonName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an addon in an AVS private cloud
      effect: read
      questions:
      - What is the configuration of one addon in my VMware private cloud?
      - Can I check a single private cloud addon by its name?
      instructions:
      - text: Get addon {addon} in private cloud {cloud}.
        slots:
          addon: path.addonName
          cloud: path.privateCloudName
      - text: Show the settings of the {addon} addon on VMware private cloud {cloud}.
        slots:
          addon: path.addonName
          cloud: path.privateCloudName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/addons/{addonName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add or update an addon in an AVS private cloud
      effect: write
      questions:
      - How do I enable an addon on my VMware private cloud?
      - Can I change the properties of an addon already installed in a private cloud?
      instructions:
      - text: Add addon {addon} to private cloud {cloud}.
        slots:
          addon: path.addonName
          cloud: path.privateCloudName
      - text: Update private cloud {cloud}'s {addon} addon with properties {properties}.
        slots:
          cloud: path.privateCloudName
          addon: path.addonName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/addons/{addonName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an addon from an AVS private cloud
      effect: destructive
      questions:
      - How do I uninstall an addon from my VMware private cloud?
      - Can I remove a private cloud addon I no longer use?
      instructions:
      - text: Delete addon {addon} from private cloud {cloud}.
        slots:
          addon: path.addonName
          cloud: path.privateCloudName
      - text: Uninstall the {addon} addon on VMware private cloud {cloud}.
        slots:
          addon: path.addonName
          cloud: path.privateCloudName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/{deviceName}/roles/{roleName}/addons'].get
  update:
    x-apievangelist-phrasing:
      intent: List addons on a Data Box Edge role
      effect: read
      questions:
      - Which addons are configured on a role of my Data Box Edge device?
      - Can I list the addons attached to one compute role on an edge device?
      instructions:
      - text: List addons for role {role} on Data Box Edge device {device} in {rg}, subscription {sub}.
        slots:
          role: path.roleName
          device: path.deviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the addons configured in edge role {role} of device {device}.
        slots:
          role: path.roleName
          device: path.deviceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/{deviceName}/roles/{roleName}/addons/{addonName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an addon on a Data Box Edge role
      effect: read
      questions:
      - What are the details of a specific addon on my Data Box Edge role?
      - Can I look up one edge device addon by name?
      instructions:
      - text: Get addon {addon} on role {role} of Data Box Edge device {device} in {rg}, subscription {sub}.
        slots:
          addon: path.addonName
          role: path.roleName
          device: path.deviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show edge addon {addon} under role {role} on device {device}.
        slots:
          addon: path.addonName
          role: path.roleName
          device: path.deviceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/{deviceName}/roles/{roleName}/addons/{addonName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an addon on a Data Box Edge role
      effect: write
      questions:
      - How do I configure a new addon on a Data Box Edge device role?
      - What kind of addon must I specify when adding one to an edge role?
      instructions:
      - text: Create addon {addon} of kind {kind} on role {role} of Data Box Edge device {device} in {rg}, subscription {sub}.
        slots:
          addon: path.addonName
          kind: requestBody.kind
          role: path.roleName
          device: path.deviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Reconfigure edge addon {addon} on role {role} of device {device} as kind {kind}.
        slots:
          addon: path.addonName
          role: path.roleName
          device: path.deviceName
          kind: requestBody.kind
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/{deviceName}/roles/{roleName}/addons/{addonName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an addon from a Data Box Edge role
      effect: destructive
      questions:
      - How do I remove an addon from my Data Box Edge device?
      - Can I delete one addon from an edge role without touching the role itself?
      instructions:
      - text: Delete addon {addon} from role {role} on Data Box Edge device {device} in {rg}, subscription {sub}.
        slots:
          addon: path.addonName
          role: path.roleName
          device: path.deviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove edge addon {addon} from role {role} on device {device}.
        slots:
          addon: path.addonName
          role: path.roleName
          device: path.deviceName
      method: generated
      generated: '2026-10-01'