Check Name Availability - Namespaces - Check Name Availability

Service:

Event Hubs

API Version:

2024-01-01

Sprawdź dostępność nazw przestrzeni nazw.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
subscriptionId	path	True	string	Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.
api-version	query	True	string	Wersja interfejsu API klienta.

Treść żądania

Nazwa	Wymagane	Typ	Opis
name	True	string	Nazwa w celu sprawdzenia dostępności nazw przestrzeni nazw

Odpowiedzi

Nazwa	Typ	Opis
200 OK	CheckNameAvailabilityResult	Sprawdź, czy dostępność została zwrócona pomyślnie.
Other Status Codes	ErrorResponse	Odpowiedź z błędem usługi EventHub opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

NamespacesCheckNameAvailability

Sample Request

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"
}

Sample Response

Status code:

200

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

Definicje

Nazwa	Opis
CheckNameAvailabilityParameter	Parametr podany w celu sprawdzenia operacji dostępności nazw przestrzeni nazw
CheckNameAvailabilityResult	Wynik operacji CheckNameAvailability
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd wskazuje, że usługa Event Hub nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie.
UnavailableReason	Określa przyczynę niedostępności usługi.

CheckNameAvailabilityParameter

Parametr podany w celu sprawdzenia operacji dostępności nazw przestrzeni nazw

Nazwa	Typ	Opis
name	string	Nazwa w celu sprawdzenia dostępności nazw przestrzeni nazw

CheckNameAvailabilityResult

Wynik operacji CheckNameAvailability

Nazwa	Typ	Opis
message	string	Szczegółowe informacje dotyczące przyczyny skojarzonej z przestrzenią nazw.
nameAvailable	boolean	Wartość wskazująca, że przestrzeń nazw jest dostępnością, wartość true, jeśli przestrzeń nazw jest dostępna; w przeciwnym razie wartość false.
reason	UnavailableReason	Przyczyna niedostępności przestrzeni nazw.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd wskazuje, że usługa Event Hub nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie.

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt error.

UnavailableReason

Określa przyczynę niedostępności usługi.

Nazwa	Typ	Opis
InvalidName	string
NameInLockdown	string
NameInUse	string
None	string
SubscriptionIsDisabled	string
TooManyNamespaceInCurrentSubscription	string