# 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 ResourcePrivateLinkClient Private Link…
  version: 1.0.0
extends: openapi/microsoft-azure-privatelinkassociation-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['/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Authorization/privateLinkAssociations/{plaId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a private link association
      effect: read
      questions:
      - Which resource management private link is associated with my management group?
      - Where can I see one private link association by its ID?
      instructions:
      - text: Get private link association {association} on management group {group}.
        slots:
          group: path.groupId
          association: path.plaId
      - text: Show management group {group} private link association {association}.
        slots:
          group: path.groupId
          association: path.plaId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Authorization/privateLinkAssociations/{plaId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a private link association
      effect: write
      questions:
      - How do I tie a resource management private link to a management group?
      - Can I restrict public network access through a private link association?
      instructions:
      - text: Create private link association {association} on management group {group}.
        slots:
          group: path.groupId
          association: path.plaId
      - text: Associate management group {group} with a private link as association {association}.
        slots:
          group: path.groupId
          association: path.plaId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Authorization/privateLinkAssociations/{plaId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a private link association
      effect: destructive
      questions:
      - Can I remove the private link association from a management group?
      - What happens to private access when I delete a private link association?
      instructions:
      - text: Delete private link association {association} from management group {group}.
        slots:
          group: path.groupId
          association: path.plaId
      - text: Remove management group {group} association {association}.
        slots:
          group: path.groupId
          association: path.plaId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Authorization/privateLinkAssociations'].get
  update:
    x-apievangelist-phrasing:
      intent: List private link associations on a management group
      effect: read
      questions:
      - Which private link associations exist for my management group?
      - Can I list every private link association at a management group scope?
      instructions:
      - text: List private link associations on management group {group}.
        slots:
          group: path.groupId
      - text: Show all private link associations for management group {group}.
        slots:
          group: path.groupId
      method: generated
      generated: '2026-09-26'