# 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 customLocations Resource Sync Rules API
  version: 1.0.0
extends: openapi/microsoft-azure-resourcesyncrules-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ExtendedLocation/customLocations/{resourceName}/resourceSyncRules'].get
  update:
    x-apievangelist-phrasing:
      intent: List resource sync rules on a custom location
      effect: read
      questions:
      - Which resource sync rules are defined on my Azure Arc custom location?
      - Can I list all sync rules for a custom location?
      instructions:
      - text: List resource sync rules on custom location {resourceName}.
        slots:
          resourceName: path.resourceName
      - text: Show every resource sync rule attached to custom location {resourceName}.
        slots:
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ExtendedLocation/customLocations/{resourceName}/resourceSyncRules/{childResourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a resource sync rule
      effect: read
      questions:
      - What are the settings of one resource sync rule on a custom location?
      - Can I look up a single sync rule by name?
      instructions:
      - text: Get resource sync rule {childResourceName} on custom location {resourceName}.
        slots:
          childResourceName: path.childResourceName
          resourceName: path.resourceName
      - text: Show the properties of sync rule {childResourceName} for custom location {resourceName}.
        slots:
          childResourceName: path.childResourceName
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ExtendedLocation/customLocations/{resourceName}/resourceSyncRules/{childResourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a resource sync rule
      effect: write
      questions:
      - What does it take to create a resource sync rule on a custom location?
      - Can I overwrite an existing sync rule's full definition?
      instructions:
      - text: Create resource sync rule {childResourceName} on custom location {resourceName}.
        slots:
          childResourceName: path.childResourceName
          resourceName: path.resourceName
      - text: Create or replace sync rule {childResourceName} under custom location {resourceName}.
        slots:
          childResourceName: path.childResourceName
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ExtendedLocation/customLocations/{resourceName}/resourceSyncRules/{childResourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a resource sync rule
      effect: destructive
      questions:
      - Can I delete a resource sync rule from a custom location?
      - What call removes a sync rule I no longer need?
      instructions:
      - text: Delete resource sync rule {childResourceName} from custom location {resourceName}.
        slots:
          childResourceName: path.childResourceName
          resourceName: path.resourceName
      - text: Remove sync rule {childResourceName} on custom location {resourceName}.
        slots:
          childResourceName: path.childResourceName
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ExtendedLocation/customLocations/{resourceName}/resourceSyncRules/{childResourceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a resource sync rule
      effect: write
      questions:
      - Can I change only the tags or some properties of an existing sync rule?
      - Is there a partial update for a resource sync rule?
      instructions:
      - text: Patch resource sync rule {childResourceName} on custom location {resourceName}.
        slots:
          childResourceName: path.childResourceName
          resourceName: path.resourceName
      - text: Set tags {tags} on existing sync rule {childResourceName} of custom location {resourceName}.
        slots:
          tags: requestBody.tags
          childResourceName: path.childResourceName
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'