# 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 Management Client…
  version: 1.0.0
extends: openapi/microsoft-azure-datastore-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: 6
- target: $.paths['/datastore/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/datastores'].get
  update:
    x-apievangelist-phrasing:
      intent: List datastores in a Machine Learning workspace
      effect: read
      questions:
      - Which datastores are attached to my Azure Machine Learning workspace?
      - Can I include the stored secrets when listing workspace datastores?
      instructions:
      - text: List datastores in ML workspace {ws} in resource group {rg}, subscription {sub}.
        slots:
          ws: path.workspaceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: List datastores {names} in workspace {ws}.
        slots:
          names: query.dataStoreNames
          ws: path.workspaceName
      - text: Show {count} datastores from workspace {ws}.
        slots:
          count: query.count
          ws: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datastore/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/datastores'].post
  update:
    x-apievangelist-phrasing:
      intent: Attach a new datastore to a Machine Learning workspace
      effect: write
      questions:
      - How do I register a blob storage or data lake account as a datastore in my ML workspace?
      - Can I skip validation when attaching a datastore to a workspace?
      instructions:
      - text: Create datastore {name} of type {type} in ML workspace {ws}, resource group {rg}, subscription {sub}.
        slots:
          name: requestBody.name
          type: requestBody.dataStoreType
          ws: path.workspaceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Attach datastore {name} to workspace {ws} without validating it.
        slots:
          name: requestBody.name
          ws: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datastore/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/datastores'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete every datastore in a Machine Learning workspace
      effect: destructive
      questions:
      - Can I remove all datastores from an Azure Machine Learning workspace at once?
      - Is there a bulk way to clear every datastore attached to my workspace?
      instructions:
      - text: Delete all datastores in ML workspace {ws} in resource group {rg}, subscription {sub}.
        slots:
          ws: path.workspaceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Wipe every datastore from workspace {ws}.
        slots:
          ws: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datastore/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/datastores/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a datastore in a Machine Learning workspace
      effect: read
      questions:
      - What storage account and settings does a specific datastore point to?
      - Can I look up one ML workspace datastore by name?
      instructions:
      - text: Show datastore {name} in ML workspace {ws}, resource group {rg}, subscription {sub}.
        slots:
          name: path.name
          ws: path.workspaceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Get the details of datastore {name} in workspace {ws}.
        slots:
          name: path.name
          ws: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datastore/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/datastores/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a named datastore in a Machine Learning workspace
      effect: write
      questions:
      - How do I change the storage settings of an existing datastore?
      - Can I update a datastore by name and create it if it is missing?
      instructions:
      - text: Update datastore {name} in ML workspace {ws}, resource group {rg}, subscription {sub}.
        slots:
          name: path.name
          ws: path.workspaceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Change the tags on datastore {name} in workspace {ws} to {tags}.
        slots:
          name: path.name
          ws: path.workspaceName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/datastore/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/datastores/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one datastore from a Machine Learning workspace
      effect: destructive
      questions:
      - How do I detach a single datastore from my ML workspace?
      - Can I delete one datastore by name and keep the others?
      instructions:
      - text: Delete datastore {name} from ML workspace {ws}, resource group {rg}, subscription {sub}.
        slots:
          name: path.name
          ws: path.workspaceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove only datastore {name} from workspace {ws}.
        slots:
          name: path.name
          ws: path.workspaceName
      method: generated
      generated: '2026-09-26'