Servers - Check Name Availability

Servicio:: SQL Database

Versión de la API:: 2014-04-01

Determina si se puede crear un recurso con el nombre especificado.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/checkNameAvailability?api-version=2014-04-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
subscriptionId	path	True	string	Identificador de suscripción que identifica una suscripción de Azure.
api-version	query	True	string	Versión de la API que se va a usar para la solicitud.

Cuerpo de la solicitud

Nombre	Tipo	Description
parameters	CheckNameAvailabilityRequest	Los parámetros para solicitar la disponibilidad de nombres.

Respuestas

Nombre	Tipo	Description
200 OK	CheckNameAvailabilityResponse	OK

Ejemplos

Check for a server name that already exists

Check for a server name that is available

Check for a server name that is invalid

Check for a server name that already exists

Solicitud de ejemplo

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/checkNameAvailability?api-version=2014-04-01

{
  "name": "server1",
  "type": "Microsoft.Sql/servers"
}

Respuesta de muestra

status code:: 200

{
  "name": "server1",
  "available": false,
  "reason": "AlreadyExists",
  "message": "Specified server name is already used"
}

Check for a server name that is available

Solicitud de ejemplo

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/checkNameAvailability?api-version=2014-04-01

{
  "name": "server1",
  "type": "Microsoft.Sql/servers"
}

Respuesta de muestra

status code:: 200

{
  "name": "server1",
  "available": true,
  "reason": null,
  "message": null
}

Check for a server name that is invalid

Solicitud de ejemplo

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/checkNameAvailability?api-version=2014-04-01

{
  "name": "SERVER1",
  "type": "Microsoft.Sql/servers"
}

Respuesta de muestra

status code:: 200

{
  "name": "SERVER1",
  "available": false,
  "reason": "Invalid",
  "message": "Specified server name contains unsupported characters or is too long. Server name must be no longer than 63 characters long, contain only lower-case characters or digits, cannot contain '.' or '_' characters and can't start or end with '-' character."
}

Definiciones

Nombre	Description
CheckNameAvailabilityReason	El código de motivo que explica por qué el nombre no está disponible. Será null si el nombre está disponible.
CheckNameAvailabilityRequest	Los parámetros para solicitar la disponibilidad de nombres.
CheckNameAvailabilityResourceType	El tipo de recurso que se utiliza como ámbito de la comprobación de disponibilidad.
CheckNameAvailabilityResponse	Una respuesta que indica si el nombre especificado para un recurso está disponible.

CheckNameAvailabilityReason

Enumeración

El código de motivo que explica por qué el nombre no está disponible. Será null si el nombre está disponible.

Valor	Description
Invalid
AlreadyExists

CheckNameAvailabilityRequest

Objeto

Los parámetros para solicitar la disponibilidad de nombres.

Nombre	Tipo	Description
name	string	El nombre cuya disponibilidad debe comprobarse.
type	CheckNameAvailabilityResourceType	El tipo de recurso que se utiliza como ámbito de la comprobación de disponibilidad.

CheckNameAvailabilityResourceType

Enumeración

El tipo de recurso que se utiliza como ámbito de la comprobación de disponibilidad.

Valor	Description
Microsoft.Sql/servers

CheckNameAvailabilityResponse

Objeto

Una respuesta que indica si el nombre especificado para un recurso está disponible.

Nombre	Tipo	Description
available	boolean	True si el nombre está disponible; de lo contrario, false.
message	string	Mensaje que explica por qué el nombre no está disponible. Será null si el nombre está disponible.
name	string	Nombre cuya disponibilidad se ha comprobado.
reason	CheckNameAvailabilityReason	El código de motivo que explica por qué el nombre no está disponible. Será null si el nombre está disponible.