共用方式為


Check Name Availability - Namespaces - Check Name Availability

檢查提供命名空間名稱可用性。

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

URI 參數

名稱 位於 必要 類型 Description
subscriptionId
path True

string

可唯一識別 Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶識別碼會構成每個服務呼叫 URI 的一部分。

api-version
query True

string

用戶端 API 版本。

要求本文

名稱 必要 類型 Description
name True

string

檢查命名空間名稱可用性的名稱

回應

名稱 類型 Description
200 OK

CheckNameAvailabilityResult

檢查成功傳回的可用性。

Other Status Codes

ErrorResponse

Eventhub 錯誤回應,描述作業失敗的原因。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
user_impersonation 模擬您的用戶帳戶

範例

NamespacesCheckNameAvailability

範例要求

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

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

範例回覆

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

定義

名稱 Description
CheckNameAvailabilityParameter

提供以檢查命名空間名稱可用性作業的參數

CheckNameAvailabilityResult

CheckNameAvailability 作業的結果

ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorDetail

錯誤詳細數據。

ErrorResponse

錯誤回應指出事件中樞服務無法處理傳入要求。 錯誤訊息中提供了原因。

UnavailableReason

指定服務無法使用的原因。

CheckNameAvailabilityParameter

提供以檢查命名空間名稱可用性作業的參數

名稱 類型 Description
name

string

檢查命名空間名稱可用性的名稱

CheckNameAvailabilityResult

CheckNameAvailability 作業的結果

名稱 類型 Description
message

string

與命名空間相關聯的原因詳細資訊。

nameAvailable

boolean

指出 Namespace 為可用性的值,如果命名空間可用,則為 true;否則為 false。

reason

UnavailableReason

命名空間無法使用的原因。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。

type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳細資料。

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應指出事件中樞服務無法處理傳入要求。 錯誤訊息中提供了原因。

名稱 類型 Description
error

ErrorDetail

error 物件。

UnavailableReason

指定服務無法使用的原因。

名稱 類型 Description
InvalidName

string

NameInLockdown

string

NameInUse

string

None

string

SubscriptionIsDisabled

string

TooManyNamespaceInCurrentSubscription

string