Códigos de status HTTP (Azure AI Search)
Esta página descreve os códigos de status HTTP que são frequentemente retornados ao usar a API de Pesquisa de IA do Azure.
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 duramente e começarão a ser indexados. A indexação é executada em segundo plano e torna os 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 contém 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, marcar a sintaxe e verifique se o nome do índice está especificado corretamente. |
| Método 405 sem suporte | Retornado quando a solicitação especifica um método reconhecido, mas sem suporte. Se você estiver consultando um índice, a formulação dessa solicitação incluirá o ponto de extremidade, a coleção de índices e o índice e a coleção docs e o método de pesquisa (por exemplo, https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2020-06-30). |
| 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. O Azure AI Search fornece gerenciamento de simultaneidade para atualizações de recursos. Para obter mais informações, consulte Como gerenciar a simultaneidade no Azure AI 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 seu tipo de preço. Uma contagem dos índices armazenados no Azure AI Search é visível no serviço de pesquisa dashboard no portal do Azure. Para exibir os índices por nome, selecione o bloco Índice . Como alternativa, você também pode obter uma lista dos índices por nome usando a operação Listar Índices . 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 que uma resposta fosse retornada pelo serviço. Quando o Azure AI 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. Consulte Analisar o desempenho para obter mais informações sobre limitação e como evitar essa condição. |
| 504: Tempo limite do gateway | O Azure AI Search escuta na porta HTTPS 443. Se a URL do serviço de pesquisa contiver HTTP em vez de HTTPS, um código 504 status será retornado. |