# 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 Microsoft NetApp Volume Groups API
  version: 1.0.0
extends: openapi/microsoft-azure-volume-groups-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: 9
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/volumeGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List NetApp volume groups in an account
      effect: read
      questions:
      - Which volume groups exist in my NetApp account?
      - Can I see all the application volume groups for one Azure NetApp Files account?
      instructions:
      - text: List volume groups in NetApp account {accountName}.
        slots:
          accountName: path.accountName
      - text: Show every volume group under account {accountName}.
        slots:
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/volumeGroups/{volumeGroupName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a NetApp volume group
      effect: read
      questions:
      - What volumes are in a specific NetApp volume group?
      - How do I see the details of one volume group?
      instructions:
      - text: Get volume group {volumeGroupName} in NetApp account {accountName}.
        slots:
          volumeGroupName: path.volumeGroupName
          accountName: path.accountName
      - text: Describe account {accountName} volume group {volumeGroupName}.
        slots:
          accountName: path.accountName
          volumeGroupName: path.volumeGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/volumeGroups/{volumeGroupName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a NetApp volume group with its volumes
      effect: write
      questions:
      - Can I create several NetApp volumes at once as a group, for example for SAP HANA?
      - What goes into creating a volume group along with its volumes?
      instructions:
      - text: Create volume group {volumeGroupName} in NetApp account {accountName} at {location}.
        slots:
          volumeGroupName: path.volumeGroupName
          accountName: path.accountName
          location: requestBody.location
      - text: Create group {volumeGroupName} with volumes {properties} in account {accountName}.
        slots:
          volumeGroupName: path.volumeGroupName
          properties: requestBody.properties
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/volumeGroups/{volumeGroupName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an empty NetApp volume group
      effect: destructive
      questions:
      - Can I delete a volume group that still has volumes in it?
      - How do I remove an empty NetApp volume group?
      instructions:
      - text: Delete volume group {volumeGroupName} from NetApp account {accountName}.
        slots:
          volumeGroupName: path.volumeGroupName
          accountName: path.accountName
      - text: Remove empty group {volumeGroupName} in account {accountName}.
        slots:
          volumeGroupName: path.volumeGroupName
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ElasticSan/elasticSans/{elasticSanName}/volumeGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List volume groups in an Elastic SAN
      effect: read
      questions:
      - Which volume groups exist in my Elastic SAN?
      - Can I list every volume group under one Elastic SAN?
      instructions:
      - text: List volume groups in Elastic SAN {san}, resource group {rg}.
        slots:
          san: path.elasticSanName
          rg: path.resourceGroupName
      - text: Show all volume groups for Elastic SAN {san}.
        slots:
          san: path.elasticSanName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ElasticSan/elasticSans/{elasticSanName}/volumegroups/{volumeGroupName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Elastic SAN volume group
      effect: read
      questions:
      - What are the settings of a specific Elastic SAN volume group?
      - Can I look up one volume group by name?
      instructions:
      - text: Get volume group {group} in Elastic SAN {san}, resource group {rg}.
        slots:
          group: path.volumeGroupName
          san: path.elasticSanName
          rg: path.resourceGroupName
      - text: Show volume group {group} details.
        slots:
          group: path.volumeGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ElasticSan/elasticSans/{elasticSanName}/volumegroups/{volumeGroupName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an Elastic SAN volume group
      effect: write
      questions:
      - Can I create a new volume group inside an Elastic SAN?
      - What do I need to provide to add a volume group with tags?
      instructions:
      - text: Create volume group {group} in Elastic SAN {san}, resource group {rg}.
        slots:
          group: path.volumeGroupName
          san: path.elasticSanName
          rg: path.resourceGroupName
      - text: Create volume group {group} with properties {properties} and tags {tags}.
        slots:
          group: path.volumeGroupName
          properties: requestBody.properties
          tags: requestBody.tags
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ElasticSan/elasticSans/{elasticSanName}/volumegroups/{volumeGroupName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Elastic SAN volume group
      effect: destructive
      questions:
      - Can I delete a volume group from my Elastic SAN?
      - Is there a way to remove a volume group I no longer use?
      instructions:
      - text: Delete volume group {group} from Elastic SAN {san}, resource group {rg}.
        slots:
          group: path.volumeGroupName
          san: path.elasticSanName
          rg: path.resourceGroupName
      - text: Remove volume group {group}.
        slots:
          group: path.volumeGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ElasticSan/elasticSans/{elasticSanName}/volumegroups/{volumeGroupName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing Elastic SAN volume group
      effect: write
      questions:
      - Can I change the tags or properties of an existing volume group?
      - Is a partial update possible on an Elastic SAN volume group?
      instructions:
      - text: Update existing volume group {group} in Elastic SAN {san}, resource group {rg}.
        slots:
          group: path.volumeGroupName
          san: path.elasticSanName
          rg: path.resourceGroupName
      - text: Patch volume group {group} tags to {tags}.
        slots:
          group: path.volumeGroupName
          tags: requestBody.tags
      method: generated
      generated: '2026-10-01'