Sprawdzanie dostępności nazwy usługi w chmurze

Artykuł
08/05/2023

Operacja Check Hosted Service Name Availability sprawdza dostępność określonej nazwy usługi w chmurze.

Żądanie

Żądanie Check Hosted Service Name Availability można określić w następujący sposób. Zastąp <subscription-id> ciąg identyfikatorem subskrypcji i <cloudservice-name> nazwą usługi w chmurze, której chcesz użyć.

Metoda	Identyfikator URI żądania
GET	`https://management.core.windows.net/<subscription-id>/services/hostedservices/operations/isavailable/<cloudservice-name>`

Parametry identyfikatora URI

Brak.

Nagłówki żądań

W poniższej tabeli opisano nagłówki żądań.

Nagłówek żądania	Opis
`x-ms-version`	Wymagane. Określa wersję operacji do użycia dla tego żądania. Ten nagłówek powinien być ustawiony na `2012-03-01` lub wyższy.

Treść żądania

Brak.

Reakcja

Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi.

Kod stanu

Operacja zakończona powodzeniem zwraca kod stanu 200 (OK).

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP.

Nagłówek odpowiedzi	Opis
`x-ms-request-id`	Wartość, która jednoznacznie identyfikuje żądanie wykonane względem usługi zarządzania.

Treść odpowiedzi

Format treści odpowiedzi jest następujący:

  
<?xml version="1.0" encoding="utf-8"?>  
<AvailabilityResponse xmlns=”http://schemas.microsoft.com/windowsazure”>  
  <Result>name-availability</Result>  
  <Reason>reason</Reason>  
</AvailabilityResponse>

W poniższej tabeli opisano elementy w treści odpowiedzi.

Nazwa elementu Opis

Wynik Wartość logiczna wskazująca, czy nazwa jest dostępna do użycia. true jeśli nazwa jest dostępna; w przeciwnym razie false.

W przypadku wersji przed 2013-03-01 operacja została zwrócona dla nazw nieprzyjętych true , nawet jeśli były zastrzeżone lub wulgarne. W przypadku nagłówków wersji 2013-03-01 i nowszych operacja zwraca wartość false dla zarezerwowanych lub wulgarnych słów.

Przyczyna Wskazuje, dlaczego nie można użyć nazwy do utworzenia usługi w chmurze.

Możliwe wartości:

- HostedServiceAlreadyExists — zwracane, jeśli nazwa usługi w chmurze już istnieje.
- HostedServiceNameNotValid — zwracane, jeśli nazwa usługi w chmurze używa nieobsługiwanych znaków, zastrzeżonych słów lub wulgarnych słów.

Element Reason jest dostępny tylko w wersji 2013-03-01 lub nowszej.

Nazwa elementu	Opis
Wynik	Wartość logiczna wskazująca, czy nazwa jest dostępna do użycia. `true` jeśli nazwa jest dostępna; w przeciwnym razie `false`. W przypadku wersji przed 2013-03-01 operacja została zwrócona dla nazw nieprzyjętych `true` , nawet jeśli były zastrzeżone lub wulgarne. W przypadku nagłówków wersji 2013-03-01 i nowszych operacja zwraca wartość `false` dla zarezerwowanych lub wulgarnych słów.
Przyczyna	Wskazuje, dlaczego nie można użyć nazwy do utworzenia usługi w chmurze. Możliwe wartości: - `HostedServiceAlreadyExists` — zwracane, jeśli nazwa usługi w chmurze już istnieje. - `HostedServiceNameNotValid` — zwracane, jeśli nazwa usługi w chmurze używa nieobsługiwanych znaków, zastrzeżonych słów lub wulgarnych słów. Element `Reason` jest dostępny tylko w wersji 2013-03-01 lub nowszej.