Códigos de status HTTP (Azure Cognitive Search)
Esta página descreve os códigos de status HTTP que são frequentemente retornados ao usar a API Azure Cognitive Search.
Códigos de status HTTP comuns
| Código | Descrição |
|---|---|
| 200 OK | Sucesso em GET, PUT ou POST. Retornado para uma resposta bem-sucedida. Durante a indexação, esse código indica que todos os itens foram armazenados com durabilidade e começarão a ser indexados. A indexação é executada em segundo plano e torna novos documentos consultáveis e pesquisáveis alguns segundos após a conclusão da operação de indexação. |
| 201 Criado | Sucesso em PUT ou POST. Objeto criado ou atualizado com êxito. |
| 204 Aceito | Sucesso em PUT ou POST. Índice ou documentos carregados com êxito. |
| 207 Status múltiplo | Êxito parcial para PUT ou POST. Alguns documentos foram bem-sucedidos, mas houve pelo menos uma falha. |
| 400 Solicitação Inválida | Retornado quando há um erro no URI, cabeçalhos ou corpo da solicitação. O corpo da resposta conterá uma mensagem de erro explicando qual é o problema específico. |
| 403 Proibido | Retornado quando você passa uma chave de API inválida. |
| 404 Não Encontrado | Retornado quando um recurso não existe no servidor. Se você estiver gerenciando ou consultando um índice, verifique a sintaxe e verifique se o nome do índice foi especificado corretamente. |
| 409 Conflito | Retornado quando as operações de gravação entram em conflito. Esse erro é retornado para atualizações de recursos ou durante a indexação quando dois processos tentam atualizar o mesmo documento simultaneamente. Azure Cognitive Search fornece gerenciamento de simultaneidade para atualizações de recursos. Para obter mais informações, consulte Como gerenciar a simultaneidade em Azure Cognitive Search. |
| 412 Falha na Pré-condição | Retornado quando uma If-Match ou a condição do cabeçalho If-None-Match é avaliada como false. Associado ao uso de controle de simultaneidade otimista ao enviar solicitações HTTP para definições de índice, indexadores ou fontes de dados. |
| 429 Número excessivo de solicitações | Se esse erro ocorrer enquanto você estiver tentando criar um índice, isso significa que você já tem o número máximo de índices permitidos para a faixa de preço. Uma contagem dos índices armazenados em Azure Cognitive Search fica visível no painel do serviço de pesquisa no portal do Azure. Para exibir os índices por nome, clique no bloco do Índice. Como alternativa, você também pode obter uma lista dos índices por nome usando a operação Índices de Lista . Consulte Listar índices para obter detalhes. Se esse erro ocorrer durante o upload do documento, ele indicará que você excedeu sua cota no número de documentos por índice. Você deve criar um novo índice ou atualizar para limites de capacidade mais altos. |
| 499 Solicitação Fechada do Cliente | Esse erro nunca é retornado em uma resposta, mas você pode vê-lo em entradas de log registradas pela análise de tráfego de pesquisa e pelo Azure Monitor. Indica que um cliente fechou a conexão antes de uma resposta ser retornada pelo serviço. Quando Azure Cognitive Search detecta um cancelamento que não foi solicitado pelo código do lado do serviço ou que o cliente não existe mais, um erro 499 é registrado. |
| 502 Gateway Incorreto | Esse erro ocorre quando você insere HTTP em vez de HTTPS na conexão. |
| 503 Serviço Indisponível | Esse erro significa que o sistema está sob carga pesada e sua solicitação não pode ser processada no momento. Importante: Nesse caso, é altamente recomendável que o código do cliente recue e aguarde antes de tentar novamente. Isso dará ao sistema algum tempo para se recuperar, aumentando as chances de que solicitações futuras sejam bem-sucedidas. Se você repetir rapidamente as solicitações, isso apenas prolongará a situação. |
| 504: Tempo limite do gateway | Azure Cognitive Search escuta na porta HTTPS 443. Se a URL do serviço de pesquisa contiver HTTP em vez de HTTPS, um código de status 504 será retornado. |