Kontrollera molntjänstnamnets tillgänglighet

Artikel
08/05/2023

Åtgärden Check Hosted Service Name Availability söker efter tillgängligheten för det angivna namnet på molntjänsten.

Förfrågan

Begäran Check Hosted Service Name Availability kan anges på följande sätt. Ersätt <subscription-id> med ditt prenumerations-ID och <cloudservice-name> med namnet på molntjänsten som du vill använda.

Metod	URI för förfrågan
GET	`https://management.core.windows.net/<subscription-id>/services/hostedservices/operations/isavailable/<cloudservice-name>`

URI-parametrar

Inga.

Rubriker för begäran

I följande tabell beskrivs begärandehuvudena.

Begärandehuvud	Description
`x-ms-version`	Krävs. Anger vilken version av åtgärden som ska användas för den här begäran. Det här huvudet ska vara inställt på `2012-03-01` eller högre.

Begärandetext

Inga.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext.

Statuskod

En lyckad åtgärd returnerar statuskod 200 (OK).

Svarsrubriker

Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden.

Svarshuvud	Description
`x-ms-request-id`	Ett värde som unikt identifierar en begäran som görs mot hanteringstjänsten.

Svarstext

Formatet på svarstexten är följande:

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

I följande tabell beskrivs elementen i svarstexten.

Elementnamn	Beskrivning
Resultat	Ett booleskt värde som anger om namnet är tillgängligt för dig att använda. `true` om namnet är tillgängligt; annars `false`. För versioner före 2013-03-01 returnerades `true` åtgärden för icke-tagna namn även om de var reserverade eller olämpliga. Med versionshuvudena 2013-03-01 och senare returneras `false` åtgärden för reserverade eller olämpliga ord.
Anledning	Anger varför namnet inte kan användas för att skapa molntjänsten. Möjliga värden: - `HostedServiceAlreadyExists` – returneras om molntjänstnamnet redan finns. - `HostedServiceNameNotValid` – returneras om molntjänstnamnet använder tecken som inte stöds, reserverade ord eller olämpliga ord. Elementet `Reason` är endast tillgängligt med version 2013-03-01 eller senare.

Dela via