# 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 HyperscaleCitusManagementClient Server…
  version: 1.0.0
extends: openapi/microsoft-azure-server-groups-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}/providers/Microsoft.DBForPostgreSql/serverGroupsv2'].get
  update:
    x-apievangelist-phrasing:
      intent: List PostgreSQL server groups in a subscription
      effect: read
      questions:
      - Which Hyperscale PostgreSQL server groups do I have across my subscription?
      - Can I see all server groups subscription-wide rather than per resource group?
      instructions:
      - text: List all PostgreSQL server groups in my subscription.
      - text: Show every Hyperscale server group across the whole subscription.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/serverGroupsv2'].get
  update:
    x-apievangelist-phrasing:
      intent: List PostgreSQL server groups in a resource group
      effect: read
      questions:
      - What PostgreSQL server groups are in one resource group?
      - Can I narrow the server group list down to a resource group?
      instructions:
      - text: List the PostgreSQL server groups in one of my resource groups.
      - text: Show the Hyperscale server groups deployed in a single resource group.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/serverGroupsv2/{serverGroupName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a PostgreSQL server group
      effect: read
      questions:
      - What are the details of my Hyperscale PostgreSQL server group?
      - Can I check the state of one server group and its servers?
      instructions:
      - text: Get server group {server_group}.
        slots:
          server_group: path.serverGroupName
      - text: Show me the configuration of PostgreSQL server group {server_group}.
        slots:
          server_group: path.serverGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/serverGroupsv2/{serverGroupName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a PostgreSQL server group
      effect: write
      questions:
      - How do I create a new Hyperscale PostgreSQL server group with servers?
      - What properties do I pass to provision a server group?
      instructions:
      - text: Create PostgreSQL server group {server_group} with properties {properties}.
        slots:
          server_group: path.serverGroupName
          properties: requestBody.properties
      - text: Provision a new server group named {server_group}.
        slots:
          server_group: path.serverGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/serverGroupsv2/{serverGroupName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a PostgreSQL server group
      effect: destructive
      questions:
      - Does deleting a server group also delete the servers in it?
      - Can I tear down a whole Hyperscale PostgreSQL server group?
      instructions:
      - text: Delete server group {server_group} and its servers.
        slots:
          server_group: path.serverGroupName
      - text: Remove the PostgreSQL server group {server_group} entirely.
        slots:
          server_group: path.serverGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/serverGroupsv2/{serverGroupName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a PostgreSQL server group
      effect: write
      questions:
      - Can I change just the tags on an existing server group?
      - How do I update only some properties of a PostgreSQL server group?
      instructions:
      - text: Update the tags on server group {server_group} to {tags}.
        slots:
          server_group: path.serverGroupName
          tags: requestBody.tags
      - text: Patch existing server group {server_group} with properties {properties}.
        slots:
          server_group: path.serverGroupName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DBForPostgreSql/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a PostgreSQL server group name
      effect: read
      questions:
      - Is a server group name already taken?
      - Can I verify a PostgreSQL resource name is available before creating it?
      instructions:
      - text: Check whether the name {name} is available for resource type {type}.
        slots:
          name: requestBody.name
          type: requestBody.type
      - text: See if I can use {name} as a new {type} name.
        slots:
          name: requestBody.name
          type: requestBody.type
      method: generated
      generated: '2026-10-01'