Tous les produits
Search
Centre de documentation

:CreateCommand

Dernière mise à jour :Aug 06, 2026

Crée une commande Cloud Assistant.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

  • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

  • API : l'API que vous pouvez appeler pour exécuter l'action.

  • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

  • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

    • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

    • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

  • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

  • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

swas-open:CreateCommand

create

*Command

acs:swas-open:{#regionId}:{#accountId}:command/*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

RegionId

string

Oui

L'identifiant de la région. Appelez ListRegions pour interroger les régions disponibles.

cn-hangzhou

Name

string

Oui

Le nom de la commande. Tous les jeux de caractères sont pris en charge. Le nom peut comporter jusqu'à 128 caractères.

testName

Description

string

Non

La description de la commande. Tous les jeux de caractères sont pris en charge. La description peut comporter jusqu'à 512 caractères.

test

Type

string

Oui

Le type de langage de la commande. Valeurs valides :

  • RunBatScript : commandes Bat pour les instances Windows.

  • RunPowerShellScript : commandes PowerShell pour les instances Windows.

  • RunShellScript : commandes Shell pour les instances Linux.

RunShellScript

CommandContent

string

Oui

Le contenu de la commande. Notez les points suivants :

  • Définissez EnableParameter sur true pour activer les paramètres personnalisés dans le contenu de la commande.

  • Définissez les paramètres personnalisés au format {{}}. Les espaces et les sauts de ligne avant et après les noms de paramètres dans {{}} sont ignorés.

  • Vous pouvez définir jusqu'à 20 paramètres personnalisés.

  • Les noms de paramètres personnalisés peuvent contenir des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (_). Les noms ne sont pas sensibles à la casse.

  • Un nom de paramètre personnalisé ne peut pas dépasser 64 octets.

ifconfig -s

WorkingDir

string

Non

Le répertoire dans lequel la commande est exécutée sur l'instance ECS.

Valeurs par défaut :

  • Pour les instances Linux : le répertoire personnel de l'utilisateur root, à savoir le répertoire /root.

  • Pour les instances Windows : le répertoire dans lequel se trouve le processus client Cloud Assistant, par exemple C:\Windows\System32.

/root/

Timeout

integer

Non

Le délai d'attente pour l'exécution de la commande sur l'instance de serveur, en secondes.

Lorsqu'une tâche de commande expire, Cloud Assistant arrête de force le processus de la tâche. Le délai d'attente doit être compris entre 10 et 86 400 secondes (24 heures).

Valeur par défaut : 60.

60

EnableParameter

boolean

Non

Indique si des paramètres personnalisés doivent être utilisés dans la commande.

Valeur par défaut : false.

false

Tag

array<object>

Non

Les balises. Vous pouvez ajouter jusqu'à 20 balises.

object

Non

La balise.

Key

string

Non

La clé de la balise N à ajouter à la commande. Valeurs valides de N : 1 à 20.

La clé de la balise ne peut pas être une chaîne vide. Elle peut comporter jusqu'à 64 caractères et ne peut pas commencer par aliyun ou acs:. Elle ne peut pas contenir http:// ou https://.

TestKey

Value

string

Non

La valeur de la balise N à ajouter à la commande. Valeurs valides de N : 1 à 20.

La valeur de la balise peut être une chaîne vide. Elle peut comporter jusqu'à 64 caractères et ne peut pas contenir http:// ou https://.

TestValue

ResourceGroupId

string

Non

L'identifiant du groupe de ressources.

rg-aek2bti7cf7****

Éléments de réponse

Élément

Type

Description

Exemple

object

Schéma de la réponse.

RequestId

string

L'identifiant de la requête.

20758A-585D-4A41-A9B2-28DA8F4****

CommandId

string

L'identifiant de la commande.

c-sh02yh0932w****

Exemples

JSON format

{
  "RequestId": "20758A-585D-4A41-A9B2-28DA8F4****",
  "CommandId": "c-sh02yh0932w****"
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.