帮你快速理解、总结文档立即下载

更新模型服务

最近更新时间:2026-07-22 02:59:29

我的收藏

1. 接口描述

接口请求域名: tione.tencentcloudapi.com 。

用于更新模型服务

默认接口请求频率限制:20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:ModifyModelService。
Version String 公共参数,本接口取值:2021-11-11。
Region String 公共参数,详见产品支持的 地域列表
ServiceId String

服务id


示例值:ms-testtest-0
TiProjectId String

TI工作空间ID

仅用于“工作空间”白名单功能。如需使用,请联系TI管理员开通白名单。


示例值:0
ModelInfo ModelInfo

模型信息,需要挂载模型时填写

ImageInfo ImageInfo

镜像信息,配置服务运行所需的镜像地址等信息

Env.N Array of EnvVar

环境变量,可选参数,用于配置容器中的环境变量

Resources ResourceInfo

资源描述,指定预付费模式下的cpu,mem,gpu等信息,后付费无需填写

InstanceType String

使用DescribeBillingSpecs接口返回的规格列表中的值,或者参考实例列表:
TI.S.MEDIUM.POST 2C4G
TI.S.LARGE.POST 4C8G
TI.S.2XLARGE16.POST 8C16G
TI.S.2XLARGE32.POST 8C32G
TI.S.4XLARGE32.POST 16C32G
TI.S.4XLARGE64.POST 16C64G
TI.S.6XLARGE48.POST 24C48G
TI.S.6XLARGE96.POST 24C96G
TI.S.8XLARGE64.POST 32C64G
TI.S.8XLARGE128.POST 32C128G
TI.GN7.LARGE20.POST 4C20G T41/4
TI.GN7.2XLARGE40.POST 10C40G T4
1/2
TI.GN7.2XLARGE32.POST 8C32G T41
TI.GN7.5XLARGE80.POST 20C80G T4
1
TI.GN7.8XLARGE128.POST 32C128G T41
TI.GN7.10XLARGE160.POST 40C160G T4
2
TI.GN7.20XLARGE320.POST 80C320G T4*4


示例值:TI.S.MEDIUM.POS
ScaleMode String

扩缩容类型 支持:自动 - "AUTO", 手动 - "MANUAL"


示例值:AUTO
Replicas Integer

实例数量, 不同计费模式和调节模式下对应关系如下
PREPAID 和 POSTPAID_BY_HOUR:
手动调节模式下对应 实例数量
自动调节模式下对应 基于时间的默认策略的实例数量
HYBRID_PAID:
后付费实例手动调节模式下对应 实例数量
后付费实例自动调节模式下对应 时间策略的默认策略的实例数量


示例值:1
HorizontalPodAutoscaler HorizontalPodAutoscaler

自动伸缩信息

LogEnable Boolean

是否开启日志投递,开启后需填写配置投递到指定cls


示例值:true
LogConfig LogConfig

日志配置,需要投递服务日志到指定cls时填写

ServiceAction String

特殊更新行为: "STOP": 停止, "RESUME": 重启, "SCALE": 扩缩容, 存在这些特殊更新行为时,会忽略其他更新字段


示例值:STOP
ServiceDescription String

服务的描述


示例值:ms-testtest
ScaleStrategy String

自动伸缩策略


示例值:HPA
CronScaleJobs.N Array of CronScaleJob

自动伸缩策略配置 HPA : 通过HPA进行弹性伸缩 CRON 通过定时任务进行伸缩

HybridBillingPrepaidReplicas Integer

计费模式[HYBRID_PAID]时生效, 用于标识混合计费模式下的预付费实例数, 若不填则默认为1


示例值:1
ModelHotUpdateEnable Boolean

是否开启模型的热更新。默认不开启


示例值:false
ScheduledAction ScheduledAction

定时停止配置

ServiceLimit ServiceLimit

服务限速限流相关配置

VolumeMount VolumeMount

挂载配置,目前只支持CFS

ModelTurboEnable Boolean

是否开启模型的加速, 仅对StableDiffusion(动态加速)格式的模型有效。默认不开启


示例值:false
Command String

服务的启动命令,如遇特殊字符导致配置失败,可使用CommandBase64参数


示例值:sleep 36000
ServiceEIP ServiceEIP

是否开启TIONE内网访问外部,此功能仅支持后付费机型与从TIONE平台购买的预付费机型;使用从CVM选择资源组时此配置不生效。

CommandBase64 String

服务的启动命令,以base64格式进行输入,与Command同时配置时,仅当前参数生效


示例值:c2xlZXAgMzYwMDA=
ServicePort Integer

服务端口,仅在非内置镜像时生效,默认8501。不支持输入8501-8510,6006,9092


示例值:8501
InstancePerReplicas Integer

单副本下的实例数,仅在部署类型为DIST时生效,默认1


示例值:1
TerminationGracePeriodSeconds Integer

服务的优雅退出时限。单位为秒,默认值为30,最小为1


示例值:30
PreStopCommand.N Array of String

服务实例停止前执行的命令,执行完毕或执行时间超过优雅退出时限后实例结束


示例值:["sleep","60"]
GrpcEnable Boolean

是否启动grpc端口


示例值:false
HealthProbe HealthProbe

健康探针

RollingUpdate RollingUpdate

滚动更新策略

Sidecar SidecarSpec

sidecar配置

ResourceGroupId String

资源组 id


示例值:rsg-xxtt111
VolumeMounts.N Array of VolumeMount

数据盘批量挂载配置,当前仅支持CFS,仅针对“模型来源-腾讯云存储、模型来源-腾讯云容器镜像、模型来源-资源组、模型来源-数据源”。

SchedulingStrategy String

调度策略 [binpack] 优先占满整机,尽量避免碎卡(默认值)[spread] 优先分散在各个节点,确保服务高可用


示例值:binpack
TargetProjectId Integer

目标工作空间,不为0则进行迁移,源服务只允许在默认空间


示例值:1884415528852783104

3. 输出参数

参数名称 类型 描述
Service Service

生成的模型服务


注意:此字段可能返回 null,表示取不到有效值。
RequestId String 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 停止服务

输入示例

POST / HTTP/1.1
Host: tione.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ModifyModelService
<公共请求参数>

{
    "ServiceId": "ms-h29wqz2b-1",
    "ServiceAction": "STOP"
}

输出示例

{
    "Response": {
        "RequestId": "d3d242fd-c8e7-44f5-8b28-a0e1bcfe92d5",
        "Service": {
            "AppId": 1317564324,
            "ArchiveStatus": "",
            "BillingInfo": "",
            "BusinessStatus": "CREATE_SUCCEED",
            "Changer": "",
            "ChangerName": "",
            "ChargeType": "POSTPAID_BY_HOUR",
            "ClusterId": "manger",
            "CreateFailedReason": "CREATE_SUCCEED",
            "CreateSource": "NORMAL",
            "CreateTime": "2026-07-08T13:16:17Z",
            "CreatedBy": "100041882933",
            "DeployType": "DIST",
            "ExternalResourceGroups": [],
            "IngressName": "none",
            "LatestVersion": "",
            "MonitorSource": "NORMAL",
            "Namespace": "infer-100030513581",
            "ProjectId": "0",
            "Region": "ap-shanghai",
            "ResourceGroupId": "",
            "ResourceGroupName": "",
            "ResourceGroupSWType": "NONE",
            "SchedulingPolicy": {
                "CrossResourceGroupScheduling": false
            },
            "ServiceDescription": "",
            "ServiceGroupId": "ms-h29wqz2b",
            "ServiceGroupName": "luis-test-new2_copy",
            "ServiceId": "ms-h29wqz2b-1",
            "ServiceInfo": {
                "AuthorizationEnable": false,
                "Command": "",
                "CronScaleJobs": [],
                "Env": [],
                "GrpcEnable": false,
                "HybridBillingPrepaidReplicas": 0,
                "ImageInfo": {
                    "ImageType": "CCR",
                    "ImageUrl": "ccr.ccs.tencentyun.com/luis-test/hellotest:v1",
                    "RegistryId": "",
                    "RegistryRegion": "ap-guangzhou"
                },
                "InstanceAlias": "",
                "InstancePerReplicas": 1,
                "InstanceType": "TI.S6.2XLARGE16.POST",
                "LogEnable": false,
                "ModelHotUpdateEnable": false,
                "ModelTurboEnable": false,
                "NodeCount": 0,
                "OldHybridBillingPrepaidReplicas": 0,
                "OldReplicas": 0,
                "PodInfos": [],
                "PodList": [],
                "PreStopCommand": [],
                "Replicas": 2,
                "Resources": {
                    "Cpu": 8000,
                    "EnableRDMA": false,
                    "Gpu": 0,
                    "GpuType": "",
                    "Memory": 16384,
                    "RealGpu": 0,
                    "RealGpuDetailSet": []
                },
                "ResourceTotal": "",
                "ScaleMode": "",
                "ScaleStrategy": "",
                "SchedulingStrategy": "",
                "ServicePort": 0,
                "TerminationGracePeriodSeconds": 30,
                "VolumeMounts": [],
                "Weight": 0,
                "Status": {
                    "Replicas": 2,
                    "UpdatedReplicas": 2,
                    "ReadyReplicas": 2,
                    "AvailableReplicas": 2,
                    "UnavailableReplicas": 0,
                    "Status": "Normal",
                    "Reason": "",
                    "Conditions": [],
                    "StatefulSetCondition": []
                }
            },
            "Status": "",
            "SubUin": "100041882933",
            "SubUinName": "",
            "Tags": [],
            "Uin": "100030513581",
            "UpdateTime": "2026-07-21T03:12:31Z",
            "Version": "1",
            "Weight": 100
        }
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
AuthFailure CAM签名/鉴权错误。
AuthFailure.CamException CAM系统异常。
AuthFailure.UnauthorizedOperation 未授权操作。
FailedOperation 操作失败。
FailedOperation.ApiGatewayQueryFailed API网关访问失败,请重试。
FailedOperation.BillingQueryFailed 计费模块访问失败。
FailedOperation.ClusterQueryFailed 集群访问失败。
FailedOperation.DuplicateName 名称重复。
FailedOperation.ExecDatabaseFail 数据库执行错误。
FailedOperation.ExecTagFail 标签操作失败。
FailedOperation.InsufficientWhitelistQuota 白名单免费配额不足。
FailedOperation.QueryDatabaseFail 数据库查询错误。
FailedOperation.QueryTagFail 查询标签服务失败。
FailedOperation.StsQueryFailed 密钥服务访问失败,请重试。
FailedOperation.UnknownInstanceType 未知的实例规格。
FailedOperation.UnmarshalData 数据解析失败。
InternalError 内部错误。
InvalidParameter 参数错误。
InvalidParameter.ModelFileInvalid 模型包不符合规范。
MissingParameter 缺少参数错误。
OperationDenied 操作被拒绝。
OperationDenied.BalanceInsufficient 余额不足,创建/更新失败。
ResourceInUse 资源被占用。
ResourceInsufficient 资源不足。
ResourceInsufficient.QuotaInsufficient 申请资源超过用户在当前资源组的最大配额限制
ResourceNotFound 资源不存在。
UnknownParameter 未知参数错误。
UnsupportedOperation 操作不支持。