Como faço para resolver erros de “Falha na execução devido a um erro de configuração: caractere ilegal no caminho” ao criar uma API do API Gateway com um recurso de proxy?

Breve descrição

Se o mapeamento de um parâmetro de caminho de URL para o parâmetro do caminho do proxy ({proxy+}) não estiver definido, o API Gateway retornará o seguinte erro:

Falha na execução devido a um erro de configuração: caractere ilegal no caminho

Sem um mapeamento de parâmetros de caminho de URL definido para esse parâmetro na solicitação de integração, o API Gateway avalia o parâmetro como a string literal “{proxy+}”. Como “{” não é um caractere válido, o API Gateway retorna um erro quando isso acontece.

Para resolver o erro, defina o mapeamento do parâmetro do caminho do URL para o parâmetro do caminho do proxy na solicitação de integração fazendo o seguinte:

Resolução

1.    No console do API Gateway, escolha o nome da sua API.

2.    Com o método selecionado no painel Recursos, escolha Solicitação de integração no painel Execução do método.

3.    No painel Solicitação de integração, verifique se o URL do endpoint usa o parâmetro correto do caminho do proxy: {proxy}. (A variável de caminho guloso sem “+”.) Por exemplo: http://exemplo.com/{proxy}

4.    Expanda os parâmetros do caminho do URL. Em seguida, escolha Adicionar caminho e faça o seguinte:
Em Nome, insira proxy. Isso corresponde ao parâmetro no URL do endpoint.
Em Mapeado de, digite method.request.path.proxy.
Observação: aqui, proxy corresponde ao nome do caminho da solicitação, conforme definido no painel Solicitação de método. Esse caminho de solicitação é adicionado criando um recurso de proxy chamado {proxy} ou, para uma variável de caminho gulosa, {proxy+}.

5.    Escolha o ícone de marca de seleção (Criar).

Observação: se você receber um erro Expressão de mapeamento inválida especificada, atualize seu modelo do AWS CloudFormation ou a definição da OpenAPI. Em seguida, repita as etapas deste artigo.

6.    Implante sua API.

Informações relacionadas

Configurar uma integração de proxy com um recurso de proxy

Configurar mapeamentos de dados de solicitação e resposta usando o console do API Gateway

Configurar uma solicitação de integração de API usando o console do API Gateway