Namespaces - CheckName Availability - Check Name Availability
Überprüfen Sie die Verfügbarkeit des Namespacenamens.
POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ServiceBus/CheckNameAvailability?api-version=2024-01-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
subscription
|
path | True |
string |
Abonnementanmeldeinformationen, die ein Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf. |
api-version
|
query | True |
string minLength: 1 |
Die API-Version, die für diesen Vorgang verwendet werden soll. |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
name | True |
string |
Der Name, um die Verfügbarkeit des Namespacenamens zu überprüfen, und der Namespacename darf nur Buchstaben, Zahlen und Bindestriche enthalten. Der Namespace muss mit einem Buchstaben beginnen und muss mit einem Buchstaben oder einer Zahl enden. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die Verfügbarkeit wurde erfolgreich überprüft. |
|
Other Status Codes |
ServiceBus-Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Fluss
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
NameSpaceCheckNameAvailability
Beispielanforderung
Beispiel für eine Antwort
{
"nameAvailable": true,
"reason": "None",
"message": ""
}
Definitionen
Name | Beschreibung |
---|---|
Check |
Beschreibung der Eigenschaften der Verfügbarkeitsanforderung "Überprüfen". |
Check |
Beschreibung der Eigenschaften der Verfügbarkeitsanforderung "Überprüfen". |
Error |
Das Fehlerobjekt. |
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
Error |
Die Fehlerantwort für die Ressourcenverwaltung. |
Unavailable |
Gibt den Grund für die Nichtverfügbarkeit des Diensts an. |
CheckNameAvailability
Beschreibung der Eigenschaften der Verfügbarkeitsanforderung "Überprüfen".
Name | Typ | Beschreibung |
---|---|---|
name |
string |
Der Name, um die Verfügbarkeit des Namespacenamens zu überprüfen, und der Namespacename darf nur Buchstaben, Zahlen und Bindestriche enthalten. Der Namespace muss mit einem Buchstaben beginnen und muss mit einem Buchstaben oder einer Zahl enden. |
CheckNameAvailabilityResult
Beschreibung der Eigenschaften der Verfügbarkeitsanforderung "Überprüfen".
Name | Typ | Beschreibung |
---|---|---|
message |
string |
Die detaillierten Informationen zu dem Grund, der dem Namespace zugeordnet ist. |
nameAvailable |
boolean |
Wert, der angibt, dass namespace verfügbar ist, true, wenn der Namespace verfügbar ist; andernfalls "false". |
reason |
Der Grund für die Nichtverfügbarkeit eines Namespaces. |
Error
Das Fehlerobjekt.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Informationen des Fehlers. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorAdditionalInfo
Der Ressourcenverwaltungsfehler zusätzliche Informationen.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Die zusätzlichen Informationen. |
type |
string |
Der zusätzliche Informationstyp. |
ErrorResponse
Die Fehlerantwort für die Ressourcenverwaltung.
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
UnavailableReason
Gibt den Grund für die Nichtverfügbarkeit des Diensts an.
Wert | Beschreibung |
---|---|
InvalidName | |
NameInLockdown | |
NameInUse | |
None | |
SubscriptionIsDisabled | |
TooManyNamespaceInCurrentSubscription |