Changes the model or the client-facing invocation name of an AI cluster.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
The region ID. |
cn-beijing |
| DBClusterId |
string |
Yes |
The ID of the PolarDB AI 3.0 logical instance. |
pm-2ze4x2mwo81knj08a |
| ModelName |
string |
Yes |
The name of the target model. Select a value from the ModelName values returned by the DescribeAvailableModels operation. |
Qwen3-32B |
| DisplayModelName |
string |
No |
The new client-facing invocation name. If this parameter is not specified, the existing invocation name is retained. |
my-flagship-chat |
| DryRun |
boolean |
No |
The maximum number of workers to restart per batch within a single MSD. Valid values: 1 to 30. This parameter takes effect only when RestartMode is set to inPlace. |
8 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Schema of Response |
||
| DryRun |
boolean |
Indicates whether the request is a dry-run request. |
true |
| ModelType |
string |
The model type of the instance. |
custom |
| RequestId |
string |
Id of the request |
3AA6E0E4-1234-5678-90AB-1234567890AB |
| TargetModelName |
string |
The resolved target model name. |
Qwen3-32B |
| TargetOssPath |
string |
The resolved target OSS path. |
/my-model-bucket/models/qwen3 |
| TaskId |
integer |
The ID of the asynchronous task. This parameter is empty when DryRun is set to true. |
123456 |
| TotalBatches |
integer |
The number of change batches. |
1 |
| TotalMsds |
integer |
The number of affected model serving instances. |
2 |
| Warnings |
array |
The change warnings returned by the upstream. The caller must display these warnings. |
|
|
string |
The warning content. |
The change will restart model workers. |
Examples
Success response
JSON format
{
"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."
]
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.