# 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 Configurations API
  version: 1.0.0
extends: openapi/microsoft-azure-configurations-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: 14
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/{clusterName}/servers/{serverName}/configurations'].get
  update:
    x-apievangelist-phrasing:
      intent: List configurations of a server in a PostgreSQL cluster
      effect: read
      questions:
      - Which configuration settings apply to one server inside my Cosmos DB for PostgreSQL cluster?
      - Can I see the per-server parameters of a node in a distributed PostgreSQL cluster?
      instructions:
      - text: List the configurations of server {serverName} in PostgreSQL cluster {clusterName}.
        slots:
          serverName: path.serverName
          clusterName: path.clusterName
      - text: Show the settings on cluster {clusterName} server {serverName}.
        slots:
          clusterName: path.clusterName
          serverName: path.serverName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/{clusterName}/configurations'].get
  update:
    x-apievangelist-phrasing:
      intent: List all configurations of a PostgreSQL cluster
      effect: read
      questions:
      - What configuration parameters are set across my whole Cosmos DB for PostgreSQL cluster?
      - How do I get a cluster-wide list of PostgreSQL settings?
      instructions:
      - text: List every configuration of PostgreSQL cluster {clusterName}.
        slots:
          clusterName: path.clusterName
      - text: Show the cluster-level settings for {clusterName}.
        slots:
          clusterName: path.clusterName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/{clusterName}/configurations/{configurationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a cluster configuration for coordinator and nodes
      effect: read
      questions:
      - How do I read one setting's value for both the coordinator and worker nodes of my cluster?
      - Does a PostgreSQL cluster setting differ between coordinator and nodes?
      instructions:
      - text: Get configuration {configurationName} for the coordinator and nodes of cluster {clusterName}.
        slots:
          configurationName: path.configurationName
          clusterName: path.clusterName
      - text: Show how {configurationName} is set cluster-wide on {clusterName}.
        slots:
          configurationName: path.configurationName
          clusterName: path.clusterName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/{clusterName}/coordinatorConfigurations/{configurationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a coordinator configuration in a PostgreSQL cluster
      effect: read
      questions:
      - What is the current value of a setting on my cluster's coordinator node?
      - Can I check a coordinator-only PostgreSQL parameter without looking at worker nodes?
      instructions:
      - text: Get coordinator configuration {configurationName} in cluster {clusterName}.
        slots:
          configurationName: path.configurationName
          clusterName: path.clusterName
      - text: Show the coordinator value of {configurationName} on cluster {clusterName}.
        slots:
          configurationName: path.configurationName
          clusterName: path.clusterName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/{clusterName}/coordinatorConfigurations/{configurationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a coordinator configuration in a PostgreSQL cluster
      effect: write
      questions:
      - How do I change a PostgreSQL parameter on just the coordinator of my cluster?
      - Can I tune a coordinator setting without touching the worker nodes?
      instructions:
      - text: Set coordinator configuration {configurationName} on cluster {clusterName} to {properties}.
        slots:
          configurationName: path.configurationName
          clusterName: path.clusterName
          properties: requestBody.properties
      - text: Change the coordinator's {configurationName} setting in cluster {clusterName}.
        slots:
          configurationName: path.configurationName
          clusterName: path.clusterName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/{clusterName}/nodeConfigurations/{configurationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a worker node configuration in a PostgreSQL cluster
      effect: read
      questions:
      - What value does a setting have on the worker nodes of my distributed PostgreSQL cluster?
      - How do I read a node-level configuration for cluster workers?
      instructions:
      - text: Get worker node configuration {configurationName} in cluster {clusterName}.
        slots:
          configurationName: path.configurationName
          clusterName: path.clusterName
      - text: Show the worker nodes' value of {configurationName} on cluster {clusterName}.
        slots:
          configurationName: path.configurationName
          clusterName: path.clusterName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/{clusterName}/nodeConfigurations/{configurationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a worker node configuration in a PostgreSQL cluster
      effect: write
      questions:
      - How do I change a PostgreSQL parameter on all worker nodes in my cluster?
      - Can I tune worker node settings separately from the coordinator?
      instructions:
      - text: Set worker node configuration {configurationName} on cluster {clusterName} to {properties}.
        slots:
          configurationName: path.configurationName
          clusterName: path.clusterName
          properties: requestBody.properties
      - text: Change the worker nodes' {configurationName} setting in cluster {clusterName}.
        slots:
          configurationName: path.configurationName
          clusterName: path.clusterName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/serverGroupsv2/{serverGroupName}/servers/{serverName}/configurations'].get
  update:
    x-apievangelist-phrasing:
      intent: List configurations of a server in a server group
      effect: read
      questions:
      - Which settings apply to one server in my Hyperscale (Citus) server group?
      - Can I see the configuration of a single server within a PostgreSQL server group?
      instructions:
      - text: List the configurations of server {serverName} in server group {serverGroupName}.
        slots:
          serverName: path.serverName
          serverGroupName: path.serverGroupName
      - text: Show the settings on server group {serverGroupName} member {serverName}.
        slots:
          serverGroupName: path.serverGroupName
          serverName: path.serverName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/serverGroupsv2/{serverGroupName}/configurations'].get
  update:
    x-apievangelist-phrasing:
      intent: List all configurations of a PostgreSQL server group
      effect: read
      questions:
      - What configuration parameters are defined for my Hyperscale (Citus) server group?
      - How do I list every setting of a PostgreSQL server group?
      instructions:
      - text: List every configuration of server group {serverGroupName}.
        slots:
          serverGroupName: path.serverGroupName
      - text: Show the server-group-level settings for {serverGroupName}.
        slots:
          serverGroupName: path.serverGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/serverGroupsv2/{serverGroupName}/configurations/{configurationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a PostgreSQL server group configuration
      effect: read
      questions:
      - How do I read a single configuration value from my server group?
      - What does one Hyperscale (Citus) server group setting look like per server role?
      instructions:
      - text: Get configuration {configurationName} of server group {serverGroupName}.
        slots:
          configurationName: path.configurationName
          serverGroupName: path.serverGroupName
      - text: Show server group {serverGroupName}'s {configurationName} setting.
        slots:
          serverGroupName: path.serverGroupName
          configurationName: path.configurationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForPostgreSql/serverGroupsv2/{serverGroupName}/configurations/{configurationName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a server role group configuration
      effect: write
      questions:
      - How do I change a setting for the server role groups in my Hyperscale (Citus) server group?
      - Can I patch a server group configuration value per role?
      instructions:
      - text: Update configuration {configurationName} in server group {serverGroupName} with {properties}.
        slots:
          configurationName: path.configurationName
          serverGroupName: path.serverGroupName
          properties: requestBody.properties
      - text: Patch the {configurationName} setting of server group {serverGroupName}.
        slots:
          configurationName: path.configurationName
          serverGroupName: path.serverGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}/configurations/{configurationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a MariaDB server configuration
      effect: read
      questions:
      - How do I check the current value of a parameter on my Azure Database for MariaDB server?
      - What does a single MariaDB server configuration report?
      instructions:
      - text: Get MariaDB configuration {configurationName} on server {serverName} in {subscriptionId}/{resourceGroupName}.
        slots:
          configurationName: path.configurationName
          serverName: path.serverName
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
      - text: Show the {configurationName} setting of MariaDB server {serverName}.
        slots:
          configurationName: path.configurationName
          serverName: path.serverName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}/configurations/{configurationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a MariaDB server configuration
      effect: write
      questions:
      - How do I change a server parameter on Azure Database for MariaDB?
      - Can I set a new value for one MariaDB server configuration?
      instructions:
      - text: Set MariaDB configuration {configurationName} on server {serverName} in {subscriptionId}/{resourceGroupName} to {properties}.
        slots:
          configurationName: path.configurationName
          serverName: path.serverName
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
          properties: requestBody.properties
      - text: Change the {configurationName} parameter on MariaDB server {serverName}.
        slots:
          configurationName: path.configurationName
          serverName: path.serverName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}/configurations'].get
  update:
    x-apievangelist-phrasing:
      intent: List all configurations of a MariaDB server
      effect: read
      questions:
      - Which server parameters are configured on my MariaDB server?
      - Can I dump every configuration setting of an Azure Database for MariaDB server?
      instructions:
      - text: List all configurations of MariaDB server {serverName} in {subscriptionId}/{resourceGroupName}.
        slots:
          serverName: path.serverName
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
      - text: Show every parameter set on MariaDB server {serverName}.
        slots:
          serverName: path.serverName
      method: generated
      generated: '2026-09-26'