# 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 customproviders Associations API
  version: 1.0.0
extends: openapi/microsoft-azure-associations-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['/{scope}/providers/Microsoft.CustomProviders/associations/{associationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom provider association
      effect: read
      questions:
      - What target resource does a custom provider association point to?
      - Can I look up one custom resource provider association by name?
      instructions:
      - text: Show association {associationName} at scope {scope}.
        slots:
          associationName: path.associationName
          scope: path.scope
      - text: Get the custom provider association {associationName} on {scope}.
        slots:
          associationName: path.associationName
          scope: path.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.CustomProviders/associations/{associationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a custom provider association
      effect: write
      questions:
      - How do I associate an existing Azure resource with my custom resource provider?
      - Can I change the target of an existing association?
      instructions:
      - text: Create association {associationName} at scope {scope} with properties {properties}.
        slots:
          associationName: path.associationName
          scope: path.scope
          properties: requestBody.properties
      - text: Link the resource at {scope} to my custom provider as association {associationName}.
        slots:
          scope: path.scope
          associationName: path.associationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.CustomProviders/associations/{associationName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom provider association
      effect: destructive
      questions:
      - How do I unlink a resource from my custom resource provider?
      - Can I delete an association without deleting the resource itself?
      instructions:
      - text: Delete association {associationName} at scope {scope}.
        slots:
          associationName: path.associationName
          scope: path.scope
      - text: Remove the custom provider association {associationName} from {scope}.
        slots:
          associationName: path.associationName
          scope: path.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.CustomProviders/associations'].get
  update:
    x-apievangelist-phrasing:
      intent: List custom provider associations at a scope
      effect: read
      questions:
      - Which custom provider associations exist on a given resource scope?
      - What resources are associated with custom providers under this scope?
      instructions:
      - text: List all associations at scope {scope}.
        slots:
          scope: path.scope
      - text: Show every custom provider association under {scope}.
        slots:
          scope: path.scope
      method: generated
      generated: '2026-09-26'