Códigos de estado HTTP (Azure AI Search)
Esta página descreve os códigos de estado HTTP que são frequentemente devolvidos ao utilizar a API de Pesquisa de IA do Azure.
Códigos de estado HTTP comuns
| Código | Descrição |
|---|---|
| 200 OK | Êxito em GET, PUT ou POST. Devolvido para obter uma resposta bem-sucedida. Durante a indexação, este código indica que todos os itens foram armazenados de forma duradoura e começarão a ser indexados. A indexação é executada em segundo plano e torna os novos documentos que podem ser consultados e pesquisáveis alguns segundos após a conclusão da operação de indexação. |
| 201 Criado | Êxito em PUT ou POST. Objeto criado ou atualizado com êxito. |
| 204 Aceite | Êxito em PUT ou POST. Índice ou documentos carregados com êxito. |
| 207 Multi-Status | Êxito parcial para PUT ou POST. Alguns documentos foram bem-sucedidos, mas pelo menos um falhou. |
| 400 Pedido Incorreto | Devolvido quando existe um erro no URI do pedido, nos cabeçalhos ou no corpo. O corpo da resposta contém uma mensagem de erro a explicar qual é o problema específico. |
| 403 Proibido | Devolvido quando transmite uma chave de API inválida. |
| 404 Não Encontrado | Devolvido quando um recurso não existe no servidor. Se estiver a gerir ou a consultar um índice, verifique a sintaxe e verifique se o nome do índice está especificado corretamente. |
| Método 405 Não Suportado | Devolvido quando o pedido especifica um método que é reconhecido, mas não suportado. Se estiver a consultar um índice, a formulação desse pedido inclui o ponto final, a coleção e o índice de índices, a coleção de documentos e o método de pesquisa (por exemplo, https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2020-06-30). |
| 409 Conflito | Devolvido quando as operações de escrita entram em conflito. Este erro é devolvido para atualizações de recursos ou durante a indexação quando dois processos tentam atualizar o mesmo documento em simultâneo. O Azure AI Search fornece gestão de simultaneidade para atualizações de recursos. Para obter mais informações, veja Como gerir a simultaneidade no Azure AI Search. |
| Falha na Pré-condição 412 | Devolvido quando uma condição de cabeçalho de If-Match ou If-None-Match é avaliada como falsa. Associado à utilização do controlo de simultaneidade otimista ao enviar pedidos HTTP para definições de índice, indexadores ou origens de dados. |
| Demasiados Pedidos 429 | Se este erro ocorrer enquanto tenta criar um índice, significa que já tem o número máximo de índices permitido para o escalão de preço. É visível uma contagem dos índices armazenados no Azure AI Search no dashboard do serviço de pesquisa no portal do Azure. Para ver os índices por nome, selecione o mosaico Índice . Em alternativa, também pode obter uma lista dos índices por nome através da operação Índices de Lista . Veja Índices de Lista para obter detalhes.
Se este erro ocorrer durante o carregamento do documento, significa que excedeu a quota no número de documentos por índice. Tem de criar um novo índice ou atualizar para limites de capacidade mais elevados. |
| 499 Pedido Fechado do Cliente | Este erro nunca é devolvido numa resposta, mas poderá vê-lo em entradas de registo registadas pela análise de tráfego de pesquisa e pelo Azure Monitor. Indica que um cliente fechou a ligação antes de uma resposta ser devolvida pelo serviço. Quando o Azure AI Search deteta um cancelamento que não foi pedido pelo código do lado do serviço ou que o cliente já não existe, é registado um erro 499. |
| 502 Gateway Incorreto | Este erro ocorre quando introduz HTTP em vez de HTTPS na ligação. |
| 503 Serviço Indisponível | Este erro significa que o sistema está com muita carga e não é possível processar o pedido neste momento. Importante: Neste caso, recomendamos vivamente que o código do cliente se desative e aguarde antes de tentar novamente. Isto irá dar ao sistema algum tempo para recuperar, aumentando a possibilidade de êxito de pedidos futuros. Ao repetir rapidamente os seus pedidos só irá prolongar a situação. Veja Analisar o desempenho para obter mais informações sobre limitação e como impedir esta condição. |
| 504: Tempo Limite do Gateway | O Azure AI Search escuta na porta HTTPS 443. Se o URL do serviço de pesquisa contiver HTTP em vez de HTTPS, é devolvido um código de estado 504. |