インデックスの削除 (Azure AI Search REST API)
インデックスの削除操作では、Azure AI Search Serviceからインデックスとその内容が完全に削除されます。 この操作は最終的な操作であり、回復オプションはありません。 再構築が必要になった場合に困らないように、インデックス定義コード、データ取り込みコード、外部データ ソースのバックアップのマスター コピーを必ず用意してください。
DELETE https://[service name].search.windows.net/indexes/[index name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
現在 エイリアスにマップされているインデックスを削除しようとすると、操作は 400 (無効な要求) で失敗し、インデックスを削除する前に、そのインデックスにマップされているエイリアスを削除するか、別のインデックスにマップする必要があることを示すエラー メッセージが表示されます。
URI パラメーター
| パラメーター | 説明 |
|---|---|
| サービス名 | 必須。 これを検索サービスの一意のユーザー定義名に設定します。 |
| インデックス名 | 必須。 要求 URI は、削除するインデックスの名前を指定します。 |
| api-version | 必須。 現在の安定バージョンは です api-version=2020-06-30。 その他 のバージョンについては、「API のバージョン 」を参照してください。 |
要求ヘッダー
次の表では、必須と省略可能の要求ヘッダーについて説明します。
| フィールド | 説明 |
|---|---|
| Content-Type | 必須。 これを application/json |
| api-key |
Azure ロールを使用していて、要求でベアラー トークンが提供されている場合は省略可能。それ以外の場合はキーが必要です。 api-key は、検索サービスに対する要求を認証する一意のシステム生成文字列です。 削除要求には、(クエリ キーではなく) 管理者キーに設定されたヘッダーを含める api-key 必要があります。 詳細については、「 キー認証を使用して Azure AI Search に接続 する」を参照してください。 |
要求本文
[なし] :
Response
状態コード: 応答の成功に対して「204 コンテンツがありません」が返されます。