数据结构

AIGWACLSubject

AI 网关 ACL 授权主体（Consumer / ConsumerGroup 共用结构），用于响应中回显 Id + Name，减少前端多次查询调用

被如下接口引用：DescribeCloudNativeAPIGatewayMCPServerACL, DescribeCloudNativeAPIGatewayMCPToolACLList。

名称	类型	描述
Id	String	鉴权主体ID 示例值：*
Name	String	鉴权主体名称 示例值：默认消费者组

AIGWConsumerGroupBrief

AI 网关中消费者组简要信息

被如下接口引用：DescribeCloudNativeAPIGatewayLLMTokenUsageList。

名称	类型	描述
Name	String	消费者组名称 示例值：test-consumer-group-1
ConsumerGroupId	String	消费者组Id 示例值：cg-3155bd3c9fd0df

AIGWCrossServiceFallbackConfig

跨服务降级配置

被如下接口引用：CreateCloudNativeAPIGatewayLLMModelAPI, DescribeCloudNativeAPIGatewayLLMModelAPI, ModifyCloudNativeAPIGatewayLLMModelAPI。

名称	类型	必选	描述
TriggerConditions	Array of String	是	触发条件 枚举值： ServiceUnavailable： 服务不可用 ConnectionTimeout： 连接超时 RateLimited： 限流 示例值：["ServiceUnavailable"]
FallbackServiceChain	Array of AIGWFallbackServiceItem	是	fallback 服务链
QuotaFallbackTrigger	AIGWLLMQuotaFallbackTrigger	否	额度降级触发配置

AIGWCustomDesensitizeRule

AI 网关自定义脱敏规则（A 层 / B 层共用结构体，MaskFormat 含义随所属层不同）

被如下接口引用：DescribeCloudNativeAPIGatewayLLMModelAPI。

名称	类型	必选	描述
Name	String	是	自定义脱敏规则名称 示例值：gonghao
Pattern	String	是	自定义脱敏规则匹配正则 示例值：E\d{6}
MaskFormat	String	是	自定义脱敏规则掩码 示例值：[REDACTED_EMP]
Enabled	Boolean	是	自定义脱敏规则开关 示例值：true

AIGWFallbackServiceItem

降级服务元素

被如下接口引用：CreateCloudNativeAPIGatewayLLMModelAPI, ModifyCloudNativeAPIGatewayLLMModelAPI。

名称	类型	必选	描述
ModelServiceId	String	是	模型服务 Id 示例值：3dcaac5d48cc4d39a8ed79937fe720c6
ModelServiceName	String	否	模型服务名 示例值：mock-openai

AIGWForwardDesensitizeConfig

AI 网关 A 层转发脱敏配置（请求转发到 LLM 供应商前对 messages 替换为占位符）

被如下接口引用：DescribeCloudNativeAPIGatewayLLMModelAPI。

名称	类型	必选	描述
Enabled	Boolean	是	转发脱敏开关 示例值：true
PredefinedRuleTypes	Array of String	否	预定义规则类型 枚举值： Phone： 电话号码 IdCard： 身份证号 BankCard： 银行卡号 Email： 电子邮箱地址 IP： IP地址 Name： 姓名 示例值：["Phone"]
CustomRules	Array of AIGWCustomDesensitizeRule	否	自定义脱敏规则
PlaceholderFormat	String	否	掩码 示例值：[{类型名}]
OnFailure	String	否	脱敏异常处理 枚举值： Reject： 拒绝请求 Skip： 跳过 示例值：Reject

AIGWHealthCheckSetting

用于定义kong插件自定义健康检查的配置

被如下接口引用：CreateCloudNativeAPIGatewayMCPServer, DescribeCloudNativeAPIGatewayMCPServer, ModifyCloudNativeAPIGatewayMCPServer。

名称	类型	必选	描述
HealthCheckType	String	是	健康检查类型 枚举值： MCP： 标准mcp HTTP： http 示例值：MCP
HealthCheckIntervalSecond	Integer	是	检查间隔 示例值：10
HealthCheckTimeout	Integer	是	检查超时时间 示例值：3
HealthCheckFailThreshold	Integer	是	检查失败阈值 示例值：3
HealthCheckRecoverThreshold	Integer	是	检查恢复阈值 示例值：3
HealthCheckPath	String	否	检查路径 示例值：/health
HealthCheckMethod	String	否	检查方法 示例值：GET

AIGWIntentRoute

AI 网关意图路由配置

被如下接口引用：CreateCloudNativeAPIGatewayLLMModelAPI, ModifyCloudNativeAPIGatewayLLMModelAPI。

名称	类型	必选	描述
IntentModelServiceId	String	是	意图识别模型id 示例值：d6015302e11b4a1f83dd3adb88180716
ConfidenceThreshold	Float	是	置信度 示例值：0.75
DefaultModelServiceId	String	是	默认服务id 示例值：d6015302e11b4a1f83dd3adb88180716
Rules	Array of AIGWIntentRouteRule	否	规则

AIGWIntentRouteRule

AI 网关意图路由规则

被如下接口引用：CreateCloudNativeAPIGatewayLLMModelAPI, ModifyCloudNativeAPIGatewayLLMModelAPI。

名称	类型	必选	描述
IntentCode	String	否	意图编码 枚举值： Coder： 代码编写 Math： 数学计算 Translation： 翻译 Flash： 快速问答 Complex： 复杂推理 示例值：Coder
ModelServiceId	String	否	模型服务id 示例值：d6015302e11b4a1f83dd3adb88180716

AIGWKVMatch

路由匹配规则

被如下接口引用：CreateCloudNativeAPIGatewayLLMModelAPI, DescribeCloudNativeAPIGatewayLLMModelAPI, ModifyCloudNativeAPIGatewayLLMModelAPI。

名称	类型	必选	描述
Key	String	是	键 示例值：k1
Value	String	是	值 示例值：asdfad
Operator	String	是	操作类型 示例值：exact

AIGWLLMQuotaFallbackTrigger

云原生网关模型API 配额降级触发条件信息

被如下接口引用：CreateCloudNativeAPIGatewayLLMModelAPI, ModifyCloudNativeAPIGatewayLLMModelAPI。

名称	类型	必选	描述
ThresholdPercent	Integer	否	配额感知阈值百分比（RPM 与 TPM 共用） 取值范围：[0, 99] 示例值：10
CheckDimension	String	否	检查维度策略 枚举值： AnyInsufficient： RPM 或 TPM 任一不足即触发 AllInsufficient： RPM 和 TPM 同时不足才触发 示例值：AnyInsufficient

AIGWLLMQuotaLimit

云原生网关模型LLM配额限制信息

被如下接口引用：CreateCloudNativeAPIGatewayLLMModelService, DescribeCloudNativeAPIGatewayLLMModelService, DescribeCloudNativeAPIGatewayLLMModelServices, ModifyCloudNativeAPIGatewayLLMModelService。

名称	类型	必选	描述
RPMLimit	Integer	否	该模型服务每分钟请求数上限，0 表示该维度不限 示例值：0
TPMLimit	Integer	否	该模型服务每分钟 Token 数上限，0 表示该维度不限 示例值：0

AIGWLLMTokenUsageItem

单个消费者 Token 用量查询结果

被如下接口引用：DescribeCloudNativeAPIGatewayLLMTokenUsageList。

名称	类型	描述
ConsumerId	String	消费者Id 示例值：02b4d312-2fcd-4995-ae7c-5acaa57962b7
ConsumerName	String	消费者名称 示例值：test-consumer-1
ConsumerGroups	Array of AIGWConsumerGroupBrief	消费者组信息列表
ModelServiceId	String	模型服务Id 示例值：f77b443101e9411ab881f183079c073a
ModelServiceName	String	模型服务名称 示例值：anthropic-deepseek
InputTokens	Integer	输入Token数（包含缓存命中Token数） 示例值：5736
CacheReadInputTokens	Integer	命中缓存输入Token数 示例值：5632
OutputTokens	Integer	输出Token数 示例值：969
TotalTokens	Integer	消耗总Token数 示例值：6705
RequestCount	Integer	请求总数 示例值：5
Cost	String	花费成本 示例值：0.00
Currency	String	成本货币单位 枚举值： CNY： 人民币 当前仅支持CNY 示例值：CNY

AIGWLLMTokenUsageListResult

Token用量统计结果

被如下接口引用：DescribeCloudNativeAPIGatewayLLMTokenUsageList。

名称	类型	描述
DataList	Array of AIGWLLMTokenUsageItem	Token用量明细返回结果列表
TotalCount	Integer	结果总数 示例值：6

AIGWLLMTokenUsageStatisticsResult

AI 网关token消耗统计汇总响应结果

被如下接口引用：DescribeCloudNativeAPIGatewayLLMTokenUsageStatistics。

名称	类型	描述
TotalRequestCount	Integer	查询时间范围内请求总数 示例值：2
TotalInputTokens	Integer	查询时间范围内总输入Token数（包含命中缓存的Token数） 示例值：45
TotalOutputTokens	Integer	查询时间范围内总输出Token数 示例值：11
TotalCachedReadInputTokens	Integer	查询时间范围内总命中缓存输入Token数 示例值：5632
TotalCost	String	查询时间范围内总成本 示例值：0.0
Currency	String	成本货币单位 示例值：CNY
TopConsumers	Array of AIGWTopConsumersItem	查询时间范围内成本最高的消费者

AIGWLatencyPriorityConfig

延迟优先路由配置

被如下接口引用：CreateCloudNativeAPIGatewayLLMModelAPI, ModifyCloudNativeAPIGatewayLLMModelAPI。

名称	类型	必选	描述
Rules	Array of AIGWLatencyPriorityRouteRule	是	路由规则列表
LatencyMetric	String	是	延迟指标 枚举值： LLMLatency： LLM 延迟 NetworkLatency： 网络延迟 示例值：LLMLatency
RouteMode	String	否	路由策略 枚举值： FastMode： 快速模式 BalanceMode： 均衡模式 示例值：BalanceMode

AIGWLatencyPriorityRouteRule

AI 网关延迟优先路由模型服务

被如下接口引用：CreateCloudNativeAPIGatewayLLMModelAPI, ModifyCloudNativeAPIGatewayLLMModelAPI。

名称	类型	必选	描述
ModelServiceId	String	是	模型服务id 示例值：4d3b21814ff540b6a1b3bc3c46a62793

AIGWLogConfig

AI 网关日志输出配置

被如下接口引用：CreateCloudNativeAPIGatewayLLMModelAPI, DescribeCloudNativeAPIGatewayLLMModelAPI, ModifyCloudNativeAPIGatewayLLMModelAPI。

名称	类型	必选	描述
EnableRequestLogPayloads	Boolean	否	是否开启请求 payload 记录日志 示例值：true
EnableResponseLogPayloads	Boolean	否	是否开启响应 payload 记录日志 示例值：true
RequestLogPayloadMaxSize	Integer	否	日志记录的请求body的最大字节数 取值范围：[512, 1048576] EnableRequestLogPayloads 为true时必填 示例值：4096
ResponseLogPayloadMaxSize	Integer	否	日志记录的响应body的最大字节数 取值范围：[512, 1048576] EnableResponseLogPayloads 为true时必填 示例值：32768

AIGWLogDesensitizeConfig

AI 网关 B 层日志脱敏配置（写入 LLM Log 前对 payload 掩码）

被如下接口引用：DescribeCloudNativeAPIGatewayLLMModelAPI。

名称	类型	必选	描述
Enabled	Boolean	是	日志脱敏开关 示例值：true
PredefinedRuleTypes	Array of String	否	预定义规则类型 枚举值： Phone： 电话号码 IdCard： 身份证号 BankCard： 银行卡号 Email： 邮箱地址 IP： IP地址 Name： 姓名 示例值：["Phone"]
CustomRules	Array of AIGWCustomDesensitizeRule	否	自定义脱敏规则
Scope	Array of String	否	日志脱敏范围 枚举值： Request： 请求 Response： 响应 示例值：["Request"]

AIGWMCPServer

MCP Server详情

被如下接口引用：DescribeCloudNativeAPIGatewayMCPServer, DescribeCloudNativeAPIGatewayMCPServerList。

名称	类型	必选	描述
ServerId	String	是	MCP Server ID 示例值：667065f5-6796-4430-b987-9a8b43c3d5b1
Name	String	是	MCP Server名称 示例值：gitee
ServerType	String	是	MCP Server类型，取值：MCP/Rest2MCP 示例值：MCP
Transport	String	是	协议类型，取值: StreamableHttp 示例值：StreamableHttp
UpstreamType	String	是	服务类型： Registry HostIP 示例值：HostIP
DisplayName	String	否	展示名字 示例值：giteeasd
MCPEndpoint	String	否	MCP提供给客户端的Endpoint 示例值：/mcpservers/gitee/mcp
UpstreamInfo	AIGWMCPUpstreamInfoDetail	否	注册中心来源信息 注意：此字段可能返回 null，表示取不到有效值。
SessionConfig	AIGWMCPSessionConfig	否	会话配置 注意：此字段可能返回 null，表示取不到有效值。
Timeout	Integer	否	超时时间，单位ms 示例值：3000
RetryCount	Integer	否	失败重试次数 示例值：3
CreateTime	String	否	创建时间 示例值：2026-04-15 16:50:50
UpdateTime	String	否	更新时间 示例值：2026-04-15 16:54:34
Description	String	否	描述 示例值：webflux-mcp-server
Status	String	否	运行状态 枚举值： Online： 在线 Offline： 离线 Error： 错误 示例值：Online
EnableHealthCheck	Boolean	否	是否启用健康检查 示例值：true
HealthCheck	AIGWHealthCheckSetting	否	健康检查配置 注意：此字段可能返回 null，表示取不到有效值。
ToolCountLimit	Integer	否	Tool分组内工具数量限制 示例值：100
ConflictStrategy	String	否	Tool分组内工具命名冲突策略 枚举值： AutoPrefix： 自动前缀 Reject： 拒绝 示例值：AutoPrefix
MarketStatus	String	否	MCP 市场发布状态 枚举值： None： 未发布 Published： 已发布 示例值：None

AIGWMCPServerACLResult

AI 网关 MCP Server ACL 配置详情

被如下接口引用：DescribeCloudNativeAPIGatewayMCPServerACL。

名称	类型	描述
ACLType	String	黑白名单鉴权类型 枚举值： None： 不鉴权 Allow： 白名单 Deny： 黑名单 示例值：Deny
ACLConsumers	Array of AIGWACLSubject	关联的消费者ID列表
ACLConsumerGroups	Array of AIGWACLSubject	关联的消费者组ID列表
AuthType	String	认证类型 枚举值： None： 无认证 ApiKey： API Key认证 示例值：ApiKey

AIGWMCPServerAuthResult

AI 网关 MCP Server 认证配置详情

被如下接口引用：DescribeCloudNativeAPIGatewayMCPServerAuth。

名称	类型	描述
AuthType	String	MCP服务认证类型 枚举值： None： 无认证 ApiKey： API Key认证 示例值：ApiKey

AIGWMCPServerList

MCP Server 列表

被如下接口引用：DescribeCloudNativeAPIGatewayMCPServerList。

名称	类型	必选	描述
TotalCount	Integer	是	总数 示例值：4
DataList	Array of AIGWMCPServer	否	mcp server 数据列表 注意：此字段可能返回 null，表示取不到有效值。

AIGWMCPSessionConfig

云原生网关MCP会话配置

被如下接口引用：CreateCloudNativeAPIGatewayMCPServer, DescribeCloudNativeAPIGatewayMCPServer, ModifyCloudNativeAPIGatewayMCPServer。

名称	类型	必选	描述
SessionStorage	String	否	会话存储类型 枚举值： memory： 内存 redis： redis 示例值：redis
RedisConfig	AIGWRedisConfig	否	Redis配置

AIGWMCPToolACLItem

AI 网关 Tool ACL 单条记录（DescribeMCPToolACLList 数组元素）

被如下接口引用：DescribeCloudNativeAPIGatewayMCPToolACLList。

名称	类型	描述
ToolId	String	MCP工具ID 示例值：****----****
ToolName	String	MCP工具名称 示例值：get_weather_mock
ACLType	String	MCP工具鉴权类型 枚举值： None： 继承server鉴权类型 Allow： 白名单 Deny： 黑名单 示例值：None
ACLConsumers	Array of AIGWACLSubject	关联的消费者ID列表
ACLConsumerGroups	Array of AIGWACLSubject	关联的消费者组ID列表

AIGWMCPToolACLListResult

AI 网关 mcp server 下所有 tool 的 ACL 状态

被如下接口引用：DescribeCloudNativeAPIGatewayMCPToolACLList。

名称	类型	描述
ACLType	String	黑白名单鉴权类型 枚举值： None： 不鉴权 Allow： 白名单 Deny： 黑名单 示例值：Deny
DataList	Array of AIGWMCPToolACLItem	数据列表
TotalCount	Integer	计数 示例值：0

AIGWMCPUpstreamInfo

云原生网关MCP后端信息,用于创建、修改请求

被如下接口引用：CreateCloudNativeAPIGatewayMCPServer, ModifyCloudNativeAPIGatewayMCPServer。

名称	类型	必选	描述
SourceId	String	否	注册中心来源ID 示例值：ins-2c6758fb
Namespace	String	否	命名空间 示例值：public
MCPServerId	String	否	MCP服务 id 示例值：06d46e56-ff98-4745-861d-66f61742e3fd
Protocol	String	否	协议，UpstreamType是Registry 时必传 http https 示例值：https
Host	String	否	域名或ip 示例值：api.gitee.com
Port	Integer	否	端口 示例值：443
ServiceId	String	否	服务 id 示例值：4e141ac6-f0cd-4d35-80f0-75e47f5d56a6
ServiceGroup	String	否	服务分组 示例值：mcp-server
MCPEndpoint	String	否	mcp endpoint 示例值：/mcp
MessageEndpoint	String	否	message端点路径，SSE协议时配置 示例值：/message

AIGWMCPUpstreamInfoDetail

云原生网关MCP后端信息，用于展示

被如下接口引用：DescribeCloudNativeAPIGatewayMCPServer。

名称	类型	必选	描述
SourceId	String	否	注册中心来源ID 示例值：ins-2c6758fb
SourceName	String	否	注册中心来源名称, 入参不传，用于返回 示例值：jensonzheng-mcp
Namespace	String	否	命名空间 示例值：public
MCPServerId	String	否	服务 id 示例值：06d46e56-ff98-4745-861d-66f61742e3fd
Protocol	String	否	协议，UpstreamType是Registry 时必传 http https 示例值：https
Host	String	否	域名或ip 示例值：api.gitee.com
Port	Integer	否	端口 示例值：443
ServiceId	String	否	服务 id 示例值：4e141ac6-f0cd-4d35-80f0-75e47f5d56a6
ServiceName	String	否	服务名字 示例值：dev
ServiceGroup	String	否	服务分组 示例值：mcp-server
MCPEndpoint	String	否	mcp endpoint 示例值：/mcp
MessageEndpoint	String	否	SSE message路径 示例值：/message

AIGWRedisConfig

精确缓存 redis 配置

被如下接口引用：CreateCloudNativeAPIGatewayMCPServer, ModifyCloudNativeAPIGatewayMCPServer。

名称	类型	必选	描述
Host	String	是	Host 示例值：10.0.2.193
Port	Integer	是	端口 示例值：6379
Username	String	否	用户名 示例值：aigw
Password	String	否	密码 示例值：Tsf123456+

AIGWTagFilter

AI网关标签过滤

被如下接口引用：CreateCloudNativeAPIGatewayLLMModelAPI, DescribeCloudNativeAPIGatewayLLMModelAPI, ModifyCloudNativeAPIGatewayLLMModelAPI。

名称	类型	必选	描述
MatchStrategy	String	否	匹配策略 枚举值： AND： 并 OR： 或 示例值：OR
Tags	Array of String	否	标签 示例值：["env:dev"]

AIGWTopConsumersItem

最高Token用量消费者

被如下接口引用：DescribeCloudNativeAPIGatewayLLMTokenUsageStatistics。

名称	类型	描述
ConsumerId	String	消费者Id 示例值：02b4d312-2fcd-4995-ae7c-5acaa57962b7
ConsumerName	String	消费者名称 示例值：test-consumer-2
TotalTokens	Integer	该消费者花费的Token数 示例值：6705

CNAPIGwConsumer

消费者结构

被如下接口引用：DescribeCloudNativeAPIGatewayConsumer。

名称	类型	必选	描述
ConsumerId	String	是	消费者 ID。 示例值：consumer-xxx
Name	String	是	名字 示例值：消费者名称
CreateTime	String	是	创建时间 示例值：2023-01-01 10:00:00
ModifyTime	String	是	更新时间 yyyy-MM-dd hh:mm:ss 示例值：2023-01-01 10:00:00
Description	String	否	描述 注意：此字段可能返回 null，表示取不到有效值。 示例值：消费者描述
ConsumerGroups	Array of CNAPIGwConsumerGroup	否	消费者分组 注意：此字段可能返回 null，表示取不到有效值。

CNAPIGwConsumerGroup

消费者组结构

被如下接口引用：DescribeCloudNativeAPIGatewayConsumer, DescribeCloudNativeAPIGatewayConsumerGroup。

名称	类型	必选	描述
ConsumerGroupId	String	是	分组id 示例值：cg-xxx
Name	String	是	名字 示例值：消费者组名称
Status	String	是	状态Disable/Enable 示例值：Enable
Description	String	是	描述 示例值：消费者组描述
CreateTime	String	否	创建时间 示例值：2023-01-01 10:00:00
ModifyTime	String	否	更新时间 yyyy-MM-dd hh:mm:ss 示例值：2023-01-01 10:00:00
BindCount	Integer	否	绑定的消费者数量 注意：此字段可能返回 null，表示取不到有效值。 示例值：0

CNAPIGwCreateCommonResult

创建资源通用结果

被如下接口引用：CreateCloudNativeAPIGatewayConsumer, CreateCloudNativeAPIGatewayConsumerGroup, CreateCloudNativeAPIGatewayMCPServer, CreateCloudNativeAPIGatewayMCPTool, CreateCloudNativeAPIGatewaySecretKey。

名称	类型	必选	描述
Success	Boolean	否	是否成功 示例值：true
ID	String	否	对应的id 值 示例值：consumer-xxx

CNAPIGwMCPTool

MCP Tool 信息

被如下接口引用：DescribeCloudNativeAPIGatewayMCPToolList。

名称	类型	必选	描述
Name	String	是	名字 示例值：createPet7
DisplayName	String	是	展示名字 示例值：createPet7
Method	String	是	方法 枚举值： GET： GET POST： POST PUT： PUT DELETE： DELETE PATCH： PATCH 示例值：POST
Description	String	是	描述 示例值：创建订单
ToolId	String	否	工具 id 示例值：3aab6316-69bb-4610-b10c-479c9320f1b0
ContentType	String	否	报文格式 示例值：application/json
ServiceId	String	否	服务 id 注意：此字段可能返回 null，表示取不到有效值。 示例值：4e141ac6-f0cd-4d35-80f0-75e47f5d56a6
Path	String	否	路径 示例值：/api/orders
InputParams	Array of CNAPIGwMCPToolParam	否	参数
CreateTime	String	否	创建时间 参数格式：yyyy-MM-dd hh:mm:ss 示例值：2026-04-15 17:44:41
UpdateTime	String	否	更新时间 参数格式：yyyy-MM-dd hh:mm:ss 示例值：2026-04-15 17:46:32
Status	String	否	tool状态 枚举值： Enable： 启用 Disable： 禁用 示例值：Enable
CurrentVersion	String	否	当前版本号 示例值：default

CNAPIGwMCPToolList

MCP Tool 列表

被如下接口引用：DescribeCloudNativeAPIGatewayMCPToolList。

名称	类型	必选	描述
DataList	Array of CNAPIGwMCPTool	否	MCPTool 列表
TotalCount	Integer	否	总数 示例值：1

CNAPIGwMCPToolParam

MCP tool 参数

被如下接口引用：DescribeCloudNativeAPIGatewayMCPToolList, ModifyCloudNativeAPIGatewayMCPTool。

名称	类型	必选	描述
Name	String	是	名字 示例值：tag
Type	String	是	参数类型 枚举值： string： 字符串 number： 数字 boolean： 布尔 array： 数组 object： 对象 示例值：number
Required	Boolean	是	必填 示例值：true
Position	String	是	位置 枚举值： query： query path： query header： header body： body 示例值：query
Description	String	否	描述 示例值：Pet name
Default	String	否	默认值 示例值：20
Items	CNAPIGwMCPToolParam	否	数组子项
Properties	Array of CNAPIGwMCPToolParam	否	对象属性
BackendName	String	否	转发到后端的名称 不填则使用原始名称 示例值：city

CNAPIGwSecretKey

密钥信息

被如下接口引用：DescribeCloudNativeAPIGatewaySecretKey。

名称	类型	必选	描述
SecretKeyId	String	否	密钥id 示例值：secret-xxx
Name	String	否	密钥名字 示例值：name
SecretType	String	否	密钥协议类型。 示例值：ApiKey
Status	String	否	状态。 枚举值： Enable： 启用 Disable： 禁用 示例值：Enable
GenerateType	String	否	密钥生成方式。 枚举值： System： 系统自动生成 Custom： 用户自定义 KMS： 使用 KMS 密钥 示例值：KMS
SecretValue	String	否	密钥明文 示例值：value
KmsKeyName	String	否	KMS凭证名字 注意：此字段可能返回 null，表示取不到有效值。 示例值：name
KmsKeyVersion	String	否	KMS凭证版本 注意：此字段可能返回 null，表示取不到有效值。 示例值：value
Description	String	否	描述 注意：此字段可能返回 null，表示取不到有效值。 示例值：密钥描述
CanBind	Boolean	否	是否可以绑定 注意：此字段可能返回 null，表示取不到有效值。 示例值：true
CreateTime	String	否	创建时间 示例值：2025-11-11 11:11:11
ModifyTime	String	否	修改时间 示例值：2025-11-11 11:11:11
BindCount	Integer	否	绑定数 示例值：0
ResourceType	String	否	密钥归属资源类型。 枚举值： Consumer： 消费者 ModelService： 模型服务 示例值：Consumer

CloudNativeAPIGatewayLLMModelAPI

LLM 模型 API

被如下接口引用：DescribeCloudNativeAPIGatewayLLMModelAPI, DescribeCloudNativeAPIGatewayLLMModelAPIs。

名称	类型	必选	描述
Id	String	否	模型 API ID。 示例值：9006154d-8770-xx
CreateTime	String	否	创建时间 示例值：2021-09-09 11:52:30
ModifyTime	String	否	修改时间 示例值：2021-09-09 11:52:30
Name	String	否	AI 网关 LLM 模型 API 的唯一标识名称，格式规则：2-50 字符，支持英文、数字、下划线。 示例值：openai_chat
SceneType	String	否	选择业务场景,xa0 选项：Chat（聊天）。 示例值：Chat
RequestProtocol	String	否	业务场景对应的请求协议，选项：OpenAI（目前只支持 OpenAI）。 示例值：OpenAI
RouteList	Array of DefaultKongRoute	否	路由列表
BasePath	String	否	为API设置统一的前缀，格式：以/开头，支持字母、数字、短横线。 示例值：/base/qq
StripPath	Boolean	否	路径简化， 启用时：客户端请求路径 → 移除Base Path → 后端接收简洁路径 禁用时：客户端请求路径 → 完整传递给后端。 示例值：true
Description	String	否	模型 API 的相关描述。 示例值：大模型统一聊天 API
ModelServiceId	String	否	模型服务Id 示例值：8006154d-8770-xx
ModelServiceName	String	否	模型服务名称 示例值：openai 服务
ModelServiceRoute	CloudNativeAPIGatewayLLMModelServiceRoute	否	模型服务路由策略（是指如何路由到模型服务）
MatchHeaders	Array of AIGWKVMatch	否	无
EnableCrossServiceFallback	Boolean	否	是否开启跨服务fallback 示例值：true
CrossServiceFallbackConfig	AIGWCrossServiceFallbackConfig	否	跨服务fallback配置详情
DescribeCloudNativeAPIGatewayLLMModelAPI	Boolean	否	是否展示模型API 示例值：true
TagFilter	AIGWTagFilter	否	标签
LogConfig	AIGWLogConfig	否	日志显示相关开关
LogDesensitizeConfig	AIGWLogDesensitizeConfig	否	日志脱敏规则
ForwardDesensitizeConfig	AIGWForwardDesensitizeConfig	否	转发脱敏规则

CloudNativeAPIGatewayLLMModelFallbackRule

LLM-单模型内降级规则

被如下接口引用：CreateCloudNativeAPIGatewayLLMModelService, DescribeCloudNativeAPIGatewayLLMModelService, DescribeCloudNativeAPIGatewayLLMModelServices, ModifyCloudNativeAPIGatewayLLMModelService。

名称	类型	必选	描述
FallbackModels	Array of String	否	备选模型，主模型不可用时将依次按顺序尝试。 示例值：["gpt-5.1","gpt-5-mini"]

CloudNativeAPIGatewayLLMModelParamCheckInfo

LLM-模型参数检查信息

被如下接口引用：CreateCloudNativeAPIGatewayLLMModelService, DescribeCloudNativeAPIGatewayLLMModelService, DescribeCloudNativeAPIGatewayLLMModelServices, ModifyCloudNativeAPIGatewayLLMModelService。

名称	类型	必选	描述
AllowModelList	Array of String	否	允许的模型列表。 示例值：["gpt-5.1","gpt-5-mini"]
ModelValidationFailureStrategy	String	否	模型参数校验失败时的处理策略，选项：Return404（返回404）、FallBackToDefaultModel（使用默认模型降级）。 示例值：Return404

CloudNativeAPIGatewayLLMModelService

LLM 模型服务

被如下接口引用：DescribeCloudNativeAPIGatewayLLMModelService, DescribeCloudNativeAPIGatewayLLMModelServices。

名称	类型	必选	描述
Id	String	否	模型服务 ID。 示例值：9006154d-8770-xx
Name	String	否	模型服务名称。 示例值：openai-test
CreateTime	String	否	创建时间。 示例值：2021-09-09 11:52:30
ModifyTime	String	否	修改时间。 示例值：2021-09-09 11:52:30
ServiceType	String	否	服务类型，目前只支持xa0LLMService。 示例值：LLMService
ModelProvider	String	否	选择模型提供商, 选项：OpenAI、Anthropic、Azure OpenAI、自定义HTTP。 示例值：OpenAI
ModelProtocol	String	否	API协议标准，根据供应商动态变化：OpenAI→OpenAI/v1，Anthropic→Anthropic/v1等 示例值：OpenAI/v1
UpstreamURL	String	否	自定义的模型请求 URL。 示例值：https://api.openai.com/v1
ModelSelector	String	否	模型选择方式，选项：Specify（指定模型）、PassThrough（透传请求模型）。 示例值：Specify
DefaultModel	String	否	默认模型，模型选择方式为 Specify 时必填。 示例值：gpt-4.1
EnableModelFallback	Boolean	否	开启模型降级，模型选择方式为 Specify 时必填。 示例值：true
ModelFallbackRule	CloudNativeAPIGatewayLLMModelFallbackRule	否	可以配置备用模型规则，EnableSpecifyModelFallbackxa0为 true 时必填。
EnableModelParamCheck	Boolean	否	开启模型参数校验，是否校验客户端传递的 model 参数,xa0模型选择方式为 PassThrough 时必填。 示例值：true
ModelParamCheckRule	CloudNativeAPIGatewayLLMModelParamCheckInfo	否	模型检验信息，EnableModelParamCheckxa0为 true 时必填。
Description	String	否	描述。 示例值：OpenAI 模型服务
ConnectTimeout	Integer	否	连接超时时间 取值范围：[1, 3600000] 单位：毫秒 默认值：10000 示例值：10000
WriteTimeout	Integer	否	写入超时时间 取值范围：[1, 3600000] 单位：毫秒 默认值：60000 示例值：60000
ReadTimeout	Integer	否	读取超时时间 取值范围：[1, 3600000] 单位：毫秒 示例值：60000
Retries	Integer	否	重试次数 取值范围：[0, 5] 单位：次 默认值：0 示例值：0
UpstreamUrlMode	String	否	路径拼接模式 枚举值： FixedPath： 固定路径 AutoConcat： 自动拼接 示例值：FixedPath
SNI	String	否	sni 示例值：generativelanguage.googleapis.com
QuotaLimit	AIGWLLMQuotaLimit	否	配额限制
Tags	String	否	标签 示例值：["capability:code"]
SecretKeyIds	Array of String	否	绑定的模型服务秘钥 示例值：["sk-hjegh"]

CloudNativeAPIGatewayLLMModelServiceRoute

模型服务路由配置

被如下接口引用：CreateCloudNativeAPIGatewayLLMModelAPI, DescribeCloudNativeAPIGatewayLLMModelAPI, ModifyCloudNativeAPIGatewayLLMModelAPI。

名称	类型	必选	描述
SelectedTypes	Array of String	是	生效的路由算法类型：权重路由，模型名称路由、参数路由等Weighted/ModelName/Query (预留多个，暂时只能填写一个) 示例值：["ModelName"]
WeightedConfig	Array of CloudNativeAPIGatewayLLMModelServiceRouteWeightedStrategy	否	权重路由配置，最多10个
ModelNameConfig	Array of CloudNativeAPIGatewayLLMModelServiceRouteModelNameStrategy	否	模型名称路由配置，最多10个
IntentRouteConfig	AIGWIntentRoute	否	意图识别
LatencyPriorityConfig	AIGWLatencyPriorityConfig	否	延迟路由

CloudNativeAPIGatewayLLMModelServiceRouteModelNameStrategy

模型服务模型名称路由策略

被如下接口引用：CreateCloudNativeAPIGatewayLLMModelAPI, ModifyCloudNativeAPIGatewayLLMModelAPI。

名称	类型	必选	描述
ModelServiceId	String	是	模型服务id 示例值：5b5b32f09bc24278a35541aa450cbbf3
MatchModelName	String	是	匹配模型服务 示例值：gen
RewriteModelName	String	否	重写模型 示例值：gemini-2.5-flash

CloudNativeAPIGatewayLLMModelServiceRouteWeightedStrategy

权重路由配置

被如下接口引用：CreateCloudNativeAPIGatewayLLMModelAPI, ModifyCloudNativeAPIGatewayLLMModelAPI。

名称	类型	必选	描述
ModelServiceId	String	是	模型服务id 示例值：5b5b32f09bc24278a35541aa450cbbf3
Weight	Integer	是	权重值 示例值：100

DefaultKongRoute

默认kong路由，目前只在 LLM 模型 API相 关接口使用

被如下接口引用：CreateCloudNativeAPIGatewayLLMModelAPI, DescribeCloudNativeAPIGatewayLLMModelAPI。

名称	类型	必选	描述
Name	String	是	服务名字 示例值：test-service
ID	String	否	服务ID 示例值：916462a4-8ce4-4605-a7b7-66cd51c38201
Methods	Array of String	否	HTTP Method 示例值：["GET"]
Paths	Array of String	否	Http Path 示例值：["/v1/users"]

Filter

查询过滤通用对象

被如下接口引用：DescribeCloudNativeAPIGatewayLLMModelAPIs, DescribeCloudNativeAPIGatewayLLMModelServices, DescribeCloudNativeAPIGatewayLLMTokenUsageList, DescribeCloudNativeAPIGatewayLLMTokenUsageStatistics。

名称	类型	必选	描述
Name	String	是	过滤参数名
Values	Array of String	是	过滤参数值

ListCloudNativeAPIGatewayLLMModelAPI

LLM 模型 API 列表

被如下接口引用：DescribeCloudNativeAPIGatewayLLMModelAPIs。

名称	类型	描述
TotalCount	Integer	总数 示例值：10
DataList	Array of CloudNativeAPIGatewayLLMModelAPI	AI 网关模型 API 列表。

ListCloudNativeAPIGatewayLLMModelService

LLM 模型服务列表

被如下接口引用：DescribeCloudNativeAPIGatewayLLMModelServices。

名称	类型	描述
TotalCount	Integer	模型服务数量。 示例值：3
DataList	Array of CloudNativeAPIGatewayLLMModelService	模型服务列表。