# 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 Private Clouds API
  version: 1.0.0
extends: openapi/microsoft-azure-privateclouds-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: 11
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure VMware Solution private clouds in a group
      effect: read
      questions:
      - Which Azure VMware Solution private clouds are in my resource group?
      - Can I see the AVS private clouds scoped to just one resource group?
      instructions:
      - text: List the AVS private clouds in my resource group.
      - text: Show every Azure VMware Solution private cloud deployed in this resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.AVS/privateClouds'].get
  update:
    x-apievangelist-phrasing:
      intent: List AVS private clouds across a subscription
      effect: read
      questions:
      - What Azure VMware Solution private clouds do I have across my whole subscription?
      - Is there a subscription-wide view of all my AVS private clouds?
      instructions:
      - text: List all AVS private clouds in my subscription.
      - text: Show every Azure VMware Solution private cloud across the subscription, regardless of resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Azure VMware Solution private cloud
      effect: read
      questions:
      - How do I look up the details of one AVS private cloud by name?
      - What state and configuration does my Azure VMware Solution private cloud have?
      instructions:
      - text: Get AVS private cloud {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      - text: Show the configuration of Azure VMware Solution cloud {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace an AVS private cloud
      effect: write
      questions:
      - How do I deploy a new Azure VMware Solution private cloud?
      - Which SKU and location do I need to provide when creating an AVS private cloud?
      instructions:
      - text: Create AVS private cloud {privateCloudName} with SKU {sku}.
        slots:
          privateCloudName: path.privateCloudName
          sku: requestBody.sku
      - text: Deploy private cloud {privateCloudName} in {location} using SKU {sku}.
        slots:
          privateCloudName: path.privateCloudName
          location: requestBody.location
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an AVS private cloud
      effect: destructive
      questions:
      - How do I tear down an Azure VMware Solution private cloud?
      - Can I delete an AVS private cloud I'm no longer using?
      instructions:
      - text: Delete AVS private cloud {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      - text: Decommission Azure VMware Solution cloud {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch an existing AVS private cloud
      effect: write
      questions:
      - Can I change the tags or properties of an AVS private cloud that already exists?
      - What can I modify on a running Azure VMware Solution private cloud without redeploying it?
      instructions:
      - text: Update the tags on AVS private cloud {privateCloudName} to {tags}.
        slots:
          privateCloudName: path.privateCloudName
          tags: requestBody.tags
      - text: Patch existing private cloud {privateCloudName} with properties {properties}.
        slots:
          privateCloudName: path.privateCloudName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/rotateVcenterPassword'].post
  update:
    x-apievangelist-phrasing:
      intent: Rotate the vCenter password of a private cloud
      effect: write
      questions:
      - How do I rotate the vCenter admin password on my AVS private cloud?
      - Can I force a new vCenter password if I think it was exposed?
      instructions:
      - text: Rotate the vCenter password for private cloud {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      - text: Generate a new vCenter credential on {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/rotateNsxtPassword'].post
  update:
    x-apievangelist-phrasing:
      intent: Rotate the NSX-T Manager password
      effect: write
      questions:
      - How do I rotate the NSX-T Manager password on an AVS private cloud?
      - Can I reset the NSX-T admin password as part of a credential rotation policy?
      instructions:
      - text: Rotate the NSX-T Manager password for private cloud {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      - text: Issue a new NSX-T password on {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/listAdminCredentials'].post
  update:
    x-apievangelist-phrasing:
      intent: Get admin credentials for a private cloud
      effect: read
      questions:
      - Where do I find the vCenter and NSX-T admin credentials for my AVS private cloud?
      - Can I retrieve the current admin logins for a private cloud?
      instructions:
      - text: List the admin credentials for private cloud {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      - text: Show me the admin usernames and passwords for {privateCloudName}.
        slots:
          privateCloudName: path.privateCloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.VMwareCloudSimple/locations/{regionId}/privateClouds'].get
  update:
    x-apievangelist-phrasing:
      intent: List CloudSimple private clouds in a region
      effect: read
      questions:
      - Which VMware CloudSimple private clouds exist in a particular region?
      - Can I list the legacy CloudSimple private clouds by region?
      instructions:
      - text: List CloudSimple private clouds in region {regionId}.
        slots:
          regionId: path.regionId
      - text: Show the CloudSimple private clouds in region {regionId} for subscription {subscriptionId}.
        slots:
          regionId: path.regionId
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.VMwareCloudSimple/locations/{regionId}/privateClouds/{pcName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a CloudSimple private cloud in a region
      effect: read
      questions:
      - How do I look up a VMware CloudSimple private cloud by name within a region?
      - What does a specific legacy CloudSimple private cloud report?
      instructions:
      - text: Get CloudSimple private cloud {pcName} in region {regionId}.
        slots:
          pcName: path.pcName
          regionId: path.regionId
      - text: Show CloudSimple cloud {pcName} in {regionId} under subscription {subscriptionId}.
        slots:
          pcName: path.pcName
          regionId: path.regionId
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'