# 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 ManagedLabsClient Environment Settings API
  version: 1.0.0
extends: openapi/microsoft-azure-environment-settings-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}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}/labs/{labName}/environmentsettings'].get
  update:
    x-apievangelist-phrasing:
      intent: List environment settings in a lab
      effect: read
      questions:
      - Which environment settings (templates) exist in my Azure Lab Services lab?
      - Can I sort or limit the list of environment settings in a lab?
      instructions:
      - text: List environment settings in lab {lab} of lab account {account} in {rg}, subscription {sub}.
        slots:
          lab: path.labName
          account: path.labAccountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the first {top} environment settings in lab {lab} of account {account} in {rg}.
        slots:
          top: query.$top
          lab: path.labName
          account: path.labAccountName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}/labs/{labName}/environmentsettings/{environmentSettingName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an environment setting
      effect: read
      questions:
      - What does a specific environment setting in my lab contain?
      - Can I expand related properties when fetching a lab environment setting?
      instructions:
      - text: Get environment setting {setting} in lab {lab} of lab account {account} in {rg}, subscription {sub}.
        slots:
          setting: path.environmentSettingName
          lab: path.labName
          account: path.labAccountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show environment setting {setting} in lab {lab} with {expand} expanded.
        slots:
          setting: path.environmentSettingName
          lab: path.labName
          expand: query.$expand
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}/labs/{labName}/environmentsettings/{environmentSettingName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace an environment setting
      effect: write
      questions:
      - How do I create an environment setting template for a lab?
      - Why does creating a lab environment setting take a while to finish?
      instructions:
      - text: Create environment setting {setting} in lab {lab} of lab account {account} in {rg}, subscription {sub}.
        slots:
          setting: path.environmentSettingName
          lab: path.labName
          account: path.labAccountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Replace environment setting {setting} in lab {lab} with properties {properties}.
        slots:
          setting: path.environmentSettingName
          lab: path.labName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}/labs/{labName}/environmentsettings/{environmentSettingName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an environment setting
      effect: destructive
      questions:
      - Can I delete an environment setting from a lab?
      - What happens to a lab's template when I remove its environment setting?
      instructions:
      - text: Delete environment setting {setting} in lab {lab} of lab account {account} in {rg}, subscription {sub}.
        slots:
          setting: path.environmentSettingName
          lab: path.labName
          account: path.labAccountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove environment setting {setting} from lab {lab}.
        slots:
          setting: path.environmentSettingName
          lab: path.labName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}/labs/{labName}/environmentsettings/{environmentSettingName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Modify an environment setting
      effect: write
      questions:
      - Can I change a few properties of an existing lab environment setting without replacing it?
      - Which environment setting fields can be patched?
      instructions:
      - text: Modify environment setting {setting} in lab {lab} of lab account {account} in {rg}, subscription {sub} with {properties}.
        slots:
          setting: path.environmentSettingName
          lab: path.labName
          account: path.labAccountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Patch the tags on environment setting {setting} in lab {lab} to {tags}.
        slots:
          setting: path.environmentSettingName
          lab: path.labName
          tags: requestBody.tags
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}/labs/{labName}/environmentsettings/{environmentSettingName}/claimAny'].post
  update:
    x-apievangelist-phrasing:
      intent: Claim a random environment from an environment setting
      effect: write
      questions:
      - How does a lab user claim any available environment from an environment setting?
      - Can I grab a random free lab VM from a template?
      instructions:
      - text: Claim any available environment from setting {setting} in lab {lab} of account {account} in {rg}, subscription {sub}.
        slots:
          setting: path.environmentSettingName
          lab: path.labName
          account: path.labAccountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Give me a random environment from environment setting {setting} in lab {lab}.
        slots:
          setting: path.environmentSettingName
          lab: path.labName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}/labs/{labName}/environmentsettings/{environmentSettingName}/publish'].post
  update:
    x-apievangelist-phrasing:
      intent: Publish an environment setting
      effect: write
      questions:
      - How do I publish a lab template so its resources get provisioned?
      - Can I publish an environment setting using the existing image?
      instructions:
      - text: Publish environment setting {setting} in lab {lab} of account {account} in {rg}, subscription {sub}.
        slots:
          setting: path.environmentSettingName
          lab: path.labName
          account: path.labAccountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: 'Publish environment setting {setting} in lab {lab}, reusing the existing image: {reuse}.'
        slots:
          setting: path.environmentSettingName
          lab: path.labName
          reuse: requestBody.useExistingImage
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}/labs/{labName}/environmentsettings/{environmentSettingName}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an environment setting's template
      effect: write
      questions:
      - How do I start the template VM behind a lab environment setting?
      - Can I power on all resources in an environment setting's template?
      instructions:
      - text: Start the template for environment setting {setting} in lab {lab} of account {account} in {rg}, subscription {sub}.
        slots:
          setting: path.environmentSettingName
          lab: path.labName
          account: path.labAccountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Power on template resources of setting {setting} in lab {lab}.
        slots:
          setting: path.environmentSettingName
          lab: path.labName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labaccounts/{labAccountName}/labs/{labName}/environmentsettings/{environmentSettingName}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop an environment setting's template
      effect: write
      questions:
      - How do I stop the template VM for a lab environment setting?
      - Can I shut down all resources in an environment setting's template when I'm done editing?
      instructions:
      - text: Stop the template for environment setting {setting} in lab {lab} of account {account} in {rg}, subscription {sub}.
        slots:
          setting: path.environmentSettingName
          lab: path.labName
          account: path.labAccountName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Shut down template resources of setting {setting} in lab {lab}.
        slots:
          setting: path.environmentSettingName
          lab: path.labName
      method: generated
      generated: '2026-10-01'