Compartilhar via


Query Keys - Create

Gera uma nova chave de consulta para o serviço de pesquisa especificado. Você 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 de URI

Nome Em Obrigatório Tipo Description
name
path True

string

O nome da nova chave de API de consulta.

resourceGroupName
path True

string

O nome do grupo de recursos na assinatura atual. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.

searchServiceName
path True

string

O nome do serviço de pesquisa associado ao grupo de recursos especificado.

subscriptionId
path True

string

O identificador exclusivo para uma assinatura do Microsoft Azure. Você pode obter esse valor da API de Resource Manager do Azure, das ferramentas de linha de comando ou do portal.

api-version
query True

string

A versão da API a ser usada para cada solicitação.

Cabeçalho da solicitação

Nome Obrigatório Tipo Description
x-ms-client-request-id

string

uuid

Um valor de GUID gerado pelo cliente que identifica esta solicitação. Se especificado, isso será incluído nas informações de resposta como uma maneira de acompanhar a solicitação.

Respostas

Nome Tipo Description
200 OK

QueryKey

A chave de consulta foi criada com êxito e está na resposta. Você pode usar a chave de consulta como o valor do parâmetro 'api-key' na API REST do plano de dados ou um SDK do Azure para executar operações somente leitura em seus índices de pesquisa, como consultar e pesquisar documentos por ID.

Other Status Codes

CloudError

HTTP 404 (Não Encontrado): não foi possível encontrar a assinatura, o grupo de recursos ou o serviço de pesquisa. HTTP 409 (Conflito): a assinatura especificada está desabilitada.

Segurança

azure_auth

Microsoft Entra ID fluxo de autorização OAuth2.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

SearchCreateQueryKey

Solicitação de exemplo

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/createQueryKey/Query key for browser-based clients?api-version=2023-11-01

Resposta de exemplo

{
  "name": "Query key for browser-based clients",
  "key": "<a query API key>"
}

Definições

Nome Description
CloudError

Contém informações sobre um erro de API.

CloudErrorBody

Descreve um erro de API específico com um código de erro e uma mensagem.

QueryKey

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.

Nome Tipo Description
error

CloudErrorBody

Descreve um erro de API específico com um código de erro e uma mensagem.

CloudErrorBody

Descreve um erro de API específico com um código de erro e uma mensagem.

Nome 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 status HTTP. Pode ser usado para lidar programaticamente com casos de erro específicos.

details

CloudErrorBody[]

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).

QueryKey

Descreve uma chave de API para um determinado serviço de pesquisa que tem permissões apenas para operações de consulta.

Nome Tipo Description
key

string

O valor da chave de API de consulta.

name

string

O nome da chave de API de consulta; pode estar vazio.