Query Keys - Delete
Exclui a chave de consulta especificada. Ao contrário das chaves de administrador, as chaves de consulta não são regeneradas. O processo para regenerar uma chave de consulta é excluí-la e, em seguida, recriá-la. Retorna 200 (OK) na eliminação bem-sucedida, 204 (Sem Conteúdo) se o serviço existir mas as chaves de consulta não forem encontradas, ou 404 (Não Encontrado) se o serviço não for encontrado. NOTA: O comportamento de devolver o 404 é inconsistente com as diretrizes do ARM. Os clientes devem esperar uma resposta 204 em versões futuras e evitar novas dependências da resposta 404.
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/deleteQueryKey/{key}?api-version=2025-05-01
Parâmetros do URI
| Name | Em | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
key
|
path | True |
string |
A chave de consulta a ser excluída. As chaves de consulta são identificadas por valor, não por nome. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
search
|
path | True |
string pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$ |
O nome do serviço Azure AI Search associado ao grupo de recursos especificado. |
|
subscription
|
path | True |
string (uuid) |
A ID da assinatura de destino. O valor deve ser um UUID. |
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a utilizar para esta operação. |
Cabeçalho do Pedido
| Name | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| x-ms-client-request-id |
string (uuid) |
Um valor GUID gerado pelo cliente que identifica essa solicitação. Se especificado, isso será incluído nas informações de resposta como uma forma de rastrear a solicitação. |
Respostas
| Name | Tipo | Descrição |
|---|---|---|
| 200 OK |
O pedido foi bem-sucedido. |
|
| 204 No Content |
Não há conteúdo para enviar para esta solicitação, mas os cabeçalhos podem ser úteis. |
|
| 404 Not Found |
O servidor não consegue encontrar o recurso solicitado. |
|
| Other Status Codes |
Uma resposta de erro inesperada. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory.
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
| Name | Descrição |
|---|---|
| user_impersonation | personificar a sua conta de utilizador |
Exemplos
SearchDeleteQueryKey
Pedido de amostra
Resposta da amostra
Definições
| Name | Descrição |
|---|---|
|
Cloud |
Contém informações sobre um erro de API. |
|
Cloud |
Descreve um erro de API específico com um código de erro e uma mensagem. |
CloudError
Contém informações sobre um erro de API.
| Name | Tipo | Descrição |
|---|---|---|
| error |
Descreve um erro de API específico com um código de erro e uma mensagem. |
|
| message |
string |
Uma breve descrição do erro que sugere o que deu errado (para obter detalhes/informações de depuração, consulte a propriedade 'error.message'). |
CloudErrorBody
Descreve um erro de API específico com um código de erro e uma mensagem.
| Name | Tipo | Descrição |
|---|---|---|
| code |
string |
Um código de erro que descreve a condição de erro com mais precisão do que um código de status HTTP. Pode ser usado para lidar programaticamente com casos de erro específicos. |
| details |
Contém erros aninhados relacionados a esse erro. |
|
| message |
string |
Uma mensagem que descreve o erro em detalhes e fornece informações de depuração. |
| target |
string |
O destino do erro específico (por exemplo, o nome da propriedade em erro). |