# 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 Custom Locations API
  version: 1.0.0
extends: openapi/microsoft-azure-customlocations-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: 9
- target: $.paths['/providers/Microsoft.ExtendedLocation/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Custom Locations API operations
      effect: read
      questions:
      - Which operations does the Custom Locations resource provider support?
      - What actions can I take with Azure Arc custom locations?
      instructions:
      - text: List all available Custom Locations operations.
      - text: Show the operations the ExtendedLocation provider exposes.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ExtendedLocation/customLocations'].get
  update:
    x-apievangelist-phrasing:
      intent: List custom locations in a subscription
      effect: read
      questions:
      - Which custom locations exist across my whole subscription?
      - Can I see every Arc custom location I have in Azure?
      instructions:
      - text: List all custom locations in my subscription.
      - text: Show every custom location across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ExtendedLocation/customLocations'].get
  update:
    x-apievangelist-phrasing:
      intent: List custom locations in a resource group
      effect: read
      questions:
      - What custom locations are in one resource group?
      - Can I narrow the custom locations list to a single resource group?
      instructions:
      - text: List custom locations in my resource group.
      - text: Show the custom locations scoped to this resource group only.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ExtendedLocation/customLocations/{resourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom location
      effect: read
      questions:
      - What namespace and host resource is a custom location tied to?
      - Where can I see the details of a single custom location?
      instructions:
      - text: Get custom location {custom_location}.
        slots:
          custom_location: path.resourceName
      - text: Show the properties of custom location {custom_location}.
        slots:
          custom_location: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ExtendedLocation/customLocations/{resourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a custom location
      effect: write
      questions:
      - How do I create a custom location on my Arc-enabled cluster?
      - Can I set a managed identity when creating a custom location?
      instructions:
      - text: Create custom location {custom_location}.
        slots:
          custom_location: path.resourceName
      - text: Create or replace custom location {custom_location} with a system-assigned identity.
        slots:
          custom_location: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ExtendedLocation/customLocations/{resourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom location
      effect: destructive
      questions:
      - Can I remove a custom location I no longer deploy to?
      - What is deleted when I remove a custom location?
      instructions:
      - text: Delete custom location {custom_location}.
        slots:
          custom_location: path.resourceName
      - text: Remove custom location {custom_location} from my resource group.
        slots:
          custom_location: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ExtendedLocation/customLocations/{resourceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a custom location
      effect: write
      questions:
      - Can I change tags or identity on an existing custom location?
      - Is there a partial update for a custom location?
      instructions:
      - text: Update tags on custom location {custom_location} to {tags}.
        slots:
          custom_location: path.resourceName
          tags: requestBody.tags
      - text: Patch the properties of custom location {custom_location}.
        slots:
          custom_location: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ExtendedLocation/customLocations/{resourceName}/enabledResourceTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List resource types enabled on a custom location
      effect: read
      questions:
      - Which resource types can I deploy to a custom location?
      - What cluster extensions are enabled on my custom location?
      instructions:
      - text: List enabled resource types on custom location {custom_location}.
        slots:
          custom_location: path.resourceName
      - text: Show what I can deploy to custom location {custom_location}.
        slots:
          custom_location: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ExtendedLocation/customLocations/{resourceName}/findTargetResourceGroup'].post
  update:
    x-apievangelist-phrasing:
      intent: Find the target resource group for resource sync
      effect: read
      questions:
      - Which resource group will synced resources land in for a custom location?
      - Can I match labels against a custom location's resource sync rules?
      instructions:
      - text: Find the target resource group on custom location {custom_location} for labels {labels}.
        slots:
          custom_location: path.resourceName
          labels: requestBody.labels
      - text: Check which sync rule on {custom_location} matches these labels.
        slots:
          custom_location: path.resourceName
      method: generated
      generated: '2026-09-26'