Services - Check Name Availability

服務:: Search Management

API 版本:: 2025-05-01

檢查指定的搜尋服務名稱是否可供使用。搜索服務名稱必須是全域唯一的，因為它們是服務 URI （https:// name.search.windows.net<>）的一部分。

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

URI 參數

名稱	位於	必要	類型	Description
subscriptionId	path	True	string (uuid)	目標訂用帳戶的標識碼。此值必須是 UUID。
api-version	query	True	string minLength: 1	用於此作業的 API 版本。

要求標頭

名稱	必要	類型	Description
x-ms-client-request-id		string (uuid)	用戶端產生的 GUID 值，可識別此要求。如果指定，則會以追蹤要求的方式包含在響應資訊中。

要求本文

名稱	必要	類型	Description
name	True	string	要驗證的搜尋服務名稱。搜尋服務名稱必須只包含小寫字母、數位或破折號，不能使用虛線做為前兩個或最後一個字元、不能包含連續連字元，而且長度必須介於 2 到 60 個字元之間。
type	True	enum: searchServices	要驗證其名稱的資源類型。此值一律必須是『searchServices』。

回應

名稱	類型	Description
200 OK	CheckNameAvailabilityOutput	要求已成功。
Other Status Codes	CloudError	未預期的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

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

範圍

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

範例

SearchCheckNameAvailability

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Search/checkNameAvailability?api-version=2025-05-01

{
  "name": "mysearchservice",
  "type": "searchServices"
}

package armsearch_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/search/armsearch/v2"
)

// Generated from example definition: 2025-05-01/SearchCheckNameAvailability.json
func ExampleServicesClient_CheckNameAvailability() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armsearch.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewServicesClient().CheckNameAvailability(ctx, armsearch.CheckNameAvailabilityInput{
		Name: to.Ptr("mysearchservice"),
		Type: to.Ptr("searchServices"),
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armsearch.ServicesClientCheckNameAvailabilityResponse{
	// 	CheckNameAvailabilityOutput: &armsearch.CheckNameAvailabilityOutput{
	// 		Message: to.Ptr(""),
	// 		IsNameAvailable: to.Ptr(false),
	// 		Reason: to.Ptr(armsearch.UnavailableNameReasonAlreadyExists),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

範例回覆

狀態碼:: 200

{
  "message": "",
  "nameAvailable": false,
  "reason": "AlreadyExists"
}

定義

名稱	Description
CheckNameAvailabilityInput	檢查名稱可用性 API 的輸入。
CheckNameAvailabilityOutput	檢查名稱可用性 API 的輸出。
CloudError	包含 API 錯誤的相關信息。
CloudErrorBody	描述具有錯誤碼和訊息的特定 API 錯誤。
UnavailableNameReason	名稱無法使用的原因。 'Invalid' 表示所提供的名稱不符合命名需求（長度不正確、不支援的字元等）。 'AlreadyExists' 表示名稱已在使用中，因此無法使用。

CheckNameAvailabilityInput

Object

檢查名稱可用性 API 的輸入。

名稱	類型	Description
name	string	要驗證的搜尋服務名稱。搜尋服務名稱必須只包含小寫字母、數位或破折號，不能使用虛線做為前兩個或最後一個字元、不能包含連續連字元，而且長度必須介於 2 到 60 個字元之間。
type	enum: searchServices	要驗證其名稱的資源類型。此值一律必須是『searchServices』。

CheckNameAvailabilityOutput

Object

檢查名稱可用性 API 的輸出。

名稱	類型	Description
message	string	訊息，說明名稱無效的原因，並提供資源命名需求。只有在『reason』屬性中傳回 'Invalid' 時才可使用。
nameAvailable	boolean	值，指出名稱是否可用。
reason	UnavailableNameReason	名稱無法使用的原因。 'Invalid' 表示所提供的名稱不符合命名需求（長度不正確、不支援的字元等）。 'AlreadyExists' 表示名稱已在使用中，因此無法使用。

CloudError

Object

包含 API 錯誤的相關信息。

名稱	類型	Description
error	CloudErrorBody	描述具有錯誤碼和訊息的特定 API 錯誤。
message	string	錯誤簡短描述，其中提示發生錯誤的原因（如需詳細數據/偵錯資訊，請參閱 'error.message' 屬性。

CloudErrorBody

Object

描述具有錯誤碼和訊息的特定 API 錯誤。

名稱	類型	Description
code	string	比 HTTP 狀態代碼更精確地描述錯誤條件的錯誤碼。可用來以程式設計方式處理特定錯誤案例。
details	CloudErrorBody[]	包含與此錯誤相關的巢狀錯誤。
message	string	描述錯誤的詳細訊息，並提供偵錯資訊。
target	string	特定錯誤的目標（例如，錯誤中的屬性名稱）。

UnavailableNameReason

列舉型別

名稱無法使用的原因。 'Invalid' 表示所提供的名稱不符合命名需求（長度不正確、不支援的字元等）。 'AlreadyExists' 表示名稱已在使用中，因此無法使用。

值	Description
Invalid	搜尋服務名稱不符合命名需求。
AlreadyExists	搜尋服務名稱已指派給不同的搜尋服務。