Compartilhar via

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.
201 - criada Êxito em PUT ou POST. Objeto criado com êxito.
202 Aceito Êxito em PUT ou POST. Esse código de status é retornado para solicitações de indexador de execução.
204 Sem Conteúdo Êxito em PUT ou POST. Uma atualização foi bem-sucedida, mas não há informações a serem retornadas na resposta.
207 Multi-Status Êxito parcial para PUT ou POST. Alguns documentos foram bem-sucedidos, mas pelo menos um falhou.
400 Solicitação Inválida Retornado quando há um erro no URI da solicitação, cabeçalhos ou corpo. O corpo da resposta contém uma mensagem de erro explicando qual é o problema específico.
401 Não autorizado Retornado quando as credenciais estão ausentes. Se você estiver usando o controle de acesso baseado em função, você ou o serviço de pesquisa não têm uma atribuição de função. Para obter problemas ao acessar o Azure AI Search, consulte Conectar-se ao Azure AI Search usando funções. Para obter mais informações sobre conexões de pesquisa com outros recursos, consulte Configurar um serviço de pesquisa para se conectar usando uma identidade gerenciada.
403 Proibido Retornado quando a autorização falha.
404 Não Encontrado Retornado quando um recurso não existe no servidor.
Método 405 sem suporte Retornado quando o serviço reconhece um método sem suporte. Se você estiver consultando um índice, a formulação dessa solicitação inclui o ponto de extremidade, a coleção de índices e o índice e a coleção de documentos e o método de pesquisa (por exemplo, https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2024-07-01).
409 Conflito Retornado quando as operações de gravação entram em conflito. Esse código de status é 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 condição de cabeçalho If-Match ou 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, conjuntos de habilidades ou fontes de dados.
429 Número excessivo de solicitações Se você receber esse código de status durante a criação do objeto, isso significa que você tem o número máximo de objetos permitidos para a camada de serviço. Se você receber esse código de erro em um índice ativo, isso geralmente significa que você está com pouco armazenamento. À medida que você se aproxima dos limites de armazenamento, o serviço pode inserir um estado em que você não pode adicionar ou atualizar até que você exclua alguns documentos. Para obter mais informações, consulte Planejar e gerenciar a capacidade se você quiser mais armazenamento ou Atualizar conteúdo se quiser liberar espaço excluindo documentos.
Solicitação fechada do cliente 499 Esse código de status 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 499 é registrado.
502 Gateway Incorreto Esse código de status ocorre quando você insere HTTP em vez de HTTPS na conexão.
Serviço 503 indisponível Esse código de status significa que o sistema está sob carga pesada e sua solicitação não pode ser processada. As mitigações incluem a adição de tempos de espera a qualquer lógica de repetição ou aumento da capacidade. Os serviços mais recentes vêm com mais capacidade de armazenamento e computação automaticamente. Para obter mais informações sobre ajuste de desempenho, consulte Analisar o desempenho no Azure AI Search.
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 de status 504 será retornado.

Consulte também