ModifyAIDBClusterModel - 变更 AI 集群模型或对客调用名-阿里云帮助中心

变更 AI 集群模型或对客调用名

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。	cn-beijing
DBClusterId	string	是	PolarDB AI 3.0 逻辑实例 ID。	pm-2ze4x2mwo81knj08a
ModelName	string	是	目标模型名称，从 DescribeAvailableModels 返回的 ModelName 中选择。	Qwen3-32B
DisplayModelName	string	否	新的对客调用名。不传则保持现有调用名。	my-flagship-chat
WorkerBatchSize	integer	否	单个 MSD 内每批最多重启的 worker 数量，范围为 1～30。仅在 RestartMode=inPlace 时生效。	8
RestartMode	string	否	worker 重启方式，仅允许 inPlace 或 recreate。	inPlace
DryRun	boolean	否	是否仅预览变更。	true

返回参数

名称	类型	描述	示例值
	object	Schema of Response
DryRun	boolean	是否为预览请求。	true
ModelType	string	实例模型形态。	custom
RequestId	string	Id of the request	3AA6E0E4-1234-5678-90AB-1234567890AB
TargetModelName	string	解析后的目标模型名称。	Qwen3-32B
TargetOssPath	string	解析后的目标 OSS 路径。	/my-model-bucket/models/qwen3
TaskId	integer	异步任务 ID，DryRun=true 时为空。	123456
TotalBatches	integer	变更批次数量。	1
TotalMsds	integer	受影响的模型服务实例数量。	2
Warnings	array	上游返回的变更告警，调用方必须展示。
	string	告警内容。	The change will restart model workers.

示例

正常返回示例

JSON格式

{
  "DryRun": true,
  "ModelType": "custom",
  "RequestId": "3AA6E0E4-1234-5678-90AB-1234567890AB",
  "TargetModelName": "Qwen3-32B",
  "TargetOssPath": "/my-model-bucket/models/qwen3",
  "TaskId": 123456,
  "TotalBatches": 1,
  "TotalMsds": 2,
  "Warnings": [
    "The change will restart model workers."
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。