# 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 API
  version: 1.0.0
extends: openapi/microsoft-azure-test-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: 20
- target: $.paths['/tests'].get
  update:
    x-apievangelist-phrasing:
      intent: List load tests in a load testing resource
      effect: read
      questions:
      - Which load tests have been set up in my Azure Load Testing resource?
      - Can I find load tests modified within a certain date range?
      - Is there a way to search my load tests by display name prefix?
      instructions:
      - text: List all my load tests, sorted by last modified time.
      - text: Find load tests whose display name starts with {search}.
        slots:
          search: query.search
      - text: Show load tests changed between {lastModifiedStartTime} and {lastModifiedEndTime}.
        slots:
          lastModifiedStartTime: query.lastModifiedStartTime
          lastModifiedEndTime: query.lastModifiedEndTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tests/{testId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a load test's details
      effect: read
      questions:
      - What configuration and pass/fail criteria does a specific load test have?
      - Where can I see the full definition of one load test by its ID?
      instructions:
      - text: Show me the details of load test {testId}.
        slots:
          testId: path.testId
      - text: Get the configuration for test {testId}.
        slots:
          testId: path.testId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tests/{testId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a load test
      effect: destructive
      questions:
      - How do I remove a load test I no longer need?
      - Can I delete a load test using only its test ID?
      instructions:
      - text: Delete load test {testId}.
        slots:
          testId: path.testId
      - text: Remove the test {testId} from my load testing resource.
        slots:
          testId: path.testId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tests/{testId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update a load test
      effect: write
      questions:
      - How do I define a new load test with pass/fail criteria and auto-stop rules?
      - Can I attach secrets, certificates and environment variables to a load test?
      - What lets me compare a test against a baseline test run?
      instructions:
      - text: Create load test {testId} named {displayName}.
        slots:
          testId: path.testId
          displayName: requestBody.displayName
      - text: Set the baseline run for test {testId} to {baselineTestRunId}.
        slots:
          testId: path.testId
          baselineTestRunId: requestBody.baselineTestRunId
      - text: Update the pass/fail criteria on load test {testId} to {passFailCriteria}.
        slots:
          testId: path.testId
          passFailCriteria: requestBody.passFailCriteria
      - text: Run test {testId} inside subnet {subnetId} with public IP disabled.
        slots:
          testId: path.testId
          subnetId: requestBody.subnetId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tests/{testId}/app-components'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the app components linked to a test
      effect: read
      questions:
      - Which Azure resources are being monitored as app components for my load test?
      - What app components are associated with a given test?
      instructions:
      - text: Show the app components attached to test {testId}.
        slots:
          testId: path.testId
      - text: List the Azure resources monitored during load test {testId}.
        slots:
          testId: path.testId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tests/{testId}/app-components'].patch
  update:
    x-apievangelist-phrasing:
      intent: Add app components to a load test
      effect: write
      questions:
      - How do I link an Azure resource to a load test as an app component?
      - Can I monitor my web app's resources while a load test runs?
      instructions:
      - text: Add app components {components} to load test {testId}.
        slots:
          components: requestBody.components
          testId: path.testId
      - text: Attach my App Service resource as an app component on test {testId}.
        slots:
          testId: path.testId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tests/{testId}/files'].get
  update:
    x-apievangelist-phrasing:
      intent: List the files uploaded to a load test
      effect: read
      questions:
      - What test scripts and input files have I uploaded to a load test?
      - Can I see every file attached to a test in one list?
      instructions:
      - text: List all files uploaded to load test {testId}.
        slots:
          testId: path.testId
      - text: Show me the JMeter scripts and CSVs on test {testId}.
        slots:
          testId: path.testId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tests/{testId}/files/{fileName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one file from a load test
      effect: read
      questions:
      - How can I look up a single named file attached to a load test?
      - Can I check the metadata of one test script by its file name?
      instructions:
      - text: Get file {fileName} from load test {testId}.
        slots:
          fileName: path.fileName
          testId: path.testId
      - text: Show the details of {fileName} on test {testId}.
        slots:
          fileName: path.fileName
          testId: path.testId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tests/{testId}/files/{fileName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload an input file to a load test
      effect: write
      questions:
      - How do I upload a JMeter script or CSV data file to a load test?
      - What is the maximum file size I can upload for a test?
      - Does uploading a file with the same name overwrite the existing one?
      instructions:
      - text: Upload {fileName} to load test {testId}.
        slots:
          fileName: path.fileName
          testId: path.testId
      - text: Upload {fileName} to test {testId} as file type {fileType}.
        slots:
          fileName: path.fileName
          testId: path.testId
          fileType: query.fileType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tests/{testId}/files/{fileName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a file from a load test
      effect: destructive
      questions:
      - How do I remove an old script file from a load test?
      - Can I delete just one input file without deleting the whole test?
      instructions:
      - text: Delete file {fileName} from load test {testId}.
        slots:
          fileName: path.fileName
          testId: path.testId
      - text: Remove {fileName} from the files on test {testId}.
        slots:
          fileName: path.fileName
          testId: path.testId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tests/{testId}/server-metrics-config'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a load test's server metrics configuration
      effect: read
      questions:
      - Which server-side metrics are collected during my load test?
      - What server metrics configuration is set on a test?
      instructions:
      - text: Show the server metrics configured for test {testId}.
        slots:
          testId: path.testId
      - text: List which resource metrics load test {testId} collects.
        slots:
          testId: path.testId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tests/{testId}/server-metrics-config'].patch
  update:
    x-apievangelist-phrasing:
      intent: Configure server metrics for a load test
      effect: write
      questions:
      - How do I choose which server metrics a load test captures?
      - Can I add CPU and memory metrics from my backend to a test?
      instructions:
      - text: Set the server metrics for test {testId} to {metrics}.
        slots:
          testId: path.testId
          metrics: requestBody.metrics
      - text: Add backend CPU metrics to the server metrics config of load test {testId}.
        slots:
          testId: path.testId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/loadtests/{testId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a load test by name (legacy endpoint)
      effect: read
      questions:
      - How do I fetch a load test model through the older loadtests endpoint?
      - Can I still read a test by name using the legacy loadtests path?
      instructions:
      - text: Get the load test model for {testId} from the legacy loadtests endpoint.
        slots:
          testId: path.testId
      - text: Using the older API, show load test {testId}.
        slots:
          testId: path.testId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/loadtests/{testId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a load test by name (legacy endpoint)
      effect: destructive
      questions:
      - How do I delete a test through the older loadtests endpoint?
      - What characters are allowed in a test name when deleting via the legacy path?
      instructions:
      - text: Delete load test {testId} using the legacy loadtests endpoint.
        slots:
          testId: path.testId
      - text: With the older API, remove the test named {testId}.
        slots:
          testId: path.testId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/loadtests/{testId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update a load test (legacy endpoint)
      effect: write
      questions:
      - How do I create a load test with input artifacts through the older loadtests API?
      - Can the legacy endpoint set the target resource ID for a load test?
      instructions:
      - text: Using the legacy loadtests API, create test {testId} targeting resource {resourceId}.
        slots:
          testId: path.testId
          resourceId: requestBody.resourceId
      - text: Update the legacy load test {testId} description to {description}.
        slots:
          testId: path.testId
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/loadtests/sortAndFilter'].get
  update:
    x-apievangelist-phrasing:
      intent: Search and sort load tests (legacy endpoint)
      effect: read
      questions:
      - How do I sort and filter load tests with the older sortAndFilter endpoint?
      - Can I page through legacy load test search results with a next link?
      instructions:
      - text: Using the legacy sortAndFilter endpoint, search load tests for {search}.
        slots:
          search: query.search
      - text: Through the older API, list load tests updated after {lastUpdatedStartTime}.
        slots:
          lastUpdatedStartTime: query.lastUpdatedStartTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/loadtests/{testId}/files/{fileId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a test file by ID (legacy endpoint)
      effect: read
      questions:
      - How do I read a load test file by its file ID on the older API?
      - Can I fetch one legacy test file's details?
      instructions:
      - text: Get legacy test file {fileId} from load test {testId}.
        slots:
          fileId: path.fileId
          testId: path.testId
      - text: Using the loadtests endpoint, show file {fileId} of test {testId}.
        slots:
          fileId: path.fileId
          testId: path.testId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/loadtests/{testId}/files/{fileId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload a test file (legacy endpoint)
      effect: write
      questions:
      - How do I upload a test file through the older loadtests API?
      - Is the 50 MB file size limit the same on the legacy upload path?
      instructions:
      - text: Upload {file} as file {fileId} to load test {testId} via the legacy endpoint.
        slots:
          file: requestBody.file
          fileId: path.fileId
          testId: path.testId
      - text: Using the older API, attach file {fileId} to test {testId}.
        slots:
          fileId: path.fileId
          testId: path.testId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/loadtests/{testId}/files/{fileId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a test file (legacy endpoint)
      effect: destructive
      questions:
      - How do I delete a test file by ID through the older loadtests path?
      - Can the legacy API remove a single uploaded file from a test?
      instructions:
      - text: Delete legacy test file {fileId} from load test {testId}.
        slots:
          fileId: path.fileId
          testId: path.testId
      - text: With the older loadtests API, remove file {fileId} from test {testId}.
        slots:
          fileId: path.fileId
          testId: path.testId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/loadtests/{testId}/files'].get
  update:
    x-apievangelist-phrasing:
      intent: List a test's files (legacy endpoint)
      effect: read
      questions:
      - How do I list every file on a load test through the older loadtests API?
      - Which files does a legacy load test have uploaded?
      instructions:
      - text: Using the legacy loadtests endpoint, list all files for test {testId}.
        slots:
          testId: path.testId
      - text: Show every uploaded file on legacy load test {testId}.
        slots:
          testId: path.testId
      method: generated
      generated: '2026-09-26'