Servers - Name Availability - Check Name Availability

  • Referencia
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

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

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

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.