# 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 Machine Learning Services Proxy…
  version: 1.0.0
extends: openapi/microsoft-azure-proxyoperations-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: 7
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/diagnose'].post
  update:
    x-apievangelist-phrasing:
      intent: Diagnose setup issues in an ML workspace
      effect: read
      questions:
      - Why is my Azure Machine Learning workspace misconfigured?
      - Can I run a diagnostic check on a workspace's networking and dependencies?
      instructions:
      - text: Diagnose setup problems in ML workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      - text: Run a health diagnosis on workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/listKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: List all keys tied to an ML workspace
      effect: read
      questions:
      - How do I get the storage, App Insights and container registry credentials for my ML workspace?
      - Where can I find the container registry password for a workspace?
      instructions:
      - text: List all keys for ML workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      - text: Get the storage, App Insights and registry secrets of {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/listNotebookAccessToken'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a notebook access token for a workspace
      effect: read
      questions:
      - How do I get an access token to use a workspace's notebooks?
      - What token do I need to call my ML workspace notebook service?
      instructions:
      - text: Get a notebook access token for workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      - text: Issue a notebook token for ML workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/listNotebookKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: List a workspace's notebook resource keys
      effect: read
      questions:
      - Where are the keys for my ML workspace's notebook resource?
      - Can I retrieve just the notebook keys rather than every workspace secret?
      instructions:
      - text: List notebook keys for workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      - text: Show only the notebook resource keys of {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/listStorageAccountKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: List a workspace's storage account keys
      effect: read
      questions:
      - How do I get the storage account key behind my ML workspace?
      - Can I fetch only the storage account keys for a workspace?
      instructions:
      - text: List storage account keys for workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      - text: Get just the storage keys attached to ML workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/prepareNotebook'].post
  update:
    x-apievangelist-phrasing:
      intent: Prepare a workspace's notebook resource
      effect: write
      questions:
      - How do I provision the notebook resource for a new ML workspace?
      - What sets up notebooks on a workspace that doesn't have them yet?
      instructions:
      - text: Prepare the notebook resource for workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      - text: Provision notebooks on ML workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/resyncKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Resync all keys for an ML workspace
      effect: write
      questions:
      - I rotated my storage key; how do I get the ML workspace to pick up the new one?
      - Can I resync the container registry and App Insights keys on a workspace?
      instructions:
      - text: Resync all keys for workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      - text: Refresh the stored credentials of ML workspace {workspaceName} after key rotation.
        slots:
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'