# Configurar uma solicitação de integração de API usando o console do API Gateway A configuração de um método de API define o método e descreve seus comportamentos. Para configurar um método, você deve especificar um recurso, incluindo a raiz ("/"), na qual o método está exposto, um método HTTP (`GET`, `POST` etc.) e como ele será integrado com o backend de destino. A solicitação e a resposta do método especificam o contrato com o aplicativo iniciador da chamada, estipulando quais parâmetros a API pode receber e qual é a aparência da resposta. Os procedimentos a seguir descrevem como usar o console do API Gateway para criar uma solicitação de integração. **Topics** + [Configurar uma integração com o Lambda](#how-to-method-settings-console-lambda) + [Configurar uma integração HTTP](#how-to-method-settings-console-http) + [Configurar uma integração de serviços da AWS](#how-to-method-settings-console-aws) + [Configurar uma integração simulada](#how-to-method-settings-console-mock) ## Configurar uma integração com o Lambda Use uma integração de função do Lambda para integrar a API a uma função do Lambda. No nível da API, esse é um tipo de integração da `AWS`, se você criar uma integração sem proxy, ou um tipo de integração `AWS_PROXY`, se criar uma integração de proxy. **Configurar uma integração com o Lambda** 1. No painel **Recursos**, escolha **Criar método**. 1. Em **Tipo de método**, selecione um método HTTP. 1. Em **Integration type** (Tipo de integração), escolha **Lambda function** (Função do Lambda). 1. Para usar uma integração do proxy do Lambda, ative **Integração do proxy do Lambda**. Para saber mais sobre integrações do proxy do Lambda, consulte [Compreender a integração de proxy do Lambda do API Gateway](set-up-lambda-proxy-integrations.md#api-gateway-create-api-as-simple-proxy). 1. Em **Função do Lambda**, insira o nome da sua função do Lambda. Se você estiver usando uma função do Lambda em uma região que não seja a da API, selecione a região no menu suspenso e insira o nome da função do Lambda. Se você estiver usando uma função do Lambda entre contas, insira o ARN da função. 1. Para usar o valor de tempo limite padrão de 29 segundos, deixe a opção **Tempo limite padrão** ativada. Para definir um tempo limite personalizado, selecione **Tempo limite padrão** e insira um valor de tempo limite entre `50` e `29000` milissegundos. 1. (Opcional) É possível definir as configurações de solicitação de método usando os menus suspensos a seguir. Escolha **Configurações de solicitação de método** e defina a solicitação de método. Para saber mais, consulte a etapa 3 de [Editar uma solicitação de método do API Gateway no console do API Gateway](how-to-set-up-method-using-console.md#how-to-method-settings-callers-console). Você também pode definir as configurações de solicitação de método depois de criar o método. 1. Escolha **Criar método**. ## Configurar uma integração HTTP Use uma integração HTTP para integrar a API a um endpoint HTTP. No nível da API, este é o tipo de integração `HTTP`. **Configurar uma integração HTTP** 1. No painel **Recursos**, escolha **Criar método**. 1. Em **Tipo de método**, selecione um método HTTP. 1. Em **Tipo de integração**, escolha **HTTP**. 1. Para usar uma integração de proxy HTTP, ative a **Integração do proxy HTTP**. Para saber mais sobre integrações de proxy HTTP, consulte [Configurar integrações de proxy HTTP no API Gateway](setup-http-integrations.md#api-gateway-set-up-http-proxy-integration-on-proxy-resource). 1. Em **HTTP method (Método HTTP)**, escolha o tipo de método HTTP mais parecido com o método no backend HTTP. 1. Em **URL do endpoint**, insira o URL do back-end HTTP que você deseja que esse método use. 1. Em **Manuseio de conteúdo**, selecione um comportamento de manuseio de conteúdo. 1. Para usar o valor de tempo limite padrão de 29 segundos, deixe a opção **Tempo limite padrão** ativada. Para definir um tempo limite personalizado, selecione **Tempo limite padrão** e insira um valor de tempo limite entre `50` e `29000` milissegundos. 1. (Opcional) É possível definir as configurações de solicitação de método usando os menus suspensos a seguir. Escolha **Configurações de solicitação de método** e defina a solicitação de método. Para saber mais, consulte a etapa 3 de [Editar uma solicitação de método do API Gateway no console do API Gateway](how-to-set-up-method-using-console.md#how-to-method-settings-callers-console). Você também pode definir as configurações de solicitação de método depois de criar o método. 1. Escolha **Criar método**. ## Configurar uma integração de serviços da AWS Use uma integração de serviços da AWS para integrar a API diretamente a um serviço da AWS. No nível da API, este é o tipo de integração `AWS`. Para configurar uma API do API Gateway, siga qualquer um destes procedimentos: + Crie uma nova função do Lambda. + Defina uma permissão de recurso na função do Lambda. + Execute qualquer outra ação do serviço do Lambda. Você deve escolher o **Serviço da AWS**. **Configurar uma integração de serviços da AWS** 1. No painel **Recursos**, escolha **Criar método**. 1. Em **Tipo de método**, selecione um método HTTP. 1. Em **Tipo de integração**, selecione **Serviço da AWS **. 1. Para **Região da AWS**, escolha a região da AWS que esse método deve usar para chamar a ação. 1. Em **Serviço da AWS**, selecione o serviço da AWS que esse método deve chamar. 1. Em **Subdomínio da AWS**, digite o subdomínio usado pelo serviço da AWS. Normalmente, você deixaria este campo em branco. Alguns serviços da AWS podem oferecer suporte a subdomínios como parte dos hosts. Consulte a documentação do serviço para a disponibilidade e, se disponível, detalhes. 1. Para **HTTP method (Método HTTP)**, escolha o tipo de método HTTP que corresponde à ação. Para o tipo de método HTTP, consulte a documentação de referência da API para o serviço da AWS que você escolheu em **Serviço da AWS**. 1. Em **Tipo de ação**, selecione **Usar nome da ação** para usar uma ação de API ou **Usar a substituição de caminho** para usar um caminho de recurso personalizado. Para conhecer as ações e os caminho de recurso personalizado disponíveis, consulte a documentação de referência de API do serviço da AWS que você escolheu em **Serviço da AWS**. 1. Insira o **Nome da ação** ou **Substituição do caminho**. 1. Em **Função de execução**, digite o ARN do perfil do IAM que o método usará para chamar a ação. Para criar um perfil do IAM, é possível adaptar as instruções em [Etapa 1: Criar o perfil de execução do proxy de serviço da AWS](getting-started-aws-proxy.md#getting-started-aws-proxy-add-roles). Especifique uma política de acesso com o número desejado de instruções de recursos e ações: Para obter mais informações, consulte [Como o Amazon API Gateway funciona com o IAM](security_iam_service-with-iam.md). Para a sintaxe da instrução de ação e recurso, consulte a documentação do serviço da AWS que você escolheu em **Serviço da AWS**. Para a relação de confiança da função do IAM, especifique o seguinte, que permite que o API Gateway tome medidas em nome da sua conta da AWS: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Service": "apigateway.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` ------ 1. Para usar o valor de tempo limite padrão de 29 segundos, deixe a opção **Tempo limite padrão** ativada. Para definir um tempo limite personalizado, selecione **Tempo limite padrão** e insira um valor de tempo limite entre `50` e `29000` milissegundos. 1. (Opcional) É possível definir as configurações de solicitação de método usando os menus suspensos a seguir. Escolha **Configurações de solicitação de método** e defina a solicitação de método. Para saber mais, consulte a etapa 3 de [Editar uma solicitação de método do API Gateway no console do API Gateway](how-to-set-up-method-using-console.md#how-to-method-settings-callers-console). Você também pode definir as configurações de solicitação de método depois de criar o método. 1. Escolha **Criar método**. ## Configurar uma integração simulada Use uma integração simulada se quiser que o API Gateway atue como seu back-end para retornar respostas estáticas. No nível da API, este é o tipo de integração `MOCK`. Normalmente, você pode usar a integração `MOCK` quando a sua API ainda não for final e você quiser gerar respostas de API para desbloquear equipes dependentes para testes. Para o método `OPTION`, o API Gateway define a integração `MOCK` como padrão para retornar cabeçalhos com compartilhamento de recursos de origem cruzada para o recurso da API aplicada. **Configurar uma integração simulada** 1. No painel **Recursos**, escolha **Criar método**. 1. Em **Tipo de método**, selecione um método HTTP. 1. Em **Tipo de integração**, escolha **Simulação**. 1. (Opcional) É possível definir as configurações de solicitação de método usando os menus suspensos a seguir. Escolha **Configurações de solicitação de método** e defina a solicitação de método. Para saber mais, consulte a etapa 3 de [Editar uma solicitação de método do API Gateway no console do API Gateway](how-to-set-up-method-using-console.md#how-to-method-settings-callers-console). Você também pode definir as configurações de solicitação de método depois de criar o método. 1. Escolha **Criar método**.