# 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 SynapseSqlV3ManagementClient Sql Pools V3…
  version: 1.0.0
extends: openapi/microsoft-azure-sqlpoolsv3-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.Synapse/workspaces/{workspaceName}/sqlPools/{sqlPoolName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Synapse SQL pool
      effect: read
      questions:
      - How do I check the status and settings of a Synapse SQL pool?
      - Can I read a single dedicated SQL pool in my Synapse workspace?
      instructions:
      - text: Get Synapse SQL pool {sqlPoolName} in workspace {workspaceName}.
        slots:
          sqlPoolName: path.sqlPoolName
          workspaceName: path.workspaceName
      - text: Show the current configuration of SQL pool {sqlPoolName}.
        slots:
          sqlPoolName: path.sqlPoolName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/sqlPools/{sqlPoolName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Synapse SQL pool
      effect: write
      questions:
      - Can I create a new dedicated SQL pool in a Synapse workspace?
      - Can I set the SKU when creating or replacing a Synapse SQL pool?
      instructions:
      - text: Create Synapse SQL pool {sqlPoolName} in workspace {workspaceName} with SKU {sku}.
        slots:
          sqlPoolName: path.sqlPoolName
          workspaceName: path.workspaceName
          sku: requestBody.sku
      - text: Create or replace the SQL pool with properties {properties}.
        slots:
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/sqlPools/{sqlPoolName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Synapse SQL pool
      effect: destructive
      questions:
      - Can I delete a Synapse SQL pool I no longer need?
      - How do I drop a dedicated SQL pool from a Synapse workspace?
      instructions:
      - text: Delete Synapse SQL pool {sqlPoolName} from workspace {workspaceName}.
        slots:
          sqlPoolName: path.sqlPoolName
          workspaceName: path.workspaceName
      - text: Drop dedicated SQL pool {sqlPoolName} permanently.
        slots:
          sqlPoolName: path.sqlPoolName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/sqlPools/{sqlPoolName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing Synapse SQL pool
      effect: write
      questions:
      - Can I scale an existing Synapse SQL pool by changing its SKU?
      - How do I update tags on a dedicated SQL pool?
      instructions:
      - text: Change the SKU of existing SQL pool {sqlPoolName} in workspace {workspaceName} to {sku}.
        slots:
          sqlPoolName: path.sqlPoolName
          workspaceName: path.workspaceName
          sku: requestBody.sku
      - text: Update tags on the Synapse SQL pool to {tags}.
        slots:
          tags: requestBody.tags
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/sqlPools/{sqlPoolName}/pause'].post
  update:
    x-apievangelist-phrasing:
      intent: Pause a Synapse SQL pool
      effect: write
      questions:
      - How do I pause a Synapse SQL pool to save compute cost?
      - Can I deactivate a dedicated SQL pool when nobody is querying it?
      instructions:
      - text: Pause Synapse SQL pool {sqlPoolName} in workspace {workspaceName}.
        slots:
          sqlPoolName: path.sqlPoolName
          workspaceName: path.workspaceName
      - text: Deactivate dedicated SQL pool {sqlPoolName} to stop compute billing.
        slots:
          sqlPoolName: path.sqlPoolName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/sqlPools/{sqlPoolName}/resume'].post
  update:
    x-apievangelist-phrasing:
      intent: Resume a paused Synapse SQL pool
      effect: write
      questions:
      - Can I resume a Synapse SQL pool that was paused?
      - What brings a deactivated dedicated SQL pool back online?
      instructions:
      - text: Resume paused Synapse SQL pool {sqlPoolName} in workspace {workspaceName}.
        slots:
          sqlPoolName: path.sqlPoolName
          workspaceName: path.workspaceName
      - text: Activate dedicated SQL pool {sqlPoolName} again.
        slots:
          sqlPoolName: path.sqlPoolName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/sqlPools'].get
  update:
    x-apievangelist-phrasing:
      intent: List SQL pools in a Synapse workspace
      effect: read
      questions:
      - Which SQL pools exist in my Synapse workspace?
      - Can I list every dedicated SQL pool of one workspace?
      instructions:
      - text: List the SQL pools in Synapse workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      - text: Show all dedicated SQL pools of workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-10-01'