Check Name Availability - Namespaces - Check Name Availability

Služba:

Event Hubs

Verze rozhraní API:

2024-01-01

Zkontrolujte dostupnost názvu oboru názvů.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
subscriptionId	path	True	string	Přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného tvoří součást identifikátoru URI pro každé volání služby.
api-version	query	True	string	Verze rozhraní API klienta.

Text požadavku

Name	Vyžadováno	Typ	Description
name	True	string	Název pro kontrolu dostupnosti názvu oboru názvů

Odpovědi

Name	Typ	Description
200 OK	CheckNameAvailabilityResult	kontrola dostupnosti byla úspěšně vrácena.
Other Status Codes	ErrorResponse	Odpověď na chybu EventHubu popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

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

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

NamespacesCheckNameAvailability

Ukázkový požadavek

HTTP

POST https://management.azure.com/subscriptions/5f750a97-50d9-4e36-8081-c9ee4c0210d4/providers/Microsoft.EventHub/checkNameAvailability?api-version=2024-01-01

{
  "name": "sdk-Namespace-8458"
}

Ukázková odpověď

Stavový kód:

200

{
  "nameAvailable": true,
  "reason": "None",
  "message": ""
}

Definice

Name	Description
CheckNameAvailabilityParameter	Parametr zadaný ke kontrole operace dostupnosti názvu oboru názvů
CheckNameAvailabilityResult	Výsledek operace CheckNameAvailability
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď značí, že služba centra událostí nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě.
UnavailableReason	Určuje důvod nedostupnosti služby.

CheckNameAvailabilityParameter

Objekt

Parametr zadaný ke kontrole operace dostupnosti názvu oboru názvů

Name	Typ	Description
name	string	Název pro kontrolu dostupnosti názvu oboru názvů

CheckNameAvailabilityResult

Objekt

Výsledek operace CheckNameAvailability

Name	Typ	Description
message	string	Podrobné informace týkající se důvodu spojeného s oborem názvů.
nameAvailable	boolean	Hodnota indikující, že obor názvů je dostupnost, true, pokud je obor názvů k dispozici; jinak nepravda.
reason	UnavailableReason	Důvod nedostupnosti oboru názvů

ErrorAdditionalInfo

Objekt

Další informace o chybě správy 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ěď značí, že služba centra událostí nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě.

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

UnavailableReason

Výčet

Určuje důvod nedostupnosti služby.

Hodnota	Description
None
InvalidName
SubscriptionIsDisabled
NameInUse
NameInLockdown
TooManyNamespaceInCurrentSubscription