# 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 V2Workspace…
  version: 1.0.0
extends: openapi/microsoft-azure-v2workspaceconnectionresource-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}/connections'].get
  update:
    x-apievangelist-phrasing:
      intent: List a workspace's connections
      effect: read
      questions:
      - Which connections are configured in my Azure Machine Learning workspace?
      - Can I filter workspace connections by category or target?
      instructions:
      - text: List the connections in ML workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      - text: Show workspace {workspaceName} connections in category {category}.
        slots:
          workspaceName: path.workspaceName
          category: query.category
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/connections/{connectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a workspace connection
      effect: read
      questions:
      - Can I look up one connection in an ML workspace by name?
      - What target and auth type does a given workspace connection use?
      instructions:
      - text: Get connection {connectionName} in workspace {workspaceName}.
        slots:
          connectionName: path.connectionName
          workspaceName: path.workspaceName
      - text: Show details of ML workspace connection {connectionName} in {workspaceName}.
        slots:
          connectionName: path.connectionName
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/connections/{connectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a workspace connection
      effect: write
      questions:
      - How do I add a new connection to my Azure ML workspace?
      - Can I overwrite a workspace connection's full definition?
      instructions:
      - text: Create connection {connectionName} in workspace {workspaceName} with properties {properties}.
        slots:
          connectionName: path.connectionName
          workspaceName: path.workspaceName
          properties: requestBody.properties
      - text: Create or replace ML workspace connection {connectionName} in {workspaceName}.
        slots:
          connectionName: path.connectionName
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/connections/{connectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a workspace connection
      effect: destructive
      questions:
      - Can I remove a connection from an ML workspace?
      - Can I delete a workspace connection I no longer use?
      instructions:
      - text: Delete connection {connectionName} from workspace {workspaceName}.
        slots:
          connectionName: path.connectionName
          workspaceName: path.workspaceName
      - text: Remove ML workspace connection {connectionName} in {workspaceName}.
        slots:
          connectionName: path.connectionName
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/connections/{connectionName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a workspace connection
      effect: write
      questions:
      - Can I change some properties of an existing workspace connection?
      - Is it possible to partially update a connection in my ML workspace?
      instructions:
      - text: Patch connection {connectionName} in workspace {workspaceName} with {properties}.
        slots:
          connectionName: path.connectionName
          workspaceName: path.workspaceName
          properties: requestBody.properties
      - text: Partially update existing ML workspace connection {connectionName} in {workspaceName}.
        slots:
          connectionName: path.connectionName
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/connections/{connectionName}/listsecrets'].post
  update:
    x-apievangelist-phrasing:
      intent: List a workspace connection's secrets
      effect: read
      questions:
      - How do I retrieve the credentials stored on a workspace connection?
      - Can I see the secrets of an ML workspace connection?
      instructions:
      - text: List the secrets of connection {connectionName} in workspace {workspaceName}.
        slots:
          connectionName: path.connectionName
          workspaceName: path.workspaceName
      - text: Reveal stored credentials for ML workspace connection {connectionName} in {workspaceName}.
        slots:
          connectionName: path.connectionName
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/connections/{connectionName}/testconnection'].post
  update:
    x-apievangelist-phrasing:
      intent: Test a workspace connection
      effect: read
      questions:
      - Can I check that a workspace connection actually works?
      - Can I validate connection settings before saving them?
      instructions:
      - text: Test connection {connectionName} in workspace {workspaceName} with properties {properties}.
        slots:
          connectionName: path.connectionName
          workspaceName: path.workspaceName
          properties: requestBody.properties
      - text: Verify that ML workspace connection {connectionName} in {workspaceName} can connect.
        slots:
          connectionName: path.connectionName
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'