# 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 PolicyClient Variables API
  version: 1.0.0
extends: openapi/microsoft-azure-variables-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: 8
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/variables/{variableName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a policy variable at subscription scope
      effect: read
      questions:
      - How do I look up a policy variable defined on my subscription?
      - What columns does a subscription-level policy variable declare?
      instructions:
      - text: Get policy variable {variableName} in subscription {subscriptionId}.
        slots:
          variableName: path.variableName
          subscriptionId: path.subscriptionId
      - text: Show the subscription-scoped policy variable {variableName}.
        slots:
          variableName: path.variableName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/variables/{variableName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a subscription policy variable
      effect: write
      questions:
      - Can I create a policy variable at subscription level for my policy definitions to use?
      - Which policy definitions are allowed to use a variable created on a subscription?
      instructions:
      - text: Create policy variable {variableName} in subscription {subscriptionId} with properties {properties}.
        slots:
          variableName: path.variableName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      - text: Update subscription policy variable {variableName} to {properties}.
        slots:
          variableName: path.variableName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/variables/{variableName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a subscription policy variable
      effect: destructive
      questions:
      - How do I remove a policy variable from my subscription?
      - Can I delete a subscription-level variable that policies still reference?
      instructions:
      - text: Delete policy variable {variableName} from subscription {subscriptionId}.
        slots:
          variableName: path.variableName
          subscriptionId: path.subscriptionId
      - text: Remove the subscription-scoped variable {variableName}.
        slots:
          variableName: path.variableName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.Authorization/variables/{variableName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a policy variable at management group scope
      effect: read
      questions:
      - Where can I read a policy variable that was defined on a management group?
      - What does a management-group-level policy variable contain?
      instructions:
      - text: Get policy variable {variableName} in management group {managementGroupId}.
        slots:
          variableName: path.variableName
          managementGroupId: path.managementGroupId
      - text: Show management group {managementGroupId}'s variable {variableName}.
        slots:
          managementGroupId: path.managementGroupId
          variableName: path.variableName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.Authorization/variables/{variableName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a management group policy variable
      effect: write
      questions:
      - Can I define a policy variable once on a management group so child scopes can use it?
      - What properties must I send to create a variable on a management group?
      instructions:
      - text: Create policy variable {variableName} in management group {managementGroupId} with properties {properties}.
        slots:
          variableName: path.variableName
          managementGroupId: path.managementGroupId
          properties: requestBody.properties
      - text: Update management group {managementGroupId} variable {variableName}.
        slots:
          managementGroupId: path.managementGroupId
          variableName: path.variableName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.Authorization/variables/{variableName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a management group policy variable
      effect: destructive
      questions:
      - How do I delete a policy variable that lives on a management group?
      - Can I remove a management-group variable without touching subscription ones?
      instructions:
      - text: Delete policy variable {variableName} from management group {managementGroupId}.
        slots:
          variableName: path.variableName
          managementGroupId: path.managementGroupId
      - text: Remove variable {variableName} defined at management group {managementGroupId}.
        slots:
          variableName: path.variableName
          managementGroupId: path.managementGroupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/variables'].get
  update:
    x-apievangelist-phrasing:
      intent: List policy variables in a subscription
      effect: read
      questions:
      - Which policy variables are defined at my subscription level?
      - Can I see every Azure Policy variable on a subscription at once?
      instructions:
      - text: List all policy variables in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show every variable created on my subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.Authorization/variables'].get
  update:
    x-apievangelist-phrasing:
      intent: List policy variables for a management group
      effect: read
      questions:
      - Which policy variables apply to a given management group?
      - Can I list all variables defined on a management group?
      instructions:
      - text: List the policy variables for management group {managementGroupId}.
        slots:
          managementGroupId: path.managementGroupId
      - text: Show every variable applicable to management group {managementGroupId}.
        slots:
          managementGroupId: path.managementGroupId
      method: generated
      generated: '2026-09-26'