# 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 Replicas API
  version: 1.0.0
extends: openapi/microsoft-azure-replicas-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: 7
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppConfiguration/configurationStores/{configStoreName}/replicas'].get
  update:
    x-apievangelist-phrasing:
      intent: List replicas of an App Configuration store
      effect: read
      questions:
      - Which geo-replicas does my App Configuration store have?
      - How do I page through configuration store replicas?
      instructions:
      - text: List replicas of configuration store {store} in {resource_group} of subscription {subscription}.
        slots:
          subscription: path.subscriptionId
          store: path.configStoreName
          resource_group: path.resourceGroupName
      - text: Show App Configuration replicas for {store}.
        slots:
          store: path.configStoreName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppConfiguration/configurationStores/{configStoreName}/replicas/{replicaName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an App Configuration replica
      effect: read
      questions:
      - How do I see the properties of one App Configuration replica?
      - What endpoint and location does a configuration store replica have?
      instructions:
      - text: Get replica {replica} of configuration store {store} in {resource_group}, subscription {subscription}.
        slots:
          subscription: path.subscriptionId
          replica: path.replicaName
          store: path.configStoreName
          resource_group: path.resourceGroupName
      - text: Show details of App Configuration replica {replica}.
        slots:
          replica: path.replicaName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppConfiguration/configurationStores/{configStoreName}/replicas/{replicaName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an App Configuration replica
      effect: write
      questions:
      - How do I add a replica of my App Configuration store in another region?
      - What location do I pass when creating a configuration store replica?
      instructions:
      - text: Create replica {replica} of store {store} in {location} under subscription {subscription}.
        slots:
          subscription: path.subscriptionId
          replica: path.replicaName
          store: path.configStoreName
          location: requestBody.location
      - text: Add App Configuration replica {replica} to {store} in {resource_group}.
        slots:
          replica: path.replicaName
          store: path.configStoreName
          resource_group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppConfiguration/configurationStores/{configStoreName}/replicas/{replicaName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an App Configuration replica
      effect: destructive
      questions:
      - Can I remove a replica from my App Configuration store?
      - What happens to a configuration store when one replica is deleted?
      instructions:
      - text: Delete replica {replica} from configuration store {store} in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
          replica: path.replicaName
          store: path.configStoreName
      - text: Remove App Configuration replica {replica} in {resource_group}.
        slots:
          replica: path.replicaName
          resource_group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}/replicas'].get
  update:
    x-apievangelist-phrasing:
      intent: List read replicas of a MariaDB server
      effect: read
      questions:
      - Which read replicas does my Azure Database for MariaDB server have?
      - How do I list MariaDB replicas for one server?
      instructions:
      - text: List MariaDB replicas of server {server} in {resource_group} of subscription {subscription}.
        slots:
          subscription: path.subscriptionId
          server: path.serverName
          resource_group: path.resourceGroupName
      - text: Show read replicas for MariaDB server {server}.
        slots:
          server: path.serverName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabricMesh/applications/{applicationName}/services/{serviceName}/replicas'].get
  update:
    x-apievangelist-phrasing:
      intent: List replicas of a Service Fabric Mesh service
      effect: read
      questions:
      - What replicas are running for a service in my Service Fabric Mesh application?
      - Can I see runtime properties of every replica of a Mesh service?
      instructions:
      - text: List replicas of service {service} in Mesh application {application} under subscription {subscription}.
        slots:
          subscription: path.subscriptionId
          service: path.serviceName
          application: path.applicationName
      - text: Show all Mesh replicas for {service} in {resource_group}.
        slots:
          service: path.serviceName
          resource_group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceFabricMesh/applications/{applicationName}/services/{serviceName}/replicas/{replicaName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Service Fabric Mesh service replica
      effect: read
      questions:
      - How do I inspect one replica of a Service Fabric Mesh service?
      - What runtime details are returned for a single Mesh replica?
      instructions:
      - text: Get replica {replica} of service {service} in Mesh application {application}, subscription {subscription}.
        slots:
          subscription: path.subscriptionId
          replica: path.replicaName
          service: path.serviceName
          application: path.applicationName
      - text: Show Mesh replica {replica} in {resource_group}.
        slots:
          replica: path.replicaName
          resource_group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'