# 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 HybridDataManagementClient Data Managers API
  version: 1.0.0
extends: openapi/microsoft-azure-datamanagers-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['/subscriptions/{subscriptionId}/providers/Microsoft.HybridData/dataManagers'].get
  update:
    x-apievangelist-phrasing:
      intent: List data manager resources in a subscription
      effect: read
      questions:
      - Which data manager resources exist across my subscription?
      - Can I list all data managers without specifying a resource group?
      instructions:
      - text: List data manager resources in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Show every data manager in {subscription} across resource groups.
        slots:
          subscription: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridData/dataManagers'].get
  update:
    x-apievangelist-phrasing:
      intent: List data managers in a resource group
      effect: read
      questions:
      - What data manager resources are in one resource group?
      - Is there a way to scope the data manager list to a single resource group?
      instructions:
      - text: List data managers in resource group {resource_group}, subscription {subscription}.
        slots:
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the data manager resources in {resource_group}.
        slots:
          resource_group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridData/dataManagers/{dataManagerName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a data manager resource
      effect: read
      questions:
      - How do I get information about one data manager resource?
      - What does a data manager's SKU and location look like?
      instructions:
      - text: Get data manager {data_manager} in {resource_group}, subscription {subscription}.
        slots:
          data_manager: path.dataManagerName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show me data manager {data_manager}.
        slots:
          data_manager: path.dataManagerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridData/dataManagers/{dataManagerName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a data manager resource
      effect: write
      questions:
      - How do I create a new data manager resource in a region?
      - Can I use the create call to update a data manager that already exists?
      instructions:
      - text: Create data manager {data_manager} in {resource_group}, subscription {subscription}, location {location}.
        slots:
          data_manager: path.dataManagerName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
          location: requestBody.location
      - text: Create data manager {data_manager} in {location} with SKU {sku}.
        slots:
          data_manager: path.dataManagerName
          location: requestBody.location
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridData/dataManagers/{dataManagerName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a data manager resource
      effect: destructive
      questions:
      - How do I delete a data manager resource?
      - What do I need to specify to remove a data manager?
      instructions:
      - text: Delete data manager {data_manager} from {resource_group}, subscription {subscription}.
        slots:
          data_manager: path.dataManagerName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Remove the {data_manager} data manager.
        slots:
          data_manager: path.dataManagerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridData/dataManagers/{dataManagerName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing data manager's SKU or tags
      effect: write
      questions:
      - Can I change the SKU or tags on an existing data manager?
      - Does updating a data manager support an If-Match ETag check?
      instructions:
      - text: Update data manager {data_manager} in {resource_group}, subscription {subscription} to SKU {sku}.
        slots:
          data_manager: path.dataManagerName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
          sku: requestBody.sku
      - text: Set tags {tags} on existing data manager {data_manager} only if its ETag matches {etag}.
        slots:
          tags: requestBody.tags
          data_manager: path.dataManagerName
          etag: header.If-Match
      method: generated
      generated: '2026-09-26'