Elastic Compute Service：ModifyInvocationAttribute - 修改雲助手命令的執行屬性

地區 ID。

地區 ID。

待修改任務的命令執行 ID。

待修改後的命令內容。命令內容可以是明文內容或 Base 64 編碼後的內容。您需要注意：

• 若建立待修改任務時選擇了儲存命令，命令內容在 Base 64 編碼後的大小不能超過 18 KB；若選擇了不儲存命令，命令內容在 Base 64 編碼後的大小不能超過 24 KB。

• 如果您的命令內容是 Base 64 編碼後的內容，則必須設定ContentEncoding=Base64。

• 指定參數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。通過調用本介面執行命令時，如需指定{{ACS::CommandId}}作為內建環境參數，需確保雲助手 Agent 不低於以下版本：

    • Linux：2.2.3.309

    • Windows：2.1.3.309

修改命令中是否包含自訂參數。

• 當您啟用自訂參數或修改自訂參數Parameters時，該參數需設定為true。

• 當您不修改自訂參數Parameters時，不設定該參數或設定為false。

命令中包含自訂參數時，修改執行命令時傳入的自訂參數的索引值對。

自訂參數的個數範圍為 0~10，且您需要注意：

• 鍵不允許為空白字串，最多支援 64 個字元。

• 值允許為空白字串。

• 自訂參數與原始命令內容在 Base 64 編碼後，若建立待修改任務時選擇了儲存命令，命令內容在 Base 64 編碼後的大小不能超過 18 KB；若選擇了不儲存命令，命令內容在 Base 64 編碼後的大小不能超過 24 KB。

• 設定的自訂參數名集合必須為建立命令時定義的參數集的子集。對於未傳入的參數，您可以使用Null 字元串代替。

預設值為空白，表示不涉及自訂參數索引值對的修改。

待修改的定時執行頻率。僅當RepeatMode為Period時生效。目前支援三種定時執行方式：固定時間間隔執行（基於 Rate 運算式）、僅在指定時間執行一次、基於時鐘定時執行（基於 Cron 運算式）。

• 固定時間間隔執行：基於 Rate 運算式，按照設定的時間間隔執行命令。時間間隔支援按秒（s） 、分鐘（m） 、小時（h）和天（d）來選擇，適用於在固定時間間隔執行任務的情境。格式為rate(<執行間隔數值><執行間隔單位>)，如 5 分鐘執行一次，格式為rate(5m)。使用固定時間間隔執行有以下限制：

  • 設定的時間間隔不大於 7 天、不小於 60 秒，且需大於建立定時任務時指定的逾時時間。

  • 執行間隔只基於固定頻率，與任務實際執行需要的時間無關。例如設定每 5 分鐘執行一次命令，任務需要 2 分鐘執行完成，則在任務完成 3 分鐘後繼續執行下一輪。

  • 按照任務的建立時間（參見DescribeInvocations返回的 CreationTime ，請注意不是修改時間）及修改後的執行間隔計算下一次執行時間。

• 僅在指定時間執行一次：按照設定的時區和執行時間點執行一次命令。格式為at(yyyy-MM-dd HH:mm:ss <時區>)，即at(年-月-日 時:分:秒 <時區>)。如果不指定時區，預設為 UTC 時區。時區支援以下三種形式：

  • 時區全稱： 如Asia/Shanghai（中國/上海時間）、America/Los_Angeles（美國/洛杉磯時間）等。

  • 時區相對于格林威治時間的位移量： 如GMT+8:00（東八區）、GMT-7:00（西七區）等。使用 GMT 格式時，小時位不支援添加前置字元為零。

  • 時區縮寫： 僅支援 UTC（國際標準時間間）。

  如果指定在中國/上海時間 2022 年 06 月 06 日 13 時 15 分 30 秒執行一次，格式為：at(2022-06-06 13:15:30 Asia/Shanghai)；如果指定在西七區 2022 年 06 月 06 日 13 時 15 分 30 秒執行一次，格式為：at(2022-06-06 13:15:30 GMT-7:00)。

• 基於時鐘定時執行（基於 Cron 運算式）：基於 Cron 運算式，按照設定的定時任務執行命令。格式為<秒> <分鐘> <小時> <日期> <月份> <星期> <年份（可選）> <時區>，即<Cron 運算式> <時區>。在指定的時區下，根據 Cron 運算式推算定時任務執行時間並執行。若不指定時區，預設為執行定時任務執行個體的系統內部時區。關於 Cron 運算式的更多資訊，請參見 Cron 運算式。時區支援以下三種形式：

  • 時區全稱： 如Asia/Shanghai（中國/上海時間）、America/Los_Angeles（美國/洛杉磯時間）等。

  • 時區相對于格林威治時間的位移量： 如GMT+8:00（東八區）、GMT-7:00（西七區）等。使用 GMT 格式時，小時位不支援添加前置字元為零。

  • 時區縮寫： 僅支援 UTC（國際標準時間間）。 例如，在中國/上海時間，2022 年每天上午 10:15 執行一次命令，格式為0 15 10 ? * * 2022 Asia/Shanghai；在東八區時間，2022 年每天上午 10:00 到 11:30 每隔半小時執行，格式為0 0/30 10-11 * * ? 2022 GMT+8:00；在 UTC 時間，從 2022 年開始，每隔兩年的 10 月每天下午 14:00 到下午 14:55 時間段內每隔 5 分鐘執行，格式為0 0/5 14 * 10 ? 2022/2 UTC。

  說明

  設定的最小時間間隔需大於或等於建立定時任務時指定的逾時時間，且不小於 10 秒。

命令內容（CommandContent）的編碼方式。取值範圍（不區分大小寫）：

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

• Base64：Base 64 編碼。

預設值：PlainText，填寫錯誤時會當作 PlainText 處理。

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