Servers - Name Availability - 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	El id. de suscripción que identifica una suscripción de Azure.
api-version	query	True	string	La versión de API que se usará para la solicitud.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
name	True	string	Nombre cuya disponibilidad se va a comprobar.
type	True	CheckNameAvailabilityResourceType	Tipo de recurso que se usa como ámbito de la comprobación de disponibilidad.

Respuestas

Nombre	Tipo	Description
200 OK	CheckNameAvailabilityResponse	Aceptar

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	Solicitud para comprobar si el nombre especificado para un recurso está disponible.
CheckNameAvailabilityResourceType	Tipo de recurso que se usa como ámbito de la comprobación de disponibilidad.
CheckNameAvailabilityResponse	Respuesta que indica si el nombre especificado para un recurso está disponible.

CheckNameAvailabilityReason

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

Nombre	Tipo	Description
AlreadyExists	string
Invalid	string

CheckNameAvailabilityRequest

Solicitud para comprobar si el nombre especificado para un recurso está disponible.

Nombre	Tipo	Description
name	string	Nombre cuya disponibilidad se va a comprobar.
type	CheckNameAvailabilityResourceType	Tipo de recurso que se usa como ámbito de la comprobación de disponibilidad.

CheckNameAvailabilityResourceType

Tipo de recurso que se usa como ámbito de la comprobación de disponibilidad.

Nombre	Tipo	Description
Microsoft.Sql/servers	string

CheckNameAvailabilityResponse

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.