Servers - Name Availability - Check Name Availability

Usługa:

SQL Database

Wersja interfejsu API:

2014-04-01

Określa, czy zasób można utworzyć przy użyciu określonej nazwy.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa	Wymagane	Typ	Opis
name	True	string	Nazwa, której dostępność ma zostać sprawdzona.
type	True	CheckNameAvailabilityResourceType	Typ zasobu, który jest używany jako zakres sprawdzania dostępności.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	CheckNameAvailabilityResponse	OK

Przykłady

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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

200

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

Check for a server name that is available

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

200

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

Check for a server name that is invalid

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Definicje

Nazwa	Opis
CheckNameAvailabilityReason	Kod przyczyny wyjaśniający, dlaczego nazwa jest niedostępna. Jeśli nazwa jest dostępna, będzie mieć wartość null.
CheckNameAvailabilityRequest	Żądanie sprawdzenia, czy określona nazwa zasobu jest dostępna.
CheckNameAvailabilityResourceType	Typ zasobu, który jest używany jako zakres sprawdzania dostępności.
CheckNameAvailabilityResponse	Odpowiedź wskazująca, czy określona nazwa zasobu jest dostępna.

CheckNameAvailabilityReason

Kod przyczyny wyjaśniający, dlaczego nazwa jest niedostępna. Jeśli nazwa jest dostępna, będzie mieć wartość null.

Nazwa	Typ	Opis
AlreadyExists	string
Invalid	string

CheckNameAvailabilityRequest

Żądanie sprawdzenia, czy określona nazwa zasobu jest dostępna.

Nazwa	Typ	Opis
name	string	Nazwa, której dostępność ma zostać sprawdzona.
type	CheckNameAvailabilityResourceType	Typ zasobu, który jest używany jako zakres sprawdzania dostępności.

CheckNameAvailabilityResourceType

Typ zasobu, który jest używany jako zakres sprawdzania dostępności.

Nazwa	Typ	Opis
Microsoft.Sql/servers	string

CheckNameAvailabilityResponse

Odpowiedź wskazująca, czy określona nazwa zasobu jest dostępna.

Nazwa	Typ	Opis
available	boolean	Prawda, jeśli nazwa jest dostępna, w przeciwnym razie wartość false.
message	string	Komunikat wyjaśniający, dlaczego nazwa jest niedostępna. Jeśli nazwa jest dostępna, będzie mieć wartość null.
name	string	Nazwa, której dostępność została sprawdzona.
reason	CheckNameAvailabilityReason	Kod przyczyny wyjaśniający, dlaczego nazwa jest niedostępna. Jeśli nazwa jest dostępna, będzie mieć wartość null.