你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Virtual Machine Scale Set VMs - Run Command
在 VM 规模集中的虚拟机上运行命令。
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/virtualmachines/{instanceId}/runCommand?api-version=2024-03-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
instance
|
path | True |
string |
虚拟机的实例 ID。 |
resource
|
path | True |
string |
资源组的名称。 |
subscription
|
path | True |
string |
唯一标识 Microsoft Azure 订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。 |
vm
|
path | True |
string |
VM 规模集的名称。 |
api-version
|
query | True |
string |
客户端 API 版本。 |
请求正文
Media Types: "application/json", "text/json"
名称 | 必需 | 类型 | 说明 |
---|---|---|---|
commandId | True |
string |
运行命令 ID。 |
parameters |
运行命令参数。 |
||
script |
string[] |
可选。 要执行的脚本。 给定此值后,给定的脚本将替代命令的默认脚本。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
确定 Media Types: "application/json", "text/json" |
|
202 Accepted |
已接受 Media Types: "application/json", "text/json" |
安全性
azure_auth
Azure Active Directory OAuth2 流
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
VirtualMachineScaleSetVMs_RunCommand
Sample Request
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myVirtualMachineScaleSet/virtualmachines/0/runCommand?api-version=2024-03-01
{
"commandId": "RunPowerShellScript",
"script": [
"Write-Host Hello World!"
]
}
Sample Response
{
"value": [
{
"code": "ComponentStatus/StdOut/succeeded",
"level": "Info",
"displayStatus": "Provisioning succeeded",
"message": "Hello World!"
},
{
"code": "ComponentStatus/StdErr/succeeded",
"level": "Info",
"displayStatus": "Provisioning succeeded",
"message": ""
}
]
}
Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2024-03-01
定义
名称 | 说明 |
---|---|
Instance |
实例视图状态。 |
Run |
捕获虚拟机参数。 |
Run |
描述 run 命令参数的属性。 |
Run |
|
Status |
级别代码。 |
InstanceViewStatus
实例视图状态。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
状态代码。 |
displayStatus |
string |
状态的简短可本地化标签。 |
level |
级别代码。 |
|
message |
string |
详细状态消息,包括警报和错误消息。 |
time |
string |
状态的时间。 |
RunCommandInput
捕获虚拟机参数。
名称 | 类型 | 说明 |
---|---|---|
commandId |
string |
运行命令 ID。 |
parameters |
运行命令参数。 |
|
script |
string[] |
可选。 要执行的脚本。 给定此值后,给定的脚本将替代命令的默认脚本。 |
RunCommandInputParameter
描述 run 命令参数的属性。
名称 | 类型 | 说明 |
---|---|---|
name |
string |
运行命令参数名称。 |
value |
string |
运行命令参数值。 |
RunCommandResult
名称 | 类型 | 说明 |
---|---|---|
value |
运行命令操作响应。 |
StatusLevelTypes
级别代码。
名称 | 类型 | 说明 |
---|---|---|
Error |
string |
|
Info |
string |
|
Warning |
string |