# 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 CloudServiceManagementClient Cloud Services…
  version: 1.0.0
extends: openapi/microsoft-azure-cloudservicesupdatedomain-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: 3
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/cloudServices/{cloudServiceName}/updateDomains/{updateDomain}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one update domain of a cloud service
      effect: read
      questions:
      - How do I inspect a specific update domain in my Cloud Services (extended support) deployment?
      - What does a single update domain of a cloud service look like?
      instructions:
      - text: Get update domain {updateDomain} of cloud service {cloudServiceName} in {resourceGroupName}.
        slots:
          updateDomain: path.updateDomain
          cloudServiceName: path.cloudServiceName
          resourceGroupName: path.resourceGroupName
      - text: Show update domain {updateDomain} for {cloudServiceName}.
        slots:
          updateDomain: path.updateDomain
          cloudServiceName: path.cloudServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/cloudServices/{cloudServiceName}/updateDomains/{updateDomain}'].put
  update:
    x-apievangelist-phrasing:
      intent: Walk an update domain to update its role instances
      effect: write
      questions:
      - How do I manually roll an upgrade through one update domain of a cloud service?
      - Can I update the role instances in a single update domain at a time?
      instructions:
      - text: Walk update domain {updateDomain} of cloud service {cloudServiceName} in {resourceGroupName}.
        slots:
          updateDomain: path.updateDomain
          cloudServiceName: path.cloudServiceName
          resourceGroupName: path.resourceGroupName
      - text: Update the role instances in domain {updateDomain} of {cloudServiceName}.
        slots:
          updateDomain: path.updateDomain
          cloudServiceName: path.cloudServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/cloudServices/{cloudServiceName}/updateDomains'].get
  update:
    x-apievangelist-phrasing:
      intent: List update domains in a cloud service
      effect: read
      questions:
      - How many update domains does my cloud service have?
      - Can I list every update domain of a Cloud Services deployment?
      instructions:
      - text: List update domains of cloud service {cloudServiceName} in {resourceGroupName}.
        slots:
          cloudServiceName: path.cloudServiceName
          resourceGroupName: path.resourceGroupName
      - text: Show all update domains for {cloudServiceName}.
        slots:
          cloudServiceName: path.cloudServiceName
      method: generated
      generated: '2026-09-26'