修改一條雲助手命令相關參數以及命令內容。
描述
- 命令執行期間也允許修改,修改命令後,後續執行會按照新的命令內容執行。
- 您不能修改命令的類型,例如,如果命令是 Shell 命令(
RunShellScript
),則不能修改為 Bat 命令(RunBatScript
)。
請求參數
名稱 | 類型 | 是否必需 | 描述 |
---|---|---|---|
Action | String | 是 | 系統規定參數。取值:ModifyCommand |
RegionId | String | 是 | 地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。 |
CommandId | String | 是 | 命令 ID。您可以通過介面 DescribeCommands 查詢所有可用的 CommandId 。 |
Name | String | 否 | 命令名稱,支援全字元集。長度不得超過 30 個字元。 |
Description | String | 否 | 命令描述,支援全字元集。長度不得超過100個字元。 |
返回參數
全是公共返回參數。參閱 公共返回參數。
樣本
請求樣本
https://ecs.aliyuncs.com/?Action=ModifyCommand
&RegionId=cn-hangzhou
&CommandId=c-e996287206324975b5fbe1dxxxxxxxxx
&NameId=Test
&TimeOut=120
&<公共請求參數>
正常返回樣本
XML 格式
<ModifyCommandResponse>
<RequestId>E69EF3CC-94CD-42E7-8926-F133B86387C0</RequestId>
</ModifyCommandResponse>
JSON 格式
{
"RequestId":"E69EF3CC-94CD-42E7-8926-F133B86387C0",
}
異常返回樣本
XML 格式
<Error>
<RequestId>E69EF3CC-94CD-42E7-8926-F133B86387C0</RequestId>
<HostId>ecs.aliyuncs.com</HostId>
<Code>InvalidCmdId.NotFound</Code>
<Message>The specified command ID does not exist.</Message>
</Error>
JSON 格式
{
"RequestId": "E69EF3CC-94CD-42E7-8926-F133B86387C0",
"HostId": "ecs.aliyuncs.com"
"Code": "InvalidCmdId.NotFound"
"Message": "The specified command ID does not exist."
}
錯誤碼
以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心 。
錯誤碼 | 錯誤資訊 | HTTP 狀態碼 | 說明 |
---|---|---|---|
MissingParameter.CommandId | The input parameter “CommandId” that is mandatory for processing this request is not supplied. | 400 | 您必須指定必需參數 CommandId 。 |
MissingParameter.RegionId | The input parameter “RegionId” that is mandatory for processing this request is not supplied. | 400 | 您必須指定必需參數 RegionId ,或者您暫時不能使用指定 RegionId 裡的資源。 |
InvalidCmdId.NotFound | The specified CommandId does not exist. | 404 | 指定的 CommandId 不存在。 |
InvalidRegionId.NotFound | The RegionId provided does not exist in our items. | 404 | 指定的 RegionId 不存在。 |
InternalError.Dispatch | An internal error occurred when dispath the request | 500 | 內部錯誤,請稍後嘗試。 |