# 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 Resource Pools API
  version: 1.0.0
extends: openapi/microsoft-azure-resource-pools-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.ConnectedVMwarevSphere/resourcePools/{resourcePoolName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Arc-connected vSphere resource pool
      effect: read
      questions:
      - How do I view an Arc-enabled VMware vSphere resource pool in a resource group?
      - What properties does Azure Arc store for one connected vSphere resource pool?
      instructions:
      - text: Get Arc vSphere resource pool {pool} in resource group {resource_group}, subscription {subscription}.
        slots:
          pool: path.resourcePoolName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the connected vSphere resource pool {pool}.
        slots:
          pool: path.resourcePoolName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/resourcePools/{resourcePoolName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an Arc vSphere resource pool
      effect: write
      questions:
      - How do I bring a VMware vSphere resource pool under Azure Arc management?
      - What location and extended location do I need to register a vSphere resource pool?
      instructions:
      - text: Create Arc resource pool {pool} in {location} in resource group {resource_group}, subscription {subscription}.
        slots:
          pool: path.resourcePoolName
          location: requestBody.location
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Register vSphere resource pool {pool} with properties {properties} and extended location {extended_location}.
        slots:
          pool: path.resourcePoolName
          properties: requestBody.properties
          extended_location: requestBody.extendedLocation
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/resourcePools/{resourcePoolName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Arc vSphere resource pool
      effect: destructive
      questions:
      - How do I remove a vSphere resource pool from Azure Arc?
      - Can I force delete an Arc resource pool?
      instructions:
      - text: Delete Arc resource pool {pool} in resource group {resource_group}, subscription {subscription}.
        slots:
          pool: path.resourcePoolName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Force delete ({force}) connected vSphere resource pool {pool}.
        slots:
          force: query.force
          pool: path.resourcePoolName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/resourcePools/{resourcePoolName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on an Arc vSphere resource pool
      effect: write
      questions:
      - How do I change the tags on an Arc-connected resource pool?
      - Can I retag a vSphere resource pool without re-registering it?
      instructions:
      - text: Set tags {tags} on Arc resource pool {pool} in resource group {resource_group}, subscription {subscription}.
        slots:
          tags: requestBody.tags
          pool: path.resourcePoolName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Retag connected vSphere pool {pool} with {tags}.
        slots:
          pool: path.resourcePoolName
          tags: requestBody.tags
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ConnectedVMwarevSphere/resourcePools'].get
  update:
    x-apievangelist-phrasing:
      intent: List Arc vSphere resource pools in a subscription
      effect: read
      questions:
      - Which Arc-enabled vSphere resource pools exist across my subscription?
      - How do I inventory every connected VMware resource pool I manage in Azure?
      instructions:
      - text: List all Arc vSphere resource pools in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Inventory every connected VMware resource pool across subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/resourcePools'].get
  update:
    x-apievangelist-phrasing:
      intent: List Arc vSphere resource pools in a resource group
      effect: read
      questions:
      - What Arc vSphere resource pools are in one particular resource group?
      - How do I list connected resource pools scoped to a resource group?
      instructions:
      - text: List Arc vSphere resource pools in resource group {resource_group}, subscription {subscription}.
        slots:
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the connected resource pools inside resource group {resource_group}.
        slots:
          resource_group: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.VMwareCloudSimple/locations/{regionId}/privateClouds/{pcName}/resourcePools'].get
  update:
    x-apievangelist-phrasing:
      intent: List CloudSimple private cloud resource pools
      effect: read
      questions:
      - How do I list the resource pools available in a CloudSimple private cloud?
      - Which resource pools can I place VMs into in my VMware private cloud region?
      instructions:
      - text: List resource pools in CloudSimple private cloud {private_cloud} in region {region}.
        slots:
          private_cloud: path.pcName
          region: path.regionId
      - text: Show private cloud {private_cloud}'s resource pools for subscription {subscription} in {region}.
        slots:
          private_cloud: path.pcName
          subscription: path.subscriptionId
          region: path.regionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.VMwareCloudSimple/locations/{regionId}/privateClouds/{pcName}/resourcePools/{resourcePoolName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a CloudSimple private cloud resource pool
      effect: read
      questions:
      - How do I look up one resource pool inside a CloudSimple private cloud?
      - What does a named resource pool template in my private cloud contain?
      instructions:
      - text: Get resource pool {pool} in CloudSimple private cloud {private_cloud} in region {region}.
        slots:
          pool: path.resourcePoolName
          private_cloud: path.pcName
          region: path.regionId
      - text: Show private cloud pool {pool} from {private_cloud} for subscription {subscription}.
        slots:
          pool: path.resourcePoolName
          private_cloud: path.pcName
          subscription: path.subscriptionId
      method: generated
      generated: '2026-10-01'