# 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 WebSite Management Client Managed Hosting…
  version: 1.0.0
extends: openapi/microsoft-azure-managedhostingenvironments-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: 9
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/managedHostingEnvironments/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a managed hosting environment
      effect: read
      questions:
      - What are the properties of a managed hosting environment?
      - Can I look up one managed hosting environment by name?
      instructions:
      - text: Get managed hosting environment {env} in {group} under subscription {sub}.
        slots:
          env: path.name
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show properties of hosting environment {env} in resource group {group}.
        slots:
          env: path.name
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/managedHostingEnvironments/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a managed hosting environment
      effect: write
      questions:
      - How do I create a managed hosting environment for App Service?
      - Which region must a new managed hosting environment specify?
      instructions:
      - text: Create managed hosting environment {env} in {group}, subscription {sub}, located in {location}.
        slots:
          env: path.name
          group: path.resourceGroupName
          location: requestBody.location
          sub: path.subscriptionId
      - text: Update hosting environment {env} in {group} with {properties}.
        slots:
          env: path.name
          group: path.resourceGroupName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/managedHostingEnvironments/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a managed hosting environment
      effect: destructive
      questions:
      - Can I delete a managed hosting environment that still has sites?
      - Is there a force option when removing a hosting environment?
      instructions:
      - text: Delete managed hosting environment {env} in {group} under subscription {sub}.
        slots:
          env: path.name
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Force-delete hosting environment {env} in {group} ({force}).
        slots:
          env: path.name
          group: path.resourceGroupName
          force: query.forceDelete
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/managedHostingEnvironments'].get
  update:
    x-apievangelist-phrasing:
      intent: List managed hosting environments
      effect: read
      questions:
      - Which managed hosting environments exist in a resource group?
      - How do I see all my managed hosting environments?
      instructions:
      - text: List managed hosting environments in {group} under subscription {sub}.
        slots:
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every hosting environment in resource group {group}.
        slots:
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/managedHostingEnvironments/{name}/capacities/virtualip'].get
  update:
    x-apievangelist-phrasing:
      intent: List a hosting environment's IP addresses
      effect: read
      questions:
      - What IP addresses are assigned to my managed hosting environment?
      - Which virtual IPs does a hosting environment use?
      instructions:
      - text: List the IP addresses of hosting environment {env} in {group} under subscription {sub}.
        slots:
          env: path.name
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show virtual IPs for managed hosting environment {env} ({group}).
        slots:
          env: path.name
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/managedHostingEnvironments/{name}/operations/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check an operation on a hosting environment
      effect: read
      questions:
      - Did a long-running operation on my hosting environment finish?
      - Where can I check the status of a hosting environment operation by id?
      instructions:
      - text: Get status of operation {operation} on hosting environment {env} in {group} under subscription {sub}.
        slots:
          operation: path.operationId
          env: path.name
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Check whether operation {operation} for environment {env} ({group}) completed.
        slots:
          operation: path.operationId
          env: path.name
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/managedHostingEnvironments/{name}/sites'].get
  update:
    x-apievangelist-phrasing:
      intent: List sites on a hosting environment
      effect: read
      questions:
      - Which web apps run on a managed hosting environment?
      - Can I limit which site properties come back?
      instructions:
      - text: List sites on hosting environment {env} in {group} under subscription {sub}.
        slots:
          env: path.name
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: List sites on environment {env} ({group}) including only {props}.
        slots:
          env: path.name
          group: path.resourceGroupName
          props: query.propertiesToInclude
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/managedHostingEnvironments/{name}/webhostingplans'].get
  update:
    x-apievangelist-phrasing:
      intent: List web hosting plans on an environment
      effect: read
      questions:
      - What web hosting plans are on a managed hosting environment?
      - Can I list the webhostingplans view of App Service plans for an environment?
      instructions:
      - text: List web hosting plans on hosting environment {env} in {group} under subscription {sub}.
        slots:
          env: path.name
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the webhostingplans for environment {env} ({group}).
        slots:
          env: path.name
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/managedHostingEnvironments/{name}/serverfarms'].get
  update:
    x-apievangelist-phrasing:
      intent: List server farms on an environment
      effect: read
      questions:
      - Which server farms run on a managed hosting environment?
      - How do I list serverfarms for an environment?
      instructions:
      - text: List server farms on hosting environment {env} in {group} under subscription {sub}.
        slots:
          env: path.name
          group: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the serverfarms endpoint results for environment {env} ({group}).
        slots:
          env: path.name
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'