/** * DescribeTargetGroupList返回参数结构体 */ export interface DescribeTargetGroupListResponse { /** *
显示的结果数量。
*/ TotalCount?: number; /** *显示的目标组信息集合。
*/ TargetGroupSet?: Array模型名称
*/ ModelName: string; /** *所属厂商
*/ Provider: string; /** *模型类型。
枚举值:
BYOK实例ID
*/ ServiceProviderId?: string; /** *当前 CMR、当前绑定模型下该 BYOK实例的调度优先级。
取值范围:[0, 2]
默认值:0
*/ Order?: number; /** *当前CMR、当前绑定模型的同一有效Order层内,BYOK实例之间的相对选择权重。
取值范围:[0, 100]
默认值:10
*/ Weight?: number; } /** * DescribeLoadBalancerTraffic返回参数结构体 */ export interface DescribeLoadBalancerTrafficResponse { /** * 按出带宽从高到低排序后的负载均衡信息。 */ LoadBalancerTraffic?: Array负载均衡监听器 ID。
*/ ListenerId: string; /** *要修改标签的后端机器列表。
*/ Targets: Array转发规则的ID,七层规则时需要此参数,4层规则不需要。
*/ LocationId?: string; /** *后端服务修改后的标签。此参数的优先级低于前述Target中的Tag参数,即最终的标签以Target中的Tag参数值为准,仅当Target中的Tag参数为空时,才以RsTagRule中的Tag参数为准。
*/ Tag?: string; } /** * DescribeCustomizedConfigList返回参数结构体 */ export interface DescribeCustomizedConfigListResponse { /** * 配置列表 */ ConfigList?: Array切换负载均衡计费方式时,可用此参数查询切换任务是否成功。
注意:此字段可能返回 null,表示取不到有效值。 */ DealName?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateModelRouterResourcePackage请求参数结构体 */ export interface CreateModelRouterResourcePackageRequest { /** *模型路由资源包容量
取值范围:[1000, 10000000]
单次购买的模型路由资源包容量下限为1000,上限为10000000
*/ ModelRouterResourcePackageAmount: number; /** *是否自动续订。
0:不自动续订, 1:用尽到期续订
*/ AutoPurchaseFlag?: number; /** *该笔订单是否自动选择代金券
默认值:false(不自动选择代金券)
true时会为本笔订单自动匹配满足条件、最优惠的代金券
*/ AutoVoucher?: boolean; } /** * DeleteBudgets请求参数结构体 */ export interface DeleteBudgetsRequest { /** *要删除的Budget ID列表。
*/ BudgetIds: Array模型路由实例 ID。
*/ ModelRouterId: string; /** *要删除的源模型名(重写规则的 key)。
长度 1-255 字符;支持特殊值 default 表示删除兜底规则。
当指定的 SourceModel 当前不存在重写规则时,请求幂等成功。
*/ SourceModel: string; } /** * 模型别名对象 */ export interface ModelAlias { /** *模型积分系数配置,包含 InputCoefficient 和 OutputCoefficient。
未配置时输入系数和输出系数均返回 1。
*/ Coefficient?: Coefficient; /** *模型别名名称。
若用户配置了模型别名,则为该别名;未配置时为原始模型名称。
*/ ModelAliasName?: string; /** *该模型别名下各 BYOK 实例(ServiceProvider)的积分系数明细,体现 ModelAlias 与 ServiceProvider 的层级关系。
默认返回该别名引用的全部实例;某实例返回 Coefficient 表示其单独配置了 ServiceProvider 维度系数,否则继承顶层 ModelAlias 的 Coefficient。
该别名当前无有效 BYOK 引用时返回空数组。
*/ ServiceProviderCoefficientSet?: Array模型来源。
枚举值:
状态
枚举值:
模型输出模态
枚举值:
分级积分系数配置
*/ CoefficientTiers?: Array峰谷积分系数配置
*/ CoefficientSchedule?: Array预算配置数组。
数组长度最大为3,最多可同时配置1d、7d、30d三个刷新周期,且每种刷新周期只能出现一次。BudgetResetAt不支持作为入参设置,系统会按配置的刷新周期自动维护刷新时间。
*/ BudgetConfigs?: ArrayBudget名称。
不传默认为 '-'。
*/ BudgetName?: string; /** *Budget限速配置。
*/ RateLimitConfig?: RateLimitConfigForBudget; /** *创建Budget时同时关联的资源列表。
仅支持企业型模型路由实例和企业型实例下的Key。如果资源不存在或不可关联,创建请求失败;资源已关联其他Budget时将替换为新创建的Budget。
*/ Resources?: Array积分分级条件
*/ Condition?: CoefficientTierCondition; /** *积分系数
*/ Coefficient?: Coefficient; } /** * InquirePriceRefundModelRouterResourcePackage返回参数结构体 */ export interface InquirePriceRefundModelRouterResourcePackageResponse { /** *待退款的模型路由资源包可退价格
*/ ModelRouterResourcePackageRefundPrice?: Array模型路由实例ID
*/ ModelRouterId: string; /** *需要绑定的安全组ID列表
*/ SecurityGroups: Array模型路由实例ID
*/ ModelRouterId?: string; } /** * DescribeTargetGroupInstanceStatus返回参数结构体 */ export interface DescribeTargetGroupInstanceStatusResponse { /** * 健康检查后端rs状态列表 */ TargetGroupInstanceSet?: Array模型路由实例ID列表
*/ ModelRouterIds?: Array分页偏移量(>=0)
*/ Offset?: number; /** *每页数量(1-100)
*/ Limit?: number; /** *过滤PrivateCustom类型自建模型。如果传递了此参数,则只返回具有相同VPC Id的模型。
*/ VpcId?: string; /** *过滤器,Name取值:
模型路由实例ID。用户组将创建在该实例下。
*/ ModelRouterId: string; /** *用户组名称。必填。同一模型路由实例下名称唯一,长度不超过255个字符。
*/ UserGroupName: string; /** *建组时直接关联的预算 ID(须为已存在的 Budget)。关联后由该 Budget 统一管理本组的消费上限与限速。不传表示不关联预算,可建组后再用 AssociateBudget 关联。
*/ BudgetId?: string; /** *用户组意图路由白名单(ir-xxx)。每一项须为该实例已创建的意图路由名。命中意图路由名时其内部真实模型自动豁免白名单。为空表示不授权任何意图路由。
*/ IntentRouters?: Array建组时同时绑定的已有 Key ID 列表,最多100个。每个 Key 须属于同一模型路由实例。建组与绑定为一个原子异步任务,任一 Key 失败则整组创建回滚。不传表示建空组。
*/ KeyIds?: Array用户组真实模型白名单。每一项须为该实例已关联的模型名。为空表示不在用户组层限制真实模型(按实例层白名单生效)。
*/ Models?: Array标签列表,最多50个。
*/ Tags?: Array服务提供商ID列表
*/ ServiceProviderIds: Array模型路由资源包抵扣信息
*/ ModelRouterResourcePackageDeductionSet?: Array符合查询条件的详情信息总数
*/ TotalCount?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyLoadBalancerAttributes请求参数结构体 */ export interface ModifyLoadBalancerAttributesRequest { /** *负载均衡的唯一ID,可以通过 DescribeLoadBalancers 接口获取。
*/ LoadBalancerId: string; /** *负载均衡实例名称,规则:1-80 个英文字母、汉字等国际通用语言字符,数字,连接线“-”、下划线“_”等常见字符(禁止Unicode补充字符,如emoji表情、生僻汉字等)。
*/ LoadBalancerName?: string; /** *设置负载均衡跨地域绑定1.0的后端服务信息
*/ TargetRegionInfo?: TargetRegionInfo; /** *网络计费相关参数
*/ InternetChargeInfo?: InternetAccessible; /** *Target是否放通来自CLB的流量。
开启放通(true):只验证CLB上的安全组;
不开启放通(false):需同时验证CLB和后端实例上的安全组。
不填则不修改。
不同计费模式之间的切换:0表示不切换,1表示预付费和后付费切换,2表示后付费之间切换。默认值:0
*/ SwitchFlag?: number; /** *是否开启跨地域绑定2.0功能。不填则不修改。
*/ SnatPro?: boolean; /** *是否开启删除保护,不填则不修改。
*/ DeleteProtect?: boolean; /** *将负载均衡二级域名由mycloud.com改为tencentclb.com,子域名也会变换,修改后mycloud.com域名将失效。不填则不修改。
*/ ModifyClassicDomain?: boolean; /** *关联的终端节点Id,可通过DescribeVpcEndPoint接口查询。传空字符串代表解除关联。
*/ AssociateEndpoint?: string; } /** * DescribeLoadBalancerTraffic请求参数结构体 */ export interface DescribeLoadBalancerTrafficRequest { /** * 负载均衡所在地域,不传默认返回所有地域负载均衡。 */ LoadBalancerRegion?: string; } /** * 积分分档匹配条件 */ export interface CoefficientTierCondition { /** *仅 chat;单位 K Token(1K=1000 Token);非负整数,最大 2147483647;非空数组首条必须为 0,数组内严格递增、无重复;输入总 Token 严格超过阈值×1000,取满足条件的最大阈值,整单选价
*/ InputTokensAbove?: number; /** *video 仅 480p/720p/768p/1024p/1080p/2k/4k,统一小写;只校验全局枚举,不校验模型支持子集;列表内不重复
*/ Resolution?: string; } /** * DescribeClassicalLBHealthStatus返回参数结构体 */ export interface DescribeClassicalLBHealthStatusResponse { /** * 后端健康状态列表。 */ HealthList?: Array模型路由实例ID
*/ ModelRouterId: string; /** *翻页限制
取值范围:[1, 100]
默认值:20
*/ Limit?: number; /** *翻页偏移量
默认值:0
*/ Offset?: number; /** *模型输出模态
*/ Capability?: string; } /** * 规格可用性 */ export interface SpecAvailability { /** * 规格类型。日志主题的名称。
*/ TopicName: string; /** *主题分区Partition的数量,不传参默认创建1个,最大创建允许10个,分裂/合并操作会改变分区数量,整体上限50个。
*/ PartitionCount?: number; /** *日志类型,ACCESS:访问日志,HEALTH:健康检查日志,默认ACCESS。
*/ TopicType?: string; /** *存储时间,单位天,默认为 30。
日志主题的存储类型,可选值 HOT(标准存储),COLD(低频存储);默认为HOT。
*/ StorageType?: string; /** *标签
最多支持一次传入20个
*/ Tags?: Array模型路由实例ID
*/ ModelRouterId: string; /** *是否停止使用
*/ Blocked: boolean; /** *需要修改的Key的ID列表
*/ KeyIds?: Array模型别名列表。
*/ ModelAliasSet?: Array符合条件的总数。
*/ TotalCount?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyBlockIPList请求参数结构体 */ export interface ModifyBlockIPListRequest { /** * 负载均衡实例ID */ LoadBalancerIds: Array模型路由ID
*/ ModelRouterId: string; /** *需要绑定的预算信息,所有Key共用
*/ BudgetId?: string; /** *Key列表
*/ Keys?: Array批量创建Key的模式
枚举值:
默认值:Generate
*/ Mode?: string; /** *限速信息,所有Key共用
*/ RateLimitConfig?: RateLimitConfigForKey; /** *标签。所有Key都会绑定该标签。
*/ Tags?: Array需要关联的用户组ID
*/ UserGroupId?: string; } /** * CreateIntentRouter请求参数结构体 */ export interface CreateIntentRouterRequest { /** *模型路由实例ID。
*/ ModelRouterId: string; /** *路由名称,用作LiteLLM的model_name。
必须以"IntentRouter/"为前缀,后缀仅支持字母、数字、连字符和下划线,后缀长度1-128个字符。
*/ RouteName: string; /** *Tier配置列表。
每个Tier至少包含一个模型,模型名称必须是已关联到该实例的模型。
*/ Tiers: Array意图路由描述。
*/ RouterDescribe?: string; } /** * DeleteKeys返回参数结构体 */ export interface DeleteKeysResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyDomain请求参数结构体 */ export interface ModifyDomainRequest { /** * 负载均衡实例 ID,可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口查询。 */ LoadBalancerId: string; /** * 负载均衡监听器 ID, 可以通过 [DescribeListeners](https://cloud.tencent.com/document/product/214/30686) 接口查询。 */ ListenerId: string; /** * 监听器下的某个旧域名, 可以通过 [DescribeListeners](https://cloud.tencent.com/document/product/214/30686) 查询。 */ Domain: string; /** * 新域名, 长度限制为:1-120。有三种使用格式:非正则表达式格式,通配符格式,正则表达式格式。非正则表达式格式只能使用字母、数字、‘-’、‘.’。通配符格式的使用 ‘*’ 只能在开头或者结尾。正则表达式以'~'开头。 */ NewDomain: string; } /** * Budget预算配置入参 */ export interface BudgetConfigInput { /** *预算刷新周期。
支持取值:
不传时默认使用30d。同一个Budget下每种刷新周期最多配置一次。
*/ BudgetDuration?: string; /** *最大预算。
单位:credit。取值需大于0且不超过10000000000;不传时默认100000。
*/ MaxBudget?: number; } /** * Key 项 */ export interface KeyItem { /** * Provider API Key */ ApiKey: string; /** * Key 标识名称 注意:此字段可能返回 null,表示取不到有效值。 */ Name?: string; } /** * 模型路由资源包退款价格 */ export interface ModelRouterResourcePackageRefundPrice { /** *模型路由资源包Id
*/ ModelRouterPackageId?: string; /** *可退还金额
*/ Price?: number; } /** * AssociateModelsToModelRouter请求参数结构体 */ export interface AssociateModelsToModelRouterRequest { /** *模型路由实例ID
*/ ModelRouterId: string; /** *需要关联的模型信息
*/ Models?: Array配额名称
注意:此字段可能返回 null,表示取不到有效值。 */ QuotaType?: string; /** *资源ID
注意:此字段可能返回 null,表示取不到有效值。 */ ResourceId?: string; /** *配额上限
单位:个
注意:此字段可能返回 null,表示取不到有效值。 */ Limit?: number; /** *已使用配额数量
单位:个
注意:此字段可能返回 null,表示取不到有效值。 */ Used?: number; /** *剩余配额数量
单位:个
注意:此字段可能返回 null,表示取不到有效值。 */ Available?: number; } /** * AddModelRewrite请求参数结构体 */ export interface AddModelRewriteRequest { /** *模型路由实例 ID。
*/ ModelRouterId: string; /** *源模型名(重写规则的 key)。
长度 1-255 字符;支持特殊值 default 表示兜底规则(命中所有未显式列出的源模型)。
不允许使用 IntentRouter/ 前缀(大小写不敏感),即 IntentRouter 不能作为 source。
目标模型名(重写规则的 value)。
长度 1-255 字符;必须是已关联到该模型路由实例的模型(含 IntentRouter/* 也需先通过 AssociateModels 关联)。
不允许使用 default;不允许与 SourceModel 相同(大小写不敏感)。
是否开启健康检查
枚举值:
该分层下的模型显示名称列表。
*/ Models?: ArrayTier 标识。
枚举值:
模型名称
*/ ModelName: string; /** *所属厂商
*/ Provider: string; /** *模型类型。
枚举值:
BYOK实例ID
*/ ServiceProviderId: string; } /** * ModifyListener返回参数结构体 */ export interface ModifyListenerResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeTargetHealth返回参数结构体 */ export interface DescribeTargetHealthResponse { /** *负载均衡实例列表。
*/ LoadBalancers?: ArrayGuardrail 防护配置 ID。
DescribeModelRouterGuardrails 会返回该字段;DisassociateModelRouterGuardrails 和 ModifyModelRouterGuardrails 需要使用该字段定位要操作的防护配置。
*/ GuardrailId?: string; /** *Guardrail 防护类型。
枚举值:
当前仅支持 WAF;AssociateModelRouterGuardrails 不传时默认为 WAF,ModifyModelRouterGuardrails 不传时沿用当前已关联 Guardrail 的 Type。
*/ Type?: string; /** *关联的腾讯云 WAF 实例 ID。
ModifyModelRouterGuardrails 在 Type 为 WAF 时必填。DescribeModelRouterGuardrails 返回。接口会校验该 WAF 实例存在且属于当前账号。
*/ InstanceId?: string; /** *WAF LLM SDK 接入服务 ID。
该字段对应 WAF LLM SDK 接入配置中的服务标识,用于指定模型路由请求要绑定的 WAF 防护配置。ModifyModelRouterGuardrails 在 Type 为 WAF 时必填。DescribeModelRouterGuardrails 返回。接口会校验该服务配置存在于指定的 WAF 实例下。
*/ ServiceId?: string; /** *最大检测对话轮数。
ModifyModelRouterGuardrails 选填;未传时沿用当前已关联 Guardrail 的 InputCheckDepth。DescribeModelRouterGuardrails 返回。若传入,取值必须为正整数。
*/ InputCheckDepth?: number; } /** * 独占集群信息 */ export interface ClusterItem { /** * 集群唯一ID */ ClusterId: string; /** * 集群名称 */ ClusterName?: string; /** * 集群所在可用区,如ap-guangzhou-1 注意:此字段可能返回 null,表示取不到有效值。 */ Zone?: string; } /** * ModifyModelRouterAttributes请求参数结构体 */ export interface ModifyModelRouterAttributesRequest { /** *模型路由ID
*/ ModelRouterId: string; /** *新的 HTTPS 证书ID,用于替换实例 HTTPS 服务端点当前绑定的证书。常用于证书到期前的更换场景。
使用限制:
不传则证书保持不变。可通过 DescribeModelRouterDetail 接口的 ServiceEndPoints.CertId 字段查询当前绑定的证书。
模型路由名称
*/ ModelRouterName?: string; /** *限速配置
*/ RateLimitConfig?: RateLimitConfigForModelRouter; /** *路由配置
*/ RouterSetting?: RouterSettingWithFallBack; /** *带宽
取值范围:[1, 2048]
单位:Mbps
*/ Bandwidth?: number; /** *模型输出模态
*/ Capability?: string; /** *embedding 模态配置
*/ EmbeddingConfig?: EmbeddingConfig; } /** * 模型路由日志 */ export interface ModelRouterLog { /** *API Key的ID
*/ KeyId?: string; /** *模型
*/ Model?: string; /** *所属厂商
*/ Provider?: string; /** *请求状态
枚举值:
最大重试次数
*/ MaxRetries?: number; /** *单次请求消耗的总Token数量
*/ TotalTokens?: number; /** *单次请求输入消耗的Token数量
*/ InputTokens?: number; /** *单次请求输出消耗的Token数量
*/ OutputTokens?: number; /** *请求耗时
单位:ms
*/ RequestDuration?: number; /** *请求IP
*/ RequesterIp?: string; /** *日志查询起始时间
*/ StartTime?: string; /** *日志查询结束时间
*/ EndTime?: string; } /** * DescribeLoadBalancers请求参数结构体 */ export interface DescribeLoadBalancersRequest { /** * 负载均衡实例ID。实例ID数量上限为20个。 */ LoadBalancerIds?: Array模型路由实例ID
*/ ModelRouterId: string; /** *Key的ID列表
*/ KeyIds?: Array默认回退模型列表
*/ DefaultFallBackModels?: Array目标组的ID。
*/ TargetGroupId: string; /** *目标组的新名称。命名规则:1-80 个英文字母、汉字等国际通用语言字符,数字,连接线“-”、下划线“_”等常见字符(禁止Unicode补充字符,如emoji表情、生僻汉字等)。
*/ TargetGroupName?: string; /** *目标组的新默认端口。全监听目标组不支持此参数。
*/ Port?: number; /** *调度算法,仅V2新版目标组,且后端转发协议为(HTTP|HTTPS|GRPC)时该参数有效。可选值:
<ur>
健康检查详情。
*/ HealthCheck?: TargetGroupHealthCheck; /** *后端服务默认权重, 其中:
是否开启长连接,此参数仅适用于HTTP/HTTPS目标组,true:关闭;false:开启, 默认关闭。
*/ KeepaliveEnable?: boolean; /** *会话保持时间,单位:秒。可选值:30~3600,默认 0,表示不开启。TCP/UDP目标组不支持该参数。
*/ SessionExpireTime?: number; /** *是否开启SNAT(源IP替换),True(开启)、False(关闭)。默认为关闭。注意:SnatEnable开启时会替换客户端源IP,此时透传客户端源IP选项关闭,反之亦然。
模型路由实例关联的Budget ID。
未关联Budget时返回空字符串。
注意:此字段可能返回 null,表示取不到有效值。 */ BudgetId?: string; /** *模型路由实例关联的Budget名称。
未关联Budget时返回空字符串。
注意:此字段可能返回 null,表示取不到有效值。 */ BudgetName?: string; /** *集群信息
*/ ClusterInfo?: ClusterInfo; /** *创建时间
*/ CreatedTime?: string; /** *模型路由实例按Budget刷新周期划分的Credit使用情况。
当关联Budget配置多个刷新周期时,按1d、7d、30d顺序返回各周期用量;未关联Budget时返回空数组。
*/ CreditUsageSet?: Array模型路由实例域名
*/ Domain?: string; /** *模型路由ID
*/ ModelRouterId?: string; /** *模型路由名称
默认值:-
*/ ModelRouterName?: string; /** *模型路由类型
枚举值:
修改时间
*/ ModifiedTime?: string; /** *模型路由实例网络类型
枚举值:
模型路由限速信息
*/ RateLimitConfig?: RateLimitConfigForModelRouter; /** *模型路由的路由配置
注意:此字段可能返回 null,表示取不到有效值。 */ RouterSetting?: RouterSettingWithFallBack; /** *安全组ID列表
*/ SecurityGroups?: Array模型路由实例的安全状态
枚举值:
模型路由网络配置列表
*/ ServiceEndPoints?: Array模型路由实例状态
枚举值:
模型路由实例所属子网的ID
*/ SubnetId?: string; /** *标签
*/ Tags?: Array模型路由实例的计费状态
枚举值:
模型路由实例VIP
*/ Vip?: string; /** *模型路由实例所属VPC的ID
*/ VpcId?: string; /** *带宽
单位:Mbps
注意:此字段可能返回 null,表示取不到有效值。 */ Bandwidth?: number; /** *弹性公网IP的ID
*/ EipAddressId?: string; /** *计费信息
*/ BillingConfig?: ModelRouterBillingConfigOutput; /** *Embedding配置
*/ EmbeddingConfig?: EmbeddingConfig; } /** * DescribeLoadBalancerListByCertId请求参数结构体 */ export interface DescribeLoadBalancerListByCertIdRequest { /** * 服务端证书的ID,或客户端证书的ID。可以通过 [DescribeCertificate](https://cloud.tencent.com/document/api/400/41674) 接口查询。 数组最大长度为20。 */ CertIds: Array模型路由资源包Id
*/ ModelRouterResourcePackageIds?: Array订单号
*/ DealName?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * RegenerateKeys返回参数结构体 */ export interface RegenerateKeysResponse { /** *重新生成失败的Key的ID列表
*/ FailedKeyIds?: Array重新生成后的Key的信息
*/ RegeneratedKeys?: Array接入类型过滤:PublicBYOK/PublicCustom/PrivateCustom
*/ AccessType?: string; /** *过滤条件
*/ Filters?: Array返回数量限制
*/ Limit?: number; /** *翻页启始索引
*/ Offset?: number; /** *服务提供商ID
*/ ServiceProviderIds?: Array缓存命中输入积分系数。
用于 provider prompt cache 命中的输入 token。
取值范围:[0, 5000]
默认值:3
*/ InputCachedCoefficient?: number; /** *缓存创建积分系数
*/ InputCacheCreationCoefficient?: number; /** *输入积分系数。
取值范围:[1, 5000]
默认值:25
*/ InputCoefficient?: number; /** *输出积分系数。
取值范围:[1, 5000]
默认值:100
*/ OutputCoefficient?: number; /** *输入图片系数
*/ InputImageCoefficient?: number; /** *输入视频每秒系数
*/ InputVideoSecondCoefficient?: number; /** *输出视频每秒系数
*/ OutputVideoSecondCoefficient?: number; } /** * DescribeAssociatedModelAvailability请求参数结构体 */ export interface DescribeAssociatedModelAvailabilityRequest { /** *模型路由ID
*/ ModelRouterId?: string; /** *模型列表
*/ Models?: Array模型
*/ Model?: string; /** *健康状况
枚举值:
错误信息
*/ ErrorInfo?: ProviderTestConnectionErrorInfo; /** *探测请求
*/ TestConnectionRequest?: TestConnectionRequestInfo; } /** * 负载均衡实例的信息 */ export interface LoadBalancer { /** * 负载均衡实例 ID。 */ LoadBalancerId?: string; /** * 负载均衡实例的名称。 */ LoadBalancerName?: string; /** * 负载均衡实例的网络类型: OPEN:公网属性, INTERNAL:内网属性;对于内网属性的负载均衡,可通过绑定EIP出公网,具体可参考EIP文档[绑定弹性公网IP](https://cloud.tencent.com/document/product/215/16700)。 */ LoadBalancerType?: string; /** * 负载均衡类型标识,1:负载均衡,0:传统型负载均衡。 */ Forward?: number; /** * 负载均衡实例的域名,仅公网传统型和域名型负载均衡实例才提供该字段。逐步下线中,建议用LoadBalancerDomain替代。 */ Domain?: string; /** * 负载均衡实例的 VIP 列表。 */ LoadBalancerVips?: Array上游模型列表
*/ Models?: Arraybase64 url编码的文件内容
*/ Data: string; /** *附件类型
枚举值:
模型路由资源包Id。
*/ ModelRouterResourcePackageIds?: Array数据偏移量。
默认值:0
*/ Offset?: number; /** *返回的数量,最大值为100。
取值范围:[1, 100]
默认值:20
*/ Limit?: number; /** *排序参数,支持以下字段:"buyTime", "startTime", "endTime"
*/ OrderBy?: string; /** *排序方式:asc,desc,默认asc
*/ SortBy?: string; /** *查询的过滤条件。
每次请求的Filters的上限为10,Filter.Values的上限为100。 Filter.Name和Filter.Values皆为必填项。详细的过滤条件如下: status - Integer - 是否必填:否 - 状态:0-有效 1-已退款 2-已过期 3-已用完。 effect_time_start - String - 是否必填:否 - 生效起始时间,YYYY-MM-DD HH:MM:SS格式。 effect_time_end - String - 是否必填:否 - 生效截止时间。 expire_time_start - String - 是否必填:否 - 失效起始时间。 expire_time_end - String - 是否必填:否 - 失效截止时间。
*/ Filters?: ArrayBYOK的ID
参数格式:byok-kot39u7j
*/ ServiceProviderId: string; /** *BYOK的自定义名字
入参限制:1~255个字符
*/ ServiceProviderName?: string; /** *多协议 Api Base URL
*/ ApiBases?: Array非chat输出模态的Api Base URL
*/ ApiBase?: string; /** *非chat输出模态的请求后缀
*/ EndpointPath?: string; } /** * ModifyUserGroupAttributes请求参数结构体 */ export interface ModifyUserGroupAttributesRequest { /** *模型路由实例ID。
*/ ModelRouterId: string; /** *待修改的用户组ID。不可为「未分组」虚拟分组 ugrp-ungrouped。
*/ UserGroupId: string; /** *用户组关联的预算ID。不传则不修改预算关联;传入有效 budget-xxx 则将该用户组关联到此预算(若已关联其它预算则替换为本预算)。仅支持关联/替换,不支持解绑——解绑请用 DisassociateBudget。预算与组内 Key、所属实例的预算各自独立判定。
*/ BudgetId?: string; /** *用户组意图路由白名单(ir-xxx)。每一项须为该实例已创建的意图路由名。不传则不修改;传入即整体覆盖。
*/ IntentRouters?: Array用户组真实模型白名单。每一项须为该实例已关联的模型名。不传则不修改;传入即整体覆盖。
*/ Models?: Array用户组名称。不传则不修改;传入时长度不超过255个字符、同实例下唯一。
*/ UserGroupName?: string; } /** * RegisterTargetsWithClassicalLB请求参数结构体 */ export interface RegisterTargetsWithClassicalLBRequest { /** * 负载均衡实例ID。 */ LoadBalancerId: string; /** * 后端服务信息。 */ Targets: Array模型间路由策略。
枚举值:
回退策略
注意:此字段可能返回 null,表示取不到有效值。 */ FallBack?: FallBackItem; /** *模型内路由策略
枚举值:
CMR实例级别请求组内重试次数
取值范围:[0, 5]
默认值:2
注意:此字段可能返回 null,表示取不到有效值。 */ NumRetries?: number; /** *L2模型组内路由调度算法参数
注意:此字段可能返回 null,表示取不到有效值。 */ RoutingStrategyArgs?: RoutingStrategyArgs; /** *粘连配置参数
*/ StickyConfig?: StickyConfig; } /** * 跨域2.0云联网下子机和网卡信息 */ export interface CrossTargets { /** * 本地私有网络ID,即负载均衡的VpcId。 */ LocalVpcId?: string; /** * 子机或网卡所属的私有网络ID。 */ VpcId?: string; /** * 子机或网卡的IP地址 */ IP?: string; /** * 子机或网卡所属的私有网络名称。 */ VpcName?: string; /** * 子机的网卡ID。 */ EniId?: string; /** * 子机实例ID。 */ InstanceId?: string; /** * 子机实例名称。 */ InstanceName?: string; /** * 子机或者网卡所属的地域。 */ Region?: string; } /** * AssociateBudget请求参数结构体 */ export interface AssociateBudgetRequest { /** *Budget ID。
*/ BudgetId: string; /** *要关联的资源列表。
仅支持企业型模型路由实例和企业型实例下的Key。同一请求内不允许重复资源;资源已关联其他Budget时将替换为新的Budget。
*/ Resources: Array关联的模型路由实例列表
*/ AssociatedModelRouters?: Array该模型当前支持的输入多模态能力列表
枚举值:
默认值:text
*/ InputModalities?: Array模型别名, 可以用于实际访问
注意:此字段可能返回 null,表示取不到有效值。 */ ModelAlias?: string; /** *模型唯一标识, 原始模型名称
*/ ModelId?: string; /** *该模型经探测最多支持的输入多模态能力列表
枚举值:
模型不健康时列表为空
注意:此字段可能返回 null,表示取不到有效值。 */ ProbedInputModalities?: ArrayBYOK的KeyID
*/ ProviderKeyId?: string; /** *模型
*/ Model?: string; /** *健康检查状态
*/ Status?: string; } /** * DescribeServiceProviderHealthStatus返回参数结构体 */ export interface DescribeServiceProviderHealthStatusResponse { /** *健康检查的结果
*/ HealthCheckResults?: Array本次请求总数
*/ TotalCount?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyTargetWeight返回参数结构体 */ export interface ModifyTargetWeightResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 可用区资源列表 */ export interface ZoneResource { /** * 主可用区,如"ap-guangzhou-1"。 */ MasterZone?: string; /** * 资源列表。 */ ResourceSet?: Array是否开启粘连路由
*/ Enabled?: boolean; } /** * DescribeExclusiveClusters返回参数结构体 */ export interface DescribeExclusiveClustersResponse { /** * 集群列表。 */ ClusterSet?: Array后端转发协议
*/ Protocol?: string; /** *Api Base URL
*/ ApiBase?: string; } /** * 负载均衡实例的健康检查状态 */ export interface LoadBalancerHealth { /** * 负载均衡实例ID */ LoadBalancerId?: string; /** * 负载均衡实例名称 */ LoadBalancerName?: string; /** * 监听器列表 */ Listeners?: Array负载均衡实例ID,可以通过 DescribeLoadBalancers 接口查询。
*/ LoadBalancerId: string; /** *负载均衡监听器ID,可以通过 DescribeListeners 接口查询。
*/ ListenerId: string; /** *新的监听器名称。命名规则:1-80 个英文字母、汉字等国际通用语言字符,数字,连接线“-”、下划线“_”等常见字符(禁止Unicode补充字符,如emoji表情、生僻汉字等)。
*/ ListenerName?: string; /** *会话保持时间,单位:秒。可选值:30~3600,默认 0,表示不开启。此参数仅适用于TCP/UDP监听器。
*/ SessionExpireTime?: number; /** *健康检查相关参数,此参数仅适用于TCP/UDP/TCP_SSL/QUIC监听器。
*/ HealthCheck?: HealthCheck; /** *证书相关信息,此参数仅适用于HTTPS/TCP_SSL/QUIC监听器;此参数和MultiCertInfo不能同时传入。
*/ Certificate?: CertificateInput; /** *监听器转发的方式。可选值:WRR(按权重轮询)、LEAST_CONN(按最小连接数)、IP_HASH(按 IP 地址哈希)
分别表示按权重轮询、最小连接数, 默认为 WRR。
使用场景:适用于TCP/UDP/TCP_SSL/QUIC监听器。七层监听器的均衡方式应在转发规则中修改。
是否开启SNI特性,此参数仅适用于HTTPS监听器。默认0,表示不开启,1表示开启。注意:未开启SNI的监听器可以开启SNI;已开启SNI的监听器不能关闭SNI。
*/ SniSwitch?: number; /** *后端目标类型,NODE表示绑定普通节点,TARGETGROUP表示绑定目标组。
*/ TargetType?: string; /** *是否开启长连接,此参数仅适用于HTTP/HTTPS监听器。
默认值0表示不开启,1表示开启。
若后端服务对连接数上限有限制,则建议谨慎开启。此功能目前处于内测中,如需使用,请提交 内测申请。
重新调度功能,解绑后端服务开关,打开此开关,当解绑后端服务时触发重新调度。仅TCP/UDP监听器支持。
*/ DeregisterTargetRst?: boolean; /** *会话保持类型。NORMAL表示默认会话保持类型。QUIC_CID表示根据Quic Connection ID做会话保持。QUIC_CID只支持UDP协议。
使用场景:适用于TCP/UDP/TCP_SSL/QUIC监听器。
默认为 NORMAL。
证书信息,支持同时传入不同算法类型的多本服务端证书;此参数仅适用于未开启SNI特性的HTTPS监听器。此参数和Certificate不能同时传入。
*/ MultiCertInfo?: MultiCertInfo; /** *监听器粒度并发连接数上限,当前仅性能容量型实例且仅TCP/UDP/TCP_SSL/QUIC监听器支持。取值范围:1-实例规格并发连接上限,其中-1表示关闭监听器粒度并发连接数限速。基础网络实例不支持该参数。
默认为 -1,表示不限速。
监听器粒度新建连接数上限,当前仅性能容量型实例且仅TCP/UDP/TCP_SSL/QUIC监听器支持。取值范围:1-实例规格新建连接上限,其中-1表示关闭监听器粒度新建连接数限速。基础网络实例不支持该参数。
默认为 -1 表示不限速。
空闲连接超时时间,此参数仅适用于TCP/UDP监听器。如需设置超过1980s,请通过 工单申请,最大可设置到3600s。
取值范围:[10, 1980]
单位:秒
默认值:900
TCP监听器默认值:900,UDP监听器默认值:300s。取值范围:共享型实例和独占型实例支持:10~900,性能容量型实例支持:10~1980。
*/ IdleConnectTimeout?: number; /** *TCP_SSL和QUIC是否支持PP
*/ ProxyProtocol?: boolean; /** *是否开启SNAT(源IP替换),True(开启)、False(关闭)。默认为关闭。注意:SnatEnable开启时会替换客户端源IP,此时透传客户端源IP选项关闭,反之亦然。
数据压缩模式
枚举值:
重新调度功能,权重调为0开关,打开此开关,后端服务器权重调为0时触发重新调度。仅TCP/UDP监听器支持。
*/ RescheduleTargetZeroWeight?: boolean; /** *重新调度功能,健康检查异常开关,打开此开关,后端服务器健康检查异常时触发重新调度。仅TCP/UDP监听器支持。
*/ RescheduleUnhealthy?: boolean; /** *重新调度功能,扩容后端服务开关,打开此开关,后端服务器增加或者减少时触发重新调度。仅TCP/UDP监听器支持。
*/ RescheduleExpandTarget?: boolean; /** *重新调度触发开始时间,取值0~3600s。仅TCP/UDP监听器支持。
*/ RescheduleStartTime?: number; /** *重新调度触发持续时间,取值0~3600s。仅TCP/UDP监听器支持。
*/ RescheduleInterval?: number; } /** * SCF云函数(Serverless Cloud Function)相关信息。 */ export interface FunctionInfo { /** * 函数命名空间 */ FunctionNamespace: string; /** * 函数名称 */ FunctionName: string; /** * 函数的版本名称或别名 */ FunctionQualifier: string; /** * 标识 FunctionQualifier 参数的类型,可取值: VERSION(版本)、ALIAS(别名) 注意:此字段可能返回 null,表示取不到有效值。 */ FunctionQualifierType?: string; } /** * RenewLoadBalancers返回参数结构体 */ export interface RenewLoadBalancersResponse { /** * 订单号。 */ DealName?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 反查Lb绑定关系。 */ export interface LBItem { /** * lb的字符串id */ LoadBalancerId?: string; /** * lb的vip */ Vip?: string; /** * 监听器规则 */ Listeners?: Array要查询的负载均衡实例ID列表。数组大小最大支持30。
*/ LoadBalancerIds: Array要查询的监听器ID列表。
*/ ListenerIds?: Array要查询的转发规则ID列表。
*/ LocationIds?: Array模型路由实例ID。
*/ ModelRouterId: string; /** *意图路由ID(ir-xxx格式)。
*/ IntentRouterId: string; } /** * DescribeBlockIPList请求参数结构体 */ export interface DescribeBlockIPListRequest { /** * 负载均衡实例 ID。 */ LoadBalancerId: string; /** * 数据偏移量,默认为 0。 */ Offset?: number; /** * 返回IP的最大个数,默认为 100000。 */ Limit?: number; } /** * 证书ID,以及与该证书ID关联的负载均衡实例列表 */ export interface CertIdRelatedWithLoadBalancers { /** * 证书ID */ CertId?: string; /** * 与证书关联的负载均衡实例列表 */ LoadBalancers?: Array接口名称
*/ ApiName?: string; /** *请求ID
*/ RequestId?: string; /** *异步任务状态
枚举值:
资源ID
*/ ResourceIds?: ArrayBudget刷新周期。
枚举值:
仅在 CreditUsageSet 数组元素中返回。
注意:此字段可能返回 null,表示取不到有效值。 */ BudgetDuration?: string; /** *下次刷新时间。
用户组关联Budget且Budget设置重置周期时返回;未关联Budget或未设置重置周期时为空。
注意:此字段可能返回 null,表示取不到有效值。 */ BudgetResetAt?: string; /** *Credit上限。
用户组关联Budget且Budget设置最大预算时返回;未设置最大预算时为空。
注意:此字段可能返回 null,表示取不到有效值。 */ Limit?: number; /** *用户组已使用的Credit数量。
*/ Used?: number; } /** * 健康检查配置 */ export interface ServiceProviderHealthCheckConfigItemOutput { /** *是否开启健康检查
枚举值:
健康检查间隔。支持以300s为步长配置。
单位:s
默认值:300
*/ HealthCheckInterval?: number; /** *不健康阈值。表示当模型连续多少次不健康时认为该模型不健康。
取值范围:[1, 10]
默认值:1
*/ HealthCheckUnhealthyThreshold?: number; /** *健康检查使用的最大Token数量。部分模型如gpt系列可能仅支持大于等于16。
默认值:1
*/ HealthCheckMaxTokens?: number; /** *健康检查协议
枚举值:
过滤条件
- ModelAliasName:模型别名- Capability:输出模态 */ Filters?: Array每页数量,取值范围:[1, 100],默认值:20。
*/ Limit?: number; /** *分页偏移量,默认值:0。
*/ Offset?: number; /** *排序条件。支持按 InputCoefficient 或 OutputCoefficient 排序,Order 支持 ASC、DESC。不传或传空数组时,默认按 OutputCoefficient 降序排列。最多支持 2 个排序条件,排序字段不可重复。
*/ Sort?: Array待关联的 Guardrail 防护配置列表。
当前最多支持 1 个元素。每个元素必须填写 InstanceId、ServiceId;Type 和 InputCheckDepth 为选填,不传时分别使用默认值 WAF 和 5。本结构不包含 GuardrailId,关联成功后由系统生成。
*/ Guardrails: Array模型路由实例 ID。
*/ ModelRouterId: string; } /** * DescribeBudgetAssociations返回参数结构体 */ export interface DescribeBudgetAssociationsResponse { /** *Budget关联资源列表。
*/ AssociationSet?: Array符合条件的总数。
*/ TotalCount?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 描述一个Target的健康信息 */ export interface TargetHealth { /** * Target的内网IP */ IP?: string; /** * Target绑定的端口 */ Port?: number; /** * 当前健康状态,true:健康,false:不健康(包括尚未开始探测、探测中、状态异常等几种状态)。只有处于健康状态(且权重大于0),负载均衡才会向其转发流量。 */ HealthStatus?: boolean; /** * Target的实例ID,如 ins-12345678 */ TargetId?: string; /** * 当前健康状态的详细信息。如:Alive、Dead、Unknown、Close。Alive状态为健康,Dead状态为异常,Unknown状态包括尚未开始探测、探测中、状态未知,Close表示健康检查关闭或监听器状态停止。 */ HealthStatusDetail?: string; /** * (**该参数对象即将下线,不推荐使用,请使用HealthStatusDetail获取健康详情**) 当前健康状态的详细信息。如:Alive、Dead、Unknown。Alive状态为健康,Dead状态为异常,Unknown状态包括尚未开始探测、探测中、状态未知。 * @deprecated */ HealthStatusDetial?: string; /** * 目标组唯一ID。 */ TargetGroupId?: string; /** * Target的权重。 */ Weight?: number; } /** * CreateKey返回参数结构体 */ export interface CreateKeyResponse { /** *Key的ID
*/ KeyId?: string; /** *返回的真实Key
*/ Key?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * TestServiceProviderConnection请求参数结构体 */ export interface TestServiceProviderConnectionRequest { /** *需要探测的模型列表
入参限制:上限为20个模型
*/ Models?: Array需要探测的Key
*/ ProviderKey?: string; /** *需要探测的KeyId,和ProviderKey二者传一个即可
*/ ProviderKeyId?: string; /** *BYOK类型,当ProviderKey存在时必传
*/ AccessType?: string; /** *模型的厂商
*/ ModelProvider?: string; /** *模型厂商协议,当ProviderKey存在时必传
*/ ModelProtocol?: string; /** *BYOK类型,当AccessType为PublicCustom时生效
*/ ApiBase?: string; /** *请求携带的Host头部,当AccessType为PrivateCustom时生效
*/ HostHeader?: string; /** *BYOK的ID,当AccessType为PrivateCustom时生效
*/ ServiceProviderId?: string; /** *是否校验服务提供商的SSL证书
默认值:AccessType取值为:
健康检查协议
枚举值:
CMR 私网管道ID
*/ CMRPrivateNetworkTunnelId?: string; /** *对应模型的能力
枚举值:
端点路径
*/ EndpointPath?: string; /** *健康检查方式
枚举值:
健康检查路径。仅HealthCheckMethod为Service时生效。
*/ HealthCheckPath?: string; } /** * DescribeModelAssociations返回参数结构体 */ export interface DescribeModelAssociationsResponse { /** *模型路由实例与模型的关联关系集合
*/ ModelAssociationSet?: Array模型路由实例ID
*/ ModelRouterId?: string; /** *符合条件的总数
*/ TotalCount?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeModelRouterGuardrails返回参数结构体 */ export interface DescribeModelRouterGuardrailsResponse { /** *当前已关联的 Guardrail 防护配置列表。
当前最多返回 1 个元素。
*/ Guardrails?: Array是否禁用Key
*/ Blocked?: boolean; /** *Key关联的Budget ID。
未关联Budget时返回空字符串。
注意:此字段可能返回 null,表示取不到有效值。 */ BudgetId?: string; /** *Key关联的Budget名称。
未关联Budget时返回空字符串。
注意:此字段可能返回 null,表示取不到有效值。 */ BudgetName?: string; /** *创建时间
*/ CreatedTime?: string; /** *Key按Budget刷新周期划分的Credit使用情况。
当关联Budget配置多个刷新周期时,按1d、7d、30d顺序返回各周期用量;未关联Budget时返回空数组。
*/ CreditUsageSet?: ArrayKey的值
*/ Key?: string; /** *Key的ID
*/ KeyId?: string; /** *Key名称
*/ KeyName?: string; /** *修改时间
*/ ModifiedTime?: string; /** *限速信息
*/ RateLimitConfig?: RateLimitConfigForKey; /** *Key状态
枚举值:
标签
*/ Tags?: Array所属的用户组ID
*/ UserGroupId?: string; /** *所属的用户组名称
*/ UserGroupName?: string; } /** * ModifyDomainAttributes返回参数结构体 */ export interface ModifyDomainAttributesResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyTargetPort返回参数结构体 */ export interface ModifyTargetPortResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * BYOK健康检查请求 */ export interface TestConnectionRequestInfo { /** *请求URL
*/ RequestUrl?: string; /** *请求体
*/ RequestBody?: string; /** *请求头
*/ RequestHeaders?: string; } /** * DescribeClassicalLBByInstanceId请求参数结构体 */ export interface DescribeClassicalLBByInstanceIdRequest { /** * 后端实例ID列表。 */ InstanceIds: ArrayBudget ID。
*/ BudgetId: string; /** *预算配置数组。
数组长度最大为3,最多可同时配置1d、7d、30d三个刷新周期,且每种刷新周期只能出现一次。BudgetResetAt不支持作为入参设置,系统会按配置的刷新周期自动维护刷新时间。
*/ BudgetConfigs?: ArrayBudget名称。
*/ BudgetName?: string; /** *Budget限速配置。
*/ RateLimitConfig?: RateLimitConfigForBudget; } /** * InquiryPriceRefundLoadBalancer返回参数结构体 */ export interface InquiryPriceRefundLoadBalancerResponse { /** * 该参数表示对应的价格。 */ Price?: Price; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeClusterResources请求参数结构体 */ export interface DescribeClusterResourcesRequest { /** * 返回集群中资源列表数目,默认为20,最大值为100。 */ Limit?: number; /** * 返回集群中资源列表起始偏移量,默认为0。 */ Offset?: number; /** * 查询集群中资源列表条件,详细的过滤条件如下:Provider 列表
*/ Providers?: ArrayProvider 总数
*/ TotalCount?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 监听器绑定的后端服务的详细信息 */ export interface Backend { /** * 后端服务的类型,可取:CVM、ENI、CCN、EVM、GLOBALROUTE、NAT、SRV等 */ Type?: string; /** * 后端服务的唯一 ID,如 ins-abcd1234 */ InstanceId?: string; /** * 后端服务的监听端口,如果是全端口段监听器绑定的全监听目标组场景,此端口返回0,表示无效端口,绑定的后端服务的端口随监听器端口。 */ Port?: number; /** * 后端服务的转发权重,取值范围:[0, 100],默认为 10。 */ Weight?: number; /** * 后端服务的外网 IP 注意:此字段可能返回 null,表示取不到有效值。 */ PublicIpAddresses?: Array服务提供商ID
*/ ServiceProviderId: string; /** *Key 业务 ID 列表,至少 1 个,最多 10 个
*/ KeyIds: ArrayGuardrail 防护配置 ID。
可通过 DescribeModelRouterGuardrails 获取;DisassociateModelRouterGuardrails 使用该字段定位要解除关联的防护配置。
*/ GuardrailId: string; } /** * DescribeModelRouterDetail返回参数结构体 */ export interface DescribeModelRouterDetailResponse { /** *模型路由实例详情
*/ ModelRouter?: ModelRouterDetail; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * MigrateClassicalLoadBalancers返回参数结构体 */ export interface MigrateClassicalLoadBalancersResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyUserGroupAttributes返回参数结构体 */ export interface ModifyUserGroupAttributesResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DeleteBudgets返回参数结构体 */ export interface DeleteBudgetsResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * RemoveModelRewrite返回参数结构体 */ export interface RemoveModelRewriteResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyServiceProviderModelAttributes请求参数结构体 */ export interface ModifyServiceProviderModelAttributesRequest { /** *BYOK 实例 ID
*/ ServiceProviderId: string; /** *待修改的模型的名称(原始模型名称)
*/ ModelName: string; /** *该模型支持的输入多模态能力列表
枚举值:
模型路由实例ID。
*/ ModelRouterId: string; /** *待删除的用户组ID列表,单次1-100个。不可包含「未分组」虚拟分组 ugrp-ungrouped。组内仍有 Key 时将拒绝删除,需先将 Key 移出或迁移到其他组。
*/ UserGroupIds: Array模型路由实例ID。
当Type为ModelRouter时表示要关联的实例;当Type为Key时表示Key所属实例。
*/ ModelRouterId: string; /** *资源类型。
枚举值:
Key ID。
字段本身选填;当Type为Key时必填,当Type为ModelRouter时不传。
*/ KeyId?: string; /** *用户组ID
*/ UserGroupId?: string; } /** * DescribeBudgets返回参数结构体 */ export interface DescribeBudgetsResponse { /** *Budget列表。
*/ BudgetSet?: Array符合条件的总数。
*/ TotalCount?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * InquiryPriceRefundLoadBalancer请求参数结构体 */ export interface InquiryPriceRefundLoadBalancerRequest { /** * 负载均衡实例ID。可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/1108/48459) 接口查询。 */ LoadBalancerId: string; } /** * Budget关联资源信息 */ export interface BudgetAssociation { /** *Budget ID。
*/ BudgetId?: string; /** *关联创建时间。
*/ CreatedTime?: string; /** *Key ID。仅当Type为Key时返回。
注意:此字段可能返回 null,表示取不到有效值。 */ KeyId?: string; /** *模型路由实例ID。
当Type为ModelRouter时表示关联资源本身;当Type为Key时表示Key所属实例。
*/ ModelRouterId?: string; /** *资源对象的名称。
*/ ResourceName?: string; /** *关联关系的状态
枚举值:
关联资源类型。
枚举值:
关联的用户组id
*/ UserGroupId?: string; } /** * DescribeBudgetAssociations请求参数结构体 */ export interface DescribeBudgetAssociationsRequest { /** *Budget ID。
一次只允许查询一个Budget。
*/ BudgetId: string; /** *本次查询限制的数量
*/ Limit?: number; /** *本次查询偏移量
*/ Offset?: number; /** *资源类型。
枚举值:
不传时返回全部资源类型。
*/ Type?: string; } /** * ModifyIntentRouterAttribute请求参数结构体 */ export interface ModifyIntentRouterAttributeRequest { /** *意图路由ID(ir-xxx格式)。
*/ IntentRouterId: string; /** *模型路由实例ID。
*/ ModelRouterId: string; /** *新的路由名称。
选填;必须以"IntentRouter/"为前缀,后缀仅支持字母、数字、连字符和下划线,后缀长度1-128个字符。不传则不修改。
*/ RouteName?: string; /** *意图路由描述。
*/ RouterDescribe?: string; /** *新的分层配置列表(全量替换)。
选填;不传则不修改。传入时必须为完整分层集合:复杂度分层须包含全部 4 个分层 SIMPLE/MEDIUM/COMPLEX/REASONING;语义分层须包含 default 及各语义 Tier(取决于实例所用协议,且不可跨协议变更)。每个分层至少包含一个模型,模型名称必须是已关联到该实例的模型。
*/ Tiers?: Array模型内路由策略
注意:此字段可能返回 null,表示取不到有效值。 */ RoutingStrategy?: string; /** *路由参数
注意:此字段可能返回 null,表示取不到有效值。 */ RoutingStrategyArgs?: RoutingStrategyArgs; /** *同一模型请求重试次数
注意:此字段可能返回 null,表示取不到有效值。 */ NumRetries?: number; } /** * CreateClsLogSet请求参数结构体 */ export interface CreateClsLogSetRequest { /** * 日志集的名字,不能和cls其他日志集重名。不填默认为clb_logset。 */ LogsetName?: string; /** * 日志集的保存周期,单位:天。 * @deprecated */ Period?: number; /** * 日志集类型,ACCESS:访问日志,HEALTH:健康检查日志,默认ACCESS。 */ LogsetType?: string; } /** * 每个待探测模态的详细结果。 */ export interface ModalityProbeDetail { /** *探测的模态
*/ Modality?: string; /** *探测结果
枚举值:
探测该模态请求的报错详情
*/ ErrorInfo?: ProviderTestConnectionErrorInfo; } /** * ModifyDomain返回参数结构体 */ export interface ModifyDomainResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * Provider 信息 */ export interface ProviderItem { /** *Provider 标识(如 openai)
*/ Provider: string; /** *显示名称(如 OpenAI)
*/ DisplayName: string; /** *模型协议列表
*/ Protocols?: Array英文显示名称
*/ EnglishDisplayName?: string; } /** * ModifyKeysUserGroup请求参数结构体 */ export interface ModifyKeysUserGroupRequest { /** *模型路由实例ID。
*/ ModelRouterId: string; /** *目标归属用户组ID。传真实用户组ID表示批量入组或跨组移动(Key 已属其它组则改为目标组);传 ugrp-ungrouped 表示批量移出到未分组。
*/ UserGroupId: string; /** *待变更归属的 Key ID 列表,单次1-100个。
*/ KeyIds: Array接入类型:PublicBYOK/PublicCustom/PrivateCustom
*/ AccessType: string; /** *模型提供商
*/ ModelProvider?: string; /** *通用模型标识列表
*/ ModelIds?: ArrayKey 列表
*/ Keys?: ArrayBYOK ID(在自定义模型时在部署网络后必须填写)
*/ ServiceProviderId?: string; /** *服务供应商(创建BYOK自定义名称)。
*/ ServiceProviderName?: string; /** *模型协议
*/ Protocol?: string; /** *API Base URL
*/ ApiBase?: string; /** *多协议 Api Base URL
*/ ApiBases?: ArrayVPC ID
*/ VpcId?: string; /** *子网 ID
*/ SubnetId?: string; /** *转发请求时添加的Host请求头
*/ HostHeader?: string; /** *标签信息
*/ Tags?: Array是否校验服务提供商的SSL证书
*/ VerifySSL?: boolean; /** *健康检查配置
*/ HealthCheckConfig?: ServiceProviderHealthCheckConfigInput; /** *私网管道 ID
*/ CMRPrivateNetworkTunnelId?: string; /** *健康检查配置
*/ HealthCheckConfigs?: Array模型输出模态
*/ Capability?: string; /** *请求后缀
*/ EndpointPath?: string; } /** * 集群的详细信息,如集群ID,名称,类型,可用区,标签等 */ export interface Cluster { /** * 集群唯一ID */ ClusterId?: string; /** * 集群名称 */ ClusterName?: string; /** * 集群类型,如TGW,STGW,VPCGW */ ClusterType?: string; /** * 集群标签,只有TGW/STGW集群有标签 注意:此字段可能返回 null,表示取不到有效值。 */ ClusterTag?: string; /** * 集群所在可用区,如ap-guangzhou-1 */ Zone?: string; /** * 集群网络类型,如Public,Private */ Network?: string; /** * 最大连接数(个/秒) 注意:此字段可能返回 null,表示取不到有效值。 */ MaxConn?: number; /** * 最大入带宽Mbps 注意:此字段可能返回 null,表示取不到有效值。 */ MaxInFlow?: number; /** * 最大入包量(个/秒) 注意:此字段可能返回 null,表示取不到有效值。 */ MaxInPkg?: number; /** * 最大出带宽Mbps 注意:此字段可能返回 null,表示取不到有效值。 */ MaxOutFlow?: number; /** * 最大出包量(个/秒) 注意:此字段可能返回 null,表示取不到有效值。 */ MaxOutPkg?: number; /** * 最大新建连接数(个/秒) 注意:此字段可能返回 null,表示取不到有效值。 */ MaxNewConn?: number; /** * http最大新建连接数(个/秒) 注意:此字段可能返回 null,表示取不到有效值。 */ HTTPMaxNewConn?: number; /** * https最大新建连接数(个/秒) 注意:此字段可能返回 null,表示取不到有效值。 */ HTTPSMaxNewConn?: number; /** * http QPS 注意:此字段可能返回 null,表示取不到有效值。 */ HTTPQps?: number; /** * https QPS 注意:此字段可能返回 null,表示取不到有效值。 */ HTTPSQps?: number; /** * 集群内资源总数目 */ ResourceCount?: number; /** * 集群内空闲资源数目 注意:此字段可能返回 null,表示取不到有效值。 */ IdleResourceCount?: number; /** * 集群内转发机的数目 注意:此字段可能返回 null,表示取不到有效值。 */ LoadBalanceDirectorCount?: number; /** * 集群的Isp属性,如:"BGP","CMCC","CUCC","CTCC","INTERNAL"。 注意:此字段可能返回 null,表示取不到有效值。 */ Isp?: string; /** * 集群所在的可用区 注意:此字段可能返回 null,表示取不到有效值。 */ ClustersZone?: ClustersZone; /** * 集群版本 注意:此字段可能返回 null,表示取不到有效值。 */ ClustersVersion?: string; /** * 集群容灾类型,如SINGLE-ZONE,DISASTER-RECOVERY,MUTUAL-DISASTER-RECOVERY */ DisasterRecoveryType?: string; /** * 网络出口 */ Egress?: string; /** * IP版本 */ IPVersion?: string; /** * 标签信息 */ Tag?: Array待解除关联的 Guardrail 防护配置列表。
每个元素只需要填写 GuardrailId。
*/ Guardrails: Array模型路由实例 ID。
*/ ModelRouterId: string; } /** * DescribeTargetGroupInstanceStatus请求参数结构体 */ export interface DescribeTargetGroupInstanceStatusRequest { /** * 目标组唯一id */ TargetGroupId: string; /** * 目标组绑定的后端服务ip列表 */ TargetGroupInstanceIps?: Array模型路由实例 ID。
*/ ModelRouterId: string; /** *选填,按源模型名精确过滤(大小写敏感)。
长度 1-255 字符;不传则返回该实例的全部重写规则;命中至多 1 条;未命中返回空列表(不报错)。
*/ SourceModel?: string; } /** * CloneLoadBalancer返回参数结构体 */ export interface CloneLoadBalancerResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DeregisterTargets请求参数结构体 */ export interface DeregisterTargetsRequest { /** * 负载均衡实例 ID,格式如 lb-12345678。 */ LoadBalancerId: string; /** * 监听器 ID,格式如 lbl-12345678。 */ ListenerId: string; /** * 要解绑的后端服务列表,数组长度最大支持20。 */ Targets: Array该模型所有健康BYOK实例下支持的输入多模态能力的并集。模型不健康时返回空列表。
枚举值:
模型
*/ Model?: string; /** *可用性状态
枚举值:
预算刷新周期。
枚举值:
不传时默认30d。同一个Budget下每种刷新周期最多配置一次。
注意:此字段可能返回 null,表示取不到有效值。 */ BudgetDuration?: string; /** *下一次刷新的时间
*/ BudgetResetAt?: string; /** *最大预算。
单位:credit。取值需大于0且不超过10000000000;不传时默认100000。
注意:此字段可能返回 null,表示取不到有效值。 */ MaxBudget?: number; } /** * DescribeLBOperateProtect返回参数结构体 */ export interface DescribeLBOperateProtectResponse { /** * 返回的负载均衡操作保护信息数组。 */ LoadBalancerSet: Array模型路由实例ID
*/ ModelRouterId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 模型路由资源包 */ export interface ModelRouterPackage { /** *模型路由资源包总容量
*/ CapacitySize?: string; /** *模型路由资源包总余量
*/ CapacityRemain?: string; /** *模型路由资源包容量精确值
*/ CapacitySizePrecise?: string; /** *模型路由资源包总余量精确值
*/ CapacityRemainPrecise?: string; /** *模型路由资源包设置用尽续购标志位 0:未设置 1:用尽到期新购
取值范围:[0, 1]
*/ AutoPurchaseFlag?: number; /** *模型路由资源包Id
*/ ModelRouterResourcePackageId?: string; /** *模型路由资源包创建时间
*/ CreateTime?: string; /** *模型路由资源包抵扣开始时间
*/ DeductionStartTime?: string; /** *模型路由资源包抵扣截止时间
*/ DeductionEndTime?: string; /** *模型路由资源包失效时间
*/ ExpiredTime?: string; /** *模型路由资源包状态
枚举值:
Budget ID列表。
*/ BudgetIds?: Array过滤列表。
支持:BudgetId、BudgetName、Status。
*/ Filters?: Array本次查询限制的数量。
取值范围:[1, 100]
默认值:20。
*/ Limit?: number; /** *本次查询偏移量。
默认值:0。
*/ Offset?: number; } /** * ModifyLoadBalancerSla请求参数结构体 */ export interface ModifyLoadBalancerSlaRequest { /** * 负载均衡实例信息。 */ LoadBalancerSla: Array由负载均衡实例唯一 ID 组成的数组。
存在某些场景,如创建出现延迟时,此字段可能返回为空;此时可以根据接口返回的RequestId或DealName参数,通过DescribeTaskStatus接口查询创建的资源ID。
订单号。
注意:此字段可能返回 null,表示取不到有效值。 */ DealName?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyFunctionTargets请求参数结构体 */ export interface ModifyFunctionTargetsRequest { /** * 负载均衡实例ID。 */ LoadBalancerId: string; /** * 负载均衡监听器ID。 */ ListenerId: string; /** * 要修改的后端云函数服务列表,仅支持 Event 函数类型。 */ FunctionTargets: Array上游模型侧返回的HTTP状态码
*/ HttpCode?: number; /** *错误状态码
*/ ErrorStatus?: string; /** *探测请求错误信息
*/ OriginalMessage?: string; } /** * 可用区转发亲和信息 */ export interface AvailableZoneAffinityInfo { /** * 是否开启可用区转发亲和。true:开启可用区转发亲和;false:开启可用区转发亲和。 */ Enable?: boolean; /** * 可用区转发亲和失效阈值,当可用区内后端服务健康比例小于该阈值时,负载均衡会退出可用区转发亲和,转为全可用区转发。 注意:此字段可能返回 null,表示取不到有效值。 */ ExitRatio?: number; /** * 可用区转发亲和的重新生效阈值,当处于全可用区转发,且负载均衡可用区内的后端服务健康比例大于等于该阈值时,负载均衡会重新进入可用区转发亲和。 注意:此字段可能返回 null,表示取不到有效值。 */ ReentryRatio?: number; } /** * DeleteLoadBalancerSnatIps请求参数结构体 */ export interface DeleteLoadBalancerSnatIpsRequest { /** * 负载均衡唯一ID,可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/1108/48459) 接口查询。例如:lb-12345678。 */ LoadBalancerId: string; /** * 删除SnatIp地址数组,最大支持删除数量为20个。 */ Ips: Array每分钟限制的请求数量。
单位:次/分钟。
*/ RPM?: number; /** *每分钟限制的Token数量。
单位:个/分钟。
*/ TPM?: number; } /** * InquirePriceCreateModelRouterResourcePackage请求参数结构体 */ export interface InquirePriceCreateModelRouterResourcePackageRequest { /** *模型路由资源包容量
取值范围:[1000, 10000000]
单次购买的模型路由资源包容量下限为1000,上限为10000000
*/ ModelRouterResourcePackageAmount: number; } /** * 模型路由待关联 Guardrail 防护配置 */ export interface AssociateGuardrailConfig { /** *Guardrail 防护类型。
枚举值:
当前仅支持 WAF;不传时默认为 WAF。
*/ Type?: string; /** *关联的腾讯云 WAF 实例 ID。
当 Type 为 WAF 时必填。接口会校验该 WAF 实例存在且属于当前账号。
*/ InstanceId?: string; /** *WAF LLM SDK 接入服务 ID。
该字段对应 WAF LLM SDK 接入配置中的服务标识,用于指定模型路由请求要绑定的 WAF 防护配置。当 Type 为 WAF 时必填。接口会校验该服务配置存在于指定的 WAF 实例下。
*/ ServiceId?: string; /** *最大检测对话轮数。
当 Type 为 WAF 时选填;未传时默认取值为 5。若传入,取值必须为正整数。
*/ InputCheckDepth?: number; } /** * DeleteLoadBalancerSnatIps返回参数结构体 */ export interface DeleteLoadBalancerSnatIpsResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * InquiryPriceCreateLoadBalancer返回参数结构体 */ export interface InquiryPriceCreateLoadBalancerResponse { /** * 该参数表示对应的价格。 */ Price?: Price; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 规则与目标组的关联关系 */ export interface TargetGroupAssociation { /** * 负载均衡ID */ LoadBalancerId: string; /** * 目标组ID */ TargetGroupId: string; /** * 监听器ID。访问AssociateTargetGroups和DisassociateTargetGroups接口时必传此参数。 */ ListenerId?: string; /** * 转发规则ID */ LocationId?: string; /** * 目标组权重,范围[0, 100]。仅绑定v2目标组时生效,如果不存在,则默认为10。 */ Weight?: number; } /** * 监听器的健康检查信息 */ export interface ListenerHealth { /** * 监听器ID */ ListenerId?: string; /** * 监听器名称 */ ListenerName?: string; /** * 监听器的协议 */ Protocol?: string; /** * 监听器的端口 */ Port?: number; /** * 监听器的转发规则列表 */ Rules?: Array最低繁忙路由算法相对近优容差。
取值范围:[0, 100]
默认值:0
仅最低繁忙路由算法生效。0 表示请求仅会路由到在途数最小的上游大模型部署,0.10 表示请求路由到的上游大模型部署在途请求数最多比最小在途数高10%,依次类推。
*/ LeastBusyBuffer?: number; /** *用量均衡路由算法相对近优容差
取值范围:[0, 100]
默认值:0
仅用量均衡路由算法生效。0 表示请求仅会路由到TPM最低的上游大模型部署;0.10 表示请求最多会路由到比TPM最小值高10%的上游大模型部署,依次类推。
*/ UsageBasedBuffer?: number; /** *最低延迟路由算法相对近优容差
取值范围:[0, 100]
默认值:0
仅最低延迟路由算法生效。0 表示请求仅会路由到延迟最低的上游大模型部署;0.10 表示请求最多会路由到比延迟最小值高10%的上游大模型部署,依次类推。
*/ LowestLatencyBuffer?: number; /** *最低积分系数路由算法相对近优容差
取值范围:[0, 100]
默认值:0
仅最低积分系数路由算法生效。0 表示请求仅会路由到积分系数最低的上游大模型部署;0.10 表示请求最多会路由到比积分系数最小值高10%的上游大模型部署,依次类推。
*/ LowestCostBuffer?: number; } /** * DeleteRewrite请求参数结构体 */ export interface DeleteRewriteRequest { /** * 负载均衡实例ID。 */ LoadBalancerId: string; /** * 源监听器ID。 */ SourceListenerId: string; /** * 目标监听器ID。 */ TargetListenerId: string; /** * 转发规则之间的重定向关系。 */ RewriteInfos: Array目标组ID数组。
*/ TargetGroupIds?: Array过滤条件数组,支持TargetGroupVpcId和TargetGroupName。与TargetGroupIds互斥,优先使用目标组ID。
*/ Filters?: Array显示的偏移起始量。
*/ Offset?: number; /** *每页显示条目数。
取值范围:[0, 100]
默认值:20
*/ Limit?: number; } /** * SetSecurityGroupForLoadbalancers请求参数结构体 */ export interface SetSecurityGroupForLoadbalancersRequest { /** * 安全组ID,如 sg-12345678。可以通过 [DescribeSecurityGroups](https://cloud.tencent.com/document/product/215/15808) 接口获取。 */ SecurityGroup: string; /** * ADD 绑定安全组; DEL 解绑安全组 */ OperationType: string; /** * 负载均衡实例ID数组,可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/1108/48459) 接口查询。 列表支持的最大长度为20。 */ LoadBalancerIds: Array模型路由实例ID
*/ ModelRouterId: string; /** *Key名称
*/ KeyName?: string; /** *限速配置
*/ RateLimitConfig?: RateLimitConfigForKey; /** *关联的积分预算ID
*/ BudgetId?: string; /** *需要关联的用户组ID
*/ UserGroupId?: string; /** *标签
*/ Tags?: Array模型路由资源包价格
*/ ModelRouterResourcePackagePrice?: ItemPrice; /** *本次购买资源包是否可享受首购优惠
1:可享受首购优惠,0:不可享受首购优惠
*/ FirstBuy?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CLB监听器或规则绑定的多证书信息 */ export interface MultiCertInfo { /** * 认证类型,UNIDIRECTIONAL:单向认证,MUTUAL:双向认证 */ SSLMode: string; /** * 监听器或规则证书列表,单双向认证,多本服务端证书算法类型不能重复;若SSLMode为双向认证,证书列表必须包含一本ca证书。 */ CertList: Array路由策略
枚举值:
模型间路由策略。
枚举值:
L2模型组内路由调度算法参数
*/ RoutingStrategyArgs?: RoutingStrategyArgs; /** *CMR实例级别请求组内重试次数
取值范围:[0, 5]
默认值:2
*/ NumRetries?: number; /** *粘连路由配置参数
*/ StickyConfig?: StickyConfig; } /** * 目标组实例 */ export interface TargetGroupInstance { /** * 目标组实例的内网IP */ BindIP: string; /** * 目标组实例的端口,全监听目标组不支持传此字段。 */ Port?: number; /** * 目标组实例的权重 v2目标组需要配置权重,调用CreateTargetGroup接口创建目标组时该参数与创建接口中的Weight参数必填其一。 取值范围:0-100 */ Weight?: number; /** * 目标组实例的新端口,全监听目标组不支持传此字段。 */ NewPort?: number; } /** * CreateRule返回参数结构体 */ export interface CreateRuleResponse { /** * 创建的转发规则的唯一标识数组。 */ LocationIds?: Array聊天的返回信息
*/ ChatResponseMessage?: string; /** *聊天请求发送过程中的失败信息
*/ ErrorInChat?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeClassicalLBTargets请求参数结构体 */ export interface DescribeClassicalLBTargetsRequest { /** * 负载均衡实例 ID。 */ LoadBalancerId: string; } /** * 模型路由列表 */ export interface ModelRouterSet { /** *模型路由实例关联的Budget ID。
未关联Budget时返回空字符串。
注意:此字段可能返回 null,表示取不到有效值。 */ BudgetId?: string; /** *模型路由实例关联的Budget名称。
未关联Budget时返回空字符串。
注意:此字段可能返回 null,表示取不到有效值。 */ BudgetName?: string; /** *集群信息
*/ ClusterInfo?: ClusterInfo; /** *创建时间
*/ CreatedTime?: string; /** *模型路由实例按Budget刷新周期划分的Credit使用情况。
当关联Budget配置多个刷新周期时,按1d、7d、30d顺序返回各周期用量;未关联Budget时返回空数组。
*/ CreditUsageSet?: Array模型路由实例域名
*/ Domain?: string; /** *模型路由ID
*/ ModelRouterId?: string; /** *模型路由名称
默认值:-
*/ ModelRouterName?: string; /** *模型路由类型
枚举值:
修改时间
*/ ModifiedTime?: string; /** *模型路由实例网络类型
枚举值:
模型路由实例的安全状态
枚举值:
模型路由实例状态
枚举值:
标签
*/ Tags?: Array模型路由实例的计费状态
枚举值:
模型路由实例VIP
*/ Vip?: string; /** *模型路由实例所属VPC的ID
*/ VpcId?: string; /** *带宽
单位:Mbps
注意:此字段可能返回 null,表示取不到有效值。 */ Bandwidth?: number; /** *弹性公网IP的ID
*/ EipAddressId?: string; /** *计费信息
*/ BillingConfig?: ModelRouterBillingConfigOutput; } /** * InquiryPriceRenewLoadBalancer返回参数结构体 */ export interface InquiryPriceRenewLoadBalancerResponse { /** * 表示续费价格 */ Price?: Price; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCustomizedConfigList请求参数结构体 */ export interface DescribeCustomizedConfigListRequest { /** * 配置类型:CLB 负载均衡维度。 SERVER 域名维度。 LOCATION 规则维度。 */ ConfigType: string; /** * 拉取页偏移,默认值0。 */ Offset?: number; /** * 拉取数目,默认值20。 */ Limit?: number; /** * 拉取指定配置名字,模糊匹配。 */ ConfigName?: string; /** * 配置ID,可以通过 [DescribeCustomizedConfigList](https://cloud.tencent.com/document/api/214/60009) 接口查询。 */ UconfigIds?: Array配额信息
*/ Quotas?: Array重写规则列表,按 SourceModel 字典序排序。无规则或过滤未命中时为空数组。
*/ Rewrites?: Array负载均衡监听器 ID
*/ ListenerId?: string; /** *监听器协议,可选值:TCP、UDP、HTTP、HTTPS、TCP_SSL、QUIC
*/ Protocol?: string; /** *监听器端口,端口范围:1-65535
*/ Port?: number; /** *监听器绑定的证书信息
注意:此字段可能返回 null,表示取不到有效值。 */ Certificate?: CertificateOutput; /** *监听器的健康检查信息
注意:此字段可能返回 null,表示取不到有效值。 */ HealthCheck?: HealthCheck; /** *请求的调度方式。 WRR、LEAST_CONN、IP_HASH分别表示按权重轮询、最小连接数、IP Hash。
注意:此字段可能返回 null,表示取不到有效值。 */ Scheduler?: string; /** *会话保持时间,单位:秒。可选值:30~3600,默认 0,默认不开启。此参数仅适用于TCP/UDP监听器。
单位:秒
注意:此字段可能返回 null,表示取不到有效值。 */ SessionExpireTime?: number; /** *是否开启SNI特性,1:表示开启,0:表示不开启(本参数仅对于HTTPS监听器有意义)
*/ SniSwitch?: number; /** *监听器下的全部转发规则(本参数仅对于HTTP/HTTPS监听器有意义)
注意:此字段可能返回 null,表示取不到有效值。 */ Rules?: Array监听器的名称
*/ ListenerName?: string; /** *监听器的创建时间。
*/ CreateTime?: string; /** *端口段结束端口,端口范围:2-65535
*/ EndPort?: number; /** *后端服务器类型,可选值:NODE、POLARIS、TARGETGROUP、TARGETGROUP-V2
注意:此字段可能返回 null,表示取不到有效值。 */ TargetType?: string; /** *绑定的目标组基本信息;当监听器绑定目标组时,会返回该字段
注意:此字段可能返回 null,表示取不到有效值。 */ TargetGroup?: BasicTargetGroupInfo; /** *会话保持类型。NORMAL表示默认会话保持类型。QUIC_CID 表示根据Quic Connection ID做会话保持。
*/ SessionType?: string; /** *是否开启长连接,1开启,0关闭,(本参数仅对于HTTP/HTTPS监听器有意义)
注意:此字段可能返回 null,表示取不到有效值。 */ KeepaliveEnable?: number; /** *仅支持Nat64 CLB TCP监听器
*/ Toa?: boolean; /** *重新调度功能,解绑后端服务开关,打开此开关,当解绑后端服务时触发重新调度。仅TCP/UDP监听器支持。
*/ DeregisterTargetRst?: boolean; /** *监听器的属性
*/ AttrFlags?: Array绑定的目标组列表
注意:此字段可能返回 null,表示取不到有效值。 */ TargetGroupList?: Array监听器最大连接数,-1表示监听器维度不限速。
*/ MaxConn?: number; /** *监听器最大新增连接数,-1表示监听器维度不限速。
*/ MaxCps?: number; /** *空闲连接超时时间,仅支持TCP监听器。默认值:900;共享型实例和独占型实例取值范围:300~900,性能容量型实例取值范围:300~1980。
注意:此字段可能返回 null,表示取不到有效值。 */ IdleConnectTimeout?: number; /** *重新调度触发持续时间,取值0~3600s。仅TCP/UDP监听器支持。触发重新调度后,长连接将会在设置的调度时间内断开并完成重新分配。
单位:秒
*/ RescheduleInterval?: number; /** *数据压缩模式
*/ DataCompressMode?: string; /** *重新调度启动时间,配置了重新调度启动时间后,会在启动时间到达时触发重新调度。
*/ RescheduleStartTime?: number; } /** * 配置内容 */ export interface ConfigListItem { /** * 配置ID */ UconfigId?: string; /** * 配置类型, 可选值:CLB(实例维度配置), SERVER(服务维度配置),LOCATION(规则维度配置) */ ConfigType?: string; /** * 配置名字 */ ConfigName?: string; /** * 配置内容 */ ConfigContent?: string; /** * 配置的创建时间。 格式:YYYY-MM-DD HH:mm:ss */ CreateTimestamp?: string; /** * 配置的修改时间。 格式:YYYY-MM-DD HH:mm:ss */ UpdateTimestamp?: string; } /** * 健康检查配置 */ export interface ServiceProviderHealthCheckConfigOutput { /** *是否开启健康检查
枚举值:
Budget ID。
*/ BudgetId: string; /** *要解除关联的资源列表。
*/ Resources: ArrayBudget ID。
创建请求提交后返回,可通过DescribeBudgets查询状态。
*/ BudgetId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DeregisterModelsFromServiceProvider请求参数结构体 */ export interface DeregisterModelsFromServiceProviderRequest { /** *BYOK的ID
*/ ServiceProviderId: string; /** *模型别名列表
*/ ModelAliases?: Array证书ID
*/ CertId?: string; /** *监听端口
*/ Port?: number; /** *网络协议
*/ Schema?: string; } /** * DeregisterFunctionTargets请求参数结构体 */ export interface DeregisterFunctionTargetsRequest { /** * 负载均衡实例 ID。 */ LoadBalancerId: string; /** * 负载均衡监听器 ID。 */ ListenerId: string; /** * 待解绑的云函数列表。 */ FunctionTargets: Array重新生成的明文Key
*/ Key?: string; /** *Key的ID
*/ KeyId?: string; } /** * BYOK信息 */ export interface ServiceProvider { /** *BYOK类型
*/ AccessType?: string; /** *单个byok实例下该模型可支持的输入多模态能力列表。
枚举值:
模型协议
*/ Protocol?: string; /** *BYOK的所属厂商
*/ Provider?: string; /** *BYOK实例ID
*/ ServiceProviderId?: string; /** *BYOK名称
*/ ServiceProviderName?: string; /** *绑定的指定模型组内BYOK实例的调度优先级
取值范围[0,2],优先级随数值增大而降低。
*/ Order?: number; /** *绑定的指定模型组Order相同层级内BYOK实例的调度权重
*/ Weight?: number; /** *CMR实例-BYOK实例的模型调度绑定关系状态
枚举值:
实际抵扣量
*/ ActualDosage?: string; /** *抵扣后包剩余量
*/ AfterDeductionRemain?: string; /** *抵扣前包剩余量
*/ BeforeDeductionRemain?: string; /** *抵扣时间
*/ DeductionTime?: string; /** *原始用量
*/ Dosage?: string; /** *用量结束时间
*/ EndTime?: string; /** *产生用量的模型路由实例Id
*/ ModelRouterId?: string; /** *模型路由资源包Id
*/ ModelRouterResourcePackageId?: string; /** *用量开始时间
*/ StartTime?: string; } /** * 传统型负载均衡后端服务的健康状态 */ export interface ClassicalHealth { /** * 后端服务的内网 IP */ IP?: string; /** * 后端服务的端口 */ Port?: number; /** * 负载均衡的监听端口 */ ListenerPort?: number; /** * 转发协议 */ Protocol?: string; /** * 健康检查结果,1 表示健康,0 表示不健康 */ HealthStatus?: number; } /** * DescribeIntentRouterTiers返回参数结构体 */ export interface DescribeIntentRouterTiersResponse { /** *Tier 字典列表(按 tier_id 升序排列)
*/ TierSet?: ArrayTier 总条数
*/ TotalCount?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * AddModelRewrite返回参数结构体 */ export interface AddModelRewriteResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeClassicalLBHealthStatus请求参数结构体 */ export interface DescribeClassicalLBHealthStatusRequest { /** * 负载均衡实例ID。 */ LoadBalancerId: string; /** * 负载均衡监听器ID。 */ ListenerId?: string; } /** * DisassociateModelsFromModelRouter请求参数结构体 */ export interface DisassociateModelsFromModelRouterRequest { /** *模型路由实例ID
*/ ModelRouterId: string; /** *需要解除关联的模型信息
*/ Models?: Array明文Key
*/ Key?: string; /** *Key的ID
*/ KeyId?: string; /** *Key的名称
*/ KeyName?: string; } /** * ChatCompletions请求参数结构体 */ export interface ChatCompletionsRequest { /** *virtual key,用于向代理网关鉴权
*/ ApiKey?: string; /** *多模态附件列表
*/ Attachments?: Array聊天内容
*/ ChatContent?: string; /** *模型名称,配置的模型标识
示例:gpt-4o、deepseek-chat
*/ Model?: string; /** *模型路由实例ID
*/ ModelRouterId?: string; /** *请求路径
默认值:/v1/chat/completions
*/ RequestPath?: string; } /** * 传统型负载均衡监听器信息 */ export interface ClassicalListener { /** *负载均衡监听器ID
*/ ListenerId?: string; /** *负载均衡监听器端口
*/ ListenerPort?: number; /** *监听器后端转发端口
*/ InstancePort?: number; /** *监听器名称
*/ ListenerName?: string; /** *监听器协议类型
*/ Protocol?: string; /** *会话保持时间
*/ SessionExpire?: number; /** *是否开启了健康检查:1(开启)、0(关闭)
*/ HealthSwitch?: number; /** *响应超时时间
单位:秒
*/ TimeOut?: number; /** *检查间隔
单位:秒
*/ IntervalTime?: number; /** *健康阈值
*/ HealthNum?: number; /** *不健康阈值
*/ UnhealthNum?: number; /** *传统型公网负载均衡 监听器的请求均衡方法。空字符串或wrr 表示按权重轮询,ip_hash 表示根据访问的源 IP 进行一致性哈希方式来分发,least_conn表示按最小连接数。
*/ HttpHash?: string; /** *传统型公网负载均衡的 HTTP、HTTPS 监听器的健康检查返回码。具体可参考创建监听器中对该字段的解释
*/ HttpCode?: number; /** *传统型公网负载均衡的 HTTP、HTTPS 监听器的健康检查路径
*/ HttpCheckPath?: string; /** *传统型公网负载均衡的 HTTPS 监听器的认证方式
*/ SSLMode?: string; /** *传统型公网负载均衡的 HTTPS 监听器的服务端证书 ID
*/ CertId?: string; /** *传统型公网负载均衡的 HTTPS 监听器的客户端证书 ID
*/ CertCaId?: string; /** *监听器的状态,0 表示创建中,1 表示运行中
*/ Status?: number; } /** * CreateBYOKNetwork请求参数结构体 */ export interface CreateBYOKNetworkRequest { /** *子网 ID
参数格式:subnet-xxxxxxxx
*/ SubnetId: string; /** *VPC 实例 ID
参数格式:vpc-xxxxxxxx
*/ VpcId: string; /** *BYOK 的自定义名字
入参限制:1~256个字符,可选
*/ ServiceProviderName?: string; /** *标签
*/ Tags?: Array模型路由实例ID。
*/ ModelRouterId: string; /** *意图路由ID列表
*/ IntentRouterIds?: Array请求ID列表
*/ RequestIds?: Array分页游标
*/ NextToken?: string; /** *本次查询最大数量
取值范围:[1, 100]
默认值:20
*/ MaxResults?: number; } /** * ModifyModelAliasAttributes请求参数结构体 */ export interface ModifyModelAliasAttributesRequest { /** *模型别名
*/ ModelAliasNames: Array基础积分系数配置,选填。不传时保留原配置。各系数字段均为选填,取值范围为 [0, 5000],最多支持 6 位小数,0 表示零价。传入本参数时,至少填写一项有效系数,不能传空对象。
*/ Coefficient?: Coefficient; /** *BYOK 实例(ServiceProvider)ID 列表。
可选,数组。传入时按 ServiceProvider 维度修改:把同一份 Coefficient 批量应用到数组内每一个实例(覆盖配置,仅作用于这些实例),此时 ModelAliasNames 只能传 1 个别名(即 1 别名 × N ServiceProvider);数组需去重、非空、上限 100,任一实例不归属/不存在/该实例下无该别名将整批返回错误。不传时按 ModelAlias(账号)维度修改,作用于该别名下未单独配置覆盖的全部实例。
模型输出模态
枚举值:
积分梯度设置
*/ CoefficientTiers?: Array积分峰谷设置
*/ CoefficientSchedule?: Array模型路由实例列表
*/ ModelRouterSet?: Array符合条件的总数
*/ TotalCount?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyModelRouterGuardrails请求参数结构体 */ export interface ModifyModelRouterGuardrailsRequest { /** *待修改的 Guardrail 防护配置列表。
当前最多支持 1 个元素。每个元素必须填写 GuardrailId;当 Type 为 WAF 或未传按 WAF 处理时,InstanceId 和 ServiceId 必填;InputCheckDepth 为选填,不传时沿用当前已关联 Guardrail 的取值。
*/ Guardrails: Array模型路由实例 ID。
*/ ModelRouterId: string; } /** * 证书信息 */ export interface CertInfo { /** * 证书 ID,如果不填写此项则必须上传证书内容,包括CertName, CertContent,若为服务端证书必须包含CertKey。 */ CertId?: string; /** * 上传证书的名称,如果没有 CertId,则此项必传。 */ CertName?: string; /** * 上传证书的公钥;如果没有 CertId,则此项必传。 */ CertContent?: string; /** * 上传服务端证书的私钥;如果没有 CertId,则此项必传。 */ CertKey?: string; } /** * CreateTargetGroup请求参数结构体 */ export interface CreateTargetGroupRequest { /** *目标组名称。命名规则:1-80 个英文字母、汉字等国际通用语言字符,数字,连接线“-”、下划线“_”等常见字符(禁止Unicode补充字符,如emoji表情、生僻汉字等)。
*/ TargetGroupName?: string; /** *目标组的vpcId属性,不填则使用默认vpc。
*/ VpcId?: string; /** *目标组的默认端口, 后续添加服务器时可使用该默认端口。全监听目标组不支持此参数,非全监听目标组Port和TargetGroupInstances.N中的port二者必填其一。
*/ Port?: number; /** *目标组绑定的后端服务器,单次最多支持50个。
*/ TargetGroupInstances?: Array目标组类型,当前支持v1(旧版目标组), v2(新版目标组), 默认为v1(旧版目标组)。
*/ Type?: string; /** *目标组后端转发协议。v2新版目标组该项必填。目前支持TCP、UDP、HTTP、HTTPS、GRPC。
*/ Protocol?: string; /** *健康检查。
*/ HealthCheck?: TargetGroupHealthCheck; /** *调度算法,仅V2新版目标组,且后端转发协议为(HTTP|HTTPS|GRPC)时该参数有效。可选值:
标签。
*/ Tags?: Array后端服务默认权重, 其中:
全监听目标组标识,true表示是全监听目标组,false表示不是全监听目标组。仅V2新版类型目标组支持该参数。
*/ FullListenSwitch?: boolean; /** *是否开启长连接,此参数仅适用于HTTP/HTTPS目标组,0:关闭;1:开启, 默认关闭。
*/ KeepaliveEnable?: boolean; /** *会话保持时间,单位:秒。可选值:30~3600,默认 0,表示不开启。仅V2新版且后端转发协议为HTTP/HTTPS/GRPC目标组支持该参数。
*/ SessionExpireTime?: number; /** *IP版本类型。
*/ IpVersion?: string; /** *是否开启SNAT(源IP替换),True(开启)、False(关闭)。默认为关闭。注意:SnatEnable开启时会替换客户端源IP,此时透传客户端源IP选项关闭,反之亦然。
负载均衡实例 ID,可以通过 DescribeLoadBalancers 接口获取。
*/ LoadBalancerId: string; /** *要将监听器创建到哪些端口,每个端口对应一个新的监听器。
端口范围:1~65535
监听器协议: TCP | UDP | HTTP | HTTPS | TCP_SSL | QUIC。
*/ Protocol: string; /** *要创建的监听器名称列表,名称与Ports数组按序一一对应,如不需立即命名,则无需提供此参数。命名规则:1-80 个英文字母、汉字等国际通用语言字符,数字,连接线“-”、下划线“_”等常见字符(禁止Unicode补充字符,如emoji表情、生僻汉字等)。
*/ ListenerNames?: Array健康检查相关参数,此参数仅适用于TCP/UDP/TCP_SSL/QUIC监听器。
*/ HealthCheck?: HealthCheck; /** *证书相关信息。参数限制如下:
会话保持时间,单位:秒。可选值:30~3600,默认为0,默认不开启。此参数仅适用于TCP/UDP监听器。
*/ SessionExpireTime?: number; /** *监听器转发的方式。可选值:WRR(按权重轮询)、LEAST_CONN(按最小连接数)
默认为 WRR。此参数仅适用于TCP/UDP/TCP_SSL/QUIC监听器。
是否开启SNI特性,此参数仅适用于HTTPS监听器。0表示未开启,1表示开启。
*/ SniSwitch?: number; /** *后端目标类型,NODE表示绑定普通节点,TARGETGROUP表示绑定目标组。此参数仅适用于TCP/UDP监听器。七层监听器应在转发规则中设置。
*/ TargetType?: string; /** *会话保持类型。不传或传NORMAL表示默认会话保持类型。QUIC_CID 表示根据Quic Connection ID做会话保持。QUIC_CID只支持UDP协议。此参数仅适用于TCP/UDP监听器。七层监听器应在转发规则中设置。(若选择QUIC_CID,则Protocol必须为UDP,Scheduler必须为WRR,同时只支持ipv4)
*/ SessionType?: string; /** *是否开启长连接,此参数仅适用于HTTP/HTTPS监听器,0:关闭;1:开启, 默认关闭。
若后端服务对连接数上限有限制,则建议谨慎开启。此功能目前处于内测中,如需使用,请提交 内测申请。
创建端口段监听器时必须传入此参数,用以标识结束端口。同时,入参Ports只允许传入一个成员,用以标识开始端口。【如果您需要体验端口段功能,请通过 工单申请】。
*/ EndPort?: number; /** *重新调度功能,解绑后端服务开关,打开此开关,当解绑后端服务时触发重新调度。仅TCP/UDP监听器支持。
*/ DeregisterTargetRst?: boolean; /** *证书信息,支持同时传入不同算法类型的多本服务端证书,参数限制如下:
监听器最大连接数,当前仅性能容量型实例且仅TCP/UDP/TCP_SSL/QUIC监听器支持,不传或者传-1表示监听器维度不限速。基础网络实例不支持该参数。
*/ MaxConn?: number; /** *监听器最大新增连接数,当前仅性能容量型实例且仅TCP/UDP/TCP_SSL/QUIC监听器支持,不传或者传-1表示监听器维度不限速。基础网络实例不支持该参数。
*/ MaxCps?: number; /** *空闲连接超时时间,此参数仅适用于TCP/UDP监听器,单位:秒。默认值:TCP监听器默认值为900s,UDP监听器默认值为300s。取值范围:共享型实例和独占型实例支持:10-900,性能容量型实例支持:10-1980。如需设置超过取值范围的值请通过 工单申请。
取值范围:[10, 1980]
单位:秒
默认值:900
TCP监听器默认值为900s,UDP监听器默认值为300s。取值范围:共享型实例和独占型实例支持:10-900,性能容量型实例支持:10-1980。
*/ IdleConnectTimeout?: number; /** *TCP_SSL和QUIC是否支持PP
*/ ProxyProtocol?: boolean; /** *是否开启SNAT(源IP替换),True(开启)、False(关闭)。默认为关闭。注意:SnatEnable开启时会替换客户端源IP,此时透传客户端源IP选项关闭,反之亦然。
全端口段监听器的结束端口,端口范围:2 - 65535
*/ FullEndPorts?: Array内网 HTTP 监听器开启 h2c 开关。
True(开启)、False(关闭)。默认为关闭。
开启后,监听器仅支持创建后端转发类型为 GRPC 或 GRPCS 的七层规则;创建规则时需在 Rules.N.ForwardType 中显式传入 GRPC 或 GRPCS。
控制 TCP_SSL 类型的监听器是否移除 SSL 加密层。开启后,监听器将作为普通 TCP 协议运行。 可选值:
数据压缩模式。可选值:transparent(透传模式)、compatibility(兼容模式)
*/ DataCompressMode?: string; /** *重新调度功能,权重调为0开关,打开此开关,后端服务器权重调为0时触发重新调度。仅TCP/UDP监听器支持。
*/ RescheduleTargetZeroWeight?: boolean; /** *重新调度功能,健康检查异常开关,打开此开关,后端服务器健康检查异常时触发重新调度。仅TCP/UDP监听器支持。
*/ RescheduleUnhealthy?: boolean; /** *重新调度功能,扩容后端服务开关,打开此开关,后端服务器增加或者减少时触发重新调度。仅TCP/UDP监听器支持。
*/ RescheduleExpandTarget?: boolean; /** *重新调度触发开始时间,取值0~3600s。仅TCP/UDP监听器支持。
*/ RescheduleStartTime?: number; /** *重新调度触发持续时间,取值0~3600s。仅TCP/UDP监听器支持。
*/ RescheduleInterval?: number; } /** * SetCustomizedConfigForLoadBalancer返回参数结构体 */ export interface SetCustomizedConfigForLoadBalancerResponse { /** * 个性化配置ID,如:pz-1234abcd */ ConfigId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * HTTP/HTTPS转发规则(输入) */ export interface RuleInput { /** *转发规则的路径。长度限制为:1~200。
*/ Url: string; /** *转发规则的域名。长度限制为:1~80。Domain和Domains只需要传一个,单域名规则传Domain,多域名规则传Domains。
*/ Domain?: string; /** *会话保持时间。设置为0表示关闭会话保持,开启会话保持可取值30~86400,单位:秒。
*/ SessionExpireTime?: number; /** *健康检查信息。详情请参见:健康检查
*/ HealthCheck?: HealthCheck; /** *证书信息;此参数和MultiCertInfo不能同时传入。
*/ Certificate?: CertificateInput; /** *规则的请求转发方式,可选值:WRR、LEAST_CONN、IP_HASH
分别表示按权重轮询、最小连接数、按IP哈希, 默认为 WRR。
负载均衡与后端服务之间的转发协议,目前支持 HTTP/HTTPS/GRPC/GRPCS/TRPC,TRPC暂未对外开放,默认HTTP。
*/ ForwardType?: string; /** *是否将该域名设为默认域名,注意,一个监听器下只能设置一个默认域名。
*/ DefaultServer?: boolean; /** *是否开启Http2,注意,只有HTTPS域名才能开启Http2。
*/ Http2?: boolean; /** *后端目标类型,NODE表示绑定普通节点,TARGETGROUP表示绑定目标组
枚举值:
TRPC被调服务器路由,ForwardType为TRPC时必填。目前暂未对外开放。
*/ TrpcCallee?: string; /** *TRPC调用服务接口,ForwardType为TRPC时必填。目前暂未对外开放
*/ TrpcFunc?: string; /** *是否开启QUIC,注意,只有HTTPS域名才能开启QUIC
*/ Quic?: boolean; /** *转发规则的域名列表。每个域名的长度限制为:1~80。Domain和Domains只需要传一个,单域名规则传Domain,多域名规则传Domains。
*/ Domains?: Array证书信息,支持同时传入不同算法类型的多本服务端证书;此参数和Certificate不能同时传入。
*/ MultiCertInfo?: MultiCertInfo; /** *自定义cookie名
*/ CookieName?: string; } /** * TestModelInputModalities返回参数结构体 */ export interface TestModelInputModalitiesResponse { /** *探测的模型
*/ Model?: string; /** *该模型确认支持的输入模态列表
枚举值:
收到上游大模型对于输入模态的响应即为“确认支持”
*/ SupportedModalities?: Array每个待探测模态的详细请求结果
*/ ProbeDetails?: Array负载均衡实例 ID。
*/ LoadBalancerId: string; /** *要批量修改权重的列表。ModifyList数组最多100个元素,ModifyList[i].Targets最多50个,全部Targets累加不超过500。
*/ ModifyList: Array监听器 ID。
*/ ListenerId: string; /** *绑定端口。
*/ Port: number; /** *子机 ID。表示绑定主网卡主 IP。
*/ InstanceId?: string; /** *绑定 IP 时需要传入此参数,支持弹性网卡的 IP 和其他内网 IP,如果是弹性网卡则必须先绑定至CVM,然后才能绑定到负载均衡实例。注意:参数 InstanceId、EniIp 只能传入一个且必须传入一个。如果绑定双栈IPV6子机,必须传该参数。如果是跨地域绑定,则必须传该参数,不支持传InstanceId参数。
*/ EniIp?: string; /** *子机权重,范围[0, 100]。绑定时如果不存在,则默认为10。
*/ Weight?: number; /** *七层规则 ID。7层负载均衡该参数必填
*/ LocationId?: string; /** *标签。
*/ Tag?: string; } /** * DeleteModelRouters返回参数结构体 */ export interface DeleteModelRoutersResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * RefundModelRouterResourcePackage请求参数结构体 */ export interface RefundModelRouterResourcePackageRequest { /** *待退还的模型路由资源包Id
非有效状态或者设置了自动续订且自动续订已生效的资源包不允许退款。
*/ ModelRouterResourcePackageIds: Array排序的字段
*/ Field?: string; /** *排序方式,支持ASC、DESC
*/ Order?: string; } /** * 模型路由计费信息 */ export interface ModelRouterBillingConfigInput { /** *模型路由计费模式
枚举值:
实例规格
枚举值:
是否关联资源包抵扣
枚举值:
是否开启健康检查。
*/ HealthSwitch: boolean; /** *健康检查方式, 其中仅V2新版目标组类型支持该参数, 支持取值 TCP | HTTP | HTTPS | PING | CUSTOM,其中:
自定义探测相关参数。健康检查端口,默认为后端服务的端口,除非您希望指定特定端口,否则建议留空。(仅适用于TCP/UDP目标组)。
*/ Port?: number; /** *健康检查超时时间。
取值范围:[2, 60]
单位:秒
默认值:2
响应超时时间要小于检查间隔时间。
*/ Timeout?: number; /** *检测间隔时间。
取值范围:[1, 600]
单位:秒
默认值:5
*/ GapTime?: number; /** *检测健康阈值。
取值范围:[2, 10]
单位:次
默认值:3
*/ GoodLimit?: number; /** *检测不健康阈值。
取值范围:[2, 10]
单位:次
默认值:3
*/ BadLimit?: number; /** *目标组下的所有rs的探测包是否开启巨帧。默认开启。仅GWLB类型目标组支持该参数。
*/ JumboFrame?: boolean; /** *健康检查状态码(仅适用于HTTP/HTTPS目标组、TCP目标组的HTTP健康检查方式)。可选值:1~31,默认 31,其中:
健康检查域名, 其中:
健康检查路径(仅适用于HTTP/HTTPS转发规则、TCP监听器的HTTP健康检查方式)。
注意:此字段可能返回 null,表示取不到有效值。 */ HttpCheckPath?: string; /** *健康检查方法(仅适用于HTTP/HTTPS转发规则、TCP监听器的HTTP健康检查方式),默认值:HEAD,可选值HEAD或GET。
注意:此字段可能返回 null,表示取不到有效值。 */ HttpCheckMethod?: string; /** *健康检查的输入格式,健康检查方式取CUSTOM时,必填此字段,可取值:HEX或TEXT,其中:
自定义探测相关参数。健康检查协议CheckType的值取CUSTOM时,必填此字段,代表健康检查发送的请求内容,只允许ASCII可见字符,最大长度限制500。(仅适用于TCP/UDP目标组)。
注意:此字段可能返回 null,表示取不到有效值。 */ SendContext?: string; /** *自定义探测相关参数。健康检查协议CheckType的值取CUSTOM时,必填此字段,代表健康检查返回的结果,只允许ASCII可见字符,最大长度限制500。(仅适用于TCP/UDP目标组)。
注意:此字段可能返回 null,表示取不到有效值。 */ RecvContext?: string; /** *HTTP版本, 其中:
GRPC健康检查状态码(仅适用于后端转发协议为GRPC的目标组)。默认值为 12,可输入值为数值、多个数值、或者范围,例如 20 或 20,25 或 0-99。
注意:此字段可能返回 null,表示取不到有效值。 */ ExtendedCode?: string; } /** * BatchRegisterTargets请求参数结构体 */ export interface BatchRegisterTargetsRequest { /** * 负载均衡ID。 */ LoadBalancerId: string; /** * 绑定目标。 */ Targets: Array模型路由计费模式
枚举值:
实例规格
枚举值:
是否关联资源包抵扣
枚举值:
服务提供商 ID
*/ ServiceProviderId: string; /** *用户自定义服务提供商名称
注意:此字段可能返回 null,表示取不到有效值。 */ ServiceProviderName?: string; /** *模型供应商
*/ ModelProvider?: string; /** *该byok实例下该模型可支持的输入多模态能力列表。
枚举值:
生成的 Key ID 列表
*/ KeyIds?: Array关联的key数量
*/ AssociationKeyCount?: number; /** *关联的模型路由数量
*/ AssociationModelRouterCount?: number; /** *关联的用户组数量
*/ AssociationUserGroupCount?: number; /** *Budget预算配置数组。
最多返回3个元素,每种刷新周期(1d/7d/30d)各一个。
*/ BudgetConfigs?: ArrayBudget ID。
*/ BudgetId?: string; /** *Budget名称。
*/ BudgetName?: string; /** *创建时间。
*/ CreatedTime?: string; /** *修改时间。
*/ ModifiedTime?: string; /** *Budget限速信息。
*/ RateLimitConfig?: RateLimitConfigForBudget; /** *Budget状态。
枚举值:
创建时间(ISO 8601格式)。
*/ CreatedTime?: string; /** *意图路由ID(ir-xxx格式)。
*/ IntentRouterId?: string; /** *路由名称(例如 IntentRouter/customer-support)。
*/ RouteName?: string; /** *意图路由描述。
*/ RouterDescribe?: string; /** *状态。
枚举值:
分层配置列表。
*/ Tiers?: Array更新时间(ISO 8601格式)。
*/ UpdatedTime?: string; } /** * DeleteLoadBalancerListeners返回参数结构体 */ export interface DeleteLoadBalancerListenersResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeIdleLoadBalancers请求参数结构体 */ export interface DescribeIdleLoadBalancersRequest { /** * 数据偏移量,默认为0。 */ Offset?: number; /** * 返回负载均衡实例的数量,默认为20,最大值为100。 */ Limit?: number; /** * 负载均衡所在地域,可以通过 [DescribeRegions](https://cloud.tencent.com/document/product/1596/77930) 接口返回值 `RegionSet.Region` 字段获取。 */ LoadBalancerRegion?: string; } /** * TestModelInputModalities请求参数结构体 */ export interface TestModelInputModalitiesRequest { /** *待探测的模型(原始模型名称)
*/ Model: string; /** *待探测的API Key(明文)
*/ ProviderKey?: string; /** *已创建的BYOK API Key ID(与ProviderKey二选一传入)
*/ ProviderKeyId?: string; /** *BYOK类型,当ProviderKey传入时必填
*/ AccessType?: string; /** *模型厂商协议,当ProviderKey传入时必填
*/ ModelProtocol?: string; /** *模型的厂商
*/ ModelProvider?: string; /** *自定义ApiBase,当ProviderKey传入且AccessType且PrivateCustom/PublicCustom时必填
*/ ApiBase?: string; /** *请求携带的Host头部,当AccessType为PrivateCustom时生效
*/ HostHeader?: string; /** *BYOK实例ID,当AccessType为PrivateCustom时生效,ProviderKey传入时必填
*/ ServiceProviderId?: string; /** *是否校验服务提供商的SSL证书
PublicBYOK时为True且禁止传入;若传入VerifySSL,则优先同步入参逻辑;若传入了ServiceProviderId则同步已创建的Byok实例该Model的逻辑;否则PublicCustom模式下为True,PrivateCustom模式下为False。
*/ VerifySSL?: boolean; /** *健康检查协议
枚举值:
CMR私网管道ID
*/ CMRPrivateNetworkTunnelId?: string; } /** * DeleteKeys请求参数结构体 */ export interface DeleteKeysRequest { /** *模型路由ID
*/ ModelRouterId: string; /** *key的ID列表
*/ KeyIds: Array目标组ID
*/ TargetGroupId?: string; /** *目标组的vpcid
*/ VpcId?: string; /** *目标组的名字
*/ TargetGroupName?: string; /** *目标组的默认端口,全监听目标组此字段返回0,表示无效端口。
注意:此字段可能返回 null,表示取不到有效值。 */ Port?: number; /** *目标组的创建时间
*/ CreatedTime?: string; /** *目标组的修改时间
*/ UpdatedTime?: string; /** *关联到的规则数组。在DescribeTargetGroupList接口调用时无法获取到该参数。
注意:此字段可能返回 null,表示取不到有效值。 */ AssociatedRule?: Array目标组后端转发协议, 仅v2新版目标组返回有效值。
注意:此字段可能返回 null,表示取不到有效值。 */ Protocol?: string; /** *调度算法,仅后端转发协议为(HTTP、HTTPS、GRPC)的目标组返回有效值, 可选值:
健康检查详情。
注意:此字段可能返回 null,表示取不到有效值。 */ HealthCheck?: TargetGroupHealthCheck; /** *目标组类型,当前支持v1(旧版目标组), v2(新版目标组)。默认为v1旧版目标组。
*/ TargetGroupType?: string; /** *目标组已关联的规则数。
*/ AssociatedRuleCount?: number; /** *目标组内的实例数量。
*/ RegisteredInstancesCount?: number; /** *标签。
*/ Tag?: Array默认权重。只有v2类型目标组返回该字段。当返回为NULL时, 表示未设置默认权重。
注意:此字段可能返回 null,表示取不到有效值。 */ Weight?: number; /** *是否全监听目标组。
*/ FullListenSwitch?: boolean; /** *是否开启长连接, 仅后端转发协议为HTTP/HTTPS/GRPC目标组返回有效值。
*/ KeepaliveEnable?: boolean; /** *会话保持时间,仅后端转发协议为HTTP/HTTPS/GRPC目标组返回有效值。
*/ SessionExpireTime?: number; /** *IP版本。
*/ IpVersion?: string; /** *是否开启SNAT
*/ SnatEnable?: boolean; } /** * RegisterTargetGroupInstances请求参数结构体 */ export interface RegisterTargetGroupInstancesRequest { /** * 目标组ID */ TargetGroupId: string; /** * 服务器实例数组,服务器和目标组的 VPC 需相同。 */ TargetGroupInstances: Array源模型名(重写规则的 key)。
特殊值 default 表示兜底规则(命中所有未显式列出的源模型)。
目标模型名(重写规则的 value)。
*/ TargetModel?: string; } /** * DescribeQuota请求参数结构体 */ export type DescribeQuotaRequest = null; /** * BatchDeregisterTargets返回参数结构体 */ export interface BatchDeregisterTargetsResponse { /** * 解绑失败的监听器ID。 */ FailListenerIdSet?: Array新建用户组的ID。
*/ UserGroupId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 负载均衡详细信息 */ export interface LoadBalancerDetail { /** * 负载均衡实例 ID。 */ LoadBalancerId?: string; /** * 负载均衡实例的名称。 */ LoadBalancerName?: string; /** * 负载均衡实例的网络类型: Public:公网属性,Private:内网属性;对于内网属性的负载均衡,可通过绑定EIP出公网,具体可参考EIP文档。 注意:此字段可能返回 null,表示取不到有效值。 */ LoadBalancerType?: string; /** * 负载均衡实例的状态,包括 0:创建中,1:正常运行。 注意:此字段可能返回 null,表示取不到有效值。 */ Status?: number; /** * 负载均衡实例的 VIP 。 注意:此字段可能返回 null,表示取不到有效值。 */ Address?: string; /** * 负载均衡实例 VIP 的IPv6地址。 注意:此字段可能返回 null,表示取不到有效值。 */ AddressIPv6?: string; /** * 负载均衡实例IP版本,IPv4 | IPv6。 注意:此字段可能返回 null,表示取不到有效值。 */ AddressIPVersion?: string; /** * 负载均衡实例IPv6地址类型,IPv6Nat64 | IPv6FullChain。 注意:此字段可能返回 null,表示取不到有效值。 */ IPv6Mode?: string; /** * 负载均衡实例所在可用区。 注意:此字段可能返回 null,表示取不到有效值。 */ Zone?: string; /** * 负载均衡实例IP地址所属的ISP。取值范围:BGP(多线)、CMCC(中国移动)、CUCC(中国联通)、CTCC(中国电信)、INTERNAL(内网)。 注意:此字段可能返回 null,表示取不到有效值。 */ AddressIsp?: string; /** * 负载均衡实例所属私有网络的 ID。 注意:此字段可能返回 null,表示取不到有效值。 */ VpcId?: string; /** * 负载均衡实例所属的项目 ID, 0 表示默认项目。 注意:此字段可能返回 null,表示取不到有效值。 */ ProjectId?: number; /** * 负载均衡实例的创建时间。 注意:此字段可能返回 null,表示取不到有效值。 */ CreateTime?: string; /** * 负载均衡实例的计费类型。取值范围:PREPAID预付费、POSTPAID_BY_HOUR按量付费。 注意:此字段可能返回 null,表示取不到有效值。 */ ChargeType?: string; /** * 负载均衡实例的网络属性。 注意:此字段可能返回 null,表示取不到有效值。 */ NetworkAttributes?: InternetAccessible; /** * 负载均衡实例的预付费相关属性。 注意:此字段可能返回 null,表示取不到有效值。 */ PrepaidAttributes?: LBChargePrepaid; /** * 暂做保留,一般用户无需关注。 注意:此字段可能返回 null,表示取不到有效值。 */ ExtraInfo?: ExtraInfo; /** * 负载均衡维度的个性化配置ID,多个配置用逗号隔开。 注意:此字段可能返回 null,表示取不到有效值。 */ ConfigId?: string; /** * 负载均衡实例的标签信息。 注意:此字段可能返回 null,表示取不到有效值。 */ Tags?: Array负载均衡实例的网络类型:
OPEN:公网属性, INTERNAL:内网属性。
负载均衡实例的类型。1:通用的负载均衡实例,目前只支持传入1。
*/ Forward?: number; /** *负载均衡实例的名称,只在创建一个实例的时候才会生效。规则:1-80 个英文字母、汉字等国际通用语言字符,数字,连接线“-”、下划线“_”等常见字符(禁止Unicode补充字符,如emoji表情、生僻汉字等)。注意:如果名称与系统中已有负载均衡实例的名称相同,则系统将会自动生成此次创建的负载均衡实例的名称。
*/ LoadBalancerName?: string; /** *负载均衡后端目标设备所属的网络 ID,如vpc-12345678,可以通过 DescribeVpcs 接口获取。 不填此参数则默认为DefaultVPC。创建内网负载均衡实例时,此参数必填。
*/ VpcId?: string; /** *在私有网络内购买内网负载均衡实例的情况下,必须指定子网 ID,内网负载均衡实例的 VIP 将从这个子网中产生。
创建内网负载均衡实例,或者创建 IPv6FullChain 版本的负载均衡实例,此参数必填。
创建公网IPv4负载均衡实例时,不支持指定该参数。
负载均衡实例所属的项目 ID,默认项目 ID 为0。可以通过 DescribeProject 接口获取。不填此参数则视为默认项目。
*/ ProjectId?: number; /** *仅适用于公网负载均衡。IP版本,可取值:IPV4、IPV6、IPv6FullChain,不区分大小写,默认值 IPV4。说明:取值为IPV6表示为IPV6 NAT64版本;取值为IPv6FullChain,表示为IPv6版本。
*/ AddressIPVersion?: string; /** *创建负载均衡的个数,默认值 1。创建个数不能超过账号所能创建的最大值,默认创建最大值为20。
*/ Number?: number; /** *仅适用于公网且IP版本为IPv4的负载均衡。设置跨可用区容灾时的主可用区ID, 可用区 ID 和名称均支持,例如 100001 或 ap-guangzhou-1
注:主可用区是需要承载流量的可用区,备可用区默认不承载流量,主可用区不可用时才使用备可用区。
仅适用于公网且IP版本为IPv4的负载均衡。可用区ID,可用区 ID 和名称均支持,指定可用区以创建负载均衡实例。如:100001 或 ap-guangzhou-1。
*/ ZoneId?: string; /** *网络计费模式,其中的最大出带宽,仅对内网属性的性能容量型实例和公网属性的所有实例生效。
*/ InternetAccessible?: InternetAccessible; /** *仅适用于公网负载均衡。目前仅广州、上海、南京、济南、杭州、福州、北京、石家庄、武汉、长沙、成都、重庆地域支持静态单线 IP 线路类型,如需体验,请联系商务经理申请。申请通过后,即可选择中国移动(CMCC)、中国联通(CUCC)或中国电信(CTCC)的运营商类型,网络计费模式只能使用按带宽包计费(BANDWIDTH_PACKAGE)。 如果不指定本参数,则默认使用BGP。可通过 DescribeResources 接口查询一个地域所支持的Isp。
*/ VipIsp?: string; /** *购买负载均衡的同时,给负载均衡打上标签,最大支持20个标签键值对。
*/ Tags?: Array指定VIP申请负载均衡。此参数选填,不填写此参数时自动分配VIP。IPv4和IPv6类型支持此参数,IPv6 NAT64类型不支持。
注意:当指定VIP创建内网实例、或公网IPv6 BGP实例时,若VIP不属于指定VPC子网的网段内时,会创建失败;若VIP已被占用,也会创建失败。
带宽包ID,可以通过 DescribeBandwidthPackages 接口获取。指定此参数时,网络计费方式(InternetAccessible.InternetChargeType)只支持按带宽包计费(BANDWIDTH_PACKAGE),带宽包的属性即为其结算方式。非上移用户购买的 IPv6 负载均衡实例,且运营商类型非 BGP 时 ,不支持指定具体带宽包id。
*/ BandwidthPackageId?: string; /** *独占型实例信息。若创建独占型的内网负载均衡实例,则此参数必填。
*/ ExclusiveCluster?: ExclusiveCluster; /** *性能容量型规格。
集群ID,集群标识,在需要配置公有云独占集群或本地专有集群时使用。公有云独占集群申请请提交工单,本地专有集群请参考本地专有集群描述。
*/ ClusterIds?: Array用于保证请求幂等性的字符串。该字符串由客户生成,需保证不同请求之间唯一,最大值不超过64个ASCII字符。若不指定该参数,则无法保证请求的幂等性。
*/ ClientToken?: string; /** *是否支持绑定跨地域/跨Vpc绑定IP的功能。
*/ SnatPro?: boolean; /** *开启绑定跨地域/跨Vpc绑定IP的功能后,创建SnatIp。
*/ SnatIps?: ArrayStgw独占集群的标签。
*/ ClusterTag?: string; /** *仅适用于公网且IP版本为IPv4的负载均衡。设置跨可用区容灾时的备可用区ID,可用区 ID 和名称均支持,例如 100001 或 ap-guangzhou-1
注:备可用区是主可用区故障后,需要承载流量的可用区。可通过 DescribeResources 接口查询一个地域的主/备可用区的列表。【如果您需要体验该功能,请通过 工单申请】
EIP 的唯一 ID,可以通过 DescribeAddresses 接口查询。形如:eip-qhx8udkc,仅适用于内网负载均衡绑定EIP。
*/ EipAddressId?: string; /** *Target是否放通来自CLB的流量。开启放通(true):只验证CLB上的安全组;不开启放通(false):需同时验证CLB和后端实例上的安全组。IPv6 CLB安全组默认放通,不需要传此参数。
*/ LoadBalancerPassToTarget?: boolean; /** *创建域名化负载均衡。
*/ DynamicVip?: boolean; /** *网络出口
*/ Egress?: string; /** *负载均衡实例的预付费相关属性
*/ LBChargePrepaid?: LBChargePrepaid; /** *负载均衡实例计费类型,取值:POSTPAID_BY_HOUR,PREPAID,默认是POSTPAID_BY_HOUR。
枚举值:
七层访问日志主题ID
*/ AccessLogTopicId?: string; /** *是否开启七层高级路由
*/ AdvancedRoute?: boolean; /** *可用区亲和信息
*/ AvailableZoneAffinityInfo?: AvailableZoneAffinityInfo; } /** * CloneLoadBalancer请求参数结构体 */ export interface CloneLoadBalancerRequest { /** * 负载均衡ID,可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。 */ LoadBalancerId: string; /** * 克隆出负载均衡实例的名称,规则:1-60 个英文、汉字、数字、连接线“-”或下划线“_”。 注意:如果名称与系统中已有负载均衡实例的名称相同,则系统将会自动生成此次创建的负载均衡实例的名称。 */ LoadBalancerName?: string; /** * 负载均衡实例所属的项目 ID,默认项目 ID 为0,可以通过 [DescribeLoadBalancers](https://cloud.tencent.com/document/product/214/30685) 接口获取。不传此参数则视为默认项目。 */ ProjectId?: number; /** * 仅适用于公网负载均衡。设置跨可用区容灾时的主可用区ID,可用区 ID 和名称均支持,例如 100001 或 ap-guangzhou-1。 注:主可用区是需要承载流量的可用区,备可用区默认不承载流量,主可用区不可用时才使用备可用区,平台将为您自动选择最佳备可用区。可通过 [DescribeResources](https://cloud.tencent.com/document/api/214/70213) 接口查询一个地域的主可用区的列表。 */ MasterZoneId?: string; /** * 仅适用于公网负载均衡。设置跨可用区容灾时的备可用区ID,可用区 ID 和名称均支持,例如 100001 或 ap-guangzhou-1。 注:备可用区是主可用区故障后,需要承载流量的可用区。可通过 [DescribeResources](https://cloud.tencent.com/document/api/214/70213) 接口查询一个地域的主/备可用区的列表。 */ SlaveZoneId?: string; /** * 仅适用于公网负载均衡。可用区ID,可用区 ID 和名称均支持,指定可用区以创建负载均衡实例。如:100001 或 ap-guangzhou-1。不传则查询所有可用区的 CVM 实例。如需指定可用区,可调用查询可用区列表 [DescribeZones](https://cloud.tencent.com/document/product/213/15707) 接口查询。 */ ZoneId?: string; /** * 仅适用于公网负载均衡。负载均衡的网络计费模式。 */ InternetAccessible?: InternetAccessible; /** * 仅适用于公网负载均衡。目前仅广州、上海、南京、济南、杭州、福州、北京、石家庄、武汉、长沙、成都、重庆地域支持静态单线 IP 线路类型,如需体验,请联系商务经理申请。申请通过后,即可选择中国移动(CMCC)、中国联通(CUCC)或中国电信(CTCC)的运营商类型,网络计费模式只能使用按带宽包计费(BANDWIDTH_PACKAGE)。 如果不指定本参数,则默认使用BGP。可通过 DescribeResources 接口查询一个地域所支持的Isp。 */ VipIsp?: string; /** * 指定Vip申请负载均衡。 */ Vip?: string; /** * 购买负载均衡同时,给负载均衡打上标签。 */ Tags?: Array该 BYOK 实例(ServiceProvider)维度的积分系数。
可选字段:仅当该实例单独配置了 ServiceProvider 维度系数时返回,返回值即该实例的生效系数;未返回时表示该实例继承所属 ModelAlias 的 Coefficient。
BYOK 实例(ServiceProvider)ID。
*/ ServiceProviderId?: string; /** *BYOK 实例(ServiceProvider)名称。
*/ ServiceProviderName?: string; /** *分级积分系数设置
*/ CoefficientTiers?: Array峰谷积分系数设置
*/ CoefficientSchedule?: Array退还模型路由资源包的订单号
*/ DealNames?: Array每分钟限制的请求数量
单位:次/分钟
*/ RPM?: number; /** *每分钟限制的Token数量
单位:个/分钟
*/ TPM?: number; } /** * AddModelKey请求参数结构体 */ export interface AddModelKeyRequest { /** *服务提供商ID
*/ ServiceProviderId: string; /** *Key 列表,至少 1 个,最多 10 个
*/ Keys: Array过滤条件
支持:ModelRouterName、ModelRouterType、Status、BudgetId、tag-key、tag:<tag-key>。
*/ Filters?: Array每页数量,1-100,默认 20
*/ Limit?: number; /** *模型路由实例ID列表
*/ ModelRouterIds?: Array分页偏移量,默认 0
*/ Offset?: number; } /** * 按模型标识聚合的信息 */ export interface ModelNameAggregatedItem { /** *模型标识显示名称(优先使用 model_alias,否则使用 model_name)
*/ ModelName: string; /** *关联的服务商列表
*/ ServiceProviders?: Array