# 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 Check Name Availability API
  version: 1.0.0
extends: openapi/microsoft-azure-checknameavailability-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: 8
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.AgFoodPlatform/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check if an agriculture platform name is available
      effect: read
      questions:
      - Is the name I want for my Azure Data Manager for Agriculture resource already taken?
      - How can I check agriculture platform resource name availability before creating one?
      instructions:
      - text: Check whether my chosen Data Manager for Agriculture resource name is available.
      - text: See if the AgFoodPlatform resource name I picked is free.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DigitalTwins/locations/{location}/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check if a Digital Twins instance name is available
      effect: read
      questions:
      - Is a given Azure Digital Twins instance name available in a region?
      - How do I verify a Digital Twins name before provisioning the instance?
      instructions:
      - text: Check whether Digital Twins name {name} of type {type} is available in {location} for subscription {sub}.
        slots:
          name: requestBody.name
          type: requestBody.type
          location: path.location
          sub: path.subscriptionId
      - text: Confirm {name} is free for a new Digital Twins instance in {location}.
        slots:
          name: requestBody.name
          location: path.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Cdn/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check if a globally unique CDN name is available
      effect: read
      questions:
      - Is the CDN endpoint name I want already used somewhere globally?
      - How do I check a globally unique Front Door or CDN endpoint name before creating it?
      instructions:
      - text: Check whether CDN name {name} of resource type {type} is globally available.
        slots:
          name: requestBody.name
          type: requestBody.type
      - text: See if CDN endpoint name {name} is free.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.Help/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check if a Help diagnostic or solution name is unique
      effect: read
      questions:
      - Is the name I want for a Help diagnostic or troubleshooter unique within a resource scope?
      - How do I check that a solutions resource name isn't already used under a scope?
      instructions:
      - text: Check whether my diagnostic name is unique under scope {scope}.
        slots:
          scope: path.scope
      - text: Verify a troubleshooter name is available for resource scope {scope}.
        slots:
          scope: path.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check if a management group name is valid and unique
      effect: read
      questions:
      - Is a management group ID I want to use valid and not already taken?
      - How do I check management group name uniqueness before creating one?
      instructions:
      - text: Check whether management group name {request} is valid and unique.
        slots:
          request: body.checkNameAvailabilityRequest
      - text: Validate the proposed management group name in {request} using API version {apiVersion}.
        slots:
          request: body.checkNameAvailabilityRequest
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DBforMariaDB/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check if a MariaDB server name is available
      effect: read
      questions:
      - Can I use a particular name for a new Azure Database for MariaDB server?
      - How do I check MariaDB server name availability in my subscription?
      instructions:
      - text: Check whether MariaDB server name {name} is available in subscription {sub}.
        slots:
          name: requestBody.name
          sub: path.subscriptionId
      - text: See if {name} is free for a new MariaDB server.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DBforMySQL/locations/{locationName}/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a MySQL server name in a specific region
      effect: read
      questions:
      - Is a MySQL flexible server name available in a particular Azure region?
      - How do I check MySQL server name availability for one location?
      instructions:
      - text: Check whether MySQL server name {name} is available in region {locationName}.
        slots:
          name: requestBody.name
          locationName: path.locationName
      - text: See if {name} of type {type} is free for a MySQL server at my chosen location.
        slots:
          name: requestBody.name
          type: requestBody.type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DBforMySQL/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a MySQL server name without a region
      effect: read
      questions:
      - Can I check MySQL server name availability across my subscription without picking a region?
      - Is a MySQL server name taken, regardless of location?
      instructions:
      - text: Check whether MySQL server name {name} is available, without specifying a location.
        slots:
          name: requestBody.name
      - text: Tell me if {name} is free for any new MySQL server in my subscription.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'