# 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 VMware Solution Hcx Enterprise Sites…
  version: 1.0.0
extends: openapi/microsoft-azure-hcxenterprisesites-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/hcxEnterpriseSites'].get
  update:
    x-apievangelist-phrasing:
      intent: List HCX enterprise sites in a private cloud
      effect: read
      questions:
      - Which HCX enterprise sites are set up in my Azure VMware Solution private cloud?
      - Can I list all HCX enterprise sites for one private cloud?
      instructions:
      - text: List HCX enterprise sites in private cloud {private_cloud}.
        slots:
          private_cloud: path.privateCloudName
      - text: Show every HCX site registered to {private_cloud}.
        slots:
          private_cloud: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/hcxEnterpriseSites/{hcxEnterpriseSiteName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an HCX enterprise site
      effect: read
      questions:
      - How do I look up one HCX enterprise site by name?
      - What does a single HCX enterprise site record include?
      instructions:
      - text: Get HCX enterprise site {site} in private cloud {private_cloud}.
        slots:
          site: path.hcxEnterpriseSiteName
          private_cloud: path.privateCloudName
      - text: Show details of HCX site {site} on {private_cloud}.
        slots:
          site: path.hcxEnterpriseSiteName
          private_cloud: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/hcxEnterpriseSites/{hcxEnterpriseSiteName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an HCX enterprise site
      effect: write
      questions:
      - Can I add an HCX enterprise site to a private cloud?
      - Is it possible to update an existing HCX enterprise site?
      instructions:
      - text: Create HCX enterprise site {site} in private cloud {private_cloud}.
        slots:
          site: path.hcxEnterpriseSiteName
          private_cloud: path.privateCloudName
      - text: Create or update HCX site {site} on {private_cloud} with properties {properties}.
        slots:
          site: path.hcxEnterpriseSiteName
          private_cloud: path.privateCloudName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/hcxEnterpriseSites/{hcxEnterpriseSiteName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an HCX enterprise site
      effect: destructive
      questions:
      - How do I delete an HCX enterprise site from a private cloud?
      - Can I remove an HCX site I no longer use?
      instructions:
      - text: Delete HCX enterprise site {site} from private cloud {private_cloud}.
        slots:
          site: path.hcxEnterpriseSiteName
          private_cloud: path.privateCloudName
      - text: Remove HCX site {site} on {private_cloud}.
        slots:
          site: path.hcxEnterpriseSiteName
          private_cloud: path.privateCloudName
      method: generated
      generated: '2026-09-26'