Tous les produits
Search
Centre de documentation

:ModifyCommand

Dernière mise à jour :Aug 18, 2026

Modifie les paramètres d'une commande Cloud Assistant.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter Type Required Example Description
Action String Yes ModifyCommand

L'opération à effectuer. Définissez la valeur sur ModifyCommand.

RegionId String Yes cn-hangzhou

ID de région de la commande. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.

CommandId String Yes c-hz01272yr52****

ID de la commande. Appelez l'opération DescribeCommands pour obtenir tous les ID de commande disponibles.

Name String No test-CommandName

Nom de la commande. Le nom accepte tous les jeux de caractères et peut contenir jusqu'à 128 caractères.

Description String No This is description.

Description de la commande. La description accepte tous les jeux de caractères et peut contenir jusqu'à 512 caractères.

CommandContent String No echo
Remarque Ce paramètre est obsolète et n'a aucun effet.
WorkingDir String No /home/

Chemin d'exécution de la commande. La valeur peut contenir jusqu'à 200 caractères.

Timeout Long No 120

Délai d'expiration maximal pour l'exécution de la commande sur les instances, en secondes. Si une commande ne s'exécute pas dans le délai imparti, une erreur de délai d'expiration se produit. Le client Cloud Assistant arrête alors de force le processus de commande en annulant son identifiant de processus (PID).

Paramètres de réponse

Parameter

Type

Example

Description

RequestId

String

0DE9B41E-EF0D-40A0-BB43-37749C5BDA9C

ID de la requête.

Exemples

Exemples de requêtes

https://ecs.aliyuncs.com/?Action=ModifyCommand
&CommandId=c-hz01272yr52****
&RegionId=cn-hangzhou
&Name=test-CommandName
&Description=This is description.
&CommandContent=c2VydmljZSB0b21jYXQgc3RhcnQ=
&WorkingDir=/home/
&Timeout=120
&<Common request parameters>

Exemples de réponses réussies

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyCommandResponse>
    <RequestId>0DE9B41E-EF0D-40A0-BB43-37749C5BDA9C</RequestId>
</ModifyCommandResponse>

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0DE9B41E-EF0D-40A0-BB43-37749C5BDA9C"
}

Codes d'erreur

HTTP status code

Error code

Error message

Description

400

RegionId.ApiNotSupported

The api is not supported in this region.

Cette opération n'est pas prise en charge dans la région spécifiée. Vérifiez la validité du paramètre RegionId.

400

InvalidParameter.WorkingDir

The specified parameter WorkingDir is not valid.

Valeur WorkingDir non valide.

403

CmdName.Readonly

The command name is readonly after publishing.

La commande est publiée et son nom ne peut pas être modifié.

403

CmdName.ExceedLimit

The length of the command name exceeds the upper limit.

La longueur maximale du nom de la commande est dépassée.

403

CmdContent.ExceedLimit

The length of the command content exceeds the upper limit.

La longueur maximale du contenu de la commande est dépassée.

403

CmdDesc.ExceedLimit

The length of the command description exceeds the upperlimit.

La longueur maximale de la description de la commande est dépassée.

403

Operation.Forbidden

The operation is not permitted.

L'opération n'est pas autorisée.

404

InvalidCmdId.NotFound

The specified command ID does not exist.

Valeur CommandId non valide. Appelez l'opération DescribeCommands pour obtenir tous les ID de commande disponibles.

500

InternalError.Dispatch

An error occurred when you dispatched the request.

Une erreur s'est produite lors de l'envoi de la requête. Réessayez ultérieurement.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.