Query Keys - List By Search Service

傳回指定搜尋服務的查詢 API 金鑰清單。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/listQueryKeys?api-version=2023-11-01

URI 參數

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

string

目前訂用帳戶內的資源組名。 您可以從 Azure 資源管理員 API 或入口網站取得這個值。

searchServiceName
path True

string

與指定資源群組相關聯的搜尋服務名稱。

subscriptionId
path True

string

Microsoft Azure 訂用帳戶的唯一標識符。 您可以從 Azure Resource Manager API、命令行工具或入口網站取得此值。

api-version
query True

string

要用於每個要求的 API 版本。

要求標頭

名稱 必要 類型 Description
x-ms-client-request-id

string

uuid

用戶端產生之可識別此要求的 GUID 值。 如果指定,回應資訊中將會包含此專案,以追蹤要求的方式。

回應

名稱 類型 Description
200 OK

ListQueryKeysResult

已成功擷取指定搜尋服務的所有查詢索引鍵,且在回應中。 您可以使用任何查詢索引鍵作為數據平面 REST API 或 Azure SDK 中 'api-key' 參數的值,在搜尋索引的檔集合上執行只讀作業,例如依標識符查詢和查閱檔。

Other Status Codes

CloudError

找不到 HTTP 404 () :找不到訂用帳戶、資源群組或搜尋服務。 HTTP 409 (衝突) :指定的訂用帳戶已停用。

安全性

azure_auth

Microsoft Entra ID OAuth2 授權流程。

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

Scopes

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

範例

SearchListQueryKeysBySearchService

Sample Request

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/listQueryKeys?api-version=2023-11-01

Sample Response

{
  "value": [
    {
      "name": "Query key for browser-based clients",
      "key": "<a query API key>"
    },
    {
      "name": "Query key for mobile clients",
      "key": "<another query API key>"
    }
  ]
}

定義

名稱 Description
CloudError

包含 API 錯誤的相關信息。

CloudErrorBody

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

ListQueryKeysResult

包含指定搜尋服務的查詢 API 金鑰的回應。

QueryKey

描述具有查詢作業許可權之指定搜尋服務的 API 金鑰。

CloudError

包含 API 錯誤的相關信息。

名稱 類型 Description
error

CloudErrorBody

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

CloudErrorBody

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

名稱 類型 Description
code

string

描述錯誤狀況的錯誤碼,比 HTTP 狀態代碼更精確。 可用來以程式設計方式處理特定錯誤案例。

details

CloudErrorBody[]

包含與此錯誤相關的巢狀錯誤。

message

string

描述錯誤的詳細訊息,並提供偵錯資訊。

target

string

例如,特定錯誤的目標 (,錯誤) 中的屬性名稱。

ListQueryKeysResult

包含指定搜尋服務的查詢 API 金鑰的回應。

名稱 類型 Description
nextLink

string

可用來查詢下一頁查詢索引鍵的要求 URL。 當要求的查詢索引鍵總數超過頁面大小上限時傳回。

value

QueryKey[]

搜尋服務的查詢索引鍵。

QueryKey

描述具有查詢作業許可權之指定搜尋服務的 API 金鑰。

名稱 類型 Description
key

string

查詢 API 金鑰的值。

name

string

查詢 API 金鑰的名稱;可能是空的。