Microsoft Azure · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Microsoft Azure AppPlatformManagementClient App Platform API

170 actions 170 updates phrasing extends openapi/microsoft-azure-appplatform-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Microsoft Azure's API. It is a proposal applied on top of the contract, not a document Microsoft Azure publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 170 · first 16 shown; the file carries all of them

$.info
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}'].put
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}'].delete
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}'].patch
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/listTestKeys'].post
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/regenerateTestKey'].post
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/disableTestEndpoint'].post
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/enableTestEndpoint'].post
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/stop'].post
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/start'].post
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/flushVirtualNetworkDnsSettings'].post
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/supportedApmTypes'].get
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/listGloballyEnabledApms'].post
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/enableApmGlobally'].post
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/disableApmGlobally'].post

OpenAPI Overlay

Raw ↑
# 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 AppPlatformManagementClient App Platform API
  version: 1.0.0
extends: openapi/microsoft-azure-appplatform-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: 169
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Spring Apps service instance
      effect: read
      questions:
      - What SKU and properties does my Azure Spring Apps instance have?
      - Can I look up a single Spring Apps service by name to see its properties?
      instructions:
      - text: Show me the properties of Spring Apps service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Fetch the details of service instance {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a Spring Apps service
      effect: write
      questions:
      - How do I provision a new Spring Apps service instance with a chosen SKU and region?
      - Can I tag a Spring Apps instance when I first create it?
      instructions:
      - text: Create Spring Apps service {service} in {location} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          location: requestBody.location
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Provision service {service} on the {sku} SKU with tags {tags}.
        slots:
          service: path.serviceName
          sku: requestBody.sku
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Spring Apps service instance
      effect: destructive
      questions:
      - How do I tear down a whole Spring Apps service instance I no longer need?
      - What happens to apps when I delete the Spring Apps service that hosts them?
      instructions:
      - text: Delete Spring Apps service {service} from resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove the entire service instance {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch settings on an existing Spring Apps service
      effect: write
      questions:
      - Can I change the SKU of a Spring Apps service that already exists without recreating it?
      - How do I add or change tags on a running Spring Apps instance?
      instructions:
      - text: Patch existing service {service} in resource group {rg}, subscription {sub} to use SKU {sku}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          sku: requestBody.sku
      - text: Change only the tags on existing service {service} to {tags}.
        slots:
          service: path.serviceName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/listTestKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Show the test endpoint keys for a service
      effect: read
      questions:
      - Where do I find the test keys for my Spring Apps test endpoint?
      - Which keys let me call the test endpoint of a service?
      instructions:
      - text: List the test keys for service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show me the current test endpoint keys of {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/regenerateTestKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate a service test key
      effect: write
      questions:
      - How do I rotate a leaked test endpoint key on my Spring Apps instance?
      - Can I regenerate one type of test key and keep the other?
      instructions:
      - text: Regenerate the {keyType} test key for service {service} in resource group {rg}, subscription {sub}.
        slots:
          keyType: requestBody.keyType
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Rotate the {keyType} key on the test endpoint of {service}.
        slots:
          keyType: requestBody.keyType
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/disableTestEndpoint'].post
  update:
    x-apievangelist-phrasing:
      intent: Turn off the service test endpoint
      effect: write
      questions:
      - How do I stop exposing the test endpoint on a Spring Apps service?
      - Can I switch off test endpoint access entirely for an instance?
      instructions:
      - text: Disable the test endpoint on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Turn off test endpoint access for {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/enableTestEndpoint'].post
  update:
    x-apievangelist-phrasing:
      intent: Turn on the service test endpoint
      effect: write
      questions:
      - How do I switch the test endpoint back on for a Spring Apps service?
      - Can I get a test endpoint to reach staging deployments before going live?
      instructions:
      - text: Enable the test endpoint on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Turn test endpoint access back on for {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop a Spring Apps service instance
      effect: write
      questions:
      - How do I pause a whole Spring Apps instance to save cost overnight?
      - Can I stop every app on a service at once by stopping the service itself?
      instructions:
      - text: Stop Spring Apps service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Shut down the service instance {service} for now.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a stopped Spring Apps service
      effect: write
      questions:
      - How do I bring a stopped Spring Apps instance back online?
      - Can I restart a whole service instance after I stopped it?
      instructions:
      - text: Start Spring Apps service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Power the stopped service instance {service} back on.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/flushVirtualNetworkDnsSettings'].post
  update:
    x-apievangelist-phrasing:
      intent: Flush VNet DNS settings for a service
      effect: write
      questions:
      - My VNet-injected Spring Apps instance is not picking up new DNS servers - how do I refresh it?
      - Can I force a service to reload its virtual network DNS configuration?
      instructions:
      - text: Flush the virtual network DNS settings of service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Make VNet-injected service {service} pick up its updated DNS servers.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/supportedApmTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List APM types a service supports
      effect: read
      questions:
      - Which application performance monitoring tools can I plug into a Spring Apps service?
      - What APM types are available for my instance?
      instructions:
      - text: List the supported APM types for service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show which APM types {service} can use.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/listGloballyEnabledApms'].post
  update:
    x-apievangelist-phrasing:
      intent: List APMs enabled globally on a service
      effect: read
      questions:
      - Which APMs are currently switched on for every app in my Spring Apps service?
      - How can I check what monitoring is enabled globally on an instance?
      instructions:
      - text: List the globally enabled APMs on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show me which APMs are on for all apps in {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/enableApmGlobally'].post
  update:
    x-apievangelist-phrasing:
      intent: Enable an APM for all apps in a service
      effect: write
      questions:
      - How do I turn on an APM for every app in a Spring Apps service at once?
      - Can I apply one APM configuration globally instead of per app?
      instructions:
      - text: Enable APM {resourceId} globally on service {service} in resource group {rg}, subscription {sub}.
        slots:
          resourceId: requestBody.resourceId
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Switch on APM {resourceId} for every app in {service}.
        slots:
          resourceId: requestBody.resourceId
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/disableApmGlobally'].post
  update:
    x-apievangelist-phrasing:
      intent: Disable a globally enabled APM
      effect: write
      questions:
      - How do I stop an APM from applying to all apps in my service?
      - Can I remove a global APM without deleting the APM resource itself?
      instructions:
      - text: Disable global APM {resourceId} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          resourceId: requestBody.resourceId
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Stop applying APM {resourceId} to all apps in {service}.
        slots:
          resourceId: requestBody.resourceId
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apms'].get
  update:
    x-apievangelist-phrasing:
      intent: List the APM configurations in a service
      effect: read
      questions:
      - What APM resources have been configured on my Spring Apps instance?
      - Can I see every APM set up in one service?
      instructions:
      - text: List all APMs on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the APM resources defined in {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apms/{apmName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one APM configuration
      effect: read
      questions:
      - How do I view the settings of a specific APM by name?
      - What type and properties does a given APM resource have?
      instructions:
      - text: Get APM {apm} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          apm: path.apmName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show me the configuration of APM {apm}.
        slots:
          apm: path.apmName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apms/{apmName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an APM configuration
      effect: write
      questions:
      - How do I add an APM configuration to my Spring Apps service?
      - Can I change the properties of an APM I already set up?
      instructions:
      - text: Create APM {apm} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          apm: path.apmName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update APM {apm} with properties {properties}.
        slots:
          apm: path.apmName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apms/{apmName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an APM configuration
      effect: destructive
      questions:
      - How do I remove an APM resource from a Spring Apps service?
      - Can I delete an APM I no longer use?
      instructions:
      - text: Delete APM {apm} from service {service} in resource group {rg}, subscription {sub}.
        slots:
          apm: path.apmName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove the APM named {apm}.
        slots:
          apm: path.apmName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apms/{apmName}/listSecretKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Reveal an APM's secret keys
      effect: read
      questions:
      - Where can I read the sensitive values stored on an APM?
      - How do I retrieve the secret keys of an APM configuration?
      instructions:
      - text: List the secret keys of APM {apm} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          apm: path.apmName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Reveal the sensitive properties stored on APM {apm}.
        slots:
          apm: path.apmName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/eurekaServers'].get
  update:
    x-apievangelist-phrasing:
      intent: List Eureka server settings
      effect: read
      questions:
      - What Eureka server settings exist on my Spring Apps instance?
      - Can I list the Eureka servers configured for a service?
      instructions:
      - text: List the Eureka server settings for service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every Eureka server entry on {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/eurekaServers/default'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the default Eureka server settings
      effect: read
      questions:
      - Is the built-in Eureka service registry enabled on my Spring Apps service?
      - How do I check the current default Eureka server configuration?
      instructions:
      - text: Get the default Eureka server settings of service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Tell me whether Eureka is enabled on {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/eurekaServers/default'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace the Eureka server settings
      effect: write
      questions:
      - How do I overwrite the whole Eureka server configuration in one request?
      - Can I enable or disable Eureka by sending the full settings payload?
      instructions:
      - text: Replace the Eureka server settings on service {service} in resource group {rg}, subscription {sub} with {properties}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Overwrite Eureka config of {service} with a full payload.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/eurekaServers/default'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update Eureka server settings
      effect: write
      questions:
      - Can I change a single Eureka setting without resending the rest?
      - How do I patch just the enabled flag on the Eureka server?
      instructions:
      - text: Patch the Eureka server on service {service} in resource group {rg}, subscription {sub} with {properties}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Change only the Eureka fields I give you on {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configServers/default'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the Spring Cloud Config Server settings
      effect: read
      questions:
      - Which git repository is my Spring Apps Config Server reading from?
      - How can I see the current Config Server settings and state?
      instructions:
      - text: Get the Config Server settings of service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show me the git backend configured for the Config Server on {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configServers/default'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace the Config Server git settings
      effect: write
      questions:
      - How do I point the Config Server at a completely new git repository configuration?
      - Can I replace all Config Server settings in one call?
      instructions:
      - text: Replace the Config Server settings on service {service} in resource group {rg}, subscription {sub} with {properties}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Overwrite the whole Config Server git setup on {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configServers/default'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update Config Server settings
      effect: write
      questions:
      - Can I change one Config Server git setting without resending everything?
      - How do I patch one field of my Config Server configuration?
      instructions:
      - text: Patch the Config Server on service {service} in resource group {rg}, subscription {sub} with {properties}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Update only the Config Server fields I specify on {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configServers/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Check Config Server git settings are valid
      effect: read
      questions:
      - Will my Config Server git repo settings actually work before I save them?
      - Can I test Config Server git properties for errors?
      instructions:
      - text: Validate Config Server git settings {gitProperty} for service {service} in resource group {rg}, subscription {sub}.
        slots:
          gitProperty: requestBody.gitProperty
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Dry-run check whether Config Server git property {gitProperty} is valid on {service}.
        slots:
          gitProperty: requestBody.gitProperty
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configurationServices/{configurationServiceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Application Configuration Service
      effect: read
      questions:
      - What git repositories does my Application Configuration Service pull config from?
      - How can I inspect the Application Configuration Service on an Enterprise instance?
      instructions:
      - text: Get Application Configuration Service {config_service} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          config_service: path.configurationServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the settings of Application Configuration Service {config_service}.
        slots:
          config_service: path.configurationServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configurationServices/{configurationServiceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable or update Application Configuration Service
      effect: write
      questions:
      - How do I turn on the Application Configuration Service for my Enterprise tier instance?
      - Can I add another git repository to the Application Configuration Service?
      instructions:
      - text: Create Application Configuration Service {config_service} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          config_service: path.configurationServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update Application Configuration Service {config_service} with {properties}.
        slots:
          config_service: path.configurationServiceName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configurationServices/{configurationServiceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disable the Application Configuration Service
      effect: destructive
      questions:
      - How do I switch off the Application Configuration Service on my instance?
      - Can I remove the default Application Configuration Service entirely?
      instructions:
      - text: Disable Application Configuration Service {config_service} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          config_service: path.configurationServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Delete the Application Configuration Service {config_service}.
        slots:
          config_service: path.configurationServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configurationServices'].get
  update:
    x-apievangelist-phrasing:
      intent: List Application Configuration Services
      effect: read
      questions:
      - Is an Application Configuration Service set up on my Spring Apps service?
      - Can I list all Application Configuration Service resources in an instance?
      instructions:
      - text: List the Application Configuration Services on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every Application Configuration Service resource in {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configurationServices/{configurationServiceName}/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate git settings for Application Config Service
      effect: read
      questions:
      - Can I check the git repos for my Application Configuration Service before applying them?
      - How do I find out why Application Configuration Service git settings fail?
      instructions:
      - text: Validate git settings {gitProperty} for Application Configuration Service {config_service} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          gitProperty: requestBody.gitProperty
          config_service: path.configurationServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Check git property {gitProperty} against Application Configuration Service {config_service}.
        slots:
          gitProperty: requestBody.gitProperty
          config_service: path.configurationServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configurationServices/{configurationServiceName}/validateResource'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a whole Application Config Service resource
      effect: read
      questions:
      - Can I validate a full Application Configuration Service resource payload, not just the git part?
      - How do I check an Application Configuration Service resource definition is valid?
      instructions:
      - text: Validate full resource {properties} of Application Configuration Service {config_service}, service {service}, group {rg}, sub {sub}.
        slots:
          properties: requestBody.properties
          config_service: path.configurationServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Check the full resource definition of Application Configuration Service {config_service}.
        slots:
          config_service: path.configurationServiceName
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (156 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure/refs/heads/main/overlays/microsoft-azure-appplatform-api-phrasing-overlay.yaml

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This overlay
curl "https://apis.io/api/v1/overlays/microsoft-azure-appplatform-api-phrasing-overlay"
All openapi overlays
curl "https://apis.io/api/v1/overlays?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.