# 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 ProviderHub Default Rollouts API
  version: 1.0.0
extends: openapi/microsoft-azure-defaultrollouts-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['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/defaultRollouts/{rolloutName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a resource provider's default rollout
      effect: read
      questions:
      - How do I check the details and progress of one default rollout for my resource provider?
      - What stage is a ProviderHub default rollout currently in?
      instructions:
      - text: Get default rollout {rolloutName} for provider namespace {providerNamespace}.
        slots:
          rolloutName: path.rolloutName
          providerNamespace: path.providerNamespace
      - text: Show the status of rollout {rolloutName}.
        slots:
          rolloutName: path.rolloutName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/defaultRollouts/{rolloutName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a default rollout
      effect: write
      questions:
      - How do I start a new default rollout of my resource provider's manifest?
      - Can I change the rollout specification of an existing default rollout?
      instructions:
      - text: Create default rollout {rolloutName} for provider namespace {providerNamespace}.
        slots:
          rolloutName: path.rolloutName
          providerNamespace: path.providerNamespace
      - text: Update rollout {rolloutName} on {providerNamespace} with properties {properties}.
        slots:
          rolloutName: path.rolloutName
          providerNamespace: path.providerNamespace
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/defaultRollouts/{rolloutName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a finished default rollout
      effect: destructive
      questions:
      - How do I delete a default rollout resource once it has completed?
      - Can I remove a rollout that is still in progress, or must it reach a terminal state first?
      instructions:
      - text: Delete default rollout {rolloutName} from provider namespace {providerNamespace}.
        slots:
          rolloutName: path.rolloutName
          providerNamespace: path.providerNamespace
      - text: Clean up the completed rollout {rolloutName}.
        slots:
          rolloutName: path.rolloutName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/defaultRollouts'].get
  update:
    x-apievangelist-phrasing:
      intent: List default rollouts for a resource provider
      effect: read
      questions:
      - Which default rollouts have been run for my resource provider registration?
      - Can I see every rollout history entry for one provider namespace?
      instructions:
      - text: List the default rollouts for provider namespace {providerNamespace}.
        slots:
          providerNamespace: path.providerNamespace
      - text: Show all rollouts registered under {providerNamespace}.
        slots:
          providerNamespace: path.providerNamespace
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/defaultRollouts/{rolloutName}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop an in-progress default rollout
      effect: destructive
      questions:
      - How do I cancel a default rollout that is going badly?
      - Can I halt a ProviderHub rollout while it is still in progress?
      instructions:
      - text: Stop default rollout {rolloutName} for provider namespace {providerNamespace}.
        slots:
          rolloutName: path.rolloutName
          providerNamespace: path.providerNamespace
      - text: Cancel the running rollout {rolloutName}.
        slots:
          rolloutName: path.rolloutName
      method: generated
      generated: '2026-09-26'