Servers - Check Name Availability

Serviço:

SQL Database

Versão da API:

2014-04-01

Determina se um recurso pode ser criado com o nome especificado.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Corpo do Pedido

Name	Tipo	Description
parameters	CheckNameAvailabilityRequest	Os parâmetros para solicitar a disponibilidade de nomes.

Respostas

Name	Tipo	Description
200 OK	CheckNameAvailabilityResponse	OK

Exemplos

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

Pedido de amostra

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"
}

Resposta da amostra

Código de estado:

200

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

Check for a server name that is available

Pedido de amostra

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"
}

Resposta da amostra

Código de estado:

200

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

Check for a server name that is invalid

Pedido de amostra

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"
}

Resposta da amostra

Código de estado:

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."
}

Definições

Name	Description
CheckNameAvailabilityReason	O código de motivo que explica por que o nome não está disponível. Será nulo se o nome estiver disponível.
CheckNameAvailabilityRequest	Os parâmetros para solicitar a disponibilidade de nomes.
CheckNameAvailabilityResourceType	O tipo de recurso usado como o escopo da verificação de disponibilidade.
CheckNameAvailabilityResponse	Uma resposta que indica se o nome especificado para um recurso está disponível.

CheckNameAvailabilityReason

Enumeração

O código de motivo que explica por que o nome não está disponível. Será nulo se o nome estiver disponível.

Valor	Description
Invalid
AlreadyExists

CheckNameAvailabilityRequest

Object

Os parâmetros para solicitar a disponibilidade de nomes.

Name	Tipo	Description
name	string	O nome cuja disponibilidade deve ser verificada.
type	CheckNameAvailabilityResourceType	O tipo de recurso usado como o escopo da verificação de disponibilidade.

CheckNameAvailabilityResourceType

Enumeração

O tipo de recurso usado como o escopo da verificação de disponibilidade.

Valor	Description
Microsoft.Sql/servers

CheckNameAvailabilityResponse

Object

Uma resposta que indica se o nome especificado para um recurso está disponível.

Name	Tipo	Description
available	boolean	True se o nome estiver disponível, caso contrário, false.
message	string	Uma mensagem explicando por que o nome não está disponível. Será nulo se o nome estiver disponível.
name	string	O nome cuja disponibilidade foi verificada.
reason	CheckNameAvailabilityReason	O código de motivo que explica por que o nome não está disponível. Será nulo se o nome estiver disponível.