Todos os produtos
Search
Central de documentação

API Gateway:Upload a plugin

Última atualização: Sep 21, 2026

Após desenvolver um plug-in, faça o upload dele como um plug-in personalizado na página Plug-in no console do Cloud-native API Gateway. Visualize e use o plug-in enviado por meio da sua conta da Alibaba Cloud ou das credenciais de um usuário do Resource Access Management (RAM) que tenha permissões no gateway cloud-native. Os plug-ins integrados e os plug-ins enviados são ativados da mesma forma.

Procedimento

  1. Faça login no API Gateway console.

  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 do plug-in e clique em Upload. A publicação do plug-in leva aproximadamente 30 segundos.

  5. Parameter

    Description

    Select Language

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

    Plug-in ID

    Um identificador em inglês exclusivo para o plug-in.

    Plug-in Name

    O nome de exibição do plug-in.

    Plug-in Description

    Uma descrição da finalidade do plug-in, exibida no cartão do plug-in após sua criação.

    Version Description

    Uma descrição desta versão do plug-in.

    WASM File

    Faça o upload do arquivo binário compilado localmente do plug-in. O nome do arquivo deve terminar com ".wasm".

    Execution Stage

    Os estágios são processados na seguinte ordem: Authorization > Authentication Phase > Statistics > Default phase. Se a execução do plug-in não depender de outros plug-ins, selecione Authorization.

    Execution Priority

    Controla a ordem de execução dentro de um estágio. Um valor maior indica maior prioridade. Ao personalizar a ordem, use múltiplos de 10 para reservar espaço para ajustes futuros.

    Adapt to Gateway Version

    Selecione Any Version ou Specified Version.

    Any Version: instale o plug-in em um gateway de qualquer versão.

    Specified Version: instale o plug-in somente em um gateway da versão especificada ou posterior.

Prioridades de plug-ins e políticas

Na tabela a seguir, o plug-in ou a política listado em posição mais alta tem prioridade de execução maior em relação aos demais.

Item

Tipo

Estágio de execução

Prioridade

Observações

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

Política

RBAC Filter

http-real-ip

Plug-in

Authorization

980

Throttling

ModelRouter

Plug-in

Authorization

900

Built in an AI API

ModelMapper

Plug-in

Authorization

800

Built in an AI API

frontend-gray

Plug-in

Authorization

450

Transmission

geo-ip

Plug-in

Authorization

440

Transmission

DeGraphQL

Plug-in

Authorization

430

Transmission

cache-control

Plug-in

Authorization

420

Transmission

Conversão de requisição/resposta

Plug-in

Authorization

410

Transmission

oauth

Plug-in

Authorization

350

Authentication

jwt-auth

Plug-in

Authorization

340

Authentication

hmac-auth

Plug-in

Authorization

330

Authentication

basic-auth

Plug-in

Authorization

320

Authentication

key-auth

Plug-in

Authorization

310

Authentication

Autenticação externa

Plug-in

Authorization

300

Authentication

OPA

Plug-in

Authorization

225

Authentication

Validação de requisição

Plug-in

Authorization

220

Transmission

Bloqueio de endereço IP

Plug-in

Authorization

210

Security

JWT Logout

Plug-in

Authorization

50

Authentication

Cache de resposta geral

Plug-in

Authorization

10

Transmission

CORS

Plug-in

Authentication

340

Security

waf

Plug-in

Authentication

330

Security

request-block

Plug-in

Authentication

320

Security

bot-detect

Plug-in

Authentication

310

Security

ai-data-masking

Plug-in

Default

991

AI

ai-statistics

Plug-in

Default

990

AI

ai-security-guard

Plug-in

Default

850

AI

ai-cache

Plug-in

Default

800

AI

ai-quota

Plug-in

Default

750

AI

ai-intent

Plug-in

Default

700

AI

ai-history

Plug-in

Default

650

AI

ai-token-ratelimit

Plug-in

Default

600

AI

ai-prompt-template

Plug-in

Default

500

AI

ai-prompt-decorator

Plug-in

Default

450

AI

ai-network-search

Plug-in

Default

440

AI

ai-transformer

Plug-in

Default

410

AI

ai-rag

Plug-in

Default

405

AI

traffic-tag

Plug-in

Default

400

Throttling

ai-json

Plug-in

Default

150

AI

ai-proxy

Plug-in

Default

110

AI

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 simultaneidade/limitação de tráfego/circuit breaking

Política

Sentinel Filter

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

Política

Router Filter

FAQ

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

Na maioria dos casos, a falha na publicação de plug-ins ocorre porque o arquivo .wasm do plug-in está em um formato binário inválido. Para um exemplo de carregamento do arquivo .wasm no ambiente local, consulte Develop plug-ins in Go.