Query Keys - Create
Gera uma nova chave de consulta para o serviço de pesquisa especificado. Pode criar até 50 chaves de consulta por serviço.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/createQueryKey/{name}?api-version=2023-11-01
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
name
|
path | True |
string |
O nome da nova chave de API de consulta. |
resource
|
path | True |
string |
O nome do grupo de recursos na subscrição atual. Pode obter este valor a partir da API do Azure Resource Manager ou do portal. |
search
|
path | True |
string |
O nome do serviço de pesquisa associado ao grupo de recursos especificado. |
subscription
|
path | True |
string |
O identificador exclusivo de uma subscrição do Microsoft Azure. Pode obter este valor a partir da API de Resource Manager do Azure, das ferramentas de linha de comandos ou do portal. |
api-version
|
query | True |
string |
A versão da API a utilizar para cada pedido. |
Cabeçalho do Pedido
Name | Necessário | Tipo | Description |
---|---|---|---|
x-ms-client-request-id |
string uuid |
Um valor GUID gerado pelo cliente que identifica este pedido. Se for especificado, isto será incluído nas informações de resposta como forma de controlar o pedido. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
A chave de consulta foi criada com êxito e está na resposta. Pode utilizar a chave de consulta como o valor do parâmetro "api-key" na API REST do plano de dados ou num SDK do Azure para realizar operações só de leitura nos índices de Pesquisa, como consultar e procurar documentos por ID. |
|
Other Status Codes |
HTTP 404 (Não Encontrado): não foi possível localizar a subscrição, o grupo de recursos ou o serviço de pesquisa. HTTP 409 (Conflito): a subscrição especificada está desativada. |
Segurança
azure_auth
Microsoft Entra ID fluxo de autorização OAuth2.
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
Name | Description |
---|---|
user_impersonation | representar a sua conta de utilizador |
Exemplos
SearchCreateQueryKey
Pedido de amostra
Resposta da amostra
{
"name": "Query key for browser-based clients",
"key": "<a query API key>"
}
Definições
Name | Description |
---|---|
Cloud |
Contém informações sobre um erro de API. |
Cloud |
Descreve um erro específico da API com um código de erro e uma mensagem. |
Query |
Descreve uma chave de API para um determinado serviço de pesquisa que tem permissões apenas para operações de consulta. |
CloudError
Contém informações sobre um erro de API.
Name | Tipo | Description |
---|---|---|
error |
Descreve um erro específico da API com um código de erro e uma mensagem. |
CloudErrorBody
Descreve um erro específico da API com um código de erro e uma mensagem.
Name | Tipo | Description |
---|---|---|
code |
string |
Um código de erro que descreve a condição de erro com mais precisão do que um código de estado HTTP. Pode ser utilizado para processar programaticamente casos de erro específicos. |
details |
Contém erros aninhados relacionados com este erro. |
|
message |
string |
Uma mensagem que descreve o erro em detalhe e fornece informações de depuração. |
target |
string |
O destino do erro específico (por exemplo, o nome da propriedade em erro). |
QueryKey
Descreve uma chave de API para um determinado serviço de pesquisa que tem permissões apenas para operações de consulta.
Name | Tipo | Description |
---|---|---|
key |
string |
O valor da chave da API de consulta. |
name |
string |
O nome da chave da API de consulta; pode estar vazio. |