# 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 Azure Arc VMware Management Service V…
  version: 1.0.0
extends: openapi/microsoft-azure-vcenters-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: 6
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/vcenters/{vcenterName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Arc-enabled vCenter
      effect: read
      questions:
      - What details can I see about a vCenter connected to Azure through Arc?
      - Can I look up one Arc-enabled vCenter by name?
      instructions:
      - text: Get vCenter {vcenter} in {rg} of subscription {sub}.
        slots:
          vcenter: path.vcenterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the Arc-enabled vCenter resource {vcenter} in {rg}.
        slots:
          vcenter: path.vcenterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/vcenters/{vcenterName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Connect or update an Arc-enabled vCenter
      effect: write
      questions:
      - How do I connect a VMware vCenter to Azure Arc?
      - Which fields are required to register a vCenter resource?
      instructions:
      - text: Create vCenter resource {vcenter} in {rg} of subscription {sub} in region {location}.
        slots:
          vcenter: path.vcenterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Register vCenter {vcenter} in {rg} with properties {properties} and location {location}.
        slots:
          vcenter: path.vcenterName
          rg: path.resourceGroupName
          properties: requestBody.properties
          location: requestBody.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/vcenters/{vcenterName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Arc-enabled vCenter
      effect: destructive
      questions:
      - Can I force-delete a vCenter resource from Azure Arc?
      - What happens when I remove an Arc-enabled vCenter?
      instructions:
      - text: Delete vCenter {vcenter} in {rg} of subscription {sub}.
        slots:
          vcenter: path.vcenterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: 'Force delete vCenter resource {vcenter} in {rg}: force={force}.'
        slots:
          vcenter: path.vcenterName
          rg: path.resourceGroupName
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/vcenters/{vcenterName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on an Arc-enabled vCenter
      effect: write
      questions:
      - Can I change the tags on an Arc-enabled vCenter?
      - Which vCenter resource properties can be patched?
      instructions:
      - text: Set tags {tags} on vCenter {vcenter} in {rg} of subscription {sub}.
        slots:
          tags: requestBody.tags
          vcenter: path.vcenterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Retag the Arc-enabled vCenter {vcenter} in {rg}.
        slots:
          vcenter: path.vcenterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ConnectedVMwarevSphere/vcenters'].get
  update:
    x-apievangelist-phrasing:
      intent: List Arc-enabled vCenters in a subscription
      effect: read
      questions:
      - Which vCenters are connected to Azure Arc across my subscription?
      - Can I see all my Arc-enabled vCenters at once?
      instructions:
      - text: List all vCenters in subscription {sub}.
        slots:
          sub: path.subscriptionId
      - text: Show every Arc-enabled vCenter across subscription {sub}.
        slots:
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/vcenters'].get
  update:
    x-apievangelist-phrasing:
      intent: List Arc-enabled vCenters in a resource group
      effect: read
      questions:
      - What vCenters are registered in one of my resource groups?
      - Can I narrow the vCenter list to a single resource group?
      instructions:
      - text: List vCenters in resource group {rg} of subscription {sub}.
        slots:
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show Arc-enabled vCenters in {rg}.
        slots:
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'