/** * CreateCloudNativeAPIGatewayMCPTool请求参数结构体 */ export interface CreateCloudNativeAPIGatewayMCPToolRequest { /** *

内容类型

*/ ContentType: string; /** *

展示名字

*/ DisplayName?: string; /** *

服务 id

*/ ServiceId?: string; } /** * DescribeCloudNativeAPIGatewayLLMModelServices返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayLLMModelServicesResponse { /** *

模型服务列表。

*/ Result?: ListCloudNativeAPIGatewayLLMModelService; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyCloudNativeAPIGatewayConsumerGroup返回参数结构体 */ export interface ModifyCloudNativeAPIGatewayConsumerGroupResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayMCPServerACL请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPServerACLRequest { /** *

网关实例 ID

*/ GatewayId: string; /** *

MCP服务ID

*/ ServerId: string; } /** * DeleteCloudNativeAPIGatewayMCPTool返回参数结构体 */ export interface DeleteCloudNativeAPIGatewayMCPToolResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateCloudNativeAPIGatewayMCPServer请求参数结构体 */ export interface CreateCloudNativeAPIGatewayMCPServerRequest { /** *

实例 ID

*/ GatewayId: string; /** *

名字

*/ Name: string; /** *

展示名字

*/ DisplayName: string; /** *

MCP服务类型

*/ ServerType: string; /** *

传输协议:StreamableHttp或SSE

枚举值:

*/ Transport: string; /** *

后端类型

枚举值:

*/ UpstreamType: string; /** *

注册中心来源信息

*/ UpstreamInfo?: AIGWMCPUpstreamInfo; /** *

会话配置

*/ SessionConfig?: AIGWMCPSessionConfig; /** *

超时时间,单位ms,最大60000

*/ Timeout?: number; /** *

重试次数,最大3次

*/ RetryCount?: number; /** *

描述

*/ Description?: string; /** *

是否启用健康检查

*/ EnableHealthCheck?: boolean; /** *

健康检查配置

*/ HealthCheck?: AIGWHealthCheckSetting; /** *

是否开启保留原Host功能

*/ PreserveHost?: boolean; } /** * DeleteCloudNativeAPIGatewaySecretKey请求参数结构体 */ export interface DeleteCloudNativeAPIGatewaySecretKeyRequest { /** * 网关ID */ GatewayId: string; /** * 密钥id */ SecretKeyId: string; } /** * 云原生网关MCP后端信息,用于创建、修改请求 */ export interface AIGWMCPUpstreamInfo { /** *

注册中心来源ID

*/ SourceId?: string; /** *

命名空间

*/ Namespace?: string; /** *

MCP服务 id

*/ MCPServerId?: string; /** *

协议,UpstreamType是Registry 时必传

*/ Protocol?: string; /** *

域名或ip

*/ Host?: string; /** *

端口

*/ Port?: number; /** *

服务 id

*/ ServiceId?: string; /** *

服务分组

*/ ServiceGroup?: string; /** *

mcp endpoint

*/ MCPEndpoint?: string; /** *

message端点路径,SSE协议时配置

*/ MessageEndpoint?: string; /** *

TLS认证配置

*/ TLSConfig?: AIGWUpstreamTLSConfig; } /** * 单个消费者 Token 用量查询结果 */ export interface AIGWLLMTokenUsageItem { /** *

消费者Id

*/ ConsumerId?: string; /** *

消费者名称

*/ ConsumerName?: string; /** *

消费者组信息列表

*/ ConsumerGroups?: Array; /** *

模型服务Id

*/ ModelServiceId?: string; /** *

模型服务名称

*/ ModelServiceName?: string; /** *

输入Token数(包含缓存命中Token数)

*/ InputTokens?: number; /** *

命中缓存输入Token数

*/ CacheReadInputTokens?: number; /** *

输出Token数

*/ OutputTokens?: number; /** *

消耗总Token数

*/ TotalTokens?: number; /** *

请求总数

*/ RequestCount?: number; /** *

花费成本

*/ Cost?: string; /** *

成本货币单位

枚举值:

当前仅支持CNY

*/ Currency?: string; } /** * DeleteCloudNativeAPIGatewayMCPTool请求参数结构体 */ export interface DeleteCloudNativeAPIGatewayMCPToolRequest { /** *

网关实例ID

*/ GatewayId: string; /** *

工具id

*/ ToolId: string; /** *

MCP 服务 id

*/ ServerId: string; } /** * 精确缓存 redis 配置 */ export interface AIGWRedisConfig { /** *

Host

*/ Host?: string; /** *

端口

*/ Port?: number; /** *

用户名

*/ Username?: string; /** *

密码

*/ Password?: string; /** *

Redis配置ID

*/ RedisConfigId?: string; /** *

Redis部署类型,如standalone(单机)、cluster(集群)

*/ Type?: string; } /** * AI 网关意图路由配置 */ export interface AIGWIntentRoute { /** *

意图识别模型id

*/ IntentModelServiceId: string; /** *

置信度

*/ ConfidenceThreshold: number; /** *

默认服务id

*/ DefaultModelServiceId: string; /** *

规则

*/ Rules?: Array; } /** * 查询过滤通用对象 */ export interface Filter { /** * 过滤参数名 */ Name: string; /** * 过滤参数值 */ Values: Array; } /** * 降级服务元素 */ export interface AIGWFallbackServiceItem { /** *

模型服务 Id

*/ ModelServiceId: string; /** *

模型服务名

*/ ModelServiceName?: string; } /** * DescribeCloudNativeAPIGatewaySecretKeyValue请求参数结构体 */ export interface DescribeCloudNativeAPIGatewaySecretKeyValueRequest { /** * 实例 ID */ GatewayId: string; /** * 密钥id */ SecretKeyId: string; } /** * AI 网关延迟优先路由模型服务 */ export interface AIGWLatencyPriorityRouteRule { /** *

模型服务id

*/ ModelServiceId: string; } /** * AI网关 Basic Auth 凭证物料配置 */ export interface AIGWBasicCredentialConfig { /** *

密码

*/ Password?: string; /** *

用户名

*/ Username?: string; } /** * AI 网关中消费者组简要信息 */ export interface AIGWConsumerGroupBrief { /** *

消费者组名称

*/ Name?: string; /** *

消费者组Id

*/ ConsumerGroupId?: string; } /** * DeleteCloudNativeAPIGatewayConsumer返回参数结构体 */ export interface DeleteCloudNativeAPIGatewayConsumerResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * RemoveCloudNativeAPIGatewayConsumerGroupAuth返回参数结构体 */ export interface RemoveCloudNativeAPIGatewayConsumerGroupAuthResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * AI 网关Rerank场景最大文档数限制配置 */ export interface AIGWRerankMaxDocumentsConfig { /** *

启用最大文档数限制

*/ EnableMaxDocuments: boolean; /** *

Rerank场景最大文档数限制

*/ MaxDocumentValue?: number; } /** * 默认kong路由,目前只在 LLM 模型 API相 关接口使用 */ export interface DefaultKongRoute { /** *

服务名字

*/ Name: string; /** *

服务ID

*/ ID?: string; /** *

HTTP Method

*/ Methods?: Array; /** *

Http Path

*/ Paths?: Array; } /** * Key/Value结构 */ export interface KeyValue { /** * 条件的Key */ Key?: string; /** * 条件的Value */ Value?: string; } /** * 路由匹配规则 */ export interface AIGWKVMatch { /** *

键

*/ Key: string; /** *

值

*/ Value: string; /** *

操作类型

*/ Operator: string; } /** * DescribeCloudNativeAPIGatewayMCPServerAuth返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPServerAuthResponse { /** *

MCP服务认证查询结果

*/ Result?: AIGWMCPServerAuthResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayConsumer请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayConsumerRequest { /** *

网关实例id

*/ GatewayId: string; /** *

消费者ID

*/ ConsumerId: string; } /** * DescribeCloudNativeAPIGatewayLLMModelService请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayLLMModelServiceRequest { /** *

网关 id。

*/ GatewayId: string; /** *

模型服务 ID,全局唯一标识。

*/ ModelServiceId: string; } /** * AI 网关 ACL 授权主体(Consumer / ConsumerGroup 共用结构),用于响应中回显 Id + Name,减少前端多次查询调用 */ export interface AIGWACLSubject { /** *

鉴权主体ID

*/ Id?: string; /** *

鉴权主体名称

*/ Name?: string; } /** * 权重路由配置 */ export interface CloudNativeAPIGatewayLLMModelServiceRouteWeightedStrategy { /** *

模型服务id

*/ ModelServiceId: string; /** *

权重值

*/ Weight: number; } /** * DescribeCloudNativeAPIGatewayMCPToolsFromFile接口的出参 */ export interface CNAPIGwParseMCPToolsResult { /** *

MCP Tools列表

*/ DataList?: Array; /** *

MCP tools的数量

*/ TotalCount?: number; } /** * ModifyCloudNativeAPIGatewaySecretKey返回参数结构体 */ export interface ModifyCloudNativeAPIGatewaySecretKeyResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * AddCloudNativeAPIGatewayConsumerInGroup返回参数结构体 */ export interface AddCloudNativeAPIGatewayConsumerInGroupResponse { /** *

是否成功。

*/ Result?: boolean; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * AI 网关指定模型路由(暂时只用在Token长度路由时的子路由选择) */ export interface AIGWRouteModelServiceConfig { /** *

模型服务名字

*/ ModelServiceName?: string; } /** * AI网关标签过滤 */ export interface AIGWTagFilter { /** *

匹配策略

枚举值:

  • AND: 并
  • OR: 或
*/ MatchStrategy?: string; /** *

标签

*/ Tags?: Array; } /** * LLM-模型参数检查信息 */ export interface CloudNativeAPIGatewayLLMModelParamCheckInfo { /** * 允许的模型列表。 */ AllowModelList?: Array; /** * 模型参数校验失败时的处理策略,选项:Return404(返回404)、FallBackToDefaultModel(使用默认模型降级)。 */ ModelValidationFailureStrategy?: string; } /** * DescribeCloudNativeAPIGatewayMCPToolACLList返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPToolACLListResponse { /** *

MCP 服务 Tool ACL 列表结果

*/ Result?: AIGWMCPToolACLListResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyCloudNativeAPIGatewayMCPServerAuth返回参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPServerAuthResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateCloudNativeAPIGatewayConsumerGroup请求参数结构体 */ export interface CreateCloudNativeAPIGatewayConsumerGroupRequest { /** *

网关实例id

*/ GatewayId: string; /** *

消费者组名称,最长 60 字符。同一网关下唯一。

*/ Name: string; /** *

启用状态。

枚举值:

  • Enable:启用
  • Disable:禁用
*/ Status: string; /** *

消费者组描述。最长 200 字符。

*/ Description?: string; } /** * 密钥信息 */ export interface CNAPIGwSecretKey { /** *

绑定数

*/ BindCount?: number; /** *

是否可以绑定

注意:此字段可能返回 null,表示取不到有效值。 */ CanBind?: boolean; /** *

创建时间

*/ CreateTime?: string; /** *

描述

注意:此字段可能返回 null,表示取不到有效值。 */ Description?: string; /** *

密钥生成方式。

枚举值:

  • System: 系统自动生成
  • Custom: 用户自定义
  • KMS: 使用 KMS 密钥
*/ GenerateType?: string; /** *

JWT凭证配置

*/ JWTCredentialConfig?: AIGWJWTCredentialConfig; /** *

KMS凭证名字

注意:此字段可能返回 null,表示取不到有效值。 */ KmsKeyName?: string; /** *

KMS凭证版本

注意:此字段可能返回 null,表示取不到有效值。 */ KmsKeyVersion?: string; /** *

修改时间

*/ ModifyTime?: string; /** *

密钥名字

*/ Name?: string; /** *

OAuth2凭证配置

*/ OAuthCredentialConfig?: AIGWOAuthCredentialConfig; /** *

OIDC凭证配置

*/ OIDCCredentialConfig?: AIGWOIDCCredentialConfig; /** *

Agent 密钥类型

*/ Provider?: string; /** *

密钥归属资源类型。

枚举值:

  • Consumer: 消费者
  • ModelService: 模型服务
*/ ResourceType?: string; /** *

密钥id

*/ SecretKeyId?: string; /** *

密钥协议类型。

*/ SecretType?: string; /** *

密钥明文

*/ SecretValue?: string; /** *

状态。

枚举值:

  • Enable: 启用
  • Disable: 禁用
*/ Status?: string; /** *

同步状态

枚举值:

  • Fail: 失败
  • Success: 成功
*/ SyncStatus?: string; /** *

资源类型

枚举值:

  • Public: 公共
  • Private: 私有
  • SourceDeleted: 资源删除
*/ SourceType?: string; /** *

同步版本

*/ SyncedVersion?: string; /** *

AK/SK凭证配置

*/ AKSKCredentialConfig?: AIGWAKSKCredentialConfig; /** *

CAM凭证配置

*/ CAMCredentialConfig?: AIGWCAMCredentialConfig; /** *

Bearer Token凭证配置

*/ BearerTokenCredentialConfig?: AIGWBearerTokenCredentialConfig; /** *

Basic Auth凭证配置

*/ BasicCredentialConfig?: AIGWBasicCredentialConfig; /** *

自定义Header凭证配置

*/ CustomHeaderCredentialConfig?: AIGWCustomHeaderCredentialConfig; /** *

自定义Query参数凭证配置

*/ QueryParamCredentialConfig?: AIGWQueryParamCredentialConfig; } /** * ModifyCloudNativeAPIGatewayLLMModelAPI返回参数结构体 */ export interface ModifyCloudNativeAPIGatewayLLMModelAPIResponse { /** *

是否成功。

*/ Result?: boolean; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 消费者结构 */ export interface CNAPIGwConsumer { /** *

消费者 ID。

*/ ConsumerId: string; /** *

名字

*/ Name: string; /** *

创建时间

*/ CreateTime: string; /** *

更新时间 yyyy-MM-dd hh:mm:ss

*/ ModifyTime: string; /** *

消费者优先级

枚举值:

  • High: 高优
  • Medium: 中优
  • Low: 低优
*/ Priority?: string; /** *

描述

注意:此字段可能返回 null,表示取不到有效值。 */ Description?: string; /** *

消费者分组

注意:此字段可能返回 null,表示取不到有效值。 */ ConsumerGroups?: Array; /** *

同步状态

枚举值:

  • Fail: 失败
*/ SyncStatus?: string; /** *

资源类型

枚举值:

  • ModelService: 模型服务
  • Consumer: 消费者
  • SecretKey: 密钥
*/ SourceType?: string; /** *

同步版本

*/ SyncedVersion?: string; } /** * AI 网关日志输出配置 */ export interface AIGWLogConfig { /** *

是否开启请求 payload 记录日志

*/ EnableRequestLogPayloads?: boolean; /** *

是否开启响应 payload 记录日志

*/ EnableResponseLogPayloads?: boolean; /** *

日志记录的请求body的最大字节数

取值范围:[512, 1048576]

EnableRequestLogPayloads 为true时必填

*/ RequestLogPayloadMaxSize?: number; /** *

日志记录的响应body的最大字节数

取值范围:[512, 1048576]

EnableResponseLogPayloads 为true时必填

*/ ResponseLogPayloadMaxSize?: number; /** *

请求 payload access log 输出模式

枚举值:

  • raw: access log 中 body 记录客户端原始请求
  • processed: access log 中 body 记录 AI 网关协议适配、改写、归一化后的 OpenAI-compatible 内容
*/ RequestLogPayloadMode?: string; /** *

上游原始 payload access log 输出模式

枚举值:

  • raw: access log 中 body 记录客户端原始上游响应
  • processed: access log 中 body 记录 AI 网关协议适配、改写、归一化后的 OpenAI-compatible 内容
*/ ResponseLogPayloadMode?: string; /** *

请求 Body 大小裁剪策略

枚举值:

  • Bounded: 裁剪大小
  • UnBounded: 不裁剪大小
*/ RequestLogPayloadTruncationPolicy?: string; /** *

响应 Body 大小裁剪策略

枚举值:

  • Bounded: 裁剪大小
  • UnBounded: 不裁剪大小
*/ ResponseLogPayloadTruncationPolicy?: string; } /** * 云原生网关服务预览信息 */ export interface KongServicePreview { /** * 服务ID */ ID: string; /** * 创建时间 */ CreatedTime?: string; /** * 是否可编辑 */ Editable?: boolean; /** * 服务名字 */ Name?: string; /** * 请求路径 注意:此字段可能返回 null,表示取不到有效值。 */ Path?: string; /** * 标签 */ Tags?: Array; /** * 后端配置 */ UpstreamInfo?: KongUpstreamInfo; /** * 后端类型 */ UpstreamType?: string; } /** * MCP Server 列表 */ export interface AIGWMCPServerList { /** *

总数

*/ TotalCount: number; /** *

mcp server 数据列表

注意:此字段可能返回 null,表示取不到有效值。 */ DataList?: Array; } /** * AI网关 JWT 凭证物料配置 */ export interface AIGWJWTCredentialConfig { /** *

签名算法,取值:HS256 HS384 HS512 RS256 RS384 RS512 ES256 ES384 ES512

*/ Algorithm: string; /** *

JWT 消费者标识,iss claim

*/ Key: string; /** *

RS/ES PEM 格式公钥,仅 Algorithm 为 RS256/RS384/RS512/ES256/ES384/ES512 时必填;HS* 时留空

*/ RSAPublicKey?: string; /** *

HS 对称密钥,仅 Algorithm 为 HS256/HS384/HS512 时必填;RS/ES* 时留空

*/ Secret?: string; } /** * ModifyCloudNativeAPIGatewayLLMModelService返回参数结构体 */ export interface ModifyCloudNativeAPIGatewayLLMModelServiceResponse { /** *

是否成功

*/ Result?: boolean; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 资源端 OIDC 认证插件配置 */ export interface AIGWOIDCAuthPluginConfig { /** *

目标受众

*/ Audience?: string; /** *

是否BearerOnly

目前只能为true

*/ BearerOnly?: boolean; /** *

授权范围

*/ Scopes?: Array; /** *

消费者标识

*/ ConsumerClaim?: string; /** *

认证域

*/ Realm?: string; /** *

超时时间

*/ Timeout?: number; /** *

令牌端点认证方法

枚举值:

  • client_secret_post: client_secret_post
  • client_secret_basic: client_secret_basic
  • private_key_jwt: private_key_jwt
*/ TokenEndpointAuthMethod?: string; /** *

令牌内省端点

*/ IntrospectionEndpoint?: string; /** *

令牌内省端点认证方法

枚举值:

  • client_secret_basic: client_secret_basic
  • client_secret_post: client_secret_post
*/ IntrospectionEndpointAuthMethod?: string; /** *

签发者地址

*/ IssuerURL?: string; /** *

客户端 ID

*/ ClientId?: string; /** *

客户端密钥

*/ ClientSecret?: string; } /** * 最高Token用量消费者 */ export interface AIGWTopConsumersItem { /** *

消费者Id

*/ ConsumerId?: string; /** *

消费者名称

*/ ConsumerName?: string; /** *

该消费者花费的Token数

*/ TotalTokens?: number; } /** * RemoveCloudNativeAPIGatewayConsumerInGroup请求参数结构体 */ export interface RemoveCloudNativeAPIGatewayConsumerInGroupRequest { /** * 网关实例id */ GatewayId: string; /** *

消费者组 ID(以 cg- 开头)。

*/ ConsumerGroupId: string; /** *

消费者 ID 列表,长度 1-10。

*/ ConsumerIds: Array; } /** * CreateCloudNativeAPIGatewayLLMModelService请求参数结构体 */ export interface CreateCloudNativeAPIGatewayLLMModelServiceRequest { /** *

网关 id。

*/ GatewayId: string; /** *

服务名称,最长60个字符,支持中英文大小写、数字及分隔符(“-”、“_”),不能以数字和分隔符开头,不能以分隔符结尾。

*/ Name: string; /** *

服务类型。目前仅支持 LLMService。

枚举值:

  • LLMService: 大语言模型服务
*/ ServiceType: string; /** *

选择模型提供商, 选项:OpenAI、Anthropic、Azure OpenAI等。

*/ ModelProvider: string; /** *

API协议标准,根据供应商动态变化:OpenAI→OpenAI/v1,Anthropic→Anthropic/v1等

*/ ModelProtocol: string; /** *

模型选择方式,选项:Specify(指定模型)、PassThrough(透传请求模型)。

*/ ModelSelector: string; /** *

LLM 厂商颁发的认证信息 token 。

*/ SecretKeyIds?: Array; /** *

默认模型,模型选择方式为 Specify 时必填。

*/ DefaultModel?: string; /** *

开启模型降级,模型选择方式为 Specify 时必填。

*/ EnableModelFallback?: boolean; /** *

可以配置备用模型规则,EnableSpecifyModelFallbackxa0为 true 时必填。

*/ ModelFallbackRule?: CloudNativeAPIGatewayLLMModelFallbackRule; /** *

开启模型参数校验,是否校验客户端传递的 model 参数,xa0模型选择方式为 PassThrough 时必填

*/ EnableModelParamCheck?: boolean; /** *

模型检验信息,EnableModelParamCheckxa0为 true 时必填。

*/ ModelParamCheckRule?: CloudNativeAPIGatewayLLMModelParamCheckInfo; /** *

描述。

*/ Description?: string; /** *

服务提供商自定义 url

*/ UpstreamURL?: string; /** *

连接超时时间

取值范围:[1, 3600000]

单位:毫秒

默认值:10000

*/ ConnectTimeout?: number; /** *

写入超时时间

取值范围:[1, 3600000]

单位:毫秒

默认值:60000

*/ WriteTimeout?: number; /** *

读取超时时间

取值范围:[1, 3600000]

单位:毫秒

默认值:60000

*/ ReadTimeout?: number; /** *

重试次数

取值范围:[0, 5]

单位:次

默认值:0

*/ Retries?: number; /** *

路径拼接模式

枚举值:

  • FixedPath: 固定地址
  • AutoConcat: 自动拼接
*/ UpstreamUrlMode?: string; /** *

sni

*/ SNI?: string; /** *

模型服务级别的配额上限(RPM/TPM)。需要网关版本 ≥ 3.9.4。

*/ QuotaLimit?: AIGWLLMQuotaLimit; /** *

标签

*/ Tags?: Array; /** *

参数改写规则

*/ ModelRewriteRules?: Array; /** *

模型自定义供应商名称

*/ CustomProviderName?: string; /** *

外部服务来源ID

*/ ExternalInstanceId?: string; /** *

其他参数

*/ ExtParams?: Array; /** *

密钥轮转开关

*/ KeyRotationEnabled?: boolean; /** *

密钥轮转周期

单位:天数

*/ KeyRotationPeriodDays?: number; /** *

来源服务 ID。

*/ SourceId?: string; /** *

命名空间。

*/ Namespace?: string; /** *

服务名称。

*/ ServiceName?: string; /** *

协议类型,如 OpenAI、Custom。

*/ Protocol?: string; /** *

负载均衡配置

*/ LoadBalanceConfig?: AIGWLoadBalanceConfig; } /** * DescribeCloudNativeAPIGatewayLLMModelServices请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayLLMModelServicesRequest { /** *

网关 id。

*/ GatewayId: string; /** *

返回数量,默认为 10,最大值为 1000。

*/ Limit?: number; /** *

偏移量,默认为 0。

*/ Offset?: number; /** *

过滤条件,多个过滤条件之间是“与”的关系,支持 Name

*/ Filters?: Array; /** *

通过模型 API 筛选模型服务

*/ ModelAPIId?: string; /** *

通过密匙查询绑定的模型服务

*/ SecretKeyId?: string; /** *

搜索关键词,模糊匹配 name 和 description

*/ Keyword?: string; } /** * CreateCloudNativeAPIGatewayLLMModelAPI请求参数结构体 */ export interface CreateCloudNativeAPIGatewayLLMModelAPIRequest { /** *

网关 id。

*/ GatewayId: string; /** *

模型 API 名称,最长 60 字符。同一网关下唯一。

*/ Name: string; /** *

业务场景。

枚举值:

  • Chat:聊天
  • Image:图像(需要网关版本 ≥ 3.9.3)
*/ SceneType: string; /** *

请求协议(小写)。当前仅支持:

  • openai
*/ RequestProtocol: string; /** *

关联的模型服务 ID 列表,长度 1-10。

注:字段名建议改为 ModelServiceIds,当前保留用于兼容。

*/ ListModelServiceId: Array; /** *

路由列表,至少 1 条。每条包含 Methods/Paths/Hosts 等 Kong 路由属性。

*/ RouteList: Array; /** *

统一前缀路径(可选)。例如 /v1/openai。

*/ BasePath?: string; /** *

模型 API 描述。最长 200 字符。

*/ Description?: string; /** *

多模型服务路由策略。ListModelServiceId 多于 1 项时必填。

*/ ModelServiceRoute?: CloudNativeAPIGatewayLLMModelServiceRoute; /** *

Header 路由匹配规则。当前仅支持 Operator=exact。

*/ MatchHeaders?: Array; /** *

是否启用跨服务 Fallback。开启后需提供 CrossServiceFallbackConfig。

*/ EnableCrossServiceFallback?: boolean; /** *

跨服务 Fallback 配置。EnableCrossServiceFallback=true 时必填。

*/ CrossServiceFallbackConfig?: AIGWCrossServiceFallbackConfig; /** *

标签过滤策略。需要网关版本 ≥ 3.9.4。

*/ TagFilter?: AIGWTagFilter; /** *

日志输出配置(请求/响应 payload 落 LLM Log)。需要网关版本 ≥ 3.9.4。

*/ LogConfig?: AIGWLogConfig; /** *

Rerank场景最大文档数高级配置

*/ MaxDocumentsConfig?: AIGWRerankMaxDocumentsConfig; /** *

敏感词路由配置

*/ SensitiveWordRoute?: AIGWSensitiveWordRoute; } /** * AI网关自定义 Header 凭证配置 */ export interface AIGWCustomHeaderCredentialConfig { /** *

Header名

*/ HeaderName?: string; /** *

Header值

*/ HeaderValue?: string; } /** * MCP tool 参数 */ export interface CNAPIGwMCPToolParam { /** *

名字

*/ Name: string; /** *

参数类型

枚举值:

  • string: 字符串
  • number: 数字
  • boolean: 布尔
  • array: 数组
  • object: 对象
*/ Type: string; /** *

必填

*/ Required: boolean; /** *

位置

枚举值:

  • query: query
  • path: query
  • header: header
  • body: body
*/ Position: string; /** *

描述

*/ Description?: string; /** *

默认值

*/ Default?: string; /** *

数组子项

*/ Items?: CNAPIGwMCPToolParam; /** *

对象属性

*/ Properties?: Array; /** *

转发到后端的名称

不填则使用原始名称

*/ BackendName?: string; } /** * 资源端 OAuth2 认证插件配置 */ export interface AIGWOAuthAuthPluginConfig { /** *

取token的头部名称

*/ HeaderNames?: Array; /** *

过期时间

*/ TokenExpiration?: number; /** *

授权范围

*/ Scopes?: Array; /** *

是否强制判断授权范围

*/ MandatoryScope?: boolean; } /** * DescribeCloudNativeAPIGatewayConsumerGroup请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayConsumerGroupRequest { /** *

网关实例id

*/ GatewayId: string; /** *

消费者组ID

*/ ConsumerGroupId: string; } /** * DescribeCloudNativeAPIGatewayMCPToolACLList请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPToolACLListRequest { /** *

网关实例ID

*/ GatewayId: string; /** *

MCP 服务ID

*/ ServerId: string; /** *

分页大小

*/ Limit: number; /** *

分页偏移

*/ Offset: number; /** *

搜索关键词

*/ Keyword?: string; } /** * 返回kong的服务和路由列表 */ export interface KongServiceWithRoutes { /** * 服务及路由列表 */ ServiceList?: Array; /** * 总数 */ TotalCount?: number; } /** * JWT 认证插件配置 */ export interface AIGWJWTAuthPluginConfig { /** *

签名的header名称列表

*/ HeaderNames?: Array; /** *

签名的cookie名称列表

*/ CookieNames?: Array; /** *

签名的URL参数名称列表

*/ URIParamNames?: Array; /** *

消费者标识

*/ KeyClaimName?: string; /** *

标准消费者校验

枚举值:

  • exp: exp
  • nbf: nbf
*/ ClaimsToVerify?: Array; /** *

最大有效期

*/ MaximumExpiration?: number; /** *

是否Base64编码

*/ SecretIsBase64?: boolean; /** *

CORS预检验证

*/ RunOnPreFlight?: boolean; } /** * DescribeCNGWServicesWithRoutes返回参数结构体 */ export interface DescribeCNGWServicesWithRoutesResponse { /** *

服务及路由查询结果

*/ Result?: KongServiceWithRoutes; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * LLM 模型 API */ export interface CloudNativeAPIGatewayLLMModelAPI { /** *

模型 API ID。

*/ Id?: string; /** *

创建时间

*/ CreateTime?: string; /** *

修改时间

*/ ModifyTime?: string; /** *

AI 网关 LLM 模型 API 的唯一标识名称,格式规则:2-50 字符,支持英文、数字、下划线。

*/ Name?: string; /** *

选择业务场景,xa0 选项:Chat(聊天)。

*/ SceneType?: string; /** *

业务场景对应的请求协议,选项:OpenAI(目前只支持 OpenAI)。

*/ RequestProtocol?: string; /** *

路由列表

*/ RouteList?: Array; /** *

为API设置统一的前缀,格式:以/开头,支持字母、数字、短横线。

*/ BasePath?: string; /** *

路径简化,
启用时:客户端请求路径 → 移除Base Path → 后端接收简洁路径
禁用时:客户端请求路径 → 完整传递给后端。

*/ StripPath?: boolean; /** *

模型 API 的相关描述。

*/ Description?: string; /** *

模型服务Id

*/ ModelServiceId?: string; /** *

模型服务名称

*/ ModelServiceName?: string; /** *

模型服务路由策略(是指如何路由到模型服务)

*/ ModelServiceRoute?: CloudNativeAPIGatewayLLMModelServiceRoute; /** *

HTTP 请求头匹配规则,用于按请求头路由到不同模型服务。

*/ MatchHeaders?: Array; /** *

是否开启跨服务fallback

*/ EnableCrossServiceFallback?: boolean; /** *

跨服务fallback配置详情

*/ CrossServiceFallbackConfig?: AIGWCrossServiceFallbackConfig; /** *

是否展示模型API

*/ DescribeCloudNativeAPIGatewayLLMModelAPI?: boolean; /** *

标签

*/ TagFilter?: AIGWTagFilter; /** *

日志显示相关开关

*/ LogConfig?: AIGWLogConfig; /** *

日志脱敏规则

*/ LogDesensitizeConfig?: AIGWLogDesensitizeConfig; /** *

转发脱敏规则

*/ ForwardDesensitizeConfig?: AIGWForwardDesensitizeConfig; /** *

rerank documents 上限

*/ MaxDocumentsConfig?: AIGWRerankMaxDocumentsConfig; /** *

敏感词路由配置

*/ SensitiveWordRoute?: AIGWSensitiveWordRoute; /** *

消费者组模型范围

*/ ConsumerGroupModelScopes?: Array; /** *

消费者继承的模型范围

*/ ConsumerInheritModelScope?: AIGWConsumerModelScope; } /** * DescribeCloudNativeAPIGatewayLLMModelAPIs请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayLLMModelAPIsRequest { /** * 网关 id。 */ GatewayId: string; /** *

每页条数,范围 [1, 1000],默认 10。

*/ Limit?: number; /** *

起始位置,从 0 开始。

*/ Offset?: number; /** *

过滤条件。当前未启用具体字段。

*/ Filters?: Array; /** *

模糊匹配模型 API 名称。

*/ Keyword?: string; /** *

消费者组 ID(以 cg- 开头),与 UseToBind 搭配使用。

*/ ConsumerGroupId?: string; /** *

是否用于绑定场景。true 时仅返回可被绑定到指定消费者组的模型 API。

*/ UseToBind?: boolean; /** *

消费者 ID(以 consumer- 开头)。

*/ ConsumerId?: string; } /** * ModifyCloudNativeAPIGatewayMCPServerACL请求参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPServerACLRequest { /** *

网关实例ID

*/ GatewayId: string; /** *

MCP服务ID

*/ ServerId: string; /** *

ACL类型

枚举值:

  • None: 不开启
  • Allow: 白名单
  • Deny: 黑名单

默认值:None

*/ ACLType: string; /** *

需要关联的消费者ID列表

*/ ACLConsumerIds?: Array; /** *

需要关联的消费者组ID列表

*/ ACLConsumerGroupIds?: Array; } /** * 模型名字重写规则 */ export interface AIGWModelRewriteRule { /** *

原始模型

*/ SourceModel?: string; /** *

目标模型

*/ TargetModel?: string; } /** * 创建资源通用结果 */ export interface CNAPIGwCreateCommonResult { /** * 对应的id 值 */ ID?: string; /** * 是否成功 */ Success?: boolean; } /** * 模型服务路由配置 */ export interface CloudNativeAPIGatewayLLMModelServiceRoute { /** *

生效的路由算法类型:权重路由,模型名称路由、参数路由等Weighted/ModelName/Query (预留多个,暂时只能填写一个)

*/ SelectedTypes: Array; /** *

权重路由配置,最多10个

*/ WeightedConfig?: Array; /** *

模型名称路由配置,最多10个

*/ ModelNameConfig?: Array; /** *

意图识别

*/ IntentRouteConfig?: AIGWIntentRoute; /** *

延迟路由

*/ LatencyPriorityConfig?: AIGWLatencyPriorityConfig; /** *

前缀缓存感知路由

*/ CacheAwareRouteConfig?: AIGWCacheAwareRouteConfig; /** *

token 长度路

*/ TokenLengthRouteConfig?: AIGWTokenLengthRoute; } /** * 消费者组结构 */ export interface CNAPIGwConsumerGroup { /** *

分组id

*/ ConsumerGroupId: string; /** *

名字

*/ Name: string; /** *

状态Disable/Enable

*/ Status: string; /** *

描述

*/ Description: string; /** *

创建时间

*/ CreateTime?: string; /** *

更新时间 yyyy-MM-dd hh:mm:ss

*/ ModifyTime?: string; /** *

绑定的消费者数量

注意:此字段可能返回 null,表示取不到有效值。 */ BindCount?: number; /** *

同步状态

枚举值:

  • Fail: 失败
  • Succes: 成功
*/ SyncStatus?: string; /** *

资源类型

枚举值:

  • Public: 公共
  • Private: 私有
  • SourceDeleted: 资源已删除
*/ SourceType?: string; /** *

同步版本

*/ SyncedVersion?: string; } /** * CreateCloudNativeAPIGatewayLLMModelService返回参数结构体 */ export interface CreateCloudNativeAPIGatewayLLMModelServiceResponse { /** *

是否成功

*/ Result?: boolean; /** *

模型服务 ID,全局唯一标识。

*/ ModelServiceId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * AI 网关 MCP Server ACL 配置详情 */ export interface AIGWMCPServerACLResult { /** *

黑白名单鉴权类型

枚举值:

  • None: 不鉴权
  • Allow: 白名单
  • Deny: 黑名单
*/ ACLType?: string; /** *

关联的消费者ID列表

*/ ACLConsumers?: Array; /** *

关联的消费者组ID列表

*/ ACLConsumerGroups?: Array; /** *

认证类型

枚举值:

  • None: 无认证
  • ApiKey: API Key认证
*/ AuthType?: string; } /** * ModifyCloudNativeAPIGatewayConsumer请求参数结构体 */ export interface ModifyCloudNativeAPIGatewayConsumerRequest { /** *

网关实例id

*/ GatewayId: string; /** *

消费者 ID。

*/ ConsumerId: string; /** *

消费者名称,最长 60 字符。

*/ Name: string; /** *

消费者优先级

枚举值:

  • High: 高优
  • Medium: 中优
  • Low: 低优
*/ Priority?: string; /** *

消费者描述。最长 200 字符。

*/ Description?: string; } /** * AI 网关日志脱敏配置 */ export interface AIGWLogDesensitizeConfig { /** *

日志脱敏配置总开关

*/ Enabled: boolean; /** *

内置规则类型:Phone、IdCard、BankCard、Email、IP、Name

*/ PredefinedRuleTypes?: Array; /** *

自定义规则,最多 20 条

*/ CustomRules?: Array; /** *

脱敏方向:Request、Response;为空时默认两者

*/ Scope?: Array; } /** * DescribeCloudNativeAPIGatewaySecretKey返回参数结构体 */ export interface DescribeCloudNativeAPIGatewaySecretKeyResponse { /** *

密钥详情。

*/ Result?: CNAPIGwSecretKey; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayConsumer返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayConsumerResponse { /** *

消费者详情

*/ Result?: CNAPIGwConsumer; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 云原生网关MCP会话配置 */ export interface AIGWMCPSessionConfig { /** *

会话存储类型

枚举值:

  • memory: 内存
  • redis: redis
*/ SessionStorage?: string; /** *

Redis配置

*/ RedisConfig?: AIGWRedisConfig; } /** * AI 网关 MCP Server 认证配置详情 */ export interface AIGWMCPServerAuthResult { /** *

MCP服务认证类型

枚举值:

  • None: 无认证
  • ApiKey: API Key认证
*/ AuthType?: string; /** *

JWT认证配置

*/ JWTAuthConfig?: AIGWJWTAuthPluginConfig; /** *

OAuth2认证配置

*/ OAuthAuthConfig?: AIGWOAuthAuthPluginConfig; /** *

OIDC认证配置

*/ OIDCAuthConfig?: AIGWOIDCAuthPluginConfig; } /** * DescribeCloudNativeAPIGatewayMCPToolList请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPToolListRequest { /** *

实例 id

*/ GatewayId: string; /** *

MCP服务 id

*/ ServerId: string; /** *

条数

取值范围:[1, 100]

*/ Limit: number; /** *

开始位置

取值范围:[1, 100000]

*/ Offset: number; } /** * DeleteCloudNativeAPIGatewayMCPServer返回参数结构体 */ export interface DeleteCloudNativeAPIGatewayMCPServerResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * AI网关模型可用范围 */ export interface AIGWModelScope { /** *

范围类型

枚举值:

  • ALL: 允许全部访问
  • ALLOWLIST: 允许访问的模型列表
  • MAG: 模型访问组
*/ ScopeType?: string; /** *

允许访问的模型列表,ScopeType=ALLOWLIST时设置

*/ AllowList?: Array; /** *

模型访问组,ScopeType=MAG时设置

*/ MagRefs?: Array; } /** * AI 网关意图路由规则 */ export interface AIGWIntentRouteRule { /** *

意图编码

枚举值:

  • Coder: 代码编写
  • Math: 数学计算
  • Translation: 翻译
  • Flash: 快速问答
  • Complex: 复杂推理
*/ IntentCode?: string; /** *

模型服务id

*/ ModelServiceId?: string; } /** * 云原生网关路由信息 */ export interface KongRoutePreview { /** *

服务ID

*/ ID: string; /** *

服务名字

*/ Name?: string; /** *

请求方法列表

注意:此字段可能返回 null,表示取不到有效值。 */ Methods?: Array; /** *

路由Paths列表

注意:此字段可能返回 null,表示取不到有效值。 */ Paths?: Array; /** *

路由Hosts列表

注意:此字段可能返回 null,表示取不到有效值。 */ Hosts?: Array; /** *

协议列表

*/ Protocols?: Array; /** *

是否保留Host头

*/ PreserveHost?: boolean; /** *

HTTPS重定向状态码

*/ HttpsRedirectStatusCode?: number; /** *

是否去除路径前缀

*/ StripPath?: boolean; /** *

创建时间

*/ CreatedTime?: string; /** *

强制转换 https

注意:此字段可能返回 null,表示取不到有效值。 * @deprecated */ ForceHttps?: boolean; /** *

服务名

*/ ServiceName?: string; /** *

服务ID

*/ ServiceID?: string; /** *

目的端口

*/ DestinationPorts?: Array; /** *

headers

*/ Headers?: Array; /** *

是否缓存请求body,默认true

*/ RequestBuffering?: boolean; /** *

是否缓存响应body,默认true

*/ ResponseBuffering?: boolean; /** *

正则优先级

*/ RegexPriority?: number; /** *

querystring参数

*/ QueryStringParameters?: Array; /** *

路由来源

*/ RouteSource?: string; } /** * ModifyCloudNativeAPIGatewayMCPTool请求参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPToolRequest { /** *

网关实例 id

*/ GatewayId: string; /** *

MCPserverId

*/ ServerId: string; /** *

工具 id

*/ ToolId: string; /** *

工具名字

*/ Name: string; /** *

路径

*/ Path: string; /** *

报文格式

*/ ContentType: string; /** *

请求方法

枚举值:

  • GET: GET
  • PUT: PUT
  • POST: POST
  • DELETE: DELETE
  • PATCH: PATCH
*/ Method: string; /** *

展示

*/ DisplayName?: string; /** *

输入参数

*/ InputParams?: Array; /** *

描述

*/ Description?: string; /** *

tool版本

*/ ToolVersion?: string; } /** * DeleteCloudNativeAPIGatewayLLMModelAPI请求参数结构体 */ export interface DeleteCloudNativeAPIGatewayLLMModelAPIRequest { /** * 网关 id。 */ GatewayId: string; /** * 模型 API ID,全局唯一标识。 */ ModelAPIId: string; } /** * LLM 模型 API 列表 */ export interface ListCloudNativeAPIGatewayLLMModelAPI { /** * 总数 */ TotalCount?: number; /** * AI 网关模型 API 列表。 */ DataList?: Array; } /** * DeleteCloudNativeAPIGatewayLLMModelService返回参数结构体 */ export interface DeleteCloudNativeAPIGatewayLLMModelServiceResponse { /** *

是否成功。

*/ Result?: boolean; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayMCPTool返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPToolResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyCloudNativeAPIGatewayMCPToolACL返回参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPToolACLResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayMCPToolsFromFile请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPToolsFromFileRequest { /** *

OpenAPI文件内容

*/ Content: string; /** *

文件内容格式

*/ Format: string; /** *

网关实例ID

*/ GatewayId: string; /** *

MCP Server ID

*/ MCPServerId: string; } /** * OIDC 凭证物料配置 */ export interface AIGWOIDCCredentialConfig { /** *

IdP 注册的 client_id

*/ ClientId: string; /** *

IdP 注册的 client_secret

*/ ClientSecret: string; /** *

IdP Issuer URL

*/ IssuerURL: string; /** *

IdP 中该用户的 claim 值

*/ ConsumerClaimValue?: string; } /** * 负载均衡配置,仅服务来源(ServiceSource,SourceId 非空)场景生效。 */ export interface AIGWLoadBalanceConfig { /** *

负载均衡类型

枚举值:

  • RoundRobin: 轮询
  • WeightedRoundRobin: 加权轮询
  • LeastConnections: 最少连接
  • Random: 随机

默认值:RoundRobin

*/ Algorithm?: string; } /** * CreateCloudNativeAPIGatewayConsumerGroup返回参数结构体 */ export interface CreateCloudNativeAPIGatewayConsumerGroupResponse { /** *

创建结果。包含成功标识与新建资源 ID。

*/ Result?: CNAPIGwCreateCommonResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * UpdateCloudNativeAPIGatewayMCPTools返回参数结构体 */ export interface UpdateCloudNativeAPIGatewayMCPToolsResponse { /** *

导入任务的ID

*/ Result?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayLLMModelAPI返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayLLMModelAPIResponse { /** *

模型 API 信息。

*/ Result?: CloudNativeAPIGatewayLLMModelAPI; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 云原生网关MCP后端信息,用于展示 */ export interface AIGWMCPUpstreamInfoDetail { /** *

注册中心来源ID

*/ SourceId?: string; /** *

注册中心来源名称, 入参不传,用于返回

*/ SourceName?: string; /** *

命名空间

*/ Namespace?: string; /** *

服务 id

*/ MCPServerId?: string; /** *

协议,UpstreamType是Registry 时必传

  • http
  • https
*/ Protocol?: string; /** *

域名或ip

*/ Host?: string; /** *

端口

*/ Port?: number; /** *

服务 id

*/ ServiceId?: string; /** *

服务名字

*/ ServiceName?: string; /** *

服务分组

*/ ServiceGroup?: string; /** *

mcp endpoint

*/ MCPEndpoint?: string; /** *

SSE message路径

*/ MessageEndpoint?: string; /** *

TLS配置

*/ TLSConfig?: AIGWUpstreamTLSConfig; } /** * Kong Upstream中的Target */ export interface KongTarget { /** * 目标主机地址 */ Host: string; /** * 端口 */ Port: number; /** * 权重 */ Weight: number; /** * 创建时间 */ CreatedTime?: string; /** * CVM实例ID */ CvmInstanceId?: string; /** * CVM实例名称 */ CvmInstanceName?: string; /** * 健康状态 */ Health?: string; /** * Target的来源 */ Source?: string; /** * target标签 */ Tags?: Array; } /** * DescribeCloudNativeAPIGatewayLLMModelAPI请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayLLMModelAPIRequest { /** *

网关 id。

*/ GatewayId: string; /** *

模型 API ID,全局唯一标识。

*/ ModelAPIId: string; } /** * 键值对 */ export interface KVMapping { /** * 键值映射的键 */ Key?: string; /** * 键值映射的值 */ Value?: string; } /** * AI网关 Bearer Token 凭证配置 */ export interface AIGWBearerTokenCredentialConfig { /** *

Token凭证

*/ Token?: string; } /** * AI 网关token长度路由配置 */ export interface AIGWTokenLengthRoute { /** *

默认tokenizer编码器

枚举值:

  • o200k_base: OpenApi o200k_base
  • cl100k_base: OpenApi cl100k_base
  • p50k_base: OpenApi p50k_base
  • r50k_base: OpenApi r50k_base
*/ DefaultEncodingName?: string; /** *

token 计数失败、规则为空或未命中任何规则时执行的默认二级路由(暂时只能选择一个指定模型路由)

*/ DefaultTarget?: AIGWLLMModelServiceSubRoute; /** *

规则

*/ Rules?: Array; } /** * 缓存感知路由候选模型服务 */ export interface AIGWCacheAwareRouteCandidate { /** *

模型服务ID

*/ ModelServiceId?: string; /** *

模型服务名称

*/ ModelServiceName?: string; } /** * BindCloudNativeAPIGatewaySecretKey请求参数结构体 */ export interface BindCloudNativeAPIGatewaySecretKeyRequest { /** * 网关实例id */ GatewayId: string; /** * 资源类型 */ ResourceType: string; /** * 资源ID,当前最多支持一个 */ ResourceIds: Array; /** * 密钥id */ SecretKeyId: string; } /** * ModifyCloudNativeAPIGatewayConsumer返回参数结构体 */ export interface ModifyCloudNativeAPIGatewayConsumerResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyCloudNativeAPIGatewayMCPServerACL返回参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPServerACLResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DeleteCloudNativeAPIGatewayMCPServer请求参数结构体 */ export interface DeleteCloudNativeAPIGatewayMCPServerRequest { /** *

云原生API网关实例ID

*/ GatewayId: string; /** *

MCP服务ID

*/ ServerId: string; } /** * ModifyCloudNativeAPIGatewayMCPServerStatus返回参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPServerStatusResponse { /** *

创建结果

*/ Result?: boolean; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DeleteCloudNativeAPIGatewaySecretKey返回参数结构体 */ export interface DeleteCloudNativeAPIGatewaySecretKeyResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayMCPTool请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPToolRequest { /** *

网关实例 id

*/ GatewayId: string; /** *

MCP Server id

*/ ServerId: string; /** *

工具 id

*/ ToolId: string; } /** * DescribeCloudNativeAPIGatewayLLMTokenUsageStatistics请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayLLMTokenUsageStatisticsRequest { /** *

网关实例Id

*/ GatewayId: string; /** *

查询开始时间戳

单位:秒

*/ StartTime: number; /** *

查询结束时间戳

单位:秒

*/ EndTime: number; /** *

查询过滤条件

*/ Filters?: Array; } /** * CreateCloudNativeAPIGatewaySecretKey请求参数结构体 */ export interface CreateCloudNativeAPIGatewaySecretKeyRequest { /** *

实例 ID

*/ GatewayId: string; /** *

密钥生成方式。

枚举值:

  • System:系统自动生成
  • Custom:用户自定义(需传 SecretValue)
  • KMS:使用 KMS 密钥(需传 KmsKeyName 与 KmsKeyVersion)
*/ GenerateType: string; /** *

密钥名称,2-60 字符。

*/ Name: string; /** *

密钥归属资源类型。

枚举值:

  • Consumer:消费者
  • ModelService:模型服务
*/ ResourceType: string; /** *

密钥协议类型。

枚举值:

  • ApiKey
  • Basic
  • Hmac
  • OAuth2
  • JWT
*/ SecretType: string; /** *

密钥描述。最长 200 字符。

*/ Description?: string; /** *

JWT凭证配置

*/ JWTCredentialConfig?: AIGWJWTCredentialConfig; /** *

KMS 密钥名称。GenerateType=KMS 时必填。

*/ KmsKeyName?: string; /** *

KMS 密钥版本。GenerateType=KMS 时必填。

*/ KmsKeyVersion?: string; /** *

OAuth2.0凭证配置

*/ OAuthCredentialConfig?: AIGWOAuthCredentialConfig; /** *

OIDC凭证配置

*/ OIDCCredentialConfig?: AIGWOIDCCredentialConfig; /** *

第三方平台类型

枚举值:

  • Dify: Dify平台
*/ Provider?: string; /** *

密钥值,长度 8-256。GenerateType=Custom 时必填。

*/ SecretValue?: string; /** *

AK/SK凭证配置

*/ AKSKCredentialConfig?: AIGWAKSKCredentialConfig; /** *

CAM凭证配置

*/ CAMCredentialConfig?: AIGWCAMCredentialConfig; /** *

Bearer Token凭证配置

*/ BearerTokenCredentialConfig?: AIGWBearerTokenCredentialConfig; /** *

自定义Header凭证配置

*/ CustomHeaderCredentialConfig?: AIGWCustomHeaderCredentialConfig; /** *

自定义Query参数凭证配置

*/ QueryParamCredentialConfig?: AIGWQueryParamCredentialConfig; /** *

Basic Auth凭证配置

*/ BasicCredentialConfig?: AIGWBasicCredentialConfig; } /** * DescribeCloudNativeAPIGatewayMCPServer返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPServerResponse { /** *

mcp server详情

*/ Result?: AIGWMCPServer; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 缓存感知路由 */ export interface AIGWCacheAwareRouteConfig { /** *

前缀缓存感知路由模型服务列表

*/ Candidates?: Array; } /** * ModifyCloudNativeAPIGatewayMCPToolACL请求参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPToolACLRequest { /** *

网关实例ID

*/ GatewayId: string; /** *

MCP服务ID

*/ ServerId: string; /** *

MCP工具ID

*/ ToolId: string; /** *

鉴权类型

枚举值:

  • None: 继承server鉴权类型
  • Allow: 白名单
  • Deny: 黑名单
*/ ACLType: string; /** *

需要关联的消费者ID列表

*/ ACLConsumerIds?: Array; /** *

需要关联的消费者组ID列表

*/ ACLConsumerGroupIds?: Array; } /** * CreateCloudNativeAPIGatewayMCPServer返回参数结构体 */ export interface CreateCloudNativeAPIGatewayMCPServerResponse { /** *

创建结果

*/ Result?: CNAPIGwCreateCommonResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * UpdateCloudNativeAPIGatewayMCPTools请求参数结构体 */ export interface UpdateCloudNativeAPIGatewayMCPToolsRequest { /** *

网关实例ID

*/ GatewayId: string; /** *

MCP Server ID

*/ MCPServerId: string; /** *

待导入的MCP Tools列表

*/ Tools: Array; } /** * 用于定义kong插件自定义健康检查的配置 */ export interface AIGWHealthCheckSetting { /** *

健康检查类型

枚举值:

  • MCP: 标准mcp
  • HTTP: http
*/ HealthCheckType: string; /** *

检查间隔

*/ HealthCheckIntervalSecond: number; /** *

检查超时时间

*/ HealthCheckTimeout: number; /** *

检查失败阈值

*/ HealthCheckFailThreshold: number; /** *

检查恢复阈值

*/ HealthCheckRecoverThreshold: number; /** *

检查路径

*/ HealthCheckPath?: string; /** *

检查方法

*/ HealthCheckMethod?: string; } /** * AI 网关token消耗统计汇总响应结果 */ export interface AIGWLLMTokenUsageStatisticsResult { /** *

查询时间范围内请求总数

*/ TotalRequestCount?: number; /** *

查询时间范围内总输入Token数(包含命中缓存的Token数)

*/ TotalInputTokens?: number; /** *

查询时间范围内总输出Token数

*/ TotalOutputTokens?: number; /** *

查询时间范围内总命中缓存输入Token数

*/ TotalCachedReadInputTokens?: number; /** *

查询时间范围内总成本

*/ TotalCost?: string; /** *

成本货币单位

*/ Currency?: string; /** *

查询时间范围内成本最高的消费者

*/ TopConsumers?: Array; } /** * CreateCloudNativeAPIGatewayConsumer请求参数结构体 */ export interface CreateCloudNativeAPIGatewayConsumerRequest { /** *

网关实例id

*/ GatewayId: string; /** *

消费者名称,最长 60 字符。同一网关下唯一。

*/ Name: string; /** *

优先级

枚举值:

  • High: 高优
  • Medium: 中优
  • Low: 低优
*/ Priority?: string; /** *

消费者描述。最长 200 字符。

*/ Description?: string; } /** * ModifyCloudNativeAPIGatewayMCPServerStatus请求参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPServerStatusRequest { /** *

实例 ID

*/ GatewayId: string; /** *

mcp server id

*/ ServerId: string; /** *

mcp server状态

枚举值:

  • Online: 上线
  • Offline: 下线
*/ Status: string; } /** * ModifyCloudNativeAPIGatewayMCPTool返回参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPToolResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 列表过滤条件,模糊匹配 */ export interface ListFilter { /** * 过滤字段 */ Key?: string; /** * 过滤值 */ Value?: string; } /** * RemoveCloudNativeAPIGatewayConsumerInGroup返回参数结构体 */ export interface RemoveCloudNativeAPIGatewayConsumerInGroupResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 跨服务降级配置 */ export interface AIGWCrossServiceFallbackConfig { /** *

触发条件

枚举值:

  • ServiceUnavailable: 服务不可用
  • ConnectionTimeout: 连接超时
  • RateLimited: 限流
*/ TriggerConditions: Array; /** *

fallback 服务链

*/ FallbackServiceChain: Array; /** *

额度降级触发配置

*/ QuotaFallbackTrigger?: AIGWLLMQuotaFallbackTrigger; } /** * AI网关Upstream TLS配置 */ export interface AIGWUpstreamTLSConfig { /** *

是否校验上游服务端证书

默认值:false

*/ TLSVerify?: boolean; /** *

客户端证书 ID(mTLS 用)

*/ ClientCertId?: string; /** *

信任的 CA 证书 ID 列表

*/ UpstreamCACertIds?: Array; } /** * AI网关消费者模型范围 */ export interface AIGWConsumerModelScope { /** *

消费者模型生效范围类型

枚举值:

  • INHERIT: 继承所在消费者组的生效模型范围
  • ALLOWLIST: 自定义白名单,必须 ⊆ 所在组针对该资源的生效模型集合
*/ ScopeType?: string; /** *

模型授权白名单列表

*/ AllowList?: Array; } /** * DescribeCloudNativeAPIGatewayLLMModelAPIs返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayLLMModelAPIsResponse { /** * 模型 API 列表。 */ Result?: ListCloudNativeAPIGatewayLLMModelAPI; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * AddCloudNativeAPIGatewayConsumerInGroup请求参数结构体 */ export interface AddCloudNativeAPIGatewayConsumerInGroupRequest { /** * 网关实例id */ GatewayId: string; /** *

消费者组 ID(以 cg- 开头)。

*/ ConsumerGroupId: string; /** *

消费者 ID 列表,长度 1-10。

*/ ConsumerIds: Array; } /** * CreateCloudNativeAPIGatewayConsumer返回参数结构体 */ export interface CreateCloudNativeAPIGatewayConsumerResponse { /** *

创建结果。包含成功标识与新建资源 ID。

*/ Result?: CNAPIGwCreateCommonResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 模型服务模型名称路由策略 */ export interface CloudNativeAPIGatewayLLMModelServiceRouteModelNameStrategy { /** *

模型服务id

*/ ModelServiceId: string; /** *

匹配模型服务

*/ MatchModelName: string; /** *

重写模型

*/ RewriteModelName?: string; } /** * DeleteCloudNativeAPIGatewayLLMModelAPI返回参数结构体 */ export interface DeleteCloudNativeAPIGatewayLLMModelAPIResponse { /** *

是否成功。

*/ Result?: boolean; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * UnbindCloudNativeAPIGatewaySecretKey返回参数结构体 */ export interface UnbindCloudNativeAPIGatewaySecretKeyResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * Token用量统计结果 */ export interface AIGWLLMTokenUsageListResult { /** *

Token用量明细返回结果列表

*/ DataList?: Array; /** *

结果总数

*/ TotalCount?: number; } /** * DescribeCloudNativeAPIGatewayMCPToolsFromFile返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPToolsFromFileResponse { /** *

解析结果

*/ Result?: CNAPIGwParseMCPToolsResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyCloudNativeAPIGatewaySecretKey请求参数结构体 */ export interface ModifyCloudNativeAPIGatewaySecretKeyRequest { /** * 实例 ID */ GatewayId: string; /** * 密钥名字 */ Name: string; /** * 密钥id */ SecretKeyId: string; /** * 描述,200字以内 */ Description?: string; } /** * 通过OpenAPI文件导入MCP tools的预览内容 */ export interface CNAPIGwMCPToolPreview { /** *

MCP Tool入参的ContentType

枚举值:

  • application/json: json格式
  • application/x-www-form-urlencoded: 表单格式
*/ ContentType?: string; /** *

MCP Tool的描述

注意:此字段可能返回 null,表示取不到有效值。 */ Description?: string; /** *

MCP Tool的参数

*/ InputParams?: Array; /** *

MCP Tool的请求方法

*/ Method?: string; /** *

MCP Tool名字

*/ Name?: string; /** *

MCP Tool的请求路径

*/ Path?: string; /** *

MCP Tool的状态

枚举值:

  • Valid: 可导入
  • Invalid: 不可导入
*/ Status?: string; /** *

不可导入的原因

注意:此字段可能返回 null,表示取不到有效值。 */ StatusMessage?: string; /** *

虚拟MCP Server的tools的完整url路径

注意:此字段可能返回 null,表示取不到有效值。 */ UpstreamUrl?: string; } /** * MCP Tool 信息 */ export interface CNAPIGwMCPTool { /** *

名字

*/ Name: string; /** *

展示名字

*/ DisplayName: string; /** *

方法

枚举值:

  • GET: GET
  • POST: POST
  • PUT: PUT
  • DELETE: DELETE
  • PATCH: PATCH
*/ Method: string; /** *

描述

*/ Description: string; /** *

工具 id

*/ ToolId?: string; /** *

报文格式

*/ ContentType?: string; /** *

服务 id

注意:此字段可能返回 null,表示取不到有效值。 */ ServiceId?: string; /** *

路径

*/ Path?: string; /** *

参数

*/ InputParams?: Array; /** *

创建时间

参数格式:yyyy-MM-dd hh:mm:ss

*/ CreateTime?: string; /** *

更新时间

参数格式:yyyy-MM-dd hh:mm:ss

*/ UpdateTime?: string; /** *

tool状态

枚举值:

  • Enable: 启用
  • Disable: 禁用
*/ Status?: string; /** *

当前版本号

*/ CurrentVersion?: string; } /** * AI 网关 Tool ACL 单条记录(DescribeMCPToolACLList 数组元素) */ export interface AIGWMCPToolACLItem { /** *

MCP工具ID

*/ ToolId?: string; /** *

MCP工具名称

*/ ToolName?: string; /** *

MCP工具鉴权类型

枚举值:

  • None: 继承server鉴权类型
  • Allow: 白名单
  • Deny: 黑名单
*/ ACLType?: string; /** *

关联的消费者ID列表

*/ ACLConsumers?: Array; /** *

关联的消费者组ID列表

*/ ACLConsumerGroups?: Array; } /** * DescribeCloudNativeAPIGatewayLLMTokenUsageStatistics返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayLLMTokenUsageStatisticsResponse { /** *

请求结果

*/ Result?: AIGWLLMTokenUsageStatisticsResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * LLM 模型服务列表 */ export interface ListCloudNativeAPIGatewayLLMModelService { /** * 模型服务数量。 */ TotalCount?: number; /** * 模型服务列表。 */ DataList?: Array; } /** * DescribeCNGWServicesWithRoutes请求参数结构体 */ export interface DescribeCNGWServicesWithRoutesRequest { /** *

网关ID

*/ GatewayId: string; /** *

列表数量

*/ Limit?: number; /** *

列表 offset

*/ Offset?: number; /** *

过滤条件,多个过滤条件之间是与的关系,支持 name,upstreamType

*/ Filters?: Array; } /** * DescribeCloudNativeAPIGatewayMCPServerACL返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPServerACLResponse { /** *

MCP 服务 ACL 列表结果

*/ Result?: AIGWMCPServerACLResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyCloudNativeAPIGatewayMCPServer返回参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPServerResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayLLMModelService返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayLLMModelServiceResponse { /** *

模型服务。

*/ Result?: CloudNativeAPIGatewayLLMModelService; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 云原生网关模型API 配额降级触发条件信息 */ export interface AIGWLLMQuotaFallbackTrigger { /** *

配额感知阈值百分比(RPM 与 TPM 共用)

取值范围:[0, 99]

*/ ThresholdPercent?: number; /** *

检查维度策略

枚举值:

  • AnyInsufficient: RPM 或 TPM 任一不足即触发
  • AllInsufficient: RPM 和 TPM 同时不足才触发
*/ CheckDimension?: string; } /** * DescribeCloudNativeAPIGatewaySecretKey请求参数结构体 */ export interface DescribeCloudNativeAPIGatewaySecretKeyRequest { /** *

实例 ID

*/ GatewayId: string; /** *

密钥id

*/ SecretKeyId: string; } /** * ModifyCloudNativeAPIGatewayMCPServer请求参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPServerRequest { /** *

实例 ID

*/ GatewayId: string; /** *

展示名字

*/ DisplayName: string; /** *

服务 id

*/ ServerId: string; /** *

后端类型

枚举值:

  • HostIP: 域名 ip
  • MCPRegistry: MCP 注册中心
  • VirtualMCPServer: 虚拟MCP 服务
*/ UpstreamType: string; /** *

超时时间,单位ms,最大60000

*/ Timeout?: number; /** *

重试次数,最大3次

*/ RetryCount?: number; /** *

注册中心来源信息

*/ UpstreamInfo?: AIGWMCPUpstreamInfo; /** *

会话配置

*/ SessionConfig?: AIGWMCPSessionConfig; /** *

描述

*/ Description?: string; /** *

是否启用健康检查

*/ EnableHealthCheck?: boolean; /** *

健康检查配置

*/ HealthCheck?: AIGWHealthCheckSetting; /** *

是否开启保留原Host功能

*/ PreserveHost?: boolean; } /** * AI 网关 mcp server 下所有 tool 的 ACL 状态 */ export interface AIGWMCPToolACLListResult { /** *

黑白名单鉴权类型

枚举值:

  • None: 不鉴权
  • Allow: 白名单
  • Deny: 黑名单
*/ ACLType?: string; /** *

数据列表

*/ DataList?: Array; /** *

计数

*/ TotalCount?: number; } /** * AddCloudNativeAPIGatewayConsumerGroupAuth返回参数结构体 */ export interface AddCloudNativeAPIGatewayConsumerGroupAuthResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 服务的后端配置 */ export interface KongUpstreamInfo { /** * 负载均衡算法,默认为 round-robin,还支持 least-connections,consisten_hashing */ Algorithm?: string; /** * CVM弹性伸缩组端口 */ AutoScalingCvmPort?: number; /** * CVM弹性伸缩组ID */ AutoScalingGroupID?: string; /** * CVM弹性伸缩组生命周期挂钩状态 */ AutoScalingHookStatus?: string; /** * CVM弹性伸缩组使用的CVM TAT命令状态 */ AutoScalingTatCmdStatus?: string; /** * upstream健康状态HEALTHY(健康), UNHEALTHY(异常), HEALTHCHECKS_OFF(未开启)和NONE(不支持健康检查) */ HealthStatus?: string; /** * IP或域名 */ Host?: string; /** * 命名空间 */ Namespace?: string; /** * 端口 */ Port?: number; /** * 精确的服务来源类型,新建服务来源时候传入的类型 */ RealSourceType?: string; /** * 云函数是否开启CAM鉴权,不填时默认为开启(true) */ ScfCamAuthEnable?: boolean; /** * 云函数是否开启Base64编码,默认为false */ ScfIsBase64Encoded?: boolean; /** * 云函数是否开启响应集成,默认为false */ ScfIsIntegratedResponse?: boolean; /** * SCF函数名 */ ScfLambdaName?: string; /** * SCF函数版本 */ ScfLambdaQualifier?: string; /** * SCF函数命名空间 */ ScfNamespace?: string; /** * SCF函数类型 */ ScfType?: string; /** * 服务(注册中心或Kubernetes中的服务)名字 */ ServiceName?: string; /** * 冷启动时间,单位秒 */ SlowStart?: number; /** * 服务来源ID */ SourceID?: string; /** * 服务来源的名字 */ SourceName?: string; /** * 服务来源类型 */ SourceType?: string; /** * 服务后端类型是IPList时提供 注意:此字段可能返回 null,表示取不到有效值。 */ Targets?: Array; } /** * DescribeCloudNativeAPIGatewaySecretKeyValue返回参数结构体 */ export interface DescribeCloudNativeAPIGatewaySecretKeyValueResponse { /** * 密钥值 */ Result?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * AI网关授权模型访问范围 */ export interface AIGWAuthModelScopeItem { /** *

授权主体 ID,如消费者组、消费者

*/ PrincipalId?: string; /** *

授权主体名称,如消费者组、消费者

*/ PrincipalName?: string; /** *

模型范围原始配置

*/ ModelScope?: AIGWModelScope; /** *

MAG 已展开、保序去重后的可用模型名称列表

*/ EffectiveModelNames?: Array; } /** * DeleteCloudNativeAPIGatewayConsumer请求参数结构体 */ export interface DeleteCloudNativeAPIGatewayConsumerRequest { /** * 网关实例id */ GatewayId: string; /** * 消费者ID */ ConsumerId: string; } /** * LLM-单模型内降级规则 */ export interface CloudNativeAPIGatewayLLMModelFallbackRule { /** * 备选模型,主模型不可用时将依次按顺序尝试。 */ FallbackModels?: Array; } /** * ModifyCloudNativeAPIGatewayMCPToolStatus返回参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPToolStatusResponse { /** *

创建结果

*/ Result?: boolean; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 云原生网关模型LLM配额限制信息 */ export interface AIGWLLMQuotaLimit { /** *

该模型服务每分钟请求数上限,0 表示该维度不限

*/ RPMLimit?: number; /** *

该模型服务每分钟 Token 数上限,0 表示该维度不限

*/ TPMLimit?: number; /** *

并发数限流

*/ ConcurrentCountLimit?: number; } /** * AI 网关自定义脱敏规则 */ export interface AIGWCustomDesensitizeRule { /** *

规则名称,同一配置内唯一,最长 64

*/ Name: string; /** *

RE2 兼容的正则表达式

*/ Pattern: string; /** *

日志场景为掩码格式,转发场景为占位符;最长 64

*/ MaskFormat: string; /** *

单条自定义规则是否启用

*/ Enabled: boolean; } /** * kong实例的服务和路由列表 */ export interface KongServiceRoute { /** *

服务信息

*/ Service?: KongServicePreview; /** *

路由总数

*/ RouteTotalCount?: number; /** *

是否还有更多路由

*/ RouteHasMore?: boolean; /** *

路由列表

*/ Routes?: Array; } /** * MCP Tool 列表 */ export interface CNAPIGwMCPToolList { /** *

MCPTool 列表

*/ DataList?: Array; /** *

总数

*/ TotalCount?: number; } /** * AI 网关Token长度路由规则 */ export interface AIGWTokenLengthRouteRule { /** *

token 长度下界,闭区间;0 合法

*/ MinTokenLength: number; /** *

token 长度上界,闭区间

*/ MaxTokenLength: number; /** *

命中该分段后执行的二级路由

*/ Target: AIGWLLMModelServiceSubRoute; } /** * OAuth2 凭证物料配置 */ export interface AIGWOAuthCredentialConfig { /** *

OAuth2 client_id

*/ ClientId: string; /** *

OAuth2 client_secret

*/ ClientSecret: string; /** *

OAuth2 授权回调地址

*/ RedirectURIs?: string; } /** * ModifyCloudNativeAPIGatewayConsumerGroup请求参数结构体 */ export interface ModifyCloudNativeAPIGatewayConsumerGroupRequest { /** * 网关实例id */ GatewayId: string; /** *

消费者组 ID(以 cg- 开头)。

*/ ConsumerGroupId: string; /** *

消费者组名称,最长 60 字符。

*/ Name: string; /** *

启用状态。

枚举值:

  • Enable:启用
  • Disable:禁用
*/ Status: string; /** *

消费者组描述。最长 200 字符。

*/ Description?: string; } /** * UnbindCloudNativeAPIGatewaySecretKey请求参数结构体 */ export interface UnbindCloudNativeAPIGatewaySecretKeyRequest { /** * 网关实例id */ GatewayId: string; /** * 资源类型 */ ResourceType: string; /** * 资源ID,当前最多支持一个 */ ResourceIds: Array; /** * 密钥id */ SecretKeyId: string; } /** * AI网关 Query Param 凭证物料配置 */ export interface AIGWQueryParamCredentialConfig { /** *

参数名

*/ ParamName?: string; /** *

参数值

*/ ParamValue?: string; } /** * BindCloudNativeAPIGatewaySecretKey返回参数结构体 */ export interface BindCloudNativeAPIGatewaySecretKeyResponse { /** * 结果 */ Result?: boolean; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayMCPToolList返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPToolListResponse { /** *

tool 列表

*/ Result?: CNAPIGwMCPToolList; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * LLM 模型服务 */ export interface CloudNativeAPIGatewayLLMModelService { /** *

模型服务 ID。

*/ Id?: string; /** *

模型服务名称。

*/ Name?: string; /** *

创建时间。

*/ CreateTime?: string; /** *

修改时间。

*/ ModifyTime?: string; /** *

服务类型,目前只支持xa0LLMService。

*/ ServiceType?: string; /** *

选择模型提供商, 选项:OpenAI、Anthropic、Azure OpenAI、自定义HTTP。

*/ ModelProvider?: string; /** *

API协议标准,根据供应商动态变化:OpenAI→OpenAI/v1,Anthropic→Anthropic/v1等

*/ ModelProtocol?: string; /** *

自定义的模型请求 URL。

*/ UpstreamURL?: string; /** *

模型选择方式,选项:Specify(指定模型)、PassThrough(透传请求模型)。

*/ ModelSelector?: string; /** *

默认模型,模型选择方式为 Specify 时必填。

*/ DefaultModel?: string; /** *

开启模型降级,模型选择方式为 Specify 时必填。

*/ EnableModelFallback?: boolean; /** *

可以配置备用模型规则,EnableSpecifyModelFallbackxa0为 true 时必填。

*/ ModelFallbackRule?: CloudNativeAPIGatewayLLMModelFallbackRule; /** *

开启模型参数校验,是否校验客户端传递的 model 参数,xa0模型选择方式为 PassThrough 时必填。

*/ EnableModelParamCheck?: boolean; /** *

模型检验信息,EnableModelParamCheckxa0为 true 时必填。

*/ ModelParamCheckRule?: CloudNativeAPIGatewayLLMModelParamCheckInfo; /** *

描述。

*/ Description?: string; /** *

连接超时时间

取值范围:[1, 3600000]

单位:毫秒

默认值:10000

*/ ConnectTimeout?: number; /** *

写入超时时间

取值范围:[1, 3600000]

单位:毫秒

默认值:60000

*/ WriteTimeout?: number; /** *

读取超时时间

取值范围:[1, 3600000]

单位:毫秒

*/ ReadTimeout?: number; /** *

重试次数

取值范围:[0, 5]

单位:次

默认值:0

*/ Retries?: number; /** *

路径拼接模式

枚举值:

  • FixedPath: 固定路径
  • AutoConcat: 自动拼接
*/ UpstreamUrlMode?: string; /** *

sni

*/ SNI?: string; /** *

配额限制

*/ QuotaLimit?: AIGWLLMQuotaLimit; /** *

标签

*/ Tags?: string; /** *

绑定的模型服务秘钥

*/ SecretKeyIds?: Array; /** *

模型改写规则

*/ ModelRewriteRules?: Array; /** *

服务来源

*/ SourceId?: string; /** *

命名空间

*/ Namespace?: string; /** *

服务名称

*/ ServiceName?: string; /** *

命名空间

*/ Protocol?: string; /** *

扩展参数

*/ ExtParams?: Array; /** *

模型自定义供应商名称

*/ CustomProviderName?: string; /** *

是否开启密钥轮转

*/ KeyRotationEnabled?: boolean; /** *

密钥轮转周期

单位:天

*/ KeyRotationPeriodDays?: number; /** *

外部服务来源ID

*/ ExternalInstanceId?: string; /** *

负载均衡配置。

*/ LoadBalanceConfig?: AIGWLoadBalanceConfig; /** *

是否可以发布到广场

*/ CanPublish?: boolean; /** *

发布状态

枚举值:

  • Unpublished: 未发布
  • Published: 已发布
*/ PublishStatus?: string; /** *

同步状态

枚举值:

  • Success: 成功
  • Fail: 失败
*/ SyncStatus?: string; /** *

资源类型

枚举值:

  • Public: 公共
  • Private: 私有
  • SourceDeleted: 资源删除
*/ SourceType?: string; /** *

同步版本

*/ SyncedVersion?: string; /** *

模型服务状态

枚举值:

  • Online: 已上线
  • Offline: 已下线
  • Error: 健康检查异常
*/ Status?: string; /** *

是否启用健康检查

*/ EnableHealthCheck?: boolean; /** *

健康检查配置

*/ HealthCheck?: AIGWLLMHealthCheckSetting; } /** * DeleteCloudNativeAPIGatewayConsumerGroup请求参数结构体 */ export interface DeleteCloudNativeAPIGatewayConsumerGroupRequest { /** * 网关实例id */ GatewayId: string; /** * 消费者组ID */ ConsumerGroupId: string; } /** * RemoveCloudNativeAPIGatewayConsumerGroupAuth请求参数结构体 */ export interface RemoveCloudNativeAPIGatewayConsumerGroupAuthRequest { /** *

网关实例id

*/ GatewayId: string; /** *

授权资源类型。

枚举值:

  • ModelAPI:模型 API
  • MCPServer:MCP Server
*/ ResourceType: string; /** *

对应资源的 ID。

  • ResourceType=ModelAPI 时是模型 API ID
  • ResourceType=MCPServer 时是 MCP Server ID
*/ ResourceId: string; /** *

消费者组 ID 列表(每个 ID 以 cg- 开头),长度 1-10。

*/ ConsumerGroupIds: Array; } /** * DescribeCloudNativeAPIGatewayMCPServerList请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPServerListRequest { /** *

实例 ID

*/ GatewayId: string; /** *

分页大小

*/ Limit: number; /** *

分页偏移

*/ Offset: number; /** *

密钥凭证ID

*/ SecretKeyId?: string; } /** * DescribeCloudNativeAPIGatewayConsumerGroup返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayConsumerGroupResponse { /** *

消费者组详情。

*/ Result?: CNAPIGwConsumerGroup; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 延迟优先路由配置 */ export interface AIGWLatencyPriorityConfig { /** *

路由规则列表

*/ Rules: Array; /** *

延迟指标

枚举值:

  • LLMLatency: LLM 延迟
  • NetworkLatency: 网络延迟
*/ LatencyMetric: string; /** *

路由策略

枚举值:

  • FastMode: 快速模式
  • BalanceMode: 均衡模式
*/ RouteMode?: string; } /** * ModifyCloudNativeAPIGatewayMCPServerAuth请求参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPServerAuthRequest { /** *

网关实例ID

*/ GatewayId: string; /** *

MCP服务ID

*/ ServerId: string; /** *

认证类型

枚举值:

  • None: 无认证
  • ApiKey: API Key认证
*/ AuthType: string; /** *

JWT认证配置

*/ JWTAuthConfig?: AIGWJWTAuthPluginConfig; /** *

OAuth认证配置

*/ OAuthAuthConfig?: AIGWOAuthAuthPluginConfig; /** *

OIDC认证配置

*/ OIDCAuthConfig?: AIGWOIDCAuthPluginConfig; } /** * DescribeCloudNativeAPIGatewayMCPServer请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPServerRequest { /** *

云原生API网关实例ID

*/ GatewayId: string; /** *

MCP服务ID

*/ ServerId: string; } /** * DescribeCloudNativeAPIGatewayLLMTokenUsageList请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayLLMTokenUsageListRequest { /** *

网关实例Id

*/ GatewayId: string; /** *

查询起始时间戳

单位:秒

*/ StartTime: number; /** *

查询结束时间戳

单位:秒

*/ EndTime: number; /** *

查询过滤条件,Name取值为ConsumerId或ConsumerGroupId

*/ Filters?: Array; /** *

分页条件,每页条数

*/ Limit?: number; /** *

分页条件,分页偏移量

*/ Offset?: number; } /** * AI网关LLM健康检查配置 */ export interface AIGWLLMHealthCheckSetting { /** *

检查失败阈值

*/ HealthCheckFailThreshold: number; /** *

检查间隔

*/ HealthCheckIntervalSecond: number; /** *

检查恢复阈值

*/ HealthCheckRecoverThreshold: number; /** *

检查超时时间

*/ HealthCheckTimeout: number; /** *

检查路径

*/ HealthCheckPath?: string; } /** * ModifyCloudNativeAPIGatewayMCPToolStatus请求参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPToolStatusRequest { /** *

实例 ID

*/ GatewayId: string; /** *

mcp server id

*/ ServerId: string; /** *

mcp tool 状态

枚举值:

  • Enable: 启用
  • Disable: 禁用
*/ Status: string; /** *

mcp tool id

*/ ToolId: string; } /** * AddCloudNativeAPIGatewayConsumerGroupAuth请求参数结构体 */ export interface AddCloudNativeAPIGatewayConsumerGroupAuthRequest { /** *

网关实例id

*/ GatewayId: string; /** *

授权资源类型。

枚举值:

  • ModelAPI:模型 API
  • MCPServer:MCP Server
*/ ResourceType: string; /** *

对应资源的 ID。

  • ResourceType=ModelAPI 时是模型 API ID
  • ResourceType=MCPServer 时是 MCP Server ID
*/ ResourceId: string; /** *

消费者组 ID 列表(每个 ID 以 cg- 开头),长度 1-10。

*/ ConsumerGroupIds: Array; } /** * 模型服务二级路由配置 */ export interface AIGWLLMModelServiceSubRoute { /** *

生效的路由算法类型:权重路由,模型名称路由、参数路由等Weighted/ModelName/Query (预留多个,暂时只能填写一个)

*/ SelectedTypes: Array; /** *

权重路由配置,最多10个

*/ WeightedConfig?: Array; /** *

延迟路由

*/ LatencyPriorityConfig?: AIGWLatencyPriorityConfig; /** *

指定模型路由(暂时只用在Token长度路由时的子路由选择)

*/ ModelServiceConfig?: AIGWRouteModelServiceConfig; } /** * AI 网关转发脱敏配置 */ export interface AIGWForwardDesensitizeConfig { /** *

转发脱敏配置总开关

*/ Enabled: boolean; /** *

内置规则类型:Phone、IdCard、BankCard、Email、IP、Name

*/ PredefinedRuleTypes?: Array; /** *

自定义规则,最多 20 条

*/ CustomRules?: Array; /** *

内置规则占位符格式,最长 32;为空时默认 [{type}]

*/ PlaceholderFormat?: string; /** *

脱敏失败处理:Reject(拒绝请求)或 Skip(跳过脱敏并转发)

*/ OnFailure?: string; } /** * AI GW Sensitive Word Route */ export interface AIGWSensitiveWordRoute { /** *

是否开启

*/ Enabled?: boolean; /** *

模型API ID列表

*/ ModelServiceRefs?: Array; /** *

查询接口会返回模型API的Name列表

*/ ModelServiceNames?: Array; /** *

路由方式

枚举值:

  • Weighted: 权重路由
  • ModelName: 按模型名称路由
*/ SelectedTypes?: Array; /** *

权重路由配置

*/ WeightedConfig?: Array; /** *

路由名称路由配置

*/ ModelNameConfig?: Array; } /** * aksk类型密钥 */ export interface AIGWAKSKCredentialConfig { /** *

AccessKeyId

*/ AccessKeyId?: string; /** *

SecretAccessKey

*/ SecretAccessKey?: string; } /** * CreateCloudNativeAPIGatewayMCPTool返回参数结构体 */ export interface CreateCloudNativeAPIGatewayMCPToolResponse { /** *

创建结果

*/ Result?: CNAPIGwCreateCommonResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyCloudNativeAPIGatewayLLMModelService请求参数结构体 */ export interface ModifyCloudNativeAPIGatewayLLMModelServiceRequest { /** *

网关 id。

*/ GatewayId: string; /** *

模型服务 ID,全局唯一标识。

*/ ModelServiceId: string; /** *

修改服务名称,长度2-50字符,支持中英文、数字、下划线。

*/ Name?: string; /** *

修改默认模型,模型选择方式为 Specify 时必填。

*/ DefaultModel?: string; /** *

修改模型选择方式,选项:Specify(指定模型)、PassThrough(透传请求模型)。

*/ ModelSelector?: string; /** *

修改开启模型降级,模型选择方式为 Specify 时必填。

*/ EnableModelFallback?: boolean; /** *

修改可以配置备用模型规则,EnableSpecifyModelFallback 为 true 时必填。

*/ ModelFallbackRule?: CloudNativeAPIGatewayLLMModelFallbackRule; /** *

修改开启模型参数校验,是否校验客户端传递的 model 参数, 模型选择方式为 PassThrough 时必填

*/ EnableModelParamCheck?: boolean; /** *

修改模型检验信息,EnableModelParamCheck 为 true 时必填。

*/ ModelParamCheckRule?: CloudNativeAPIGatewayLLMModelParamCheckInfo; /** *

修改描述。

*/ Description?: string; /** *

修改模型服务地址

*/ UpstreamURL?: string; /** *

连接超时时间

取值范围:[1, 3600000]

单位:毫秒

默认值:10000

*/ ConnectTimeout?: number; /** *

写入超时时间

取值范围:[1, 3600000]

单位:毫秒

默认值:60000

*/ WriteTimeout?: number; /** *

读取超时时间

取值范围:[1, 3600000]

单位:毫秒

默认值:60000

*/ ReadTimeout?: number; /** *

重试次数

取值范围:[0, 5]

单位:次

默认值:0

*/ Retries?: number; /** *

路径拼接模式

枚举值:

  • FixedPath: 固定路径
  • AutoConcat: 自动拼接
*/ UpstreamUrlMode?: string; /** *

SNI

*/ SNI?: string; /** *

模型服务级别的配额上限(RPM/TPM)。需要网关版本 ≥ 3.9.4。

*/ QuotaLimit?: AIGWLLMQuotaLimit; /** *

标签

*/ Tags?: Array; /** *

参数改写规则

*/ ModelRewriteRules?: Array; /** *

外部服务来源ID

*/ ExternalInstanceId?: string; /** *

其他参数

*/ ExtParams?: Array; /** *

密钥轮转开关

*/ KeyRotationEnabled?: boolean; /** *

密钥轮转周期

单位:天数

*/ KeyRotationPeriodDays?: number; /** *

来源服务 ID。

*/ SourceId?: string; /** *

命名空间。

*/ Namespace?: string; /** *

服务名称。

*/ ServiceName?: string; /** *

协议类型,如 OpenAI、Custom。

*/ Protocol?: string; /** *

自定义供应商名称

*/ CustomProviderName?: string; /** *

负载均衡配置

*/ LoadBalanceConfig?: AIGWLoadBalanceConfig; } /** * DescribeCloudNativeAPIGatewayMCPServerList返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPServerListResponse { /** *

MCP Server 列表结果

*/ Result?: AIGWMCPServerList; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateCloudNativeAPIGatewayLLMModelAPI返回参数结构体 */ export interface CreateCloudNativeAPIGatewayLLMModelAPIResponse { /** *

是否成功。

*/ Result?: boolean; /** *

模型 API ID,全局唯一标识。

*/ ModelAPIId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateCloudNativeAPIGatewaySecretKey返回参数结构体 */ export interface CreateCloudNativeAPIGatewaySecretKeyResponse { /** *

创建结果。包含成功标识与新建资源 ID。

*/ Result?: CNAPIGwCreateCommonResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayMCPServerAuth请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPServerAuthRequest { /** *

网关实例ID

*/ GatewayId: string; /** *

MCP服务ID

*/ ServerId: string; } /** * DeleteCloudNativeAPIGatewayLLMModelService请求参数结构体 */ export interface DeleteCloudNativeAPIGatewayLLMModelServiceRequest { /** * 网关 id。 */ GatewayId: string; /** * 模型服务 ID,全局唯一标识。 */ ModelServiceId: string; } /** * DeleteCloudNativeAPIGatewayConsumerGroup返回参数结构体 */ export interface DeleteCloudNativeAPIGatewayConsumerGroupResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyCloudNativeAPIGatewayLLMModelAPI请求参数结构体 */ export interface ModifyCloudNativeAPIGatewayLLMModelAPIRequest { /** *

网关 id。

*/ GatewayId: string; /** *

模型 API ID,全局唯一标识。

*/ ModelAPIId: string; /** *

模型 API 名称,最长 60 字符。

*/ Name?: string; /** *

统一前缀路径(可选)。例如 /v1/openai。

*/ BasePath?: string; /** *

模型 API 描述。最长 200 字符。

*/ Description?: string; /** *

关联的模型服务 ID 列表,长度 1-10。

*/ ListModelServiceId?: Array; /** *

多模型服务路由策略。ListModelServiceId 多于 1 项时必填。

*/ ModelServiceRoute?: CloudNativeAPIGatewayLLMModelServiceRoute; /** *

Header 路由匹配规则。当前仅支持 Operator=exact。

*/ MatchHeaders?: Array; /** *

是否启用跨服务 Fallback。

*/ EnableCrossServiceFallback?: boolean; /** *

跨服务 Fallback 配置。EnableCrossServiceFallback=true 时必填。

*/ CrossServiceFallbackConfig?: AIGWCrossServiceFallbackConfig; /** *

标签过滤策略。需要网关版本 ≥ 3.9.4。

*/ TagFilter?: AIGWTagFilter; /** *

日志输出配置。需要网关版本 ≥ 3.9.4。

*/ LogConfig?: AIGWLogConfig; /** *

AI 网关Rerank场景最大文档数限制配置

*/ MaxDocumentsConfig?: AIGWRerankMaxDocumentsConfig; /** *

敏感词路由配置

*/ SensitiveWordRoute?: AIGWSensitiveWordRoute; } /** * CAM类型密钥 */ export interface AIGWCAMCredentialConfig { /** *

SecretId

*/ SecretId?: string; /** *

SecretKey

*/ SecretKey?: string; } /** * MCP Server详情 */ export interface AIGWMCPServer { /** *

MCP Server ID

*/ ServerId: string; /** *

MCP Server名称

*/ Name: string; /** *

MCP Server类型,取值:MCP/Rest2MCP

*/ ServerType: string; /** *

协议类型,取值: StreamableHttp

*/ Transport: string; /** *

服务类型:

  • Registry
  • HostIP
*/ UpstreamType: string; /** *

展示名字

*/ DisplayName?: string; /** *

MCP提供给客户端的Endpoint

*/ MCPEndpoint?: string; /** *

注册中心来源信息

注意:此字段可能返回 null,表示取不到有效值。 */ UpstreamInfo?: AIGWMCPUpstreamInfoDetail; /** *

会话配置

注意:此字段可能返回 null,表示取不到有效值。 */ SessionConfig?: AIGWMCPSessionConfig; /** *

超时时间,单位ms

*/ Timeout?: number; /** *

失败重试次数

*/ RetryCount?: number; /** *

创建时间

*/ CreateTime?: string; /** *

更新时间

*/ UpdateTime?: string; /** *

描述

*/ Description?: string; /** *

运行状态

枚举值:

  • Online: 在线
  • Offline: 离线
  • Error: 错误
*/ Status?: string; /** *

是否启用健康检查

*/ EnableHealthCheck?: boolean; /** *

健康检查配置

注意:此字段可能返回 null,表示取不到有效值。 */ HealthCheck?: AIGWHealthCheckSetting; /** *

Tool分组内工具数量限制

*/ ToolCountLimit?: number; /** *

Tool分组内工具命名冲突策略

枚举值:

  • AutoPrefix: 自动前缀
  • Reject: 拒绝
*/ ConflictStrategy?: string; /** *

MCP 市场发布状态

枚举值:

  • None: 未发布
  • Published: 已发布
*/ MarketStatus?: string; /** *

是否开启保留原Host功能

*/ PreserveHost?: boolean; } /** * DescribeCloudNativeAPIGatewayLLMTokenUsageList返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayLLMTokenUsageListResponse { /** *

查询Token用量明细结果

*/ Result?: AIGWLLMTokenUsageListResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; }