# 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 Package API
  version: 1.0.0
extends: openapi/microsoft-azure-test-base-package-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: 15
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/getFileUploadUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a file upload URL for a Test Base account
      effect: read
      questions:
      - Where do I upload a package file before creating a Test Base package?
      - Can I get an upload URL for a specific blob name?
      instructions:
      - text: Get a file upload URL for Test Base account {account} in {group}, subscription {sub}.
        slots:
          account: path.testBaseAccountName
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Get an upload URL for blob {blob} in Test Base account {account} ({group}, subscription {sub}).
        slots:
          blob: requestBody.blobName
          account: path.testBaseAccountName
          group: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/availableOSs'].get
  update:
    x-apievangelist-phrasing:
      intent: List OSs available for testing
      effect: read
      questions:
      - Which operating systems can I run my package against in Test Base?
      - What OS versions are available for security updates versus feature updates?
      instructions:
      - text: List available OSs for {update_type} updates in Test Base account {account} ({group}, subscription {sub}).
        slots:
          update_type: query.osUpdateType
          account: path.testBaseAccountName
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show which OSs support {update_type} testing in account {account}, group {group}.
        slots:
          update_type: query.osUpdateType
          account: path.testBaseAccountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/availableOSs/{availableOSResourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an available OS
      effect: read
      questions:
      - What are the details of one specific OS available to my Test Base account?
      - Can I look up a single available OS by its resource name?
      instructions:
      - text: Get available OS {os} in Test Base account {account} ({group}, subscription {sub}).
        slots:
          os: path.availableOSResourceName
          account: path.testBaseAccountName
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show details of OS {os} for account {account} in {group}, subscription {sub}.
        slots:
          os: path.availableOSResourceName
          account: path.testBaseAccountName
          group: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/flightingRings'].get
  update:
    x-apievangelist-phrasing:
      intent: List flighting rings
      effect: read
      questions:
      - Which flighting rings does my Test Base account have?
      - What pre-release rings can I test packages on?
      instructions:
      - text: List flighting rings in Test Base account {account} ({group}, subscription {sub}).
        slots:
          account: path.testBaseAccountName
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all flighting rings for account {account} in resource group {group}.
        slots:
          account: path.testBaseAccountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/flightingRings/{flightingRingResourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a flighting ring
      effect: read
      questions:
      - What does a specific flighting ring in Test Base contain?
      - Can I look up one flighting ring by name?
      instructions:
      - text: Get flighting ring {ring} in Test Base account {account} ({group}, subscription {sub}).
        slots:
          ring: path.flightingRingResourceName
          account: path.testBaseAccountName
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show flighting ring {ring} for account {account}, group {group}.
        slots:
          ring: path.flightingRingResourceName
          account: path.testBaseAccountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/testTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List test types
      effect: read
      questions:
      - Which test types can I run in my Test Base account?
      - What kinds of tests are offered for packages?
      instructions:
      - text: List test types in Test Base account {account} ({group}, subscription {sub}).
        slots:
          account: path.testBaseAccountName
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all test types available to account {account} in {group}, subscription {sub}.
        slots:
          account: path.testBaseAccountName
          group: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/testTypes/{testTypeResourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a test type
      effect: read
      questions:
      - What does one specific Test Base test type do?
      - Can I retrieve a single test type by name?
      instructions:
      - text: Get test type {test_type} in Test Base account {account} ({group}, subscription {sub}).
        slots:
          test_type: path.testTypeResourceName
          account: path.testBaseAccountName
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show test type {test_type} for account {account}, group {group}.
        slots:
          test_type: path.testTypeResourceName
          account: path.testBaseAccountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/checkPackageNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check if a package name and version are free
      effect: read
      questions:
      - Is a package name and version already in use in my Test Base account?
      - Can I validate a package name before I create it?
      instructions:
      - text: Check whether package {name} version {version} of app {app} is available in account {account} ({group}), type {type}.
        slots:
          name: requestBody.name
          version: requestBody.version
          app: requestBody.applicationName
          account: path.testBaseAccountName
          group: path.resourceGroupName
          type: requestBody.type
      - text: Verify {name} {version} for {app} is unused in Test Base account {account}, group {group}, subscription {sub}, resource type {type}.
        slots:
          name: requestBody.name
          version: requestBody.version
          app: requestBody.applicationName
          account: path.testBaseAccountName
          group: path.resourceGroupName
          type: requestBody.type
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages'].get
  update:
    x-apievangelist-phrasing:
      intent: List packages in a Test Base account
      effect: read
      questions:
      - Which packages have I uploaded to my Test Base account?
      - How do I see every package under a Test Base account?
      instructions:
      - text: List packages in Test Base account {account} ({group}, subscription {sub}).
        slots:
          account: path.testBaseAccountName
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all packages for account {account} in resource group {group}.
        slots:
          account: path.testBaseAccountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages/{packageName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Test Base package
      effect: read
      questions:
      - What is the current state of one of my Test Base packages?
      - Can I retrieve a single package's details by name?
      instructions:
      - text: Get package {package} in Test Base account {account} ({group}, subscription {sub}).
        slots:
          package: path.packageName
          account: path.testBaseAccountName
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show details of package {package} for account {account}, group {group}.
        slots:
          package: path.packageName
          account: path.testBaseAccountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages/{packageName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a Test Base package
      effect: write
      questions:
      - How do I create a new package in Test Base?
      - Will re-creating an existing package overwrite it with downtime?
      instructions:
      - text: Create package {package} in Test Base account {account} ({group}, subscription {sub}) in {location}.
        slots:
          package: path.packageName
          account: path.testBaseAccountName
          group: path.resourceGroupName
          location: requestBody.location
          sub: path.subscriptionId
      - text: Create or overwrite package {package} in account {account}, group {group}, region {location}, with {properties}.
        slots:
          package: path.packageName
          account: path.testBaseAccountName
          group: path.resourceGroupName
          location: requestBody.location
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages/{packageName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Test Base package
      effect: destructive
      questions:
      - Can I remove a package from my Test Base account?
      - What is the standard way to delete a package, as opposed to a hard delete?
      instructions:
      - text: Delete package {package} from Test Base account {account} ({group}, subscription {sub}).
        slots:
          package: path.packageName
          account: path.testBaseAccountName
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove package {package} in account {account}, group {group}.
        slots:
          package: path.packageName
          account: path.testBaseAccountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages/{packageName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Test Base package
      effect: write
      questions:
      - Can I change the tags or properties of an existing Test Base package?
      - How do I edit a package without re-creating it?
      instructions:
      - text: Update package {package} in account {account} ({group}, subscription {sub}) with {properties}.
        slots:
          package: path.packageName
          account: path.testBaseAccountName
          group: path.resourceGroupName
          properties: requestBody.properties
          sub: path.subscriptionId
      - text: Set tags {tags} on existing package {package} in account {account}, group {group}.
        slots:
          tags: requestBody.tags
          package: path.packageName
          account: path.testBaseAccountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages/{packageName}/hardDelete'].post
  update:
    x-apievangelist-phrasing:
      intent: Hard delete a Test Base package
      effect: destructive
      questions:
      - Is there a way to permanently purge a Test Base package?
      - What does a hard delete of a package do differently?
      instructions:
      - text: Hard delete package {package} in Test Base account {account} ({group}, subscription {sub}).
        slots:
          package: path.packageName
          account: path.testBaseAccountName
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Permanently purge package {package} from account {account}, group {group}.
        slots:
          package: path.packageName
          account: path.testBaseAccountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages/{packageName}/getDownloadUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a package download URL
      effect: read
      questions:
      - Where can I download a package I uploaded to Test Base?
      - Can I get a download link for a specific package?
      instructions:
      - text: Get the download URL for package {package} in account {account} ({group}, subscription {sub}).
        slots:
          package: path.packageName
          account: path.testBaseAccountName
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Give me a link to download package {package} from Test Base account {account}, group {group}.
        slots:
          package: path.packageName
          account: path.testBaseAccountName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'