Check Name Availability - Namespaces - Check Name Availability

Riferimento

Service:: Event Hubs

API Version:: 2024-01-01

Controllare la disponibilità del nome dello spazio dei nomi.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
subscriptionId	path	True	string	Credenziali di sottoscrizione che identificano in modo univoco una sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.
api-version	query	True	string	Versione dell'API client.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
name	True	string	Nome per controllare la disponibilità del nome dello spazio dei nomi

Risposte

Nome	Tipo	Descrizione
200 OK	CheckNameAvailabilityResult	verificare la disponibilità restituita correttamente.
Other Status Codes	ErrorResponse	Risposta di errore di EventHub che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

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

Scopes

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

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

Definizioni

Nome	Descrizione
CheckNameAvailabilityParameter	Parametro fornito per controllare l'operazione di disponibilità del nome dello spazio dei nomi
CheckNameAvailabilityResult	Risultato dell'operazione CheckNameAvailability
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta errore indica che il servizio Hub eventi non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.
UnavailableReason	Specifica il motivo dell'indisponibilità del servizio.

CheckNameAvailabilityParameter

Parametro fornito per controllare l'operazione di disponibilità del nome dello spazio dei nomi

Nome	Tipo	Descrizione
name	string	Nome per controllare la disponibilità del nome dello spazio dei nomi

CheckNameAvailabilityResult

Risultato dell'operazione CheckNameAvailability

Nome	Tipo	Descrizione
message	string	Informazioni dettagliate relative al motivo associato allo spazio dei nomi.
nameAvailable	boolean	Valore che indica che spazio dei nomi è disponibile, true se lo spazio dei nomi è disponibile; in caso contrario, false.
reason	UnavailableReason	Motivo dell'indisponibilità di uno spazio dei nomi.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta errore indica che il servizio Hub eventi non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

UnavailableReason

Specifica il motivo dell'indisponibilità del servizio.

Nome	Tipo	Descrizione
InvalidName	string
NameInLockdown	string
NameInUse	string
None	string
SubscriptionIsDisabled	string
TooManyNamespaceInCurrentSubscription	string

Share via