Elastic Compute Service：CreateCommand

地域 ID。您可以呼叫 DescribeRegions 查看最新的阿里雲地域列表。

命令名稱，支援全字元集。長度不得超過 128 個字元。

命令描述，支援全字元集。長度不得超過 512 個字元。

命令的類型。取值範圍：

• RunBatScript：建立一個在 Windows 執行個體中執行的 Bat 腳本。

• RunPowerShellScript：建立一個在 Windows 執行個體中執行的 PowerShell 腳本。

• RunShellScript：建立一個在 Linux 執行個體中執行的 Shell 腳本。

命令 Base64 編碼後的內容。

• 該參數的值必須使用 Base64 編碼後傳輸，且腳本內容的大小在 Base64 編碼之後不能超過 18 KB。

• 命令內容支援使用自訂參數形式，具體透過指定參數EnableParameter=true啟用自訂參數功能：

  • 自訂參數用{{}}包含的方式定義，在{{}}內參數名前後的空格以及換行符會被忽略。

  • 自訂參數個數不能超過 20 個。

  • 自訂參數名允許 a-zA-Z0-9-_ 的組合，不支援 acs:: 前綴指定非內建環境參數，不支援其餘字元，參數名不區分大小寫。

  • 單個參數名不能超過 64 位元組。

• 您可以指定內建環境參數作為自訂參數，執行命令時無需手動對參數賦值，雲端助手將為您自動替換為環境中對應的值。支援指定以下內建環境參數：

  • {{ACS::RegionId}}：地域 ID。

  • {{ACS::AccountId}}：阿里雲主帳號 UID。

  • {{ACS::InstanceId}}：執行個體 ID。命令下發到多個執行個體時，如需指定{{ACS::InstanceId}}作為內建環境參數，需確保雲端助手 Agent 不低於以下版本：

    • Linux：2.2.3.309

    • Windows：2.1.3.309

  • {{ACS::InstanceName}}：執行個體名稱。命令下發到多個執行個體時，如需指定{{ACS::InstanceName}}作為內建環境參數，需確保雲端助手 Agent 不低於以下版本：

    • Linux：2.2.3.344

    • Windows：2.1.3.344

  • {{ACS::InvokeId}}：命令執行 ID。如需指定{{ACS::InvokeId}}作為內建環境參數，需確保雲端助手 Agent 不低於以下版本：

    • Linux：2.2.3.309

    • Windows：2.1.3.309

  • {{ACS::CommandId}}：命令 ID。透過呼叫 RunCommand 介面執行命令時，如需指定{{ACS::CommandId}}作為內建環境參數，需確保雲端助手 Agent 不低於以下版本：

    • Linux：2.2.3.309

    • Windows：2.1.3.309。

您建立的命令在 ECS 執行個體中執行的目錄。長度不得超過 200 個字元。

預設值：

• Linux 執行個體：管理員 root 使用者的 home 目錄下，具體為/root目錄。

• Windows 執行個體：雲端助手 Agent 處理程序所在目錄，例如C:\Windows\System32。

您建立的命令在 ECS 執行個體中執行時最大的逾時時間，單位為秒。當因為某種原因無法執行您建立的命令時，會出現逾時現象。逾時後，會強制終止命令處理程序，即取消命令的 PID。

預設值：60。

建立的命令是否使用自訂參數。

預設值：false。

命令內容（CommandContent）的編碼方式。取值範圍：

• PlainText：不編碼，採用明文傳輸。

• Base64：Base64 編碼。

預設值：Base64。

保證請求冪等性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元，且不能超過 64 個字元。更多資訊，請參見如何保證冪等性。

命令所屬的資源群組 ID。

腳本執行的引導程式。長度不能超過 1 KB。