Kontrola dostupnosti názvu cloudové služby

Článek
07/19/2023

Operace Check Hosted Service Name Availability zkontroluje dostupnost zadaného názvu cloudové služby.

Žádost

Žádost Check Hosted Service Name Availability může být zadána následujícím způsobem. Nahraďte <subscription-id> ID předplatného a <cloudservice-name> názvem cloudové služby, který chcete použít.

Metoda	Identifikátor URI žádosti
GET	`https://management.core.windows.net/<subscription-id>/services/hostedservices/operations/isavailable/<cloudservice-name>`

Parametry identifikátoru URI

Žádné

Hlavičky požadavku

Následující tabulka popisuje hlavičky požadavku.

Hlavička požadavku	Description
`x-ms-version`	Povinná hodnota. Určuje verzi operace, která se má použít pro tento požadavek. Tato hlavička by měla být nastavená na `2012-03-01` hodnotu nebo vyšší.

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědi a tělo odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK).

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat další standardní hlavičky HTTP.

Hlavička odpovědi	Description
`x-ms-request-id`	Hodnota, která jednoznačně identifikuje požadavek provedený vůči službě pro správu.

Text odpovědi

Text odpovědi má následující formát:

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

Následující tabulka popisuje prvky v textu odpovědi.

Název elementu Popis

Výsledek Logická hodnota, která označuje, jestli je název k dispozici pro použití. true pokud je název k dispozici; jinak false.

U verzí před 2013-03-01 se operace vrátila true pro nezabrané názvy, i když byly rezervované nebo vulgární. S hlavičkami verze z 1. 3. 2013 a novější vrátí operace false rezervovaná nebo vulgární slova.

Důvod Označuje, proč název nelze použít k vytvoření cloudové služby.

Možné hodnoty:

- HostedServiceAlreadyExists – vrátí, pokud název cloudové služby již existuje.
- HostedServiceNameNotValid – vráceno, pokud název cloudové služby používá nepodporované znaky, vyhrazená slova nebo vulgární slova.

Element Reason je k dispozici pouze ve verzi 2013-03-01 nebo vyšší.

Název elementu	Popis
Výsledek	Logická hodnota, která označuje, jestli je název k dispozici pro použití. `true` pokud je název k dispozici; jinak `false`. U verzí před 2013-03-01 se operace vrátila `true` pro nezabrané názvy, i když byly rezervované nebo vulgární. S hlavičkami verze z 1. 3. 2013 a novější vrátí operace `false` rezervovaná nebo vulgární slova.
Důvod	Označuje, proč název nelze použít k vytvoření cloudové služby. Možné hodnoty: - `HostedServiceAlreadyExists` – vrátí, pokud název cloudové služby již existuje. - `HostedServiceNameNotValid` – vráceno, pokud název cloudové služby používá nepodporované znaky, vyhrazená slova nebo vulgární slova. Element `Reason` je k dispozici pouze ve verzi 2013-03-01 nebo vyšší.

Sdílet prostřednictvím