Pools - Check Name Availability

Služba:

Managed DevOps Pools

Verze rozhraní API:

2026-06-02

Zkontroluje, zda je název fondu platný a zda se již nepoužívá.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DevOpsInfrastructure/checkNameAvailability?api-version=2026-06-02

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Vyžadováno	Typ	Description
name	True	string	Název zdroje.
type	True	DevOpsInfrastructureResourceType	Typ prostředku, který se používá jako rozsah kontroly dostupnosti.

Odpovědi

Name	Typ	Description
200 OK	CheckNameAvailabilityResult	Požadavek byl úspěšný.
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok OAuth2 služby Azure Active Directory.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	vydávat se za svůj uživatelský účet

Příklady

Pools_CheckNameAvailability

Ukázkový požadavek

HTTP

POST https://management.azure.com/subscriptions/a2e95d27-c161-4b61-bda4-11512c14c2c2/providers/Microsoft.DevOpsInfrastructure/checkNameAvailability?api-version=2026-06-02

{
  "name": "mydevopspool",
  "type": "Microsoft.DevOpsInfrastructure/pools"
}

Ukázková odpověď

Stavový kód:

200

{
  "available": "Unavailable",
  "message": "Managed DevOps pool mydevopspool is already in use. Please choose a pool name that has not been taken.",
  "name": "mydevopspool",
  "reason": "AlreadyExists"
}

Definice

Name	Description
AvailabilityStatus	DostupnostStav jména.
CheckNameAvailability	Parametry používané ke kontrole dostupnosti zdroje.
CheckNameAvailabilityReason	Kód důvodu vysvětlující, proč název není k dispozici. Bude mít hodnotu null, pokud je název k dispozici.
CheckNameAvailabilityResult	Odpověď operace CheckNameAvailability.
DevOpsInfrastructureResourceType	Typ prostředků.
ErrorAdditionalInfo	Další informace o chybě při správě prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď

AvailabilityStatus

Výčet

DostupnostStav jména.

Hodnota	Description
Available	Název je k dispozici.
Unavailable	Název není k dispozici

CheckNameAvailability

Objekt

Parametry používané ke kontrole dostupnosti zdroje.

Name	Typ	Description
name	string	Název zdroje.
type	DevOpsInfrastructureResourceType	Typ prostředku, který se používá jako rozsah kontroly dostupnosti.

CheckNameAvailabilityReason

Výčet

Kód důvodu vysvětlující, proč název není k dispozici. Bude mít hodnotu null, pokud je název k dispozici.

Hodnota	Description
Invalid	Název je neplatný.
AlreadyExists	Název již existuje.

CheckNameAvailabilityResult

Objekt

Odpověď operace CheckNameAvailability.

Name	Typ	Description
available	AvailabilityStatus	Stav dostupnosti názvu.
message	string	Zpráva s vysvětlením, proč je název nedostupný. Bude mít hodnotu null, pokud je název k dispozici.
name	string	Název, jehož dostupnost byla zkontrolována.
reason	CheckNameAvailabilityReason	Kód důvodu vysvětlující, proč název není k dispozici. Bude mít hodnotu null, pokud je název k dispozici.

DevOpsInfrastructureResourceType

Výčet

Typ prostředků.

Hodnota	Description
Microsoft.DevOpsInfrastructure/pools	Prostředek fondu DevOpsInfrastructure.

ErrorAdditionalInfo

Objekt

Další informace o chybě při správě prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.