Servers - Check Name Availability

Service:: SQL Database

Version d'API:: 2014-04-01

Détermine si une ressource peut être créée avec le nom spécifié.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
subscriptionId	path	True	string	ID d’abonnement qui identifie un abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Corps de la demande

Nom	Type	Description
parameters	CheckNameAvailabilityRequest	Les paramètres pour demander la disponibilité du nom.

Réponses

Nom	Type	Description
200 OK	CheckNameAvailabilityResponse	Ok

Exemples

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

Exemple de requête

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

Exemple de réponse

Code d’état:: 200

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

Check for a server name that is available

Exemple de requête

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

Exemple de réponse

Code d’état:: 200

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

Check for a server name that is invalid

Exemple de requête

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

Exemple de réponse

Code d’état:: 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."
}

Définitions

Nom	Description
CheckNameAvailabilityReason	Code de raison expliquant pourquoi le nom n’est pas disponible. Sera null si le nom est disponible.
CheckNameAvailabilityRequest	Les paramètres pour demander la disponibilité du nom.
CheckNameAvailabilityResourceType	Type de ressource utilisé comme étendue de la vérification de disponibilité.
CheckNameAvailabilityResponse	Une réponse indiquant si le nom spécifié d’une ressource est disponible.

CheckNameAvailabilityReason

Énumération

Code de raison expliquant pourquoi le nom n’est pas disponible. Sera null si le nom est disponible.

Valeur	Description
Invalid
AlreadyExists

CheckNameAvailabilityRequest

Objet

Les paramètres pour demander la disponibilité du nom.

Nom	Type	Description
name	string	Le nom dont la disponibilité doit être vérifiée.
type	CheckNameAvailabilityResourceType	Type de ressource utilisé comme étendue de la vérification de disponibilité.

CheckNameAvailabilityResourceType

Énumération

Type de ressource utilisé comme étendue de la vérification de disponibilité.

Valeur	Description
Microsoft.Sql/servers

CheckNameAvailabilityResponse

Objet

Une réponse indiquant si le nom spécifié d’une ressource est disponible.

Nom	Type	Description
available	boolean	True si le nom est disponible, sinon false.
message	string	Message expliquant pourquoi le nom n’est pas disponible. Sera null si le nom est disponible.
name	string	Nom dont la disponibilité a été vérifiée.
reason	CheckNameAvailabilityReason	Code de raison expliquant pourquoi le nom n’est pas disponible. Sera null si le nom est disponible.