Query Keys - Delete
Elimina la clave de consulta especificada. A diferencia de las claves de administración, las claves de consulta no se vuelven a generar. El proceso para volver a generar una clave de consulta es eliminarla y volver a crearla.
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/deleteQueryKey/{key}?api-version=2025-02-01-previewParámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
key
|
path | True |
string |
Clave de consulta que se va a eliminar. Las claves de consulta se identifican por valor, no por nombre. |
|
resource
|
path | True |
string |
Nombre del grupo de recursos dentro de la suscripción actual. Puede obtener este valor desde la API de Azure Resource Manager o el portal. |
|
search
|
path | True |
string pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$ |
Nombre del servicio Azure AI Search asociado al grupo de recursos especificado. |
|
subscription
|
path | True |
string |
Identificador único de una suscripción de Microsoft Azure. Puede obtener este valor desde la API de Azure Resource Manager o el portal. |
|
api-version
|
query | True |
string |
Versión de la API que se va a usar para cada solicitud. |
Encabezado de la solicitud
| Nombre | Requerido | Tipo | Description |
|---|---|---|---|
| x-ms-client-request-id |
string (uuid) |
Valor GUID generado por el cliente que identifica esta solicitud. Si se especifica, se incluirá en la información de respuesta como una manera de realizar un seguimiento de la solicitud. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
La clave de consulta se eliminó correctamente. |
|
| 204 No Content |
La clave de consulta se eliminó correctamente. |
|
| 404 Not Found |
No se encontró la suscripción, el grupo de recursos, el servicio de búsqueda o la clave de consulta. |
|
| Other Status Codes |
HTTP 409 (Conflicto): la suscripción especificada está deshabilitada. |
Seguridad
azure_auth
Especifica un flujo de concesión implícito, como se admite en la plataforma de identidad de Microsoft.
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
| Nombre | Description |
|---|---|
| user_impersonation | suplantar la cuenta de usuario |
Ejemplos
SearchDeleteQueryKey
Solicitud de ejemplo
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
Respuesta de muestra
Definiciones
| Nombre | Description |
|---|---|
|
Cloud |
Contiene información sobre un error de API. |
|
Cloud |
Describe un error de API determinado con un código de error y un mensaje. |
CloudError
Contiene información sobre un error de API.
| Nombre | Tipo | Description |
|---|---|---|
| error |
Describe un error de API determinado con un código de error y un mensaje. |
|
| message |
string |
Una breve descripción del error que indica lo que salió mal (para obtener detalles o información de depuración, consulte la propiedad "error.message"). |
CloudErrorBody
Describe un error de API determinado con un código de error y un mensaje.
| Nombre | Tipo | Description |
|---|---|---|
| code |
string |
Código de error que describe la condición de error más precisamente que un código de estado HTTP. Se puede usar para controlar mediante programación casos de error específicos. |
| details |
Contiene errores anidados relacionados con este error. |
|
| message |
string |
Mensaje que describe el error con detalle y proporciona información de depuración. |
| target |
string |
Destino del error concreto (por ejemplo, el nombre de la propiedad en error). |