# 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 Artifacts API
  version: 1.0.0
extends: openapi/microsoft-azure-artifacts-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DevHub/locations/{location}/generatePreviewArtifacts'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a generated Dockerfile and manifests
      effect: read
      questions:
      - Can Developer Hub generate a Dockerfile and Kubernetes manifests for my app?
      - Which language and port settings shape the previewed deployment files?
      instructions:
      - text: Preview a Dockerfile and manifests in {location} for a {generationLanguage} app on port {port}.
        slots:
          location: path.location
          generationLanguage: requestBody.generationLanguage
          port: requestBody.port
      - text: Generate preview deployment files for app {appName} with image {imageName}:{imageTag}.
        slots:
          appName: requestBody.appName
          imageName: requestBody.imageName
          imageTag: requestBody.imageTag
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/artifactsources/{artifactSourceName}/artifacts'].get
  update:
    x-apievangelist-phrasing:
      intent: List artifacts in a DevTest Labs artifact source
      effect: read
      questions:
      - What install artifacts does an artifact source provide in my DevTest lab?
      - Can I filter and sort the artifacts from one artifact repository?
      instructions:
      - text: List artifacts in source {artifactSourceName} of lab {labName} in {resourceGroupName}, sub {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
          labName: path.labName
          artifactSourceName: path.artifactSourceName
      - text: List artifacts in source {artifactSourceName} matching {filter}.
        slots:
          artifactSourceName: path.artifactSourceName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/artifactsources/{artifactSourceName}/artifacts/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a DevTest Labs artifact
      effect: read
      questions:
      - How do I see the parameters one DevTest Labs artifact takes?
      - Can I read a single artifact's definition from an artifact source?
      instructions:
      - text: Get artifact {name} from source {artifactSourceName} in lab {labName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          name: path.name
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
          labName: path.labName
          artifactSourceName: path.artifactSourceName
      - text: Show the definition of artifact {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/artifactsources/{artifactSourceName}/artifacts/{name}/generateArmTemplate'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate an ARM template for a lab artifact
      effect: write
      questions:
      - Can I turn a DevTest Labs artifact into an ARM template for a VM?
      - Does generating an artifact template also upload the files it needs to storage?
      instructions:
      - text: Generate an ARM template for artifact {name} in source {artifactSourceName}, lab {labName} ({resourceGroupName}, {subscriptionId}).
        slots:
          name: path.name
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
          labName: path.labName
          artifactSourceName: path.artifactSourceName
      - text: Build the ARM template to apply artifact {name} to VM {virtualMachineName}.
        slots:
          name: path.name
          virtualMachineName: requestBody.virtualMachineName
      method: generated
      generated: '2026-09-26'