# 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 Configuration API
  version: 1.0.0
extends: openapi/microsoft-azure-configuration-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['/providers/Microsoft.ADHybridHealthService/configuration'].get
  update:
    x-apievangelist-phrasing:
      intent: Get my tenant's AD Connect Health onboarding details
      effect: read
      questions:
      - Is my tenant onboarded to Azure AD Connect Health, and with what settings?
      - What tenant details does AD Connect Health have on file for me?
      instructions:
      - text: Show my tenant's Azure AD Connect Health configuration using API version {api_version}.
        slots:
          api_version: query.api-version
      - text: Check whether this tenant is onboarded to AD Connect Health.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/configuration'].post
  update:
    x-apievangelist-phrasing:
      intent: Onboard my tenant to AD Connect Health
      effect: write
      questions:
      - How do I onboard my Microsoft Entra tenant to Azure AD Connect Health?
      - Can I enable Connect Health monitoring for my tenant through the API?
      instructions:
      - text: Onboard this tenant to Azure AD Connect Health with API version {api_version}.
        slots:
          api_version: query.api-version
      - text: Sign my tenant up for AD Connect Health monitoring.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/configuration'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tenant settings in AD Connect Health
      effect: write
      questions:
      - How do I turn on agent auto-update for my tenant in AD Connect Health?
      - Can I change how long Connect Health suppresses repeat alerts?
      - Which tenant properties can I edit after onboarding to Connect Health?
      instructions:
      - text: Set agent auto-update to {auto_update} for my Connect Health tenant.
        slots:
          auto_update: requestBody.agentAutoUpdate
      - text: Suppress repeat Connect Health alerts for {minutes} minutes.
        slots:
          minutes: requestBody.alertSuppressionTimeInMins
      - text: Update the onboarded tenant's global admin email list to {emails}.
        slots:
          emails: requestBody.globalAdminsEmail
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.ADHybridHealthService/services/{serviceName}/ipAddressAggregateSettings'].patch
  update:
    x-apievangelist-phrasing:
      intent: Set IP address alert thresholds for a Connect Health service
      effect: write
      questions:
      - How do I change the bad password and extranet lockout alert thresholds in AD Connect Health?
      - Can I get email notifications when risky IP thresholds are crossed for my ADFS service?
      instructions:
      - text: Set the hourly extranet lockout threshold to {hourly} for Connect Health service {service}.
        slots:
          hourly: requestBody.extranetLockoutHourlyThreshold
          service: path.serviceName
      - text: Set daily bad-password-plus-lockout threshold {daily} on service {service}.
        slots:
          daily: requestBody.badPasswordAndExtranetLockoutCombinedDailyThreshold
          service: path.serviceName
      - text: Turn email notifications {enabled} for risky IP alerts on service {service}.
        slots:
          enabled: requestBody.emailNotificationEnabled
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/configuration'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Code Transparency service configuration
      effect: read
      questions:
      - What configuration is my Azure Code Transparency service running with?
      - Can I read the Code Transparency ledger's current settings?
      instructions:
      - text: Get the Code Transparency configuration using API version {api_version}.
        slots:
          api_version: query.api-version
      - text: Show the Code Transparency service settings.
      method: generated
      generated: '2026-09-26'