Criação de uma política de limitação de solicitações

Cenário

A limitação de solicitações controla o número de vezes que uma API pode ser chamada dentro de um período de tempo para proteger os serviços de back-end.

Para fornecer serviços estáveis e ininterruptos, você pode criar políticas de limitação de solicitações para controlar o número de chamadas feitas às suas APIs.

As políticas de limitação de solicitação entram em vigor para uma API somente se tiverem sido vinculadas à API.

• Uma API pode ser vinculada a apenas uma política de limitação de solicitações para um determinado ambiente, mas cada política de limitação de solicitações pode ser vinculada a várias APIs.
• Para o gateway compartilhado, o limite de solicitação padrão é de 200 chamadas por segundo. Para um gateway dedicado, o limite é o valor de ratelimit_api_limits que você configurou na página Configuration Parameters.

Pré-requisitos

Você publicou a API à qual deseja vincular uma política de limitação de solicitações.

Criação de uma política de limitação de solicitações

1. Acesse o console de gerenciamento.
2. Clique em no canto superior esquerdo e selecione uma região.
3. Clique em no canto superior esquerdo e escolha API Gateway.
4. Escolha um tipo de gateway no painel de navegação.
   • Shared Gateway: você pode criar e gerenciar APIs imediatamente. Você será cobrado com base no número de chamadas de API.
   • Dedicated Gateways: você pode criar e gerenciar APIs depois de comprar um gateway. Você será cobrado com base na duração de uso do gateway.

5. No painel de navegação, escolha API Publishing > Request Throttling.
6. Clique em Create Request Throttling Policy e defina os parâmetros listados em Tabela 1.

   

   Tabela 1 Parâmetros para criar uma política de limitação de solicitações

   Parâmetro	Descrição
   Name	Nome da política de limitação de solicitação.
   Type	Limitação de solicitação baseada em API ou compartilhada por API. API-based: a limitação de solicitações é baseada em todas as APIs às quais a política está vinculada. API-shared: a limitação de solicitações baseia-se em todas as APIs como um todo às quais a política está vinculada.
   Period	Por quanto tempo você deseja limitar o número de chamadas de API. Este parâmetro pode ser usado em conjunto com os seguintes parâmetros: Max. API Requests: limite o número máximo de vezes que uma API pode ser chamada em um período específico. Max. User Requests: limite o número máximo de vezes que uma API pode ser chamada por um usuário dentro de um período específico. Max. App Requests: limite o número máximo de vezes que uma API pode ser chamada por uma aplicação em um período específico. Max. IP Address Requests: limite o número máximo de vezes que uma API pode ser chamada por um endereço IP dentro de um período específico.
   Max. API Requests	O número máximo de vezes que cada API vinculada pode ser chamada dentro do período especificado. Este parâmetro deve ser utilizado em conjunto com o Period.
   Max. User Requests	O número máximo de vezes que cada API vinculada pode ser chamada por um usuário dentro do período especificado. Esse limite se aplica apenas às APIs acessadas por meio da autenticação do IAM. O valor deste parâmetro não pode exceder o de Máximo de solicitações de API. Este parâmetro deve ser utilizado em conjunto com o Period. Se houver muitos usuários na sua conta que acessam uma API, os limites de limitação de solicitações da API serão aplicados a todos esses usuários.
   Max. App Requests	O número máximo de vezes que cada API vinculada pode ser chamada por uma aplicação dentro do período especificado. Esse limite só se aplica a APIs acessadas por meio da autenticação da aplicação. O valor deste parâmetro não pode exceder o de Max. User Requests. Este parâmetro deve ser utilizado em conjunto com o Period.
   Max. IP Address Requests	O número máximo de vezes que cada API vinculada pode ser chamada por um endereço IP dentro do período especificado. O valor deste parâmetro não pode exceder o de Máximo de solicitações de API. Este parâmetro deve ser utilizado em conjunto com o Period.
   Description	Descrição da política de limitação de solicitação.

7. Clique em OK.

   Depois que a política é criada, ela é exibida na página Request Throttling. Você pode vincular essa política a APIs para limitar as solicitações de API.

Vinculação de uma política de limitação de solicitações a uma API

1. Acesse a página para vincular uma política de limitação de solicitações a uma API. Você pode usar um dos seguintes métodos:
   • Na coluna Operation da política de limitação de solicitação a ser vinculada, clique em Bind to API e, em seguida, clique em Select API.
   • Clique no nome da política de limitação de solicitações de destino e clique em Select API na página de guia APIs.

2. Especifique um grupo de APIs, um ambiente e uma palavra-chave de nome de API para pesquisar a API desejada.
3. Selecione a API e clique em OK.
   Figura 1 Vinculação de uma política de limitação de solicitações a uma API
   
   

   Se uma política de limitação de solicitações não for mais necessária para uma API, você poderá desvinculá-la. Para desvincular uma política de limitação de solicitação de várias APIs, selecione as APIs e clique em Unbind. Você pode desvincular uma política de limitação de solicitações de no máximo 1000 APIs por vez.

Criação, vinculação e desvinculação de uma política de limitação de solicitações chamando uma API

Você também pode criar uma política de limitação de solicitações, vinculá-la a APIs ou desvinculá-la de APIs chamando uma API fornecida pelo APIG. Para detalhes, consulte as seguintes referências:

Criação de uma política de limitação de solicitações

Vinculação de uma política de limitação de solicitações

Desvinculação de uma política de limitação de solicitações

Operações de acompanhamento

Para controlar o número máximo de chamadas de API recebidas de uma aplicação ou locatário específico, especifique a aplicação ou locatário a ser excluído referindo-se a Adição de uma aplicação ou locatário excluído. Se uma aplicação for excluída em uma política de limitação de solicitações, qualquer limite configurado para essa aplicação terá precedência sobre a política de limitação de solicitações. A API e os limites de solicitação do usuário dessa política ainda são válidos. Se um locatário for excluído em uma política de limitação de solicitação, qualquer limite configurado para esse locatário será aplicado. Os limites de solicitação de API e aplicação desta política ainda são válidos.