Todos os produtos
Search
Central de documentação

API Gateway:Upload a plug-in

Última atualização: Jun 27, 2026

Após desenvolver um plug-in, faça o upload dele como plug-in personalizado na página Plug-in no console do Cloud-native API Gateway. Você pode visualizar e usar o plug-in enviado com sua conta Alibaba Cloud ou com as credenciais de um usuário do Resource Access Management (RAM) que tenha permissões no gateway nativo da nuvem. A ativação dos plug-ins integrados e dos enviados segue o mesmo processo.

Procedimento

  1. Faça login no console do API Gateway.

  2. No painel de navegação à esquerda, clique em Plug-in. Na barra de navegação superior, selecione uma região.

  3. Na página Plug-in, clique em Publish Plug-in no canto superior direito.

  4. No painel Publish Plug-in, configure os parâmetros e clique em Upload. O envio pode levar cerca de 30 segundos.

    Parâmetro

    Descrição

    Select Language

    Selecione a linguagem de programação usada para desenvolver o plug-in.

    Plug-in ID

    Especifique o ID do plug-in.

    Plug-in Name

    Especifique o nome do plug-in.

    Plug-in Description

    Insira uma descrição para o plug-in. Após a configuração, a descrição aparece no cartão do plug-in.

    Version Description

    Insira uma descrição para a versão do plug-in.

    WASM File

    Faça o upload do arquivo binário do plug-in compilado e criado em sua máquina local. A extensão do arquivo deve ser .wasm.

    Execution Stage

    Selecione um estágio na lista suspensa. Os estágios de execução do plug-in seguem esta ordem: Authorization > Authentication > Statistics > Default. Se a execução do plug-in não depender da ordem de outros plug-ins, selecione Default na lista suspensa.

    Execution Priority

    Especifique a prioridade de execução do plug-in no estágio definido. Valores maiores indicam maior prioridade. Recomendamos inserir um múltiplo inteiro de 10.

    Adapt to Gateway Version

    Selecione Any Version ou Specified Version.

    Any Version: Permite instalar o plug-in em instâncias de qualquer versão.

    Specified Version: Restringe a instalação do plug-in a instâncias de uma versão específica ou superior.

Prioridades de plug-ins e políticas

Na tabela a seguir, o plug-in ou política listado nas linhas superiores tem prioridade de execução maior em relação aos listados nas linhas inferiores.

Item

Tipo

Estágio de execução

Prioridade

Observações

Lista de bloqueios ou lista de permissões de endereços IP

Política

RBAC Filter

http-real-ip

Plug-in

Authorization

980

Throttling

ModelRouter

Plug-in

Authorization

900

Integrado a uma API de IA

ModelMapper

Plug-in

Authorization

800

Integrado a uma API de IA

frontend-gray

Plug-in

Authorization

450

Transmissão

geo-ip

Plug-in

Authorization

440

Transmissão

DeGraphQL

Plug-in

Authorization

430

Transmissão

cache-control

Plug-in

Authorization

420

Transmissão

Conversão de requisição/resposta

Plug-in

Authorization

410

Transmissão

oauth

Plug-in

Authorization

350

Autenticação

jwt-auth

Plug-in

Authorization

340

Autenticação

hmac-auth

Plug-in

Authorization

330

Autenticação

basic-auth

Plug-in

Authorization

320

Autenticação

key-auth

Plug-in

Authorization

310

Autenticação

Autenticação externa

Plug-in

Authorization

300

Autenticação

OPA

Plug-in

Authorization

225

Autenticação

Validação de requisição

Plug-in

Authorization

220

Transmissão

Bloqueio de endereço IP

Plug-in

Authorization

210

Segurança

JWT Logout

Plug-in

Authorization

50

Autenticação

Cache de resposta geral

Plug-in

Authorization

10

Transmissão

CORS

Plug-in

Authentication

340

Segurança

waf

Plug-in

Authentication

330

Segurança

request-block

Plug-in

Authentication

320

Segurança

bot-detect

Plug-in

Authentication

310

Segurança

ai-data-masking

Plug-in

Default

991

IA

ai-statistics

Plug-in

Default

990

IA

ai-security-guard

Plug-in

Default

850

IA

ai-cache

Plug-in

Default

800

IA

ai-quota

Plug-in

Default

750

IA

ai-intent

Plug-in

Default

700

IA

ai-history

Plug-in

Default

650

IA

ai-token-ratelimit

Plug-in

Default

600

IA

ai-prompt-template

Plug-in

Default

500

IA

ai-prompt-decorator

Plug-in

Default

450

IA

ai-network-search

Plug-in

Default

440

IA

ai-transformer

Plug-in

Default

410

IA

ai-rag

Plug-in

Default

405

IA

traffic-tag

Plug-in

Default

400

Throttling

ai-json

Plug-in

Default

150

IA

ai-proxy

Plug-in

Default

110

IA

canary-header

Plug-in

Default

100

Throttling

cluster-key-rate-limit

Plug-in

Default

20

Throttling

key-rate-limit

Plug-in

Default

10

Throttling

Controle de concorrência/throttling/circuit breaking

Política

Sentinel Filter

Timeout/retry/replicação de tráfego/modificação de cabeçalho/reescrita HTTP/CORS

Política

Router Filter

Perguntas frequentes

Quais são as possíveis causas de falhas na publicação de plug-ins?

Geralmente, as falhas na publicação ocorrem porque o arquivo .wasm do plug-in apresenta um formato binário inválido. Para obter um exemplo de como carregar o arquivo .wasm em seu ambiente local, consulte Desenvolver plug-ins em Go.