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)/ Gerenciamento de política de limitação de solicitação/ Modificação de uma política de limitação de solicitação
Atualizado em 2023-05-29 GMT+08:00
Ver PDF
Compartilhar

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

Função

Esta API é usada para modificar as informações detalhadas de uma política de limitação de solicitações.

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

PUT

/v1.0/apigw/throttles/{id}

A tabela a seguir lista o parâmetro no URI.

Tabela 2 Descrição do parâmetro

Parâmetro

Obrigatório

Tipo

Descrição

id

Sim

String

ID da política de limitação de solicitações que você deseja modificar

Solicitação

Tabela 3 Descrição do parâmetro

Parâmetro

Obrigatório

Tipo

Descrição

name

Sim

String

Nome da política de limitação de solicitações que você deseja modificar

O nome de uma política de limitação de solicitações consiste de 3 a 64 caracteres, começando com uma letra. Apenas letras, dígitos e sublinhados (_) são permitidos.

api_call_limits

Sim

Integer

Número máximo de vezes que uma API pode ser acessada em um período especificado. O valor deste parâmetro não pode exceder o limite padrão 200 TPS. Você pode alterar o limite padrão para atender aos requisitos de serviço. O valor máximo é 2.147.483.647. Insira um número inteiro positivo.

user_call_limits

Não

Integer

Número máximo de vezes que a API pode ser acessada por um usuário no mesmo período. O valor deste parâmetro deve ser menor ou igual ao de api_call_limits. O valor máximo é 2.147.483.647. Insira um número inteiro positivo.

app_call_limits

Não

Integer

Número máximo de vezes que a API pode ser acessada por uma aplicação no mesmo período. O valor deste parâmetro deve ser menor ou igual ao de user_call_limits. O valor máximo é 2.147.483.647. Insira um número inteiro positivo.

ip_call_limits

Não

Integer

Número máximo de vezes que a API pode ser acessada por um endereço IP no mesmo período. O valor deste parâmetro deve ser menor ou igual ao de api_call_limits. O valor máximo é 2.147.483.647. Insira um número inteiro positivo.

time_interval

Sim

Integer

Período de tempo para limitar o número de chamadas de API. Esse parâmetro se aplica a cada um dos três limites de chamada de API anteriores. O valor máximo é 2.147.483.647. Insira um número inteiro positivo.

time_unit

Sim

String

Unidade de tempo, que pode ser:

  • SECOND
  • MINUTE
  • HOUR
  • DAY

remark

Não

String

Descrição da política de limitação de solicitações

A descrição não pode exceder 255 caracteres.

type

Não

Integer

Tipo da política de limitação de solicitações, que pode ser:

  • 1: exclusivo, limitando o número máximo de vezes que uma única API pode ser chamada dentro do período especificado.
  • 2: compartilhado, limitando o número máximo de vezes que todas as APIs podem ser chamadas dentro do período especificado.

enable_adaptive_control

Não

String

Habilitação do status da limitação de solicitações dinâmicas

  • TRUE
  • FALSE

Esta função não está disponível no momento.

Exemplo de solicitação:

{
	"api_call_limits": 1000,
        "user_call_limits": 500,
	"app_call_limits": 300,
        "ip_call_limits": 600,
	"name": "1000_calls_per_second",
	"remark": "Total: 1000 calls/second; user: 500 calls/second; app: 300 calls/second; IP address: 600 calls/second",
	"time_interval": 1,
	"time_unit": "SECOND"
}

Resposta

Tabela 4 Descrição do parâmetro

Parâmetro

Tipo

Descrição

id

String

ID da política de limitação de solicitação

name

String

Nome da política de limitação de solicitação

api_call_limits

Integer

Número máximo de vezes que uma API pode ser acessada dentro de um período especificado

user_call_limits

Integer

Número máximo de vezes que a API pode ser acessada por um usuário no mesmo período

app_call_limits

Integer

Número máximo de vezes que a API pode ser acessada por uma aplicação no mesmo período

ip_call_limits

Integer

Número máximo de vezes que a API pode ser acessada por um endereço IP no mesmo período

time_interval

Integer

Período de tempo para limitar o número de chamadas de API

time_unit

String

Unidade de tempo para limitar o número de chamadas de API

remark

String

Descrição da política de limitação de solicitações

create_time

Timestamp

Hora em que a política de limitação de solicitações é criada

is_include_special_throttle

Integer

Indica se uma configuração de limitação de solicitação excluída foi criada. O valor pode ser:

  • 1: sim
  • 2: não

type

Integer

Tipo da política de limitação de solicitações, que pode ser:

  • 1: exclusivo
  • 2: partilhado

bind_num

Integer

Número de APIs às quais a política de limitação de solicitações foi vinculada

enable_adaptive_control

String

Habilitação do status da limitação de solicitações dinâmicas

  • TRUE
  • FALSE

Esta função não está disponível no momento.

Exemplo de resposta:

{
	"id": "0325b671-2d50-4614-9868-22102262695d",
	"name": "1000_calls_per_second",
	"api_call_limits": 1000,
	"user_call_limits": 500,
	"app_call_limits": 300,
        "ip_call_limits": 600,
	"time_interval": 1,
	"time_unit": "SECOND",
	"create_time": "2017-12-29T01:55:59Z",
	"remark": "Total: 1000 calls/second; user: 500 calls/second; app: 300 calls/second; IP address: 600 calls/second",
	"is_inclu_special_throttle": 2,
        "type":1,
	"bind_num": 0,
        "enable_adaptive_control": "FALSE"
}

Códigos de status

Tabela 5 Códigos de status

Código de status

Descrição

200

OK

400

Solicitação inválida

401

Não autorizado

403

Proibido

404

Não encontrado

500

Erro do servidor interno