Servers - Check Name Availability

Określa, czy zasób można utworzyć z określoną nazwą.

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

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Przykłady

Check for a server name that already exists

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

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

Check for a server name that is available

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

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

Check for a server name that is invalid

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

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

Definicje

CheckNameAvailabilityReason

Kod przyczyny wyjaśniający, dlaczego nazwa jest niedostępna. Będzie to nieważne, jeśli nazwa jest dostępna.

CheckNameAvailabilityRequest

Parametry do żądania dostępności nazwy.

CheckNameAvailabilityResourceType

Typ zasobu wykorzystywanego jako zakres kontroli dostępności.

CheckNameAvailabilityResponse

Odpowiedź wskazująca, czy podana nazwa zasobu jest dostępna.