# 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 Service Fabrics API
  version: 1.0.0
extends: openapi/microsoft-azure-servicefabrics-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: 8
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}/servicefabrics'].get
  update:
    x-apievangelist-phrasing:
      intent: List service fabrics in a lab user profile
      effect: read
      questions:
      - Which service fabrics does a user have in a DevTest Labs lab?
      - Can I filter or sort the service fabrics in a user's lab profile?
      instructions:
      - text: List service fabrics for user {user} in lab {lab}.
        slots:
          lab: path.labName
          user: path.userName
      - text: List the top {top} service fabrics for user {user} in lab {lab}, resource group {rg}, subscription {subscription}.
        slots:
          lab: path.labName
          user: path.userName
          top: query.$top
          subscription: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}/servicefabrics/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a lab service fabric
      effect: read
      questions:
      - How do I see the details of one service fabric in a DevTest lab?
      - Can I expand extra properties when fetching a lab service fabric?
      instructions:
      - text: Get service fabric {fabric} for user {user} in lab {lab}.
        slots:
          lab: path.labName
          user: path.userName
          fabric: path.name
      - text: Show service fabric {fabric} of user {user}, lab {lab}, resource group {rg}, subscription {subscription}.
        slots:
          lab: path.labName
          user: path.userName
          fabric: path.name
          subscription: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}/servicefabrics/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a lab service fabric
      effect: write
      questions:
      - How do I create a service fabric in a DevTest Labs user profile?
      - Does creating a lab service fabric take long to finish?
      instructions:
      - text: Create service fabric {fabric} for user {user} in lab {lab} with properties {properties}.
        slots:
          lab: path.labName
          user: path.userName
          fabric: path.name
          properties: requestBody.properties
      - text: Replace service fabric {fabric} of user {user} in lab {lab}, group {rg}, subscription {subscription} using {properties}.
        slots:
          lab: path.labName
          user: path.userName
          fabric: path.name
          subscription: path.subscriptionId
          rg: path.resourceGroupName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}/servicefabrics/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a lab service fabric
      effect: destructive
      questions:
      - Can I delete a service fabric from a lab user's profile?
      - How long does removing a DevTest Labs service fabric take?
      instructions:
      - text: Delete service fabric {fabric} for user {user} in lab {lab}.
        slots:
          lab: path.labName
          user: path.userName
          fabric: path.name
      - text: Remove service fabric {fabric} of user {user} from lab {lab}, resource group {rg}, subscription {subscription}.
        slots:
          lab: path.labName
          user: path.userName
          fabric: path.name
          subscription: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}/servicefabrics/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a lab service fabric
      effect: write
      questions:
      - Can I change only the tags on a lab service fabric?
      - Which service fabric properties can be modified after creation?
      instructions:
      - text: Set tags {tags} on service fabric {fabric} for user {user} in lab {lab}.
        slots:
          lab: path.labName
          user: path.userName
          fabric: path.name
          tags: requestBody.tags
      - text: Retag service fabric {fabric} of user {user}, lab {lab}, group {rg}, subscription {subscription} with {tags}.
        slots:
          lab: path.labName
          user: path.userName
          fabric: path.name
          subscription: path.subscriptionId
          rg: path.resourceGroupName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}/servicefabrics/{name}/listApplicableSchedules'].post
  update:
    x-apievangelist-phrasing:
      intent: List start and stop schedules for a service fabric
      effect: read
      questions:
      - What auto start or stop schedules apply to my lab service fabric?
      - Is a lab service fabric covered by any shutdown schedule?
      instructions:
      - text: List applicable schedules for service fabric {fabric} of user {user} in lab {lab}.
        slots:
          lab: path.labName
          user: path.userName
          fabric: path.name
      - text: Show start/stop schedules for fabric {fabric}, user {user}, lab {lab}, group {rg}, subscription {subscription}.
        slots:
          lab: path.labName
          user: path.userName
          fabric: path.name
          subscription: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}/servicefabrics/{name}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a lab service fabric
      effect: write
      questions:
      - How do I start a stopped service fabric in a DevTest lab?
      - Can I power on a lab service fabric on demand?
      instructions:
      - text: Start service fabric {fabric} for user {user} in lab {lab}.
        slots:
          lab: path.labName
          user: path.userName
          fabric: path.name
      - text: Power on fabric {fabric} of user {user} in lab {lab}, resource group {rg}, subscription {subscription}.
        slots:
          lab: path.labName
          user: path.userName
          fabric: path.name
          subscription: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/users/{userName}/servicefabrics/{name}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop a lab service fabric
      effect: write
      questions:
      - How do I stop a running service fabric in a DevTest lab to save cost?
      - Can I shut down a lab service fabric manually?
      instructions:
      - text: Stop service fabric {fabric} for user {user} in lab {lab}.
        slots:
          lab: path.labName
          user: path.userName
          fabric: path.name
      - text: Shut down fabric {fabric} of user {user} in lab {lab}, resource group {rg}, subscription {subscription}.
        slots:
          lab: path.labName
          user: path.userName
          fabric: path.name
          subscription: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'