Elastic Compute Service：CreateCommand - 建立雲助手命令

地區 ID。您可以調用 DescribeRegions 查看最新的阿里雲地區列表。

地區 ID。您可以調用 DescribeRegions 查看最新的阿里雲地區列表。

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

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

命令的類型。取值範圍：

• RunBatScript：建立一個在 Windows 執行個體中啟動並執行 Bat 指令碼。

• RunPowerShellScript：建立一個在 Windows 執行個體中啟動並執行 PowerShell 指令碼。

• RunShellScript：建立一個在 Linux 執行個體中啟動並執行 Shell 指令碼。

命令 Base 64 編碼後的內容。

• 該參數的值必須使用 Base 64 編碼後傳輸，且指令碼內容的大小在 Base 64 編碼之後不能超過 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：Base 64 編碼。

預設值：Base64。

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

命令所屬的資源群組 ID。

指令碼執行的引導程式。長度不能超過 1 KB。