# 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 NetApp Resource API
  version: 1.0.0
extends: openapi/microsoft-azure-netapp-resource-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: 10
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetApp/locations/{location}/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a NetApp resource name is available
      effect: read
      questions:
      - Is a given NetApp resource name still available?
      - Can I verify a volume name is free in a resource group before creating it?
      instructions:
      - text: Check whether name {name} of type {type} is available in resource group {resource_group} in region {location}.
        slots:
          name: requestBody.name
          type: requestBody.type
          resource_group: requestBody.resourceGroup
          location: path.location
      - text: Verify NetApp resource name {name} ({type}) isn't taken in {resource_group}.
        slots:
          name: requestBody.name
          type: requestBody.type
          resource_group: requestBody.resourceGroup
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetApp/locations/{location}/checkFilePathAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a volume file path is available
      effect: read
      questions:
      - Can I check if a volume file path is free in a subnet?
      - Does the file path availability check take an availability zone into account?
      instructions:
      - text: Check whether file path {path} is available in subnet {subnet} in region {location}.
        slots:
          path: requestBody.name
          subnet: requestBody.subnetId
          location: path.location
      - text: Check file path {path} in subnet {subnet} for availability zone {zone}.
        slots:
          path: requestBody.name
          subnet: requestBody.subnetId
          zone: requestBody.availabilityZone
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetApp/locations/{location}/checkQuotaAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check NetApp quota is available
      effect: read
      questions:
      - Is there enough NetApp quota left to create another resource?
      - How can I tell if quota is available for a resource type in a resource group?
      instructions:
      - text: Check quota availability in {location} for {name} of type {type} in resource group {resource_group}.
        slots:
          location: path.location
          name: requestBody.name
          type: requestBody.type
          resource_group: requestBody.resourceGroup
      - text: Confirm there is quota to create {type} resource {name} in {resource_group}.
        slots:
          type: requestBody.type
          name: requestBody.name
          resource_group: requestBody.resourceGroup
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetApp/locations/{location}/quotaLimits'].get
  update:
    x-apievangelist-phrasing:
      intent: List NetApp quota limits
      effect: read
      questions:
      - What are the default and current NetApp quota limits in a region?
      - Can I see all Azure NetApp Files quota limits for my subscription at once?
      instructions:
      - text: List all NetApp quota limits for my subscription in region {location}.
        slots:
          location: path.location
      - text: Show every default and current NetApp Files quota limit in this location.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetApp/locations/{location}/quotaLimits/{quotaLimitName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one NetApp quota limit
      effect: read
      questions:
      - How do I check a single NetApp quota limit?
      - What is my current value for one particular NetApp quota?
      instructions:
      - text: Get NetApp quota limit {quota} in region {location}.
        slots:
          quota: path.quotaLimitName
          location: path.location
      - text: Show the default and current value of quota limit {quota}.
        slots:
          quota: path.quotaLimitName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetApp/locations/{location}/regionInfos'].get
  update:
    x-apievangelist-phrasing:
      intent: List NetApp region information entries
      effect: read
      questions:
      - What region-specific information does NetApp Files publish?
      - Can I list all region info entries for a location?
      instructions:
      - text: List NetApp region information entries for {location}.
        slots:
          location: path.location
      - text: Show all NetApp Files region info records for this location.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetApp/locations/{location}/regionInfos/default'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the default NetApp region info entry
      effect: read
      questions:
      - Where do I find storage-to-network proximity in the default region info entry?
      - Which logical zone mappings does the default region info resource show?
      instructions:
      - text: Get the default NetApp region info entry for {location}.
        slots:
          location: path.location
      - text: Show storage to network proximity from the default regionInfos resource.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetApp/locations/{location}/regionInfo'].get
  update:
    x-apievangelist-phrasing:
      intent: Query region info via the regionInfo endpoint
      effect: read
      questions:
      - Is there a direct regionInfo query for proximity and zone mapping without listing entries?
      - Can I query NetApp region info through the single regionInfo endpoint?
      instructions:
      - text: Query NetApp region info for {location} via the regionInfo endpoint.
        slots:
          location: path.location
      - text: Fetch zone mapping with the direct region info query.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetApp/locations/{location}/queryNetworkSiblingSet'].post
  update:
    x-apievangelist-phrasing:
      intent: Describe a network sibling set
      effect: read
      questions:
      - What does a network sibling set in my subnet currently look like?
      - Can I look up a network sibling set's details, including its state ID?
      instructions:
      - text: Describe network sibling set {sibling_set} in subnet {subnet} in region {location}.
        slots:
          sibling_set: requestBody.networkSiblingSetId
          subnet: requestBody.subnetId
          location: path.location
      - text: Get details of sibling set {sibling_set} for subnet {subnet}.
        slots:
          sibling_set: requestBody.networkSiblingSetId
          subnet: requestBody.subnetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.NetApp/locations/{location}/updateNetworkSiblingSet'].post
  update:
    x-apievangelist-phrasing:
      intent: Change network features of a sibling set
      effect: write
      questions:
      - Can I change the network features of a network sibling set?
      - Why does updating a sibling set's network features need its state ID?
      instructions:
      - text: Update network sibling set {sibling_set} in subnet {subnet} to network features {features} using state ID {state_id}.
        slots:
          sibling_set: requestBody.networkSiblingSetId
          subnet: requestBody.subnetId
          features: requestBody.networkFeatures
          state_id: requestBody.networkSiblingSetStateId
      - text: Switch sibling set {sibling_set} in {location} to {features} network features.
        slots:
          sibling_set: requestBody.networkSiblingSetId
          location: path.location
          features: requestBody.networkFeatures
      method: generated
      generated: '2026-10-01'