Query Keys - Delete
指定したクエリ キーを削除します。 管理者キーとは異なり、クエリ キーは再生成されません。 クエリ キーを再生成するプロセスは、削除してから再作成することです。
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/deleteQueryKey/{key}?api-version=2025-02-01-previewURI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
key
|
path | True |
string |
削除するクエリ キー。 クエリ キーは、名前ではなく値によって識別されます。 |
|
resource
|
path | True |
string |
現在のサブスクリプション内のリソース グループの名前。 この値は、Azure Resource Manager API またはポータルから取得できます。 |
|
search
|
path | True |
string pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$ |
指定したリソース グループに関連付けられている Azure AI Search サービスの名前。 |
|
subscription
|
path | True |
string |
Microsoft Azure サブスクリプションの一意識別子。 この値は、Azure Resource Manager API またはポータルから取得できます。 |
|
api-version
|
query | True |
string |
各要求に使用する API バージョン。 |
要求ヘッダー
| 名前 | 必須 | 型 | 説明 |
|---|---|---|---|
| x-ms-client-request-id |
string (uuid) |
この要求を識別するクライアントによって生成される GUID 値。 指定した場合、これは要求を追跡する方法として応答情報に含まれます。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
クエリ キーが正常に削除されました。 |
|
| 204 No Content |
クエリ キーが正常に削除されました。 |
|
| 404 Not Found |
サブスクリプション、リソース グループ、検索サービス、またはクエリ キーが見つかりませんでした。 |
|
| Other Status Codes |
HTTP 409 (競合): 指定されたサブスクリプションが無効になっています。 |
セキュリティ
azure_auth
Microsoft ID プラットフォームでサポートされている暗黙的な許可フローを指定します。
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
| 名前 | 説明 |
|---|---|
| user_impersonation | ユーザー アカウントを偽装する |
例
SearchDeleteQueryKey
要求のサンプル
DELETE https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/deleteQueryKey/<a query API key>?api-version=2025-02-01-preview
応答のサンプル
定義
| 名前 | 説明 |
|---|---|
|
Cloud |
API エラーに関する情報が含まれています。 |
|
Cloud |
エラー コードとメッセージを含む特定の API エラーについて説明します。 |
CloudError
API エラーに関する情報が含まれています。
| 名前 | 型 | 説明 |
|---|---|---|
| error |
エラー コードとメッセージを含む特定の API エラーについて説明します。 |
|
| message |
string |
問題の原因を示すエラーの簡単な説明 (詳細/デバッグ情報については、'error.message' プロパティを参照してください)。 |
CloudErrorBody
エラー コードとメッセージを含む特定の API エラーについて説明します。
| 名前 | 型 | 説明 |
|---|---|---|
| code |
string |
HTTP 状態コードよりも正確にエラー状態を記述するエラー コード。 特定のエラー ケースをプログラムで処理するために使用できます。 |
| details |
このエラーに関連する入れ子になったエラーが含まれています。 |
|
| message |
string |
エラーの詳細を説明し、デバッグ情報を提供するメッセージ。 |
| target |
string |
特定のエラーのターゲット (たとえば、エラーのプロパティの名前)。 |