API Evangelist conversational phrasing for Microsoft Azure Providers API

# 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 Providers API
  version: 1.0.0
extends: openapi/microsoft-azure-providers-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 167
- target: $.paths['/providers/Microsoft.ADHybridHealthService/addsservices/{serviceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of an onboarded AD Domain Service
      effect: read
      questions:
      - Where can I see the Connect Health details for one of my Active Directory Domain Services?
      - Can I look up a single AD DS service that is onboarded to Azure AD Connect Health by name?
      instructions:
      - text: Show me the Connect Health details for AD Domain Service {serviceName}.
        slots:
          serviceName: path.serviceName
      - text: Fetch the ADDS service record named {serviceName}.
        slots:
          serviceName: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/addsservices/{serviceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an AD Domain Service from Connect Health
      effect: destructive
      questions:
      - How do I offboard an Active Directory Domain Service from Connect Health?
      - Is there a confirm flag I must pass before an AD DS service is deleted from Connect Health?
      instructions:
      - text: Delete AD Domain Service {serviceName} from Connect Health monitoring.
        slots:
          serviceName: path.serviceName
      - text: Offboard ADDS service {serviceName} with confirm set to {confirm}.
        slots:
          serviceName: path.serviceName
          confirm: query.confirm
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/addsservices/{serviceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an onboarded AD Domain Service's settings
      effect: write
      questions:
      - Can I change the notification emails for an AD Domain Service monitored by Connect Health?
      - What AD DS service properties, like display name or disabled state, can I patch?
      instructions:
      - text: Rename AD Domain Service {serviceName} to display as {displayName}.
        slots:
          serviceName: path.serviceName
          displayName: requestBody.displayName
      - text: Send health alerts for ADDS service {serviceName} to {notificationEmails}.
        slots:
          serviceName: path.serviceName
          notificationEmails: requestBody.notificationEmails
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/addsservices/premiumCheck'].get
  update:
    x-apievangelist-phrasing:
      intent: List AD Domain Services on a premium-licensed tenant
      effect: read
      questions:
      - Which Active Directory Domain Services in my Azure AD Premium tenant are onboarded to Connect Health?
      - Can I page through the premium-checked AD DS services with skip and take counts?
      instructions:
      - text: List the premium-licensed AD Domain Services onboarded to Connect Health.
      - text: List premium AD DS services of type {serviceType}, taking {takeCount} results.
        slots:
          serviceType: query.serviceType
          takeCount: query.takeCount
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/services'].get
  update:
    x-apievangelist-phrasing:
      intent: List services onboarded to AD Connect Health
      effect: read
      questions:
      - What services does my tenant have onboarded to Azure Active Directory Connect Health?
      - Can I filter my Connect Health services by service type?
      instructions:
      - text: List every service my tenant has onboarded to Connect Health.
      - text: List Connect Health onboarded services filtered by type {serviceType}.
        slots:
          serviceType: query.serviceType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/services'].post
  update:
    x-apievangelist-phrasing:
      intent: Onboard a service to AD Connect Health
      effect: write
      questions:
      - How do I onboard a new service into AD Connect Health for my tenant?
      - Can I set notification emails when I first add a service to Connect Health?
      instructions:
      - text: Onboard a new Connect Health service named {serviceName}.
        slots:
          serviceName: requestBody.serviceName
      - text: Add service {displayName} to Connect Health and email alerts to {notificationEmails}.
        slots:
          displayName: requestBody.displayName
          notificationEmails: requestBody.notificationEmails
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/services/premiumCheck'].get
  update:
    x-apievangelist-phrasing:
      intent: List Connect Health services on a premium tenant
      effect: read
      questions:
      - Which Connect Health services qualify under my tenant's Azure AD Premium license?
      - Is there a premium check that lists only licensed Connect Health services?
      instructions:
      - text: Run the premium check and list licensed Connect Health services.
      - text: Show premium-licensed Connect Health services matching filter {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/services/{serviceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one Connect Health onboarded service
      effect: read
      questions:
      - How can I read the details of a single service onboarded to AD Connect Health?
      - What does Connect Health report about one specific onboarded service?
      instructions:
      - text: Get the Connect Health service record for {serviceName}.
        slots:
          serviceName: path.serviceName
      - text: Look up onboarded Connect Health service {serviceName} and show its health.
        slots:
          serviceName: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/services/{serviceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Connect Health onboarded service
      effect: destructive
      questions:
      - Can I remove a service I previously onboarded to AD Connect Health?
      - What happens to Connect Health monitoring when an onboarded service is deleted?
      instructions:
      - text: Delete onboarded Connect Health service {serviceName}.
        slots:
          serviceName: path.serviceName
      - text: Remove Connect Health service {serviceName}, passing confirm {confirm}.
        slots:
          serviceName: path.serviceName
          confirm: query.confirm
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/services/{serviceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Connect Health service's properties
      effect: write
      questions:
      - How do I turn off global admin email notifications for a Connect Health service?
      - Can I change which addresses get custom notifications for an onboarded service?
      instructions:
      - text: Set the custom notification emails for Connect Health service {serviceName} to {customNotificationEmails}.
        slots:
          serviceName: path.serviceName
          customNotificationEmails: requestBody.customNotificationEmails
      - text: Disable Connect Health service {serviceName} by setting disabled to {disabled}.
        slots:
          serviceName: path.serviceName
          disabled: requestBody.disabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/services/{serviceName}/checkServiceFeatureAvailibility/{featureName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if a service meets a feature's prerequisites
      effect: read
      questions:
      - Does my Connect Health service have all the prerequisites met to use a given feature?
      - Can I verify feature availability for a service before turning the feature on?
      instructions:
      - text: Check whether service {serviceName} meets the prerequisites for feature {featureName}.
        slots:
          serviceName: path.serviceName
          featureName: path.featureName
      - text: Verify feature {featureName} is available on Connect Health service {serviceName}.
        slots:
          featureName: path.featureName
          serviceName: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/services/{serviceName}/exporterrors/counts'].get
  update:
    x-apievangelist-phrasing:
      intent: Count the latest AAD export errors
      effect: read
      questions:
      - How many AAD export errors did my sync service hit most recently?
      - Can I get just the counts of export errors rather than the error details?
      instructions:
      - text: Count the latest AAD export errors for service {serviceName}.
        slots:
          serviceName: path.serviceName
      - text: Give me export error totals by type for {serviceName}.
        slots:
          serviceName: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/services/{serviceName}/exporterrors/listV2'].get
  update:
    x-apievangelist-phrasing:
      intent: List categorized export errors by bucket
      effect: read
      questions:
      - What are the individual export errors in one error category for my sync service?
      - Which error bucket do I have to choose when listing categorized export errors?
      instructions:
      - text: List the export errors in bucket {errorBucket} for service {serviceName}.
        slots:
          errorBucket: query.errorBucket
          serviceName: path.serviceName
      - text: Show categorized export error details for {serviceName} in the {errorBucket} category.
        slots:
          serviceName: path.serviceName
          errorBucket: query.errorBucket
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/services/{serviceName}/exportstatus'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a service's export status
      effect: read
      questions:
      - Is my Connect Health sync service currently exporting successfully?
      - Where do I see the export status of a sync service?
      instructions:
      - text: Get the export status for service {serviceName}.
        slots:
          serviceName: path.serviceName
      - text: Report how exports are running on {serviceName}.
        slots:
          serviceName: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/services/{serviceName}/monitoringconfiguration'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change a service's monitoring configuration
      effect: write
      questions:
      - How do I change a service-level monitoring setting in Connect Health?
      - Can I set one monitoring configuration key to a new value?
      instructions:
      - text: Set monitoring configuration {key} to {value} on service {serviceName}.
        slots:
          key: requestBody.key
          value: requestBody.value
          serviceName: path.serviceName
      - text: Update the monitoring setting {key} for {serviceName}.
        slots:
          key: requestBody.key
          serviceName: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/services/{serviceName}/monitoringconfigurations'].get
  update:
    x-apievangelist-phrasing:
      intent: List a service's monitoring configurations
      effect: read
      questions:
      - What service-level monitoring configurations are set on my Connect Health service?
      - Can I review all monitoring settings for a service before changing one?
      instructions:
      - text: List the monitoring configurations for service {serviceName}.
        slots:
          serviceName: path.serviceName
      - text: Show every monitoring setting currently applied to {serviceName}.
        slots:
          serviceName: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/services/{serviceName}/TenantWhitelisting/{featureName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if a tenant is allowed to use a feature
      effect: read
      questions:
      - Is the tenant behind my Connect Health service on the allow list for a feature?
      - Can I check tenant allow-listing for a feature through a registered service?
      instructions:
      - text: Check whether the tenant for service {serviceName} is allowed to use feature {featureName}.
        slots:
          serviceName: path.serviceName
          featureName: path.featureName
      - text: Confirm tenant allow-listing of {featureName} via service {serviceName}.
        slots:
          featureName: path.featureName
          serviceName: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Web/publishingUsers/web'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the App Service publishing user
      effect: read
      questions:
      - What deployment credentials user is set up for publishing my web apps?
      - Can I see the current publishing user for my App Service account?
      instructions:
      - text: Get my web app publishing user.
      - text: Show the publishing user using API version {api_version}.
        slots:
          api_version: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Web/publishingUsers/web'].put
  update:
    x-apievangelist-phrasing:
      intent: Update the App Service publishing user
      effect: write
      questions:
      - How do I change the deployment publishing user for my web apps?
      - Can I replace the publishing user credentials that my deployments use?
      instructions:
      - text: Update my web app publishing user.
      - text: Replace the publishing user with API version {api_version}.
        slots:
          api_version: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Web/sourcecontrols'].get
  update:
    x-apievangelist-phrasing:
      intent: List source controls available for websites
      effect: read
      questions:
      - Which source control providers are available to connect to my websites?
      - What source controls can App Service deploy from?
      instructions:
      - text: List the source controls available for my websites.
      - text: List website source controls using API version {api_version}.
        slots:
          api_version: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Web/sourcecontrols/{sourceControlType}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a source control token
      effect: read
      questions:
      - Can I see the token App Service holds for one source control type?
      - What source control token is stored for a given provider type?
      instructions:
      - text: Get the source control token for type {sourceControlType}.
        slots:
          sourceControlType: path.sourceControlType
      - text: Show the stored {sourceControlType} source control token.
        slots:
          sourceControlType: path.sourceControlType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Web/sourcecontrols/{sourceControlType}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a source control token
      effect: write
      questions:
      - How do I refresh the token App Service uses for a source control type?
      - Can I replace an expired source control token for my deployments?
      instructions:
      - text: Update the source control token for type {sourceControlType}.
        slots:
          sourceControlType: path.sourceControlType
      - text: Replace the {sourceControlType} token with properties {properties}.
        slots:
          sourceControlType: path.sourceControlType
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceId}/providers/Microsoft.PolicyInsights/attestations'].get
  update:
    x-apievangelist-phrasing:
      intent: List policy attestations for a resource
      effect: read
      questions:
      - Which compliance attestations have been recorded for one of my resources?
      - Can I limit how many attestations come back for a resource?
      instructions:
      - text: List all attestations for resource {resourceId}.
        slots:
          resourceId: path.resourceId
      - text: List the first {top} attestations on resource {resourceId}.
        slots:
          top: query.$top
          resourceId: path.resourceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceId}/providers/Microsoft.PolicyInsights/attestations/{attestationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one attestation on a resource
      effect: read
      questions:
      - How can I read a specific policy attestation I made on a resource?
      - What compliance state does a named attestation record at resource scope?
      instructions:
      - text: Get attestation {attestationName} on resource {resourceId}.
        slots:
          attestationName: path.attestationName
          resourceId: path.resourceId
      - text: Show me the {attestationName} attestation for {resourceId}.
        slots:
          attestationName: path.attestationName
          resourceId: path.resourceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceId}/providers/Microsoft.PolicyInsights/attestations/{attestationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an attestation on a resource
      effect: write
      questions:
      - How do I attest that a resource complies with a manual policy?
      - Can I overwrite an existing attestation at resource scope?
      instructions:
      - text: Create attestation {attestationName} on resource {resourceId} with properties {properties}.
        slots:
          attestationName: path.attestationName
          resourceId: path.resourceId
          properties: requestBody.properties
      - text: Update the {attestationName} attestation on {resourceId}.
        slots:
          attestationName: path.attestationName
          resourceId: path.resourceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceId}/providers/Microsoft.PolicyInsights/attestations/{attestationName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an attestation on a resource
      effect: destructive
      questions:
      - Can I withdraw a compliance attestation I made on a resource?
      - What removes an attestation at individual resource scope?
      instructions:
      - text: Delete attestation {attestationName} from resource {resourceId}.
        slots:
          attestationName: path.attestationName
          resourceId: path.resourceId
      - text: Remove the {attestationName} attestation recorded on {resourceId}.
        slots:
          attestationName: path.attestationName
          resourceId: path.resourceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Authorization/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Authorization provider operations
      effect: read
      questions:
      - What operations does the Microsoft.Authorization resource provider expose?
      - Which authorization actions can I reference in role definitions?
      instructions:
      - text: List the Microsoft.Authorization provider operations.
      - text: List authorization operations using API version {api_version}.
        slots:
          api_version: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.AlertsManagement/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Alerts Management provider operations
      effect: read
      questions:
      - Which operations are available through the Alerts Management resource provider?
      - What actions can I grant on Alerts Management resources?
      instructions:
      - text: List all Alerts Management provider operations.
      - text: Show the operations the Microsoft.AlertsManagement namespace supports.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.AlertsManagement/alertsMetaData'].get
  update:
    x-apievangelist-phrasing:
      intent: Get alerts metadata by identifier
      effect: read
      questions:
      - Where do I get metadata about alerts, such as the list of monitor services?
      - What identifier values does the alerts metadata endpoint accept?
      instructions:
      - text: Get alerts metadata for identifier {identifier}.
        slots:
          identifier: query.identifier
      - text: Fetch the {identifier} alert metadata information.
        slots:
          identifier: query.identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.AlertsManagement/alerts'].get
  update:
    x-apievangelist-phrasing:
      intent: List alerts in a scope with filters
      effect: read
      questions:
      - Which alerts fired in my subscription over the last day?
      - Can I filter alerts by severity and sort them by start time?
      - How do I find only the alerts that are still in the New state?
      instructions:
      - text: List alerts in scope {scope} with severity {severity}.
        slots:
          scope: path.scope
          severity: query.severity
      - text: List alerts in {scope} in state {alertState} over time range {timeRange}.
        slots:
          scope: path.scope
          alertState: query.alertState
          timeRange: query.timeRange
      - text: List alerts for target resource group {targetResourceGroup} in {scope}.
        slots:
          targetResourceGroup: query.targetResourceGroup
          scope: path.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.AlertsManagement/alerts/{alertId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a specific alert
      effect: read
      questions:
      - How can I see the full details of one alert instance?
      - What information is available about an alert when I have its ID?
      instructions:
      - text: Get alert {alertId} in scope {scope}.
        slots:
          alertId: path.alertId
          scope: path.scope
      - text: Show me everything about alert instance {alertId} under {scope}.
        slots:
          alertId: path.alertId
          scope: path.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.AlertsManagement/alerts/{alertId}/changestate'].post
  update:
    x-apievangelist-phrasing:
      intent: Change an alert's state
      effect: write
      questions:
      - How do I acknowledge an alert so my team knows someone is on it?
      - Can I close an alert and leave a comment explaining why?
      instructions:
      - text: Set alert {alertId} in scope {scope} to state {newState}.
        slots:
          alertId: path.alertId
          scope: path.scope
          newState: query.newState
      - text: Mark alert {alertId} under {scope} as {newState} with comment {comment}.
        slots:
          alertId: path.alertId
          scope: path.scope
          newState: query.newState
          comment: body.comment
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.AlertsManagement/alerts/{alertId}/history'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the change history of an alert
      effect: read
      questions:
      - When was an alert acknowledged, closed, or resolved?
      - Can I see the monitor condition changes an alert went through?
      instructions:
      - text: Get the history of alert {alertId} in scope {scope}.
        slots:
          alertId: path.alertId
          scope: path.scope
      - text: Show who changed the state of alert {alertId} under {scope} and when.
        slots:
          alertId: path.alertId
          scope: path.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.AlertsManagement/alertsSummary'].get
  update:
    x-apievangelist-phrasing:
      intent: Summarize alert counts grouped by field
      effect: read
      questions:
      - How many alerts do I have for each severity level?
      - Can I group my alert counts by two fields at once, like severity and state?
      instructions:
      - text: Summarize alerts in scope {scope} grouped by {groupby}.
        slots:
          scope: path.scope
          groupby: query.groupby
      - text: Count alerts in {scope} grouped by {groupby} for monitor service {monitorService}.
        slots:
          scope: path.scope
          groupby: query.groupby
          monitorService: query.monitorService
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.AlertsManagement/alerts/{alertId}/enrichments'].get
  update:
    x-apievangelist-phrasing:
      intent: List an alert's enrichments
      effect: read
      questions:
      - What enrichments have been attached to an alert?
      - Is there a collection of enrichment objects I can list for an alert?
      instructions:
      - text: List the enrichments collection for alert {alertId} in scope {scope}.
        slots:
          alertId: path.alertId
          scope: path.scope
      - text: Enumerate enrichment objects attached to alert {alertId} under {scope}.
        slots:
          alertId: path.alertId
          scope: path.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.AlertsManagement/alerts/{alertId}/enrichments/default'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an alert's default enrichment
      effect: read
      questions:
      - Can I read the default enrichment details for an alert directly?
      - What extra context does the default enrichment give me about an alert?
      instructions:
      - text: Get the default enrichment for alert {alertId} in scope {scope}.
        slots:
          alertId: path.alertId
          scope: path.scope
      - text: Fetch alert {alertId}'s default enrichment record under {scope}.
        slots:
          alertId: path.alertId
          scope: path.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Migrate/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure Migrate provider operations
      effect: read
      questions:
      - Which REST operations does the Microsoft.Migrate provider support?
      - What migration actions are exposed by Azure Migrate?
      instructions:
      - text: List the operations supported by Microsoft.Migrate.
      - text: Show every Azure Migrate REST operation.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Quantum/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure Quantum provider operations
      effect: read
      questions:
      - What operations can I perform on Azure Quantum workspaces?
      - Which actions does the Microsoft.Quantum provider publish?
      instructions:
      - text: List the Microsoft.Quantum operations.
      - text: List quantum provider operations using API version {api_version}.
        slots:
          api_version: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers'].get
  update:
    x-apievangelist-phrasing:
      intent: List resource providers for a subscription
      effect: read
      questions:
      - Which resource providers are available in my subscription and are they registered?
      - Can I expand the provider list to include resource type metadata like aliases?
      instructions:
      - text: List all resource providers for subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: List providers in subscription {subscriptionId} expanding {expand}.
        slots:
          subscriptionId: path.subscriptionId
          expand: query.$expand
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.Insights/tenantActionGroups/{tenantActionGroupName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tenant action group
      effect: read
      questions:
      - How can I view the receivers configured on a tenant-level action group?
      - Which tenant ID header do I need to read a tenant action group?
      instructions:
      - text: Get tenant action group {tenantActionGroupName} in management group {managementGroupId}.
        slots:
          tenantActionGroupName: path.tenantActionGroupName
          managementGroupId: path.managementGroupId
      - text: Show tenant action group {tenantActionGroupName} under {managementGroupId} for tenant {tenantId}.
        slots:
          tenantActionGroupName: path.tenantActionGroupName
          managementGroupId: path.managementGroupId
          tenantId: header.x-ms-client-tenant-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.Insights/tenantActionGroups/{tenantActionGroupName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a tenant action group
      effect: write
      questions:
      - How do I set up a tenant-level action group that notifies people when alerts fire?
      - Do I have to give a location when creating a tenant action group?
      instructions:
      - text: Create tenant action group {tenantActionGroupName} in management group {managementGroupId} at location {location}.
        slots:
          tenantActionGroupName: path.tenantActionGroupName
          managementGroupId: path.managementGroupId
          location: requestBody.location
      - text: Replace tenant action group {tenantActionGroupName} under {managementGroupId} with properties {properties}.
        slots:
          tenantActionGroupName: path.tenantActionGroupName
          managementGroupId: path.managementGroupId
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (128 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure/refs/heads/main/overlays/microsoft-azure-providers-api-phrasing-overlay.yaml