Api Management Service - Check Name Availability

Checks availability and correctness of a name for an API Management service.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ApiManagement/checkNameAvailability?api-version=2021-08-01

URI Parameters

Name In Required Type Description
subscriptionId
path True

string

Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call.

api-version
query True

string

Version of the API to be used with the client request.

Request Body

Name Required Type Description
name True

string

The name to check for availability.

Responses

Name Type Description
200 OK

ApiManagementServiceNameAvailabilityResult

The result of check name availability.

Other Status Codes

ErrorResponse

Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation impersonate your user account

Examples

ApiManagementServiceCheckNameAvailability

Sample request

POST https://management.azure.com/subscriptions/subid/providers/Microsoft.ApiManagement/checkNameAvailability?api-version=2021-08-01

{
  "name": "apimService1"
}

Sample response

{
  "nameAvailable": true,
  "reason": "Valid",
  "message": ""
}

Definitions

Name Description
ApiManagementServiceCheckNameAvailabilityParameters

Parameters supplied to the CheckNameAvailability operation.

ApiManagementServiceNameAvailabilityResult

Response of the CheckNameAvailability operation.

ErrorFieldContract

Error Field contract.

ErrorResponse

Error Response.

NameAvailabilityReason

Invalid indicates the name provided does not match the resource provider’s naming requirements (incorrect length, unsupported characters, etc.) AlreadyExists indicates that the name is already in use and is therefore unavailable.

ApiManagementServiceCheckNameAvailabilityParameters

Parameters supplied to the CheckNameAvailability operation.

Name Type Description
name

string

The name to check for availability.

ApiManagementServiceNameAvailabilityResult

Response of the CheckNameAvailability operation.

Name Type Description
message

string

If reason == invalid, provide the user with the reason why the given name is invalid, and provide the resource naming requirements so that the user can select a valid name. If reason == AlreadyExists, explain that is already in use, and direct them to select a different name.

nameAvailable

boolean

True if the name is available and can be used to create a new API Management service; otherwise false.

reason

NameAvailabilityReason

Invalid indicates the name provided does not match the resource provider’s naming requirements (incorrect length, unsupported characters, etc.) AlreadyExists indicates that the name is already in use and is therefore unavailable.

ErrorFieldContract

Error Field contract.

Name Type Description
code

string

Property level error code.

message

string

Human-readable representation of property-level error.

target

string

Property name.

ErrorResponse

Error Response.

Name Type Description
error.code

string

Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response.

error.details

ErrorFieldContract[]

The list of invalid fields send in request, in case of validation error.

error.message

string

Human-readable representation of the error.

NameAvailabilityReason

Invalid indicates the name provided does not match the resource provider’s naming requirements (incorrect length, unsupported characters, etc.) AlreadyExists indicates that the name is already in use and is therefore unavailable.

Name Type Description
AlreadyExists

string

Invalid

string

Valid

string