/** * CreateCloudNativeAPIGatewayMCPTool请求参数结构体 */ export interface CreateCloudNativeAPIGatewayMCPToolRequest { /** *
内容类型
*/ ContentType: string; /** *展示名字
*/ DisplayName?: string; /** *服务 id
*/ ServiceId?: string; } /** * CheckCloudNativeAPIGatewayMCPToolVersionExist请求参数结构体 */ export interface CheckCloudNativeAPIGatewayMCPToolVersionExistRequest { /** *网关实例 id
*/ GatewayId: string; /** *MCPserverId
*/ ServerId: string; /** *工具 id
*/ ToolId: string; /** *mcp tool版本id
*/ ToolVersion: string; } /** * CompareCloudNativeAPIGatewayMCPToolVersion返回参数结构体 */ export interface CompareCloudNativeAPIGatewayMCPToolVersionResponse { /** *对比总结
*/ Result?: AIGWChangeSummary; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 密钥列表 */ export interface CNAPIGwSecretKeyList { /** * 密钥列表 */ SecretKeys?: Array模型服务列表。
*/ Result?: ListCloudNativeAPIGatewayLLMModelService; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DeleteCloudNativeAPIGatewayMCPTool返回参数结构体 */ export interface DeleteCloudNativeAPIGatewayMCPToolResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * RollbackCloudNativeAPIGatewayMCPToolVersion返回参数结构体 */ export interface RollbackCloudNativeAPIGatewayMCPToolVersionResponse { /** *操作结果
*/ Result?: boolean; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateCloudNativeAPIGatewayMCPServer请求参数结构体 */ export interface CreateCloudNativeAPIGatewayMCPServerRequest { /** *实例 ID
*/ GatewayId: string; /** *名字
*/ Name: string; /** *展示名字
*/ DisplayName: string; /** *MCP服务类型
传输协议:StreamableHttp或SSE
枚举值:
后端类型
枚举值:
注册中心来源信息
*/ UpstreamInfo?: AIGWMCPUpstreamInfo; /** *会话配置
*/ SessionConfig?: AIGWMCPSessionConfig; /** *超时时间,单位ms,最大60000
*/ Timeout?: number; /** *重试次数,最大3次
*/ RetryCount?: number; /** *描述
*/ Description?: string; /** *是否启用健康检查
*/ EnableHealthCheck?: boolean; /** *健康检查配置
*/ HealthCheck?: AIGWHealthCheckSetting; /** *是否开启保留原Host功能
*/ PreserveHost?: boolean; /** *日志采集配置
*/ LogConfig?: AIGWLogConfig; } /** * DescribeCloudNativeAPIGatewaySecretKeyList返回参数结构体 */ export interface DescribeCloudNativeAPIGatewaySecretKeyListResponse { /** *密钥列表
*/ Result?: CNAPIGwSecretKeyList; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 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 时必传
域名或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模型服务 Id
*/ ModelServiceId: string; /** *模型服务名
*/ ModelServiceName?: string; } /** * DescribeCloudNativeAPIGatewaySecretKeyValue请求参数结构体 */ export interface DescribeCloudNativeAPIGatewaySecretKeyValueRequest { /** * 实例 ID */ GatewayId: string; /** * 密钥id */ SecretKeyId: string; /** * 指定从 AKSK 或 CAM 成对凭证中返回哪一半。取值:AccessKey(AKSK 返回 AccessKeyId,CAM 返回 SecretId)、SecretKey(AKSK 返回 SecretAccessKey,CAM 返回 SecretKey)。不传则保持原行为,仅返回 AccessKeyId 或 SecretId。 */ SecretValueType?: string; } /** * AI 网关延迟优先路由模型服务 */ export interface AIGWLatencyPriorityRouteRule { /** *模型服务id
*/ ModelServiceId: string; } /** * 版本变更的兼容变更,破坏变更数 */ export interface AIGWChangeSummary { /** *破坏性变更数
*/ Breaking?: number; /** *兼容性变更数
*/ Compatible?: number; } /** * AI网关 Basic Auth 凭证物料配置 */ export interface AIGWBasicCredentialConfig { /** *密码
*/ Password?: string; /** *用户名
*/ Username?: string; } /** * DescribeCloudNativeAPIGatewayMCPToolVersionList请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPToolVersionListRequest { /** *网关实例 id
*/ GatewayId: string; /** *MCPserverId
*/ ServerId: string; /** *工具 id
*/ ToolId: string; /** *分页查询limit
*/ Limit?: number; /** *分页查询偏移
*/ Offset?: number; } /** * 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?: ArrayHttp Path
*/ Paths?: Array键
*/ Key: string; /** *值
*/ Value: string; /** *操作类型
*/ Operator: string; } /** * ModifyCloudNativeAPIGatewaySecretKey请求参数结构体 */ export interface ModifyCloudNativeAPIGatewaySecretKeyRequest { /** * 实例 ID */ GatewayId: string; /** * 密钥名字 */ Name: string; /** * 密钥id */ SecretKeyId: string; /** * 描述,200字以内 */ Description?: string; } /** * AI数据源列表 */ export interface CNAPIGwAIServiceSourceList { /** *MCP服务列表
*/ DataList?: Array总数
*/ TotalCount?: number; } /** * 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; } /** * RemoveCloudNativeAPIGatewayConsumerGroupAuth请求参数结构体 */ export interface RemoveCloudNativeAPIGatewayConsumerGroupAuthRequest { /** *网关实例id
*/ GatewayId: string; /** *授权资源类型。
枚举值:
对应资源的 ID。
消费者组 ID 列表(每个 ID 以 cg- 开头),长度 1-10。
*/ ConsumerGroupIds: Array模型服务id
*/ ModelServiceId: string; /** *权重值
*/ Weight: number; } /** * DescribeCloudNativeAPIGatewayMCPToolsFromFile接口的出参 */ export interface CNAPIGwParseMCPToolsResult { /** *MCP Tools列表
*/ DataList?: ArrayMCP 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 { /** *匹配策略
枚举值:
标签
*/ Tags?: Array网关ID
*/ GatewayId: string; /** *MCP Server ID
*/ ServerId: string; /** *描述
*/ Description?: string; /** *Header匹配规则
*/ HeaderMatch?: Arrayhttp method
*/ Methods?: Array路由名称
*/ Name?: string; /** *路径
*/ Path?: string; /** *路径匹配规则
枚举值:
route优先级
*/ Priority?: number; } /** * DescribeCloudNativeAPIGatewayMCPTool返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPToolResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * LLM-模型参数检查信息 */ export interface CloudNativeAPIGatewayLLMModelParamCheckInfo { /** * 允许的模型列表。 */ AllowModelList?: ArrayMCP 服务 Tool ACL 列表结果
*/ Result?: AIGWMCPToolACLListResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayMCPServerList请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPServerListRequest { /** *实例 ID
*/ GatewayId: string; /** *分页大小
*/ Limit: number; /** *分页偏移
*/ Offset: number; /** *密钥凭证ID
*/ SecretKeyId?: string; } /** * ModifyCloudNativeAPIGatewayMCPServerAuth返回参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPServerAuthResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyCloudNativeAPIGatewayMCPRouteStatus返回参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPRouteStatusResponse { /** *操作结果
注意:此字段可能返回 null,表示取不到有效值。 */ Result?: boolean; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateCloudNativeAPIGatewayConsumerGroup请求参数结构体 */ export interface CreateCloudNativeAPIGatewayConsumerGroupRequest { /** *网关实例id
*/ GatewayId: string; /** *消费者组名称,最长 60 字符。同一网关下唯一。
*/ Name: string; /** *启用状态。
枚举值:
消费者组描述。最长 200 字符。
*/ Description?: string; } /** * 密钥信息 */ export interface CNAPIGwSecretKey { /** *绑定数
*/ BindCount?: number; /** *是否可以绑定
注意:此字段可能返回 null,表示取不到有效值。 */ CanBind?: boolean; /** *创建时间
*/ CreateTime?: string; /** *描述
注意:此字段可能返回 null,表示取不到有效值。 */ Description?: 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; /** *密钥归属资源类型。
枚举值:
密钥id
*/ SecretKeyId?: string; /** *密钥协议类型。
*/ SecretType?: string; /** *密钥明文
*/ SecretValue?: string; /** *状态。
枚举值:
同步状态
枚举值:
资源类型
枚举值:
同步版本
*/ SyncedVersion?: string; /** *AK/SK凭证配置
*/ AKSKCredentialConfig?: AIGWAKSKCredentialConfig; /** *CAM凭证配置
*/ CAMCredentialConfig?: AIGWCAMCredentialConfig; /** *Bearer Token凭证配置
*/ BearerTokenCredentialConfig?: AIGWBearerTokenCredentialConfig; /** *Basic Auth凭证配置
*/ BasicCredentialConfig?: AIGWBasicCredentialConfig; /** *自定义Header凭证配置
*/ CustomHeaderCredentialConfig?: AIGWCustomHeaderCredentialConfig; /** *自定义Query参数凭证配置
*/ QueryParamCredentialConfig?: AIGWQueryParamCredentialConfig; /** *该消费者密钥绑定的模型密钥列表
*/ BoundModelSecretKeys?: Array绑定了该模型密钥的消费者密钥列表
*/ BoundConsumerSecretKeys?: Array是否成功。
*/ 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; /** *消费者优先级
枚举值:
描述
注意:此字段可能返回 null,表示取不到有效值。 */ Description?: string; /** *消费者分组
注意:此字段可能返回 null,表示取不到有效值。 */ ConsumerGroups?: Array同步状态
枚举值:
资源类型
枚举值:
同步版本
*/ 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 输出模式
枚举值:
上游原始 payload access log 输出模式
枚举值:
请求 Body 大小裁剪策略
枚举值:
响应 Body 大小裁剪策略
枚举值:
服务来源实例id
*/ InstanceId?: string; /** *授权信息
*/ Auth?: CNAPIGwAIServiceSourceAuth; /** *地址列表
*/ Addresses?: Array总数
*/ TotalCount: number; /** *mcp server 数据列表
注意:此字段可能返回 null,表示取不到有效值。 */ DataList?: Array签名算法,取值: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; } /** * DescribeCloudNativeAPIGatewayLLMModelService返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayLLMModelServiceResponse { /** *模型服务。
*/ Result?: CloudNativeAPIGatewayLLMModelService; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 资源端 OIDC 认证插件配置 */ export interface AIGWOIDCAuthPluginConfig { /** *目标受众
*/ Audience?: string; /** *是否BearerOnly
目前只能为true
*/ BearerOnly?: boolean; /** *授权范围
*/ Scopes?: Array消费者标识
*/ ConsumerClaim?: string; /** *认证域
*/ Realm?: string; /** *超时时间
*/ Timeout?: number; /** *令牌端点认证方法
枚举值:
令牌内省端点
*/ IntrospectionEndpoint?: 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: ArrayHeader的Key
*/ Key: string; /** *Header匹配规则
枚举值:
Header匹配的值
*/ Value: string; } /** * CreateCloudNativeAPIGatewayLLMModelService请求参数结构体 */ export interface CreateCloudNativeAPIGatewayLLMModelServiceRequest { /** *网关 id。
*/ GatewayId: string; /** *服务名称,最长60个字符,支持中英文大小写、数字及分隔符(“-”、“_”),不能以数字和分隔符开头,不能以分隔符结尾。
*/ Name: string; /** *服务类型。目前仅支持 LLMService。
枚举值:
选择模型提供商, 选项: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; /** *路径拼接模式
枚举值:
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; /** *业务场景。
枚举值:
请求协议(小写)。当前仅支持:
关联的模型服务 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; /** *参数类型
枚举值:
必填
*/ Required: boolean; /** *位置
枚举值:
描述
*/ 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签名的header名称列表
*/ HeaderNames?: Array签名的cookie名称列表
*/ CookieNames?: Array签名的URL参数名称列表
*/ URIParamNames?: Array消费者标识
*/ KeyClaimName?: string; /** *标准消费者校验
枚举值:
最大有效期
*/ MaximumExpiration?: number; /** *是否Base64编码
*/ SecretIsBase64?: boolean; /** *CORS预检验证
*/ RunOnPreFlight?: boolean; } /** * MCP Tools导入任务的进度 */ export interface CNAPIGwMCPToolImportTaskResult { /** *导入失败的数量
*/ FailedCount?: number; /** *已处理导入Tool的总数
*/ ProcessedCount?: number; /** *成功导入的Tool数量
*/ SuccessCount?: number; /** *任务结束时间
注意:此字段可能返回 null,表示取不到有效值。 */ TaskEndTime?: string; /** *任务ID
*/ TaskId?: string; /** *任务开始时间
注意:此字段可能返回 null,表示取不到有效值。 */ TaskStartTime?: string; /** *任务状态
枚举值:
导入结果详情
*/ ToolsImportResult?: Array待导入Tools的总数
*/ TotalCount?: number; } /** * 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 → 后端接收简洁路径
禁用时:客户端请求路径 → 完整传递给后端。
模型 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
*/ ACLType: string; /** *需要关联的消费者ID列表
*/ ACLConsumerIds?: Array需要关联的消费者组ID列表
*/ ACLConsumerGroupIds?: Array原始模型
*/ SourceModel?: string; /** *目标模型
*/ TargetModel?: string; } /** * AI网关配额 */ export interface AIGWQuota { /** *Id
*/ Id?: string; /** *资源类型
枚举值:
资源 id
*/ ResourceId?: string; /** *资源名字
如消费者名字
*/ ResourceName?: string; /** *配额类型
枚举值:
配额周期单位
枚举值:
配额
*/ QuotaLimit?: number; /** *启用
*/ Enabled?: boolean; /** *创建时间
参数格式:YYYY-MM-DD hh:mm:ss
*/ CreateTime?: string; /** *更新时间
参数格式:YYYY-MM-DD hh:mm:ss
*/ ModifyTime?: string; /** *配额类型,手动配额还是默认配额
*/ Source?: string; /** *配额超限行为
枚举值:
缓存是否计入限额
枚举值:
生效的路由算法类型:权重路由,模型名称路由、参数路由等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; /** *同步状态
枚举值:
资源类型
枚举值:
同步版本
*/ SyncedVersion?: string; } /** * CreateCloudNativeAPIGatewayLLMModelService返回参数结构体 */ export interface CreateCloudNativeAPIGatewayLLMModelServiceResponse { /** *是否成功
*/ Result?: boolean; /** *模型服务 ID,全局唯一标识。
*/ ModelServiceId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * AI 网关 MCP Server ACL 配置详情 */ export interface AIGWMCPServerACLResult { /** *黑白名单鉴权类型
枚举值:
关联的消费者ID列表
*/ ACLConsumers?: Array关联的消费者组ID列表
*/ ACLConsumerGroups?: Array认证类型
枚举值:
网关实例id
*/ GatewayId: string; /** *消费者 ID。
*/ ConsumerId: string; /** *消费者名称,最长 60 字符。
*/ Name: string; /** *消费者优先级
枚举值:
消费者描述。最长 200 字符。
*/ Description?: string; } /** * DescribeCloudNativeAPIGatewayMCPToolImportTask返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPToolImportTaskResponse { /** *导入任务的进度
*/ Result?: CNAPIGwMCPToolImportTaskResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * AI 网关日志脱敏配置 */ export interface AIGWLogDesensitizeConfig { /** *日志脱敏配置总开关
*/ Enabled: boolean; /** *内置规则类型:Phone、IdCard、BankCard、Email、IP、Name
*/ PredefinedRuleTypes?: Array自定义规则,最多 20 条
*/ CustomRules?: Array脱敏方向:Request、Response;为空时默认两者
*/ Scope?: ArrayToken凭证
*/ Token?: string; } /** * 新建MCP路由结果 */ export interface AIGWCreateMCPRouteResult { /** *路由ID
*/ RouteId?: string; /** *结果
*/ Success?: boolean; } /** * DescribeCloudNativeAPIGatewayConsumer返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayConsumerResponse { /** *消费者详情
*/ Result?: CNAPIGwConsumer; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 云原生网关MCP会话配置 */ export interface AIGWMCPSessionConfig { /** *会话存储类型
枚举值:
Redis配置
*/ RedisConfig?: AIGWRedisConfig; } /** * AI 网关 MCP Server 认证配置详情 */ export interface AIGWMCPServerAuthResult { /** *MCP服务认证类型
枚举值:
JWT认证配置
*/ JWTAuthConfig?: AIGWJWTAuthPluginConfig; /** *OAuth2认证配置
*/ OAuthAuthConfig?: AIGWOAuthAuthPluginConfig; /** *OIDC认证配置
*/ OIDCAuthConfig?: AIGWOIDCAuthPluginConfig; } /** * DeleteCloudNativeAPIGatewayMCPToolVersion返回参数结构体 */ export interface DeleteCloudNativeAPIGatewayMCPToolVersionResponse { /** *删除mcp tool版本结果
*/ Result?: boolean; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 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 { /** *范围类型
枚举值:
允许访问的模型列表,ScopeType=ALLOWLIST时设置
*/ AllowList?: Array模型访问组,ScopeType=MAG时设置
*/ MagRefs?: Array意图编码
枚举值:
模型服务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?: Arrayheaders
*/ 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; /** *请求方法
枚举值:
展示
*/ 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是否成功。
*/ Result?: boolean; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayMCPRouteList返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPRouteListResponse { /** *路由列表信息
注意:此字段可能返回 null,表示取不到有效值。 */ Result?: AIGWMCPRouteListResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * AI网关配额列表 */ export interface AIGWQuotaList { /** *总数
*/ TotalCount?: number; /** *配额列表
*/ DataList?: ArrayOpenAPI文件内容
*/ 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
*/ 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; } /** * ModifyCloudNativeAPIGatewayMCPServerStatus返回参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPServerStatusResponse { /** *创建结果
*/ Result?: boolean; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayMCPToolVersion返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPToolVersionResponse { /** *tool版本的json snapshot
*/ Result?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 云原生网关MCP后端信息,用于展示 */ export interface AIGWMCPUpstreamInfoDetail { /** *注册中心来源ID
*/ SourceId?: string; /** *注册中心来源名称, 入参不传,用于返回
*/ SourceName?: string; /** *命名空间
*/ Namespace?: string; /** *服务 id
*/ MCPServerId?: string; /** *协议,UpstreamType是Registry 时必传
域名或ip
*/ Host?: string; /** *端口
*/ Port?: number; /** *服务 id
*/ ServiceId?: string; /** *服务名字
*/ ServiceName?: string; /** *服务分组
*/ ServiceGroup?: string; /** *mcp endpoint
*/ MCPEndpoint?: string; /** *SSE message路径
*/ MessageEndpoint?: string; /** *TLS配置
*/ TLSConfig?: AIGWUpstreamTLSConfig; } /** * MCP 路由列表分页查询结果 */ export interface AIGWMCPRouteListResult { /** *路由列表
*/ DataList?: Array总数
*/ TotalCount?: number; } /** * DescribeCloudNativeAPIGatewayLLMModelAPI请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayLLMModelAPIRequest { /** *网关 id。
*/ GatewayId: string; /** *模型 API ID,全局唯一标识。
*/ ModelAPIId: string; } /** * DescribeCloudNativeAPIGatewaySecretKeyList请求参数结构体 */ export interface DescribeCloudNativeAPIGatewaySecretKeyListRequest { /** *实例 ID
*/ GatewayId: string; /** *每页条数,范围 [1, 100],默认 10。
*/ Limit: number; /** *起始位置,从 0 开始。
*/ Offset: number; /** *过滤条件。支持的 Name:Status / GenerateType / SecretType。
*/ Filters?: Array模糊匹配密钥名称。
*/ Keyword?: string; /** *对应资源的 ID(消费者 ID 或模型服务 ID)。
*/ ResourceId?: string; /** *密钥归属资源类型。UseToBind=true 时必填。
枚举值:
是否用于绑定场景。true 时返回可被绑定到指定资源的密钥。
*/ UseToBind?: boolean; } /** * 键值对 */ export interface KVMapping { /** * 键值映射的键 */ Key?: string; /** * 键值映射的值 */ Value?: string; } /** * ModifyCloudNativeAPIGatewayMCPRoute返回参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPRouteResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * mcp tool版本信息 */ export interface AIGWMCPToolVersion { /** *创建时间
*/ CreateTime?: string; /** *创建者
*/ Creator?: string; /** *是否生效
*/ IsActive?: boolean; /** *总参数
*/ TotalParam?: number; /** *版本号
*/ Version?: string; } /** * AI的服务来源授权信息 */ export interface CNAPIGwAIServiceSourceAuth { /** *账号
*/ Username?: string; /** *密码
*/ Password?: string; /** *接入Token
*/ AccessToken?: string; } /** * AI 网关token长度路由配置 */ export interface AIGWTokenLengthRoute { /** *默认tokenizer编码器
枚举值:
token 计数失败、规则为空或未命中任何规则时执行的默认二级路由(暂时只能选择一个指定模型路由)
*/ DefaultTarget?: AIGWLLMModelServiceSubRoute; /** *规则
*/ Rules?: Array解析结果
*/ Result?: CNAPIGwParseMCPToolsResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 缓存感知路由候选模型服务 */ export interface AIGWCacheAwareRouteCandidate { /** *模型服务ID
*/ ModelServiceId?: string; /** *模型服务名称
*/ ModelServiceName?: string; } /** * AI服务来源 */ export interface CNAPIGwAIServiceSource { /** *服务来源
*/ SourceName: string; /** *服务ID
*/ SourceId: string; /** *来源类型
*/ SourceType: string; /** *来源产品
*/ SourceProduct: string; /** *来源配置信息
*/ SourceInfo: CNAPIGwAIServiceSourceInfo; /** *描述
*/ Description?: string; /** *创建时间
*/ CreateTime?: string; /** *更新时间
*/ UpdateTime?: string; } /** * ModifyCloudNativeAPIGatewayAIServiceSource返回参数结构体 */ export interface ModifyCloudNativeAPIGatewayAIServiceSourceResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * BindCloudNativeAPIGatewaySecretKey请求参数结构体 */ export interface BindCloudNativeAPIGatewaySecretKeyRequest { /** * 网关实例id */ GatewayId: string; /** * 资源类型 */ ResourceType: string; /** * 资源ID,当前最多支持一个 */ ResourceIds: Array配额详情
*/ Result?: AIGWQuotaDetail; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayAIServiceSourceList请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayAIServiceSourceListRequest { /** *实例 ID
*/ GatewayId: string; /** *分页大小
*/ Limit: number; /** *分页偏移
*/ Offset: number; /** *搜索关键词
*/ Keyword?: string; /** *过滤条件
*/ Filters?: Array网关实例 id
*/ GatewayId: string; /** *MCPserverId
*/ ServerId: string; /** *工具 id
*/ ToolId: string; /** *mcp tool版本
*/ ToolVersion: string; } /** * DescribeCloudNativeAPIGatewayMCPToolVersion请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPToolVersionRequest { /** *网关实例 id
*/ GatewayId: string; /** *MCPserverId
*/ ServerId: string; /** *工具 id
*/ ToolId: string; /** *tool版本id
*/ ToolVersion: string; } /** * DeleteCloudNativeAPIGatewayMCPServer请求参数结构体 */ export interface DeleteCloudNativeAPIGatewayMCPServerRequest { /** *云原生API网关实例ID
*/ GatewayId: string; /** *MCP服务ID
*/ ServerId: string; } /** * 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网关实例 id
*/ GatewayId: string; /** *MCP Server id
*/ ServerId: string; /** *工具 id
*/ ToolId: string; } /** * DescribeCloudNativeAPIGatewayLLMTokenUsageStatistics请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayLLMTokenUsageStatisticsRequest { /** *网关实例Id
*/ GatewayId: string; /** *查询开始时间戳
单位:秒
*/ StartTime: number; /** *查询结束时间戳
单位:秒
*/ EndTime: number; /** *查询过滤条件
*/ Filters?: Array实例 ID
*/ GatewayId: string; /** *密钥生成方式。
枚举值:
密钥名称,2-60 字符。
*/ Name: string; /** *密钥归属资源类型。
枚举值:
密钥协议类型。
枚举值:
密钥描述。最长 200 字符。
*/ Description?: string; /** *JWT凭证配置
*/ JWTCredentialConfig?: AIGWJWTCredentialConfig; /** *KMS 密钥名称。GenerateType=KMS 时必填。
*/ KmsKeyName?: string; /** *KMS 密钥版本。GenerateType=KMS 时必填。
*/ KmsKeyVersion?: string; /** *OAuth2.0凭证配置
*/ OAuthCredentialConfig?: AIGWOAuthCredentialConfig; /** *OIDC凭证配置
*/ OIDCCredentialConfig?: AIGWOIDCCredentialConfig; /** *第三方平台类型
枚举值:
密钥值,长度 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; } /** * AI 网关配额详情 */ export interface AIGWQuotaDetail { /** *id
*/ Id?: string; /** *资源类型
枚举值:
资源id
*/ ResourceId?: string; /** *资源名字
*/ ResourceName?: string; /** *配额类型
枚举值:
配额单位
枚举值:
配额
如果是成本则数值单位是分,如 1000 表示 10.00 元
*/ QuotaLimit?: number; /** *启用
*/ Enabled?: boolean; /** *用量
*/ Used?: number; /** *使用率
*/ UsageRate?: number; /** *预警级别
枚举值:
配额规则来源
枚举值:
配额超限行为
枚举值:
创建时间
参数格式:YYYY-MM-DD hh:mm:ss
注意:此字段可能返回 null,表示取不到有效值。 */ CreateTime?: string; /** *更新时间
参数格式:YYYY-MM-DD hh:mm:ss
注意:此字段可能返回 null,表示取不到有效值。 */ ModifyTime?: string; /** *缓存是否计入限额
枚举值:
mcp server详情
*/ Result?: AIGWMCPServer; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 缓存感知路由 */ export interface AIGWCacheAwareRouteConfig { /** *前缀缓存感知路由模型服务列表
*/ Candidates?: Array网关实例ID
*/ GatewayId: string; /** *MCP服务ID
*/ ServerId: string; /** *MCP工具ID
*/ ToolId: string; /** *鉴权类型
枚举值:
需要关联的消费者ID列表
*/ ACLConsumerIds?: Array需要关联的消费者组ID列表
*/ ACLConsumerGroupIds?: Array创建结果
*/ Result?: CNAPIGwCreateCommonResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * UpdateCloudNativeAPIGatewayMCPTools请求参数结构体 */ export interface UpdateCloudNativeAPIGatewayMCPToolsRequest { /** *网关实例ID
*/ GatewayId: string; /** *MCP Server ID
*/ MCPServerId: string; /** *待导入的MCP Tools列表
*/ Tools: Array健康检查类型
枚举值:
检查间隔
*/ 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网关实例id
*/ GatewayId: string; /** *消费者名称,最长 60 字符。同一网关下唯一。
*/ Name: string; /** *优先级
枚举值:
消费者描述。最长 200 字符。
*/ Description?: string; } /** * ModifyCloudNativeAPIGatewayMCPServerStatus请求参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPServerStatusRequest { /** *实例 ID
*/ GatewayId: string; /** *mcp server id
*/ ServerId: string; /** *mcp server状态
枚举值:
触发条件
枚举值:
fallback 服务链
*/ FallbackServiceChain: Array额度降级触发配置
*/ QuotaFallbackTrigger?: AIGWLLMQuotaFallbackTrigger; } /** * AI网关Upstream TLS配置 */ export interface AIGWUpstreamTLSConfig { /** *是否校验上游服务端证书
默认值:false
*/ TLSVerify?: boolean; /** *客户端证书 ID(mTLS 用)
*/ ClientCertId?: string; /** *信任的 CA 证书 ID 列表
*/ UpstreamCACertIds?: Array消费者模型生效范围类型
枚举值:
模型授权白名单列表
*/ AllowList?: Array网关ID
*/ GatewayId: string; /** *路由ID
*/ RouteId: string; /** *MCP Server ID
*/ ServerId: string; } /** * DescribeCloudNativeAPIGatewayLLMModelAPIs返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayLLMModelAPIsResponse { /** * 模型 API 列表。 */ Result?: ListCloudNativeAPIGatewayLLMModelAPI; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CompareCloudNativeAPIGatewayMCPToolVersion请求参数结构体 */ export interface CompareCloudNativeAPIGatewayMCPToolVersionRequest { /** *对比源版本号
*/ BaseVersion: string; /** *网关实例 id
*/ GatewayId: string; /** *MCPserverId
*/ ServerId: string; /** *对比目标版本号
*/ TargetVersion: string; /** *工具 id
*/ ToolId: string; } /** * AddCloudNativeAPIGatewayConsumerInGroup请求参数结构体 */ export interface AddCloudNativeAPIGatewayConsumerInGroupRequest { /** * 网关实例id */ GatewayId: string; /** *消费者组 ID(以 cg- 开头)。
*/ ConsumerGroupId: string; /** *消费者 ID 列表,长度 1-10。
*/ ConsumerIds: Array创建结果。包含成功标识与新建资源 ID。
*/ Result?: CNAPIGwCreateCommonResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * MCP路由对象 */ export interface AIGWMCPRoute { /** *创建时间
*/ CreateTime?: string; /** *路由表达式
*/ Expression?: string; /** *Header匹配规则
*/ HeaderMatch?: Array是否为默认路由
枚举值:
http path
*/ Methods?: Array路由名称
*/ Name?: string; /** *路由路径
*/ Path?: string; /** *路径匹配方式
枚举值:
优先级
*/ Priority?: number; /** *路由ID
*/ RouteId?: string; /** *启用/禁用状态
枚举值:
是否开启保留原Host功能
*/ PreserveHost?: boolean; } /** * 模型服务模型名称路由策略 */ export interface CloudNativeAPIGatewayLLMModelServiceRouteModelNameStrategy { /** *模型服务id
*/ ModelServiceId: string; /** *匹配模型服务
*/ MatchModelName: string; /** *重写模型
*/ RewriteModelName?: string; } /** * DeleteCloudNativeAPIGatewayLLMModelAPI返回参数结构体 */ export interface DeleteCloudNativeAPIGatewayLLMModelAPIResponse { /** *是否成功。
*/ Result?: boolean; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 简单密钥信息 */ export interface AIGWSimpleSecretKey { /** *密钥ID
*/ SecretKeyId?: string; /** *密钥名称
*/ Name?: string; /** *启用状态
枚举值:
密钥类型
枚举值:
创建时间
参数格式:2026-09-03 14:11:05
*/ CreateTime?: string; } /** * DescribeCloudNativeAPIGatewayMCPServerList返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPServerListResponse { /** *MCP Server 列表结果
*/ Result?: AIGWMCPServerList; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * Token用量统计结果 */ export interface AIGWLLMTokenUsageListResult { /** *Token用量明细返回结果列表
*/ DataList?: Array结果总数
*/ TotalCount?: number; } /** * DescribeCloudNativeAPIGatewayMCPServerAuth返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPServerAuthResponse { /** *MCP服务认证查询结果
*/ Result?: AIGWMCPServerAuthResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * MCP Tools的导入结果 */ export interface CNAPIGwMCPToolImportResult { /** *导入失败的原因信息
注意:此字段可能返回 null,表示取不到有效值。 */ FailedMessage?: string; /** *请求方法
*/ Method?: string; /** *MCP Tool 名字
*/ Name?: string; /** *MCP Tool的请求路径
*/ Path?: string; /** *导入结果
枚举值:
虚拟MCP Server的Tool的完整后端地址
注意:此字段可能返回 null,表示取不到有效值。 */ UpstreamUrl?: string; } /** * ModifyCloudNativeAPIGatewayMCPRoute请求参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPRouteRequest { /** *网关ID
*/ GatewayId: string; /** *Route ID
*/ RouteId: string; /** *MCP Server ID
*/ ServerId: string; /** *描述
*/ Description?: string; /** *Header 匹配规则
*/ HeaderMatch?: Arrayhttp method
*/ Methods?: Array路径
*/ Path?: string; /** *匹配规则
枚举值:
路由优先级
*/ Priority?: number; } /** * 通过OpenAPI文件导入MCP tools的预览内容 */ export interface CNAPIGwMCPToolPreview { /** *MCP Tool入参的ContentType
枚举值:
MCP Tool的描述
注意:此字段可能返回 null,表示取不到有效值。 */ Description?: string; /** *MCP Tool的参数
*/ InputParams?: ArrayMCP Tool的请求方法
*/ Method?: string; /** *MCP Tool名字
*/ Name?: string; /** *MCP Tool的请求路径
*/ Path?: string; /** *MCP Tool的状态
枚举值:
不可导入的原因
注意:此字段可能返回 null,表示取不到有效值。 */ StatusMessage?: string; /** *虚拟MCP Server的tools的完整url路径
注意:此字段可能返回 null,表示取不到有效值。 */ UpstreamUrl?: string; } /** * MCP Tool 信息 */ export interface CNAPIGwMCPTool { /** *名字
*/ Name: string; /** *展示名字
*/ DisplayName: 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状态
枚举值:
当前版本号
*/ CurrentVersion?: string; } /** * ModifyCloudNativeAPIGatewayAIServiceSource请求参数结构体 */ export interface ModifyCloudNativeAPIGatewayAIServiceSourceRequest { /** *实例 ID
*/ GatewayId: string; /** *服务来源名字
*/ SourceName: string; /** *服务来源类型
枚举值:
服务来源id
*/ SourceId?: string; /** *描述
*/ Description?: string; /** *来源信息
*/ SourceInfo?: CNAPIGwAIServiceSourceInfo; } /** * AI 网关 Tool ACL 单条记录(DescribeMCPToolACLList 数组元素) */ export interface AIGWMCPToolACLItem { /** *MCP工具ID
*/ ToolId?: string; /** *MCP工具名称
*/ ToolName?: string; /** *MCP工具鉴权类型
枚举值:
关联的消费者ID列表
*/ ACLConsumers?: Array关联的消费者组ID列表
*/ ACLConsumerGroups?: Array请求结果
*/ Result?: AIGWLLMTokenUsageStatisticsResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayAIQuotaList请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayAIQuotaListRequest { /** *网关实例Id
*/ GatewayId: string; /** *开始位置
*/ Offset: number; /** *每页数量
*/ Limit: number; /** *关键字
*/ Keyword?: string; /** *过滤条件
*/ Filters?: Array配额预警级别
枚举值:
网关ID
*/ GatewayId: string; /** *列表数量
*/ Limit?: number; /** *列表 offset
*/ Offset?: number; /** *过滤条件,多个过滤条件之间是与的关系,支持 name,upstreamType
*/ Filters?: Array密钥详情。
*/ Result?: CNAPIGwSecretKey; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayMCPServerACL返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPServerACLResponse { /** *MCP 服务 ACL 列表结果
*/ Result?: AIGWMCPServerACLResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayAIServiceSourceList返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayAIServiceSourceListResponse { /** *MCP Server 列表结果
*/ Result?: CNAPIGwAIServiceSourceList; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayMCPRouteList请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPRouteListRequest { /** *网关ID
*/ GatewayId: string; /** *MCP Server ID
*/ ServerId: string; /** *分页限制
*/ Limit?: number; /** *分页偏移
*/ Offset?: number; } /** * ModifyCloudNativeAPIGatewayMCPServer返回参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPServerResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CheckCloudNativeAPIGatewayMCPRouteMatch请求参数结构体 */ export interface CheckCloudNativeAPIGatewayMCPRouteMatchRequest { /** *网关 ID
*/ GatewayId: string; /** *MCP Server ID
*/ ServerId: string; /** *Modify时用于排除自身的Route ID
*/ ExcludeRouteId?: string; /** *Head匹配规则
*/ HeaderMatch?: Arrayhttp method
*/ Methods?: Array路径
*/ Path?: string; /** *path的匹配方式
枚举值:
配额感知阈值百分比(RPM 与 TPM 共用)
取值范围:[0, 99]
*/ ThresholdPercent?: number; /** *检查维度策略
枚举值:
网关实例Id
*/ GatewayId: string; /** *配额 id
*/ Id: string; } /** * DescribeCloudNativeAPIGatewaySecretKey请求参数结构体 */ export interface DescribeCloudNativeAPIGatewaySecretKeyRequest { /** *实例 ID
*/ GatewayId: string; /** *密钥id
*/ SecretKeyId: string; } /** * ModifyCloudNativeAPIGatewayMCPServer请求参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPServerRequest { /** *实例 ID
*/ GatewayId: string; /** *展示名字
*/ DisplayName: string; /** *服务 id
*/ ServerId: string; /** *后端类型
枚举值:
超时时间,单位ms,最大60000
*/ Timeout?: number; /** *重试次数,最大3次
*/ RetryCount?: number; /** *注册中心来源信息
*/ UpstreamInfo?: AIGWMCPUpstreamInfo; /** *会话配置
*/ SessionConfig?: AIGWMCPSessionConfig; /** *描述
*/ Description?: string; /** *是否启用健康检查
*/ EnableHealthCheck?: boolean; /** *健康检查配置
*/ HealthCheck?: AIGWHealthCheckSetting; /** *是否开启保留原Host功能
*/ PreserveHost?: boolean; /** *日志配置
*/ LogConfig?: AIGWLogConfig; } /** * AI 网关 mcp server 下所有 tool 的 ACL 状态 */ export interface AIGWMCPToolACLListResult { /** *黑白名单鉴权类型
枚举值:
数据列表
*/ 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授权主体 ID,如消费者组、消费者
*/ PrincipalId?: string; /** *授权主体名称,如消费者组、消费者
*/ PrincipalName?: string; /** *模型范围原始配置
*/ ModelScope?: AIGWModelScope; /** *MAG 已展开、保序去重后的可用模型名称列表
*/ EffectiveModelNames?: Array冲突路由ID
*/ ConflictRouteId?: string; /** *是否冲突
枚举值:
冲突原因
*/ Reason?: string; } /** * DeleteCloudNativeAPIGatewayConsumer请求参数结构体 */ export interface DeleteCloudNativeAPIGatewayConsumerRequest { /** * 网关实例id */ GatewayId: string; /** * 消费者ID */ ConsumerId: string; } /** * LLM-单模型内降级规则 */ export interface CloudNativeAPIGatewayLLMModelFallbackRule { /** * 备选模型,主模型不可用时将依次按顺序尝试。 */ FallbackModels?: Array创建结果
*/ Result?: boolean; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateCloudNativeAPIGatewayMCPRoute返回参数结构体 */ export interface CreateCloudNativeAPIGatewayMCPRouteResponse { /** *操作结果
注意:此字段可能返回 null,表示取不到有效值。 */ Result?: AIGWCreateMCPRouteResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyCloudNativeAPIGatewayMCPRouteStatus请求参数结构体 */ export interface ModifyCloudNativeAPIGatewayMCPRouteStatusRequest { /** *网关ID
*/ GatewayId: string; /** *路由ID
*/ RouteId: string; /** *MCP Server ID
*/ ServerId: string; /** *启用/禁用状态
枚举值:
该模型服务每分钟请求数上限,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?: ArrayMCPTool 列表
*/ DataList?: Array总数
*/ TotalCount?: number; } /** * DeleteCloudNativeAPIGatewayAIServiceSource返回参数结构体 */ export interface DeleteCloudNativeAPIGatewayAIServiceSourceResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * UnbindCloudNativeAPIGatewaySecretKey返回参数结构体 */ export interface UnbindCloudNativeAPIGatewaySecretKeyResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateCloudNativeAPIGatewayAIServiceSource请求参数结构体 */ export interface CreateCloudNativeAPIGatewayAIServiceSourceRequest { /** *实例 ID
*/ GatewayId: string; /** *来源类型:
服务来源名字
*/ SourceName?: string; /** *来源产品:- TSFNacos:TSF Nacos
*/ SourceProduct?: string; /** *来源详情
*/ SourceInfo?: CNAPIGwAIServiceSourceInfo; /** *描述
*/ Description?: string; } /** * 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; /** *启用状态。
枚举值:
消费者组描述。最长 200 字符。
*/ Description?: string; } /** * DeleteCloudNativeAPIGatewayMCPRoute返回参数结构体 */ export interface DeleteCloudNativeAPIGatewayMCPRouteResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * UnbindCloudNativeAPIGatewaySecretKey请求参数结构体 */ export interface UnbindCloudNativeAPIGatewaySecretKeyRequest { /** * 网关实例id */ GatewayId: string; /** * 资源类型 */ ResourceType: string; /** * 资源ID,当前最多支持一个 */ ResourceIds: Array参数名
*/ 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; /** *路径拼接模式
枚举值:
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; /** *发布状态
枚举值:
同步状态
枚举值:
资源类型
枚举值:
同步版本
*/ SyncedVersion?: string; /** *模型服务状态
枚举值:
是否启用健康检查
*/ EnableHealthCheck?: boolean; /** *健康检查配置
*/ HealthCheck?: AIGWLLMHealthCheckSetting; } /** * DeleteCloudNativeAPIGatewayConsumerGroup请求参数结构体 */ export interface DeleteCloudNativeAPIGatewayConsumerGroupRequest { /** * 网关实例id */ GatewayId: string; /** * 消费者组ID */ ConsumerGroupId: string; } /** * DescribeCloudNativeAPIGatewayMCPToolVersionList返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPToolVersionListResponse { /** *tool版本列表
*/ Result?: AIGWMCPToolVersionList; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 分页查询返回的mcp tool version列表 */ export interface AIGWMCPToolVersionList { /** *mcp. tool 版本详情
*/ MCPToolVersions?: Array总数
*/ TotalCount?: number; } /** * DescribeCloudNativeAPIGatewayConsumerGroup返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayConsumerGroupResponse { /** *消费者组详情。
*/ Result?: CNAPIGwConsumerGroup; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CheckCloudNativeAPIGatewayMCPToolVersionExist返回参数结构体 */ export interface CheckCloudNativeAPIGatewayMCPToolVersionExistResponse { /** *版本是否存在
*/ Result?: boolean; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CheckCloudNativeAPIGatewayMCPRouteMatch返回参数结构体 */ export interface CheckCloudNativeAPIGatewayMCPRouteMatchResponse { /** *是否冲突
注意:此字段可能返回 null,表示取不到有效值。 */ Result?: AIGWMCPRouteCheckResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 延迟优先路由配置 */ export interface AIGWLatencyPriorityConfig { /** *路由规则列表
*/ Rules: Array延迟指标
枚举值:
路由策略
枚举值:
网关实例ID
*/ GatewayId: string; /** *MCP服务ID
*/ ServerId: 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 状态
枚举值:
mcp tool id
*/ ToolId: string; } /** * AddCloudNativeAPIGatewayConsumerGroupAuth请求参数结构体 */ export interface AddCloudNativeAPIGatewayConsumerGroupAuthRequest { /** *网关实例id
*/ GatewayId: string; /** *授权资源类型。
枚举值:
对应资源的 ID。
消费者组 ID 列表(每个 ID 以 cg- 开头),长度 1-10。
*/ ConsumerGroupIds: Array配额列表
*/ Result?: AIGWQuotaList; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 模型服务二级路由配置 */ export interface AIGWLLMModelServiceSubRoute { /** *生效的路由算法类型:权重路由,模型名称路由、参数路由等Weighted/ModelName/Query (预留多个,暂时只能填写一个)
*/ SelectedTypes: Array权重路由配置,最多10个
*/ WeightedConfig?: Array延迟路由
*/ LatencyPriorityConfig?: AIGWLatencyPriorityConfig; /** *指定模型路由(暂时只用在Token长度路由时的子路由选择)
*/ ModelServiceConfig?: AIGWRouteModelServiceConfig; } /** * ModifyCloudNativeAPIGatewayConsumer返回参数结构体 */ export interface ModifyCloudNativeAPIGatewayConsumerResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 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路由方式
枚举值:
权重路由配置
*/ WeightedConfig?: Array路由名称路由配置
*/ ModelNameConfig?: ArrayAccessKeyId
*/ 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; /** *路径拼接模式
枚举值:
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; } /** * DeleteCloudNativeAPIGatewayAIServiceSource请求参数结构体 */ export interface DeleteCloudNativeAPIGatewayAIServiceSourceRequest { /** *实例 ID
*/ GatewayId: string; /** *服务来源id
*/ SourceId?: string; /** *服务来源类型
枚举值:
是否成功
*/ Result?: boolean; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DeleteCloudNativeAPIGatewayMCPToolVersion请求参数结构体 */ export interface DeleteCloudNativeAPIGatewayMCPToolVersionRequest { /** *网关实例 id
*/ GatewayId: string; /** *MCPserverId
*/ ServerId: string; /** *工具 id
*/ ToolId: string; /** *mcp tool版本
*/ ToolVersion: 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; } /** * CreateCloudNativeAPIGatewayAIServiceSource返回参数结构体 */ export interface CreateCloudNativeAPIGatewayAIServiceSourceResponse { /** *创建结果
*/ Result?: CNAPIGwCreateCommonResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DeleteCloudNativeAPIGatewayLLMModelService请求参数结构体 */ export interface DeleteCloudNativeAPIGatewayLLMModelServiceRequest { /** * 网关 id。 */ GatewayId: string; /** * 模型服务 ID,全局唯一标识。 */ ModelServiceId: string; } /** * DescribeCloudNativeAPIGatewayMCPToolImportTask请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPToolImportTaskRequest { /** *网关实例ID
*/ GatewayId: string; /** *MCP Server ID
*/ MCPServerId: string; } /** * DeleteCloudNativeAPIGatewayConsumerGroup返回参数结构体 */ export interface DeleteCloudNativeAPIGatewayConsumerGroupResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCloudNativeAPIGatewayMCPServerACL请求参数结构体 */ export interface DescribeCloudNativeAPIGatewayMCPServerACLRequest { /** *网关实例 ID
*/ GatewayId: string; /** *MCP服务ID
*/ ServerId: 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; /** *后端类型
枚举值:
展示名字
*/ DisplayName?: string; /** *MCP提供给客户端的Endpoint
*/ MCPEndpoint?: string; /** *注册中心来源信息
注意:此字段可能返回 null,表示取不到有效值。 */ UpstreamInfo?: AIGWMCPUpstreamInfoDetail; /** *会话配置
注意:此字段可能返回 null,表示取不到有效值。 */ SessionConfig?: AIGWMCPSessionConfig; /** *超时时间,单位ms
*/ Timeout?: number; /** *失败重试次数
*/ RetryCount?: number; /** *创建时间
*/ CreateTime?: string; /** *更新时间
*/ UpdateTime?: string; /** *描述
*/ Description?: string; /** *运行状态
枚举值:
是否启用健康检查
*/ EnableHealthCheck?: boolean; /** *健康检查配置
注意:此字段可能返回 null,表示取不到有效值。 */ HealthCheck?: AIGWHealthCheckSetting; /** *Tool分组内工具数量限制
*/ ToolCountLimit?: number; /** *Tool分组内工具命名冲突策略
枚举值:
MCP 市场发布状态
枚举值:
是否开启保留原Host功能
*/ PreserveHost?: boolean; /** *日志采集配置
*/ LogConfig?: AIGWLogConfig; } /** * DescribeCloudNativeAPIGatewayLLMTokenUsageList返回参数结构体 */ export interface DescribeCloudNativeAPIGatewayLLMTokenUsageListResponse { /** *查询Token用量明细结果
*/ Result?: AIGWLLMTokenUsageListResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; }