# 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 Quota Information API
  version: 1.0.0
extends: openapi/microsoft-azure-quotainformation-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: 8
- target: $.paths['/{scope}/providers/Microsoft.Quota/quotas/{resourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a resource's quota limit at a scope
      effect: read
      questions:
      - What is my current quota limit for a specific resource at a given scope?
      - How much quota remains before I request an increase through the Quota service?
      instructions:
      - text: Get the Microsoft.Quota limit for {resourceName} at scope {scope}.
        slots:
          resourceName: path.resourceName
          scope: path.scope
      - text: Show the current quota cap on {resourceName} under {scope}.
        slots:
          resourceName: path.resourceName
          scope: path.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.Quota/quotas/{resourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Request a new quota limit at a scope
      effect: write
      questions:
      - How do I request a higher quota limit for a resource with the Quota service?
      - Can I submit a new quota limit value for a resource at a subscription scope?
      instructions:
      - text: Set the Microsoft.Quota limit for {resourceName} at scope {scope} to {properties}.
        slots:
          resourceName: path.resourceName
          scope: path.scope
          properties: requestBody.properties
      - text: Submit a quota limit request for {resourceName} under {scope}.
        slots:
          resourceName: path.resourceName
          scope: path.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.Quota/quotas/{resourceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a resource's quota limit at a scope
      effect: write
      questions:
      - Can I patch just the limit value of an existing quota at a scope?
      - What steps come before patching a Microsoft.Quota limit?
      instructions:
      - text: Patch the quota for {resourceName} at scope {scope} with {properties}.
        slots:
          resourceName: path.resourceName
          scope: path.scope
          properties: requestBody.properties
      - text: Partially update the Microsoft.Quota limit on {resourceName} in {scope}.
        slots:
          resourceName: path.resourceName
          scope: path.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.Quota/quotas'].get
  update:
    x-apievangelist-phrasing:
      intent: List all quota limits at a scope
      effect: read
      questions:
      - What are all the current quota limits for resources in a scope?
      - Which Microsoft.Quota limits apply across my subscription scope?
      instructions:
      - text: List every Microsoft.Quota limit at scope {scope}.
        slots:
          scope: path.scope
      - text: Show all quota caps defined under {scope}.
        slots:
          scope: path.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Capacity/resourceProviders/{providerId}/locations/{location}/serviceLimits/{resourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a legacy service limit and usage
      effect: read
      questions:
      - What is the current service limit and usage for one resource in a region via Microsoft.Capacity?
      - How close am I to the service limit for a resource in a location?
      instructions:
      - text: Get the Microsoft.Capacity service limit for {resourceName} from provider {providerId} in {location} for subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          subscriptionId: path.subscriptionId
          providerId: path.providerId
          location: path.location
      - text: Show usage vs limit of {resourceName} in {location} (provider {providerId}, subscription {subscriptionId}).
        slots:
          resourceName: path.resourceName
          subscriptionId: path.subscriptionId
          providerId: path.providerId
          location: path.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Capacity/resourceProviders/{providerId}/locations/{location}/serviceLimits/{resourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Request a service limit increase in a region
      effect: write
      questions:
      - How do I raise a service limit for a resource in a specific region with Microsoft.Capacity?
      - Can I ask for a new regional service limit value by updating the limit field?
      instructions:
      - text: Request a new Microsoft.Capacity service limit {properties} for {resourceName} in {location} (provider {providerId}, subscription {subscriptionId}).
        slots:
          resourceName: path.resourceName
          properties: requestBody.properties
          subscriptionId: path.subscriptionId
          providerId: path.providerId
          location: path.location
      - text: Increase the regional limit on {resourceName} in {location} for provider {providerId} in subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          subscriptionId: path.subscriptionId
          providerId: path.providerId
          location: path.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Capacity/resourceProviders/{providerId}/locations/{location}/serviceLimits/{resourceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a regional service limit
      effect: write
      questions:
      - Can I patch a regional Microsoft.Capacity service limit instead of replacing it?
      - What do I send to partially update a service limit in a location?
      instructions:
      - text: Patch the Microsoft.Capacity limit for {resourceName} in {location} with {properties} (provider {providerId}, subscription {subscriptionId}).
        slots:
          resourceName: path.resourceName
          properties: requestBody.properties
          subscriptionId: path.subscriptionId
          providerId: path.providerId
          location: path.location
      - text: Partially update the regional service limit of {resourceName} in {location}, provider {providerId}, subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          subscriptionId: path.subscriptionId
          providerId: path.providerId
          location: path.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Capacity/resourceProviders/{providerId}/locations/{location}/serviceLimits'].get
  update:
    x-apievangelist-phrasing:
      intent: List service limits and usage in a region
      effect: read
      questions:
      - What are all my service limits and current usage for a provider in one region?
      - Which resources in a location are nearest their Microsoft.Capacity limits?
      instructions:
      - text: List Microsoft.Capacity service limits for provider {providerId} in {location} for subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          providerId: path.providerId
          location: path.location
      - text: Show usage and limits of all resources in {location} for provider {providerId}, subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          providerId: path.providerId
          location: path.location
      method: generated
      generated: '2026-09-26'