Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ API Gateway/ Referência de API/ APIs compartilhadas de gateway (para usuários existentes)/ Políticas de limitação de solicitação de vinculação/ Vinculação de uma política de limitação de solicitação
Atualizado em 2023-05-29 GMT+08:00
Ver PDF
Compartilhar

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

Função

A política de limitação de solicitações vinculada a uma API controlará todo o acesso à API. Se o número de chamadas de API dentro de um período especificado atingir o limite, o acesso subsequente será rejeitado, protegendo a API de back-end de tráfego anormal e garantindo a execução estável do serviço.

Esta API é usada para vincular uma política de limitação de solicitações a uma API que foi publicada em um ambiente.

Você pode vincular diferentes políticas de limitação de solicitações a uma API em ambientes diferentes, mas pode vincular apenas uma política de limitação de solicitações à API em cada ambiente.

URI

A tabela a seguir lista o método de solicitação HTTP/HTTPS e o URI da API.

Tabela 1 Método de solicitação HTTP/HTTPS e URI

Método de solicitação

URI

POST

/v1.0/apigw/throttle-bindings

Solicitação

Tabela 2 Descrição do parâmetro

Parâmetro

Obrigatório

Tipo

Descrição

publish_ids

Sim

Array of strings

ID do registro de publicação da API

strategy_id

Sim

String

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

Exemplo de solicitação:

{
  "publish_ids": [
    "374a6d5a-20c7-4ea1-82e1-19fce4556956",
    "65e6fe53-1ac3-4481-ba36-9f0bc6f22057"
  ],
  "strategy_id": "0325b671-2d50-4614-9868-22102262695d"
}

Resposta

Tabela 3 Descrição do parâmetro

Parâmetro

Tipo

Descrição

throttle_applys

Dicionário

Lista de vinculação
Tabela 4 Descrição do parâmetro de throttle_applys

Parâmetro

Tipo

Descrição

id

String

ID de vinculação

strategy_id

String

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

publish_id

String

ID do registro de publicação da API

scope

Integer

Escopo da política de limitação de solicitação, que pode ser:

  • 1: acesso de usuários e aplicações
  • 2: acesso de um usuário
  • 3: acesso a partir de uma aplicação

Atualmente, apenas 1 é suportado.

apply_time

Timestamp

Hora em que a política de limitação de solicitações está vinculada à API

Exemplo de resposta:

{
	"throttle_applys": [{
		"id": "507c6a9f-8322-4dc2-8ba5-b4d74e3690d3",
		"strategy_id": "0325b671-2d50-4614-9868-22102262695d",
		"publish_id": "374a6d5a-20c7-4ea1-82e1-19fce4556956",
		"scope": 1,
		"apply_time": "2017-12-29T03:01:11.138456Z"
	},
	{
		"id": "90f05978-06a3-4096-8bea-b5e2fa12b843",
		"strategy_id": "0325b671-2d50-4614-9868-22102262695d",
		"publish_id": "65e6fe53-1ac3-4481-ba36-9f0bc6f22057",
		"scope": 1,
		"apply_time": "2017-12-29T03:01:11.138456Z"
	}]
}

Códigos de status

Tabela 5 Códigos de status

Código de status

Descrição

201

Criado

400

Solicitação inválida

401

Não autorizado

403

Proibido

404

Não encontrado

500

Erro do servidor interno