Partilhar via

Códigos de status HTTP (Azure AI Search)

Esta página descreve os códigos de status HTTP que são retornados com freqüência ao usar as APIs REST do Azure AI 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.
201 Criado Sucesso em PUT ou POST. Objeto criado com êxito.
202 Aceito Sucesso em PUT ou POST. Esse código de status é retornado para executar solicitações de indexador.
204 Sem Conteúdo Sucesso em PUT ou POST. Uma atualização foi bem-sucedida, mas não há informações a serem retornadas na resposta.
206 Conteúdo parcial Sucesso parcial em GET ou POST para recuperação de base de dados de conhecimento em fluxos de trabalho de recuperação de agentes. Retornado quando a solicitação foi bem-sucedida, mas certos componentes não críticos do processo de recuperação ou classificação falharam, levando a resultados incompletos ou classificações que podem não refletir a pontuação de relevância total.
207 Multi-Estado Sucesso parcial em PUT ou POST. Alguns documentos tiveram sucesso, mas pelo menos um falhou.
400 Pedido Inválido 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.
401 Não autorizado Retornado quando as credenciais estão faltando. Se você estiver usando o controle de acesso baseado em função, você ou o serviço de pesquisa não terão uma atribuição de função. Para 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.
402 Pagamento Necessário Retornado quando a alocação mensal de solicitações de classificação semântica livre estiver esgotada. Você também pode ver este erro: "Uso semântico de consulta livre excedido para o mês. Habilite a cobrança semântica para continuar usando a pesquisa https://aka.ms/SemanticPriceDocPage"semântica ;. Para resolver o erro, mude do plano gratuito para o faturamento padrão.
403 Proibido Retornado quando a autorização falhar.
404 Não encontrado Retornado quando um recurso não existe no servidor.
Método 405 não suportado Retornado quando o serviço reconhece um método 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=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 simultaneidade no Azure AI Search.
412 Falha na pré-condição Retornado quando a condição de um 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.
415 Tipo de mídia não suportado Este erro pode ocorrer se estiveres a usar CURL ou ações de linha de comandos para passar JSON numa definição de objeto ou pedido, e o cabeçalho do pedido não especificar um tipo de conteúdo de aplicação/json. Para CURL, se usares a -d flag (que por defeito é x-www-form-urlencoded), podes substituir essa flag pela --json flag (que por defeito é application/json), ou adicionar a -H "Content-Type: application/json".
Demasiados Pedidos 429 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 permitido para sua 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 entrar em um estado em que você não pode adicionar ou atualizar até excluir alguns documentos. Para obter mais informações, consulte Planejar e gerenciar a capacidade se quiser mais armazenamento ou Atualizar conteúdo se quiser liberar espaço excluindo documentos.
499 Pedido Fechado do Cliente 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. Ele indica que um cliente fechou a conexão antes que uma resposta fosse retornada pelo serviço. Quando o Azure AI Search deteta 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.
503 Serviço indisponível Este código de estado significa que o sistema está sob carga pesada e o seu pedido não pode ser processado. As atenuações incluem a adição de tempos de espera a qualquer lógica de repetição ou o aumento da capacidade. Os serviços mais recentes vêm com mais armazenamento e poder de 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 o URL do serviço de pesquisa contiver HTTP em vez de HTTPS, será retornado um código de status 504.

Ver também

  • Last updated on