# 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 Azure ML Management Client Web Services API
  version: 1.0.0
extends: openapi/microsoft-azure-web-services-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: 7
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/webServices/{webServiceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Machine Learning web service definition
      effect: read
      questions:
      - How do I view the definition of a classic Azure Machine Learning web service?
      - Does fetching a web service definition return its keys or storage credentials?
      instructions:
      - text: Get web service {webServiceName} in resource group {resourceGroupName}.
        slots:
          webServiceName: path.webServiceName
          resourceGroupName: path.resourceGroupName
      - text: Show the definition of ML web service {webServiceName} in subscription {subscriptionId}.
        slots:
          webServiceName: path.webServiceName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/webServices/{webServiceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or overwrite a web service
      effect: destructive
      questions:
      - How do I deploy a new Machine Learning web service?
      - Will creating a web service with an existing name overwrite it without warning?
      instructions:
      - text: Create web service {webServiceName} in {resourceGroupName} at {location} with properties {properties}.
        slots:
          webServiceName: path.webServiceName
          resourceGroupName: path.resourceGroupName
          location: requestBody.location
          properties: requestBody.properties
      - text: Overwrite web service {webServiceName} in subscription {subscriptionId} with a new definition.
        slots:
          webServiceName: path.webServiceName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/webServices/{webServiceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Machine Learning web service
      effect: destructive
      questions:
      - How do I remove an ML web service I no longer serve predictions from?
      - Can I delete a web service in a specific resource group?
      instructions:
      - text: Delete web service {webServiceName} from resource group {resourceGroupName}.
        slots:
          webServiceName: path.webServiceName
          resourceGroupName: path.resourceGroupName
      - text: Remove ML web service {webServiceName} in subscription {subscriptionId}.
        slots:
          webServiceName: path.webServiceName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/webServices/{webServiceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Modify an existing web service
      effect: write
      questions:
      - Can I change part of a deployed ML web service without overwriting it?
      - How do I know when an asynchronous web service patch has finished?
      instructions:
      - text: Patch web service {webServiceName} in {resourceGroupName} at {location} with {properties}.
        slots:
          webServiceName: path.webServiceName
          resourceGroupName: path.resourceGroupName
          location: requestBody.location
          properties: requestBody.properties
      - text: Update tags {tags} on existing web service {webServiceName} in subscription {subscriptionId}.
        slots:
          tags: requestBody.tags
          webServiceName: path.webServiceName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/webServices/{webServiceName}/listKeys'].get
  update:
    x-apievangelist-phrasing:
      intent: Get access keys for a web service
      effect: read
      questions:
      - Where do I get the API keys to call my ML web service?
      - How do I retrieve the primary and secondary keys of a web service?
      instructions:
      - text: List access keys for web service {webServiceName} in {resourceGroupName}.
        slots:
          webServiceName: path.webServiceName
          resourceGroupName: path.resourceGroupName
      - text: Give me the scoring keys of {webServiceName} in subscription {subscriptionId}.
        slots:
          webServiceName: path.webServiceName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/webServices'].get
  update:
    x-apievangelist-phrasing:
      intent: List web services in a resource group
      effect: read
      questions:
      - Which ML web services exist in a given resource group?
      - How do I page through web services in one resource group with a skip token?
      instructions:
      - text: List web services in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Continue listing resource group {resourceGroupName} web services from token {skiptoken}.
        slots:
          resourceGroupName: path.resourceGroupName
          skiptoken: query.$skiptoken
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.MachineLearning/webServices'].get
  update:
    x-apievangelist-phrasing:
      intent: List web services in a subscription
      effect: read
      questions:
      - What Machine Learning web services are deployed across my whole subscription?
      - Can I get the next page of subscription-wide web services?
      instructions:
      - text: List all web services in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Get the next page of subscription {subscriptionId} web services after {skiptoken}.
        slots:
          subscriptionId: path.subscriptionId
          skiptoken: query.$skiptoken
      method: generated
      generated: '2026-10-01'