API标准及多语言预置SDK
本产品（云原生API 网关/2024-03-27）的 OpenAPI 采用 ROA 签名机制，具体签名方式请参见签名机制说明。我们已为开发者封装了主流编程语言的 SDK，您可通过 下载 SDK 快速调用 API，无需关注签名等底层实现细节，显著降低开发门槛与集成复杂度。自定义签名场景
若您的业务场景有特殊需求，需通过自签名方式对接 API，建议优先咨询我们的技术支持团队（服务钉钉群：147535001692），获取专业指导以确保高效接入。
账号与安全准备
阿里云账号具备对所有资源的完全管理权限。一旦 AccessKey 泄露，所有相关资源都将面临未经授权访问的风险。为确保安全，建议创建一个仅具备 API 访问权限的 RAM 用户并配置其 AccessKey，同时基于最小权限原则 (PoLP) 配置 RAM 策略。仅在明确需要阿里云账号权限的特定场景下，才使用阿里云账号。
API管理
| API | 标题 | API概述 |
|---|---|---|
| ExportHttpApi | 导出HTTP API | 导出指定的HTTP API。 |
| ImportHttpApi | 导入HTTP API | 导入HTTP API，支持将OpenAPI 2.0和 OpenAPI 3.0.x版本的定义文件导入为REST类型的API。 |
| DeployHttpApi | 发布API | 发布HTTP API。包括Rest API 和HTTP API里的路由。 |
| CreateHttpApi | 创建HTTP API | 创建一个HTTP类型的API。 |
| UpdateHttpApi | 更新HTTP API | 更新HTTP API。 |
| GetHttpApi | 获取HTTP API | 读取HTTP API信息。 |
| ListHttpApis | 获取HTTP API列表 | 获取HTTP API列表。 |
| UndeployHttpApi | 下线API | 取消部署HttpApi。 |
| DeleteHttpApi | 删除HTTP API | 删除指定的HTTP API。 |
接口管理
| API | 标题 | API概述 |
|---|---|---|
| CreateHttpApiOperation | 创建接口 | 为HTTP API创建接口。 |
| GetHttpApiOperation | 获取接口信息 | 获取接口信息。 |
| UpdateHttpApiOperation | 更新接口 | 更新接口。 |
| ListHttpApiOperations | 获取接口列表 | 获取接口列表。 |
| DeleteHttpApiOperation | 删除接口 | 删除指定的接口。 |
MCP管理
| API | 标题 | API概述 |
|---|---|---|
| CreateMcpServer | 创建MCP Server | 创建一个模型上下文协议（MCP）服务器。 |
| UpdateMcpServer | 修改MCP Server | 更新MCP server。 |
| GetMcpServer | 查询MCP Server详情 | 获取MCP server。 |
| ListMcpServers | 查询MCP Server列表 | 获取MCP server列表。 |
| DeleteMcpServer | 删除MCP Server | 删除MCP server。 |
| DeployMcpServer | 发布MCP Server | 发布MCP server。 |
| UnDeployMcpServer | 取消发布MCP Server | 取消发布MCP server。 |
| SyncMCPServers | 同步Nacos MCP到网关 | 同步外部MCP server。 |
路由管理
| API | 标题 | API概述 |
|---|---|---|
| CreateHttpApiRoute | 创建HTTP API路由 | 创建HttpApi的路由。 |
| UpdateHttpApiRoute | 更新路由 | 更新HttpApi的路由。 |
| GetHttpApiRoute | 查询路由详情 | 获取HttpApi的路由详情。 |
| DeleteHttpApiRoute | 删除路由 | 删除HttpApi的路由。 |
| ListHttpApiRoutes | 查询路由列表 | 查询HTTP API的路由列表。 |
服务管理
| API | 标题 | API概述 |
|---|---|---|
| GetService | Query Service Details | Get Service Details。 |
| CreateService | 创建服务 | 创建服务。 |
| ListServices | 查询服务列表 | 获取服务列表。 |
| UpdateService | 更新服务 | 更新服务。支持更新服务健康检查配置， DNS 域名和固定地址的地址配置信息。 |
| DeleteService | 删除服务 | 删除服务。 |
| CreateServiceVersion | 创建服务版本 | 创建服务版本。 |
| UpdateServiceVersion | 更新服务版本 | 更新服务版本。 |
| DeleteServiceVersion | 删除服务版本 | 删除服务版本。 |
| CreateSource | 创建来源 | 创建来源。 |
| GetSource | 获取服务来源详情 | 获取服务来源详情。 |
| DeleteSource | 删除来源 | 删除服务来源。 |
网关管理
| API | 标题 | API概述 |
|---|---|---|
| CreateGateway | 创建网关 | 创建云原生网关。 |
| UpdateGatewayName | 修改网关名称 | 修改网关名称。 |
| UpdateGatewayFeature | 更新网关特性参数 | 更新网关特性参数。 |
| UpgradeGateway | 升级网关 | 升级网关版本。 |
| GetGateway | 查询网关详情 | 获取网关的所属VPC，所属交换机, 网关入口等基本信息。 |
| ListGateways | 查询网关列表 | 查询网关列表。 |
| AddGatewaySecurityGroupRule | 添加网关安全组规则 | 授权网关访问服务的安全组。 |
| DeleteGateway | 删除网关 | 删除网关。 |
| DeleteGatewaySecurityGroupRule | 删除网关安全组规则 | 删除网关安全组规则。 |
| ListZones | 获取可用区 | 获取云原生API网关region下的可用区。 |
| RestartGateway | 重启网关 | 重启网关。 |
| ListGatewayFeatures | 查询网关特性参数配置列表 | 查询网关特性参数配置列表。 |
消费者管理
| API | 标题 | API概述 |
|---|---|---|
| RemoveConsumerAuthorizationRule | 删除消费者授权规则 | 删除消费者授权规则。 |
| QueryConsumerAuthorizationRules | 查询消费者授权规则列表 | 查询消费者授权规则列表。 |
| CreateConsumerAuthorizationRules | 创建消费者授权规则 | 创建消费者授权规则。 |
| BatchDeleteConsumerAuthorizationRule | 批量解除消费者授权规则 | 批量解除消费者授权规则。 |
| DeleteConsumer | 删除消费者 | 删除消费者。 |
| ListConsumers | 获取消费者列表 | 获取消费者列表。 |
| DeleteConsumerAuthorizationRule | 删除消费者授权规则 | 删除消费者授权规则。 |
| CreateConsumer | 创建消费者 | 创建消费者。 |
| UpdateConsumer | 更新消费者 | 更新消费者。 |
| GetConsumer | 获取消费者 | 获取消费者。 |
| CreateConsumerAuthorizationRule | 创建消费者授权规则 | 创建消费者授权规则。 |
| UpdateConsumerAuthorizationRule | 更新消费者授权规则 | 更新消费者授权规则。 |
| GetConsumerAuthorizationRule | 获取消费者授权规则 | 获取消费者授权规则。 |
策略管理
| API | 标题 | API概述 |
|---|---|---|
| ListPolicies | 查询策略列表 | 查询策略列表。 |
| ListPolicyClasses | 获取策略模板 | 获取策略模板。 |
| CreatePolicy | 创建策略 | 创建策略。 |
| GetPolicy | 获取策略 | 获取策略。 |
| UpdatePolicy | 更新策略 | 更新策略。 |
| DeletePolicy | 删除策略 | 删除策略。 |
| CreatePolicyAttachment | 创建策略挂载 | 创建策略资源挂载。 |
| GetPolicyAttachment | 查询策略挂载 | 查询策略资源挂载。 |
| DeletePolicyAttachment | 删除策略挂载 | 删除策略资源挂载。 |
插件管理
| API | 标题 | API概述 |
|---|---|---|
| ListPlugins | 获取插件列表 | 获取插件列表。 |
| CreatePluginAttachment | 挂载插件 | 挂载插件。 |
| GetPluginAttachment | 查询插件挂载 | 查询插件挂载。 |
| ListPluginAttachments | 获取插件挂载列表 | 获取插件挂载列表。 |
| UpdatePluginAttachment | 更新插件挂载 | 更新插件挂载。 |
| DeletePluginAttachment | 删除插件挂载 | 删除插件挂载。 |
| InstallPlugin | 安装插件 | 安装插件。 |
| UninstallPlugin | 卸载插件 | 卸载插件。 |
域名管理
| API | 标题 | API概述 |
|---|---|---|
| ListSslCerts | 获取证书列表 | 获取证书列表。 |
| GetDomain | 查询域名 | 查询域名。 |
| CreateDomain | 创建域名 | 创建域名。 |
| ListDomains | 查询域名列表 | 查询域名列表。 |
| DeleteDomain | 删除域名 | 删除域名。 |
| UpdateDomain | 更新域名 | 更新域名。 |
监控管理
| API | 标题 | API概述 |
|---|---|---|
| GetTraceConfig | 获取trace配置 | 获取链路追踪配置。 |
| GetDashboard | 获取监控大盘 | 获取监控日志大盘接口。 |
资源管理
| API | 标题 | API概述 |
|---|---|---|
| ChangeResourceGroup | 资源转组 | 资源转组。 |
| GetResourceOverview | 获取资源概览 | 获取资源概览信息。 |
历史接口
| API | 标题 | API概述 |
|---|---|---|
| CreateAndAttachPolicy | 创建并附加策略 | 创建并附加策略。 |
| UpdateAndAttachPolicy | 更新并挂载策略 | 更新并挂载策略。 |
| 环境管理 | 环境管理 | |
| GetEnvironment | 查询环境 | 查询环境。 |
| UpdateEnvironment | 更新环境 | 更新环境。 |
| DeleteEnvironment | 删除环境 | 删除环境。 |
| ListEnvironments | 查询环境列表 | 查询环境列表。 |