# 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 Test Base Test Base Account API
  version: 1.0.0
extends: openapi/microsoft-azure-test-base-account-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: 9
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.TestBase/skus'].get
  update:
    x-apievangelist-phrasing:
      intent: List available Test Base account SKUs
      effect: read
      questions:
      - Which Test Base account SKUs can I choose in my subscription?
      - What tiers are offered when creating a Test Base account?
      instructions:
      - text: List the available Test Base account SKUs.
      - text: Show the SKUs I can pick for a new Test Base account.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.TestBase/testBaseAccounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List Test Base accounts in a subscription
      effect: read
      questions:
      - What Test Base accounts exist across my subscription?
      - Can I include soft-deleted Test Base accounts when listing the subscription?
      instructions:
      - text: List all Test Base accounts in my subscription.
      - text: 'List subscription Test Base accounts with deleted ones included: {getDeleted}.'
        slots:
          getDeleted: query.getDeleted
      - text: Show every Test Base account under subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List Test Base accounts in a resource group
      effect: read
      questions:
      - Which Test Base accounts are in one resource group?
      - Can I see deleted Test Base accounts in a resource group too?
      instructions:
      - text: List Test Base accounts in resource group {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      - text: 'List Test Base accounts in {resourceGroupName} including deleted: {getDeleted}.'
        slots:
          resourceGroupName: path.resourceGroupName
          getDeleted: query.getDeleted
      - text: Show Test Base accounts in subscription {subscriptionId}, group {resourceGroupName}.
        slots:
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Test Base account
      effect: read
      questions:
      - Where do I find the details of one Test Base account?
      - What SKU and state is my Test Base account in?
      instructions:
      - text: Get Test Base account {testBaseAccountName} in {resourceGroupName}.
        slots:
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
      - text: Look up Test Base account {testBaseAccountName} in subscription {subscriptionId}, group {resourceGroupName}.
        slots:
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
          testBaseAccountName: path.testBaseAccountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a Test Base account
      effect: write
      questions:
      - How do I create a Test Base account for testing my Windows app?
      - Can I restore a previously deleted Test Base account when creating one?
      - Does recreating a Test Base account cause downtime?
      instructions:
      - text: Create Test Base account {testBaseAccountName} in {resourceGroupName} at {location}.
        slots:
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
          location: requestBody.location
      - text: 'Recreate Test Base account {testBaseAccountName} in {resourceGroupName} in {location} restoring it: {restore}.'
        slots:
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
          location: requestBody.location
          restore: query.restore
      - text: Provision Test Base account {testBaseAccountName} under subscription {subscriptionId} in {resourceGroupName} at {location}.
        slots:
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
          testBaseAccountName: path.testBaseAccountName
          location: requestBody.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Test Base account
      effect: destructive
      questions:
      - Can I delete a Test Base account I no longer use?
      - Can I remove a Test Base account from a resource group?
      instructions:
      - text: Delete Test Base account {testBaseAccountName} in {resourceGroupName}.
        slots:
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
      - text: Remove Test Base account {testBaseAccountName} from subscription {subscriptionId}, group {resourceGroupName}.
        slots:
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
          testBaseAccountName: path.testBaseAccountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Test Base account
      effect: write
      questions:
      - How do I change tags on an existing Test Base account?
      - Can I modify a Test Base account's properties without recreating it?
      instructions:
      - text: Update tags on Test Base account {testBaseAccountName} in {resourceGroupName} to {tags}.
        slots:
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
          tags: requestBody.tags
      - text: Patch properties of existing Test Base account {testBaseAccountName} in subscription {subscriptionId}, group {resourceGroupName}.
        slots:
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
          testBaseAccountName: path.testBaseAccountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/offboard'].post
  update:
    x-apievangelist-phrasing:
      intent: Offboard a Test Base account
      effect: destructive
      questions:
      - Is there a way to offboard a Test Base account from the service?
      - What does offboarding a Test Base account do versus deleting it?
      instructions:
      - text: Offboard Test Base account {testBaseAccountName} in {resourceGroupName}.
        slots:
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
      - text: Offboard {testBaseAccountName} from Test Base in subscription {subscriptionId}, group {resourceGroupName}.
        slots:
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
          testBaseAccountName: path.testBaseAccountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/usages'].get
  update:
    x-apievangelist-phrasing:
      intent: Get usage data for a Test Base account
      effect: read
      questions:
      - How much has my Test Base account used so far?
      - Can I filter a Test Base account's usage data?
      instructions:
      - text: Show usage data for Test Base account {testBaseAccountName} in {resourceGroupName}.
        slots:
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
      - text: List usage of Test Base account {testBaseAccountName} matching {filter}.
        slots:
          testBaseAccountName: path.testBaseAccountName
          filter: query.$filter
      method: generated
      generated: '2026-10-01'