# 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 DevTestLabsClient Artifact Sources API
  version: 1.0.0
extends: openapi/microsoft-azure-artifactsources-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/artifactsources'].get
  update:
    x-apievangelist-phrasing:
      intent: List artifact sources in a DevTest lab
      effect: read
      questions:
      - Which artifact repositories are connected to my DevTest Labs lab?
      - Can I filter and sort the artifact sources in a lab?
      instructions:
      - text: List artifact sources in lab {labName}, resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the top {top} artifact sources in lab {labName} matching {filter}.
        slots:
          top: query.$top
          labName: path.labName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/artifactsources/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an artifact source in a DevTest lab
      effect: read
      questions:
      - What repository URL and settings does one of my lab's artifact sources use?
      - Can I look up a single artifact source in a lab by name?
      instructions:
      - text: Show artifact source {name} in lab {labName}, resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          name: path.name
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Get lab {labName}'s artifact source {name} expanded with {expand}.
        slots:
          labName: path.labName
          name: path.name
          expand: query.$expand
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/artifactsources/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add or replace an artifact source in a lab
      effect: write
      questions:
      - How do I connect a Git repository of artifacts to my DevTest lab?
      - Can I completely replace an existing artifact source's configuration?
      instructions:
      - text: Create artifact source {name} in lab {labName}, resource group {resourceGroupName}, subscription {subscriptionId}, with properties {properties}.
        slots:
          name: path.name
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      - text: Replace lab {labName}'s artifact source {name} with the configuration {properties}.
        slots:
          labName: path.labName
          name: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/artifactsources/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an artifact source from a lab
      effect: destructive
      questions:
      - How do I disconnect an artifact repository from my DevTest lab?
      - Can I remove an artifact source I no longer use?
      instructions:
      - text: Delete artifact source {name} from lab {labName}, resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          name: path.name
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove the artifact repository {name} from lab {labName}.
        slots:
          name: path.name
          labName: path.labName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/artifactsources/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change the tags on an artifact source
      effect: write
      questions:
      - How do I retag an artifact source in my lab?
      - Which artifact source fields can be patched besides tags?
      instructions:
      - text: Set tags {tags} on artifact source {name} in lab {labName}, resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          tags: requestBody.tags
          name: path.name
          labName: path.labName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Update only the tags of lab {labName}'s artifact source {name} to {tags}.
        slots:
          labName: path.labName
          name: path.name
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'