# 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 Azure Stack Azure Bridge Client…
  version: 1.0.0
extends: openapi/microsoft-azure-registrations-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: 8
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure Stack registrations in a resource group
      effect: read
      questions:
      - Which Azure Stack registrations exist in this resource group?
      - Can I see every Azure Stack registration scoped to one resource group?
      instructions:
      - text: List the Azure Stack registrations in resource group {resourceGroup}.
        slots:
          resourceGroup: path.resourceGroup
      - text: Show all Azure Stack registrations scoped to {resourceGroup}.
        slots:
          resourceGroup: path.resourceGroup
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.AzureStack/registrations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure Stack registrations in a subscription
      effect: read
      questions:
      - What Azure Stack registrations do I have across my whole subscription?
      - Is there a subscription-wide view of Azure Stack registrations?
      instructions:
      - text: List every Azure Stack registration under my subscription.
      - text: Show subscription-level Azure Stack registrations across all resource groups.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Azure Stack registration
      effect: read
      questions:
      - What properties does my Azure Stack registration have?
      - Can I read the details of one Azure Stack registration?
      instructions:
      - text: Get the properties of Azure Stack registration {registrationName} in resource group {resourceGroup}.
        slots:
          registrationName: path.registrationName
          resourceGroup: path.resourceGroup
      - text: Show me the details of Azure Stack registration {registrationName}.
        slots:
          registrationName: path.registrationName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Register an Azure Stack with a registration token
      effect: write
      questions:
      - How do I register my Azure Stack using a registration token?
      - Can I re-submit an Azure Stack registration to replace it?
      instructions:
      - text: Create Azure Stack registration {registrationName} in {resourceGroup} from registration token {token}.
        slots:
          registrationName: path.registrationName
          resourceGroup: path.resourceGroup
          token: body.token
      - text: Create or overwrite Azure Stack registration {registrationName}.
        slots:
          registrationName: path.registrationName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Azure Stack registration
      effect: destructive
      questions:
      - How do I unregister an Azure Stack by deleting its registration?
      - Can I remove an Azure Stack registration I no longer need?
      instructions:
      - text: Delete Azure Stack registration {registrationName} from resource group {resourceGroup}.
        slots:
          registrationName: path.registrationName
          resourceGroup: path.resourceGroup
      - text: Remove registration {registrationName} so the Azure Stack is unregistered.
        slots:
          registrationName: path.registrationName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch an Azure Stack registration
      effect: write
      questions:
      - Can I patch an existing Azure Stack registration with a new token?
      - What's the way to update a registration without recreating it?
      instructions:
      - text: Patch Azure Stack registration {registrationName} in {resourceGroup} with fresh registration token {token}.
        slots:
          registrationName: path.registrationName
          resourceGroup: path.resourceGroup
          token: body.token
      - text: Update existing registration {registrationName} in place rather than replacing it.
        slots:
          registrationName: path.registrationName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/getactivationkey'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the activation key for an Azure Stack
      effect: read
      questions:
      - Where do I get the activation key for my Azure Stack registration?
      - Can I retrieve an Azure Stack activation key again after registering?
      instructions:
      - text: Get the Azure Stack activation key for registration {registrationName} in {resourceGroup}.
        slots:
          registrationName: path.registrationName
          resourceGroup: path.resourceGroup
      - text: Fetch the activation key I need to activate the Azure Stack behind registration {registrationName}.
        slots:
          registrationName: path.registrationName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/enableRemoteManagement'].post
  update:
    x-apievangelist-phrasing:
      intent: Enable remote management for an Azure Stack
      effect: write
      questions:
      - How do I turn on remote management for a device under my Azure Stack registration?
      - Can remote management be enabled through the registration?
      instructions:
      - text: Enable remote management for the device under Azure Stack registration {registrationName} in {resourceGroup}.
        slots:
          registrationName: path.registrationName
          resourceGroup: path.resourceGroup
      - text: Turn on remote device management for registration {registrationName}.
        slots:
          registrationName: path.registrationName
      method: generated
      generated: '2026-10-01'