日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

ModifyInvocationAttribute - 修改云助手命令的執(zhí)行屬性

修改云助手定時任務的執(zhí)行信息,包括命令內容、定時執(zhí)行方式、添加ECS實例或托管實例到任務。

接口說明

  • 支持修改以下執(zhí)行方式的任務(參見 DescribeInvocations 返回的RepeatMode值):
    • Period:周期執(zhí)行。
    • NextRebootOnly:當實例下一次啟動時,自動執(zhí)行命令。
    • EveryReboot:實例每一次啟動都將自動執(zhí)行命令。
  • 支持修改以下狀態(tài)的任務(參見 DescribeInvocations 返回的InvocationStatus值):
    • Pending:系統(tǒng)正在校驗或發(fā)送命令。存在至少一臺實例的命令執(zhí)行狀態(tài)為 Pending,則總執(zhí)行狀態(tài)為 Pending。
    • Running:命令正在實例上運行。存在至少一臺實例的命令執(zhí)行狀態(tài)為 Running,則總執(zhí)行狀態(tài)為 Running。
    • Scheduled:定時執(zhí)行的命令已發(fā)送,等待運行。存在至少一臺實例的命令執(zhí)行狀態(tài)為 Scheduled,則總執(zhí)行狀態(tài)為 Scheduled。
    • Stopping:正在停止任務。存在至少一臺實例的命令執(zhí)行狀態(tài)為 Stopping,則總執(zhí)行狀態(tài)為 Stopping。
  • 修改定時任務執(zhí)行信息(包括命令內容、自定義參數、執(zhí)行頻率)前,已執(zhí)行的 ECS 實例或托管實例的云助手 Agent 版本需要高于以下對應的版本。
    • Linux:2.2.3.541
    • Windows:2.1.3.541
    • 如果調用結果返回InvalidOperation.CloudAssistantVersionUnsupported錯誤碼,請將云助手 Agent 更新至最新版本。
  • 當您執(zhí)行一個云助手公共命令時,無法修改命令內容CommandContent
  • 當您修改了命令內容CommandContent,且調用 InvokeCommand 或調用 RunCommand 時設置KeepCommandtrue創(chuàng)建任務,將會新增一條命令并長期保留,并占用云助手命令配額;在一個地域下,您最多可以保有 500~50,000 條云助手命令。您也可以申請?zhí)嵘漕~,關于如何查詢及提升配額,請參見配額管理

調試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

授權信息

下表是API對應的授權信息,可以在RAM權限策略語句的Action元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:

  • 操作:是指具體的權限點。
  • 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
  • 資源類型:是指操作中支持授權的資源類型。具體說明如下:
    • 對于必選的資源類型,用背景高亮的方式表示。
    • 對于不支持資源級授權的操作,用全部資源表示。
  • 條件關鍵字:是指云產品自身定義的條件關鍵字。
  • 關聯(lián)操作:是指成功執(zhí)行操作所需要的其他權限。操作者必須同時具備關聯(lián)操作的權限,操作才能成功。
操作訪問級別資源類型條件關鍵字關聯(lián)操作
ecs:ModifyInvocationAttributeupdate
*Invocation
acs:ecs:{#regionId}:{#accountId}:invocation/{#invocationId}
*Instance
acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

請求參數

名稱類型必填描述示例值
RegionIdstring

地域 ID。

cn-hangzhou
InstanceIdarray

待加入任務的 ECS 實例 ID 或托管實例 ID。

string

待加入任務的 ECS 實例 ID 或托管實例 ID。待加入的實例數量與已執(zhí)行的實例數量總和不得超過 100。

i-bp1i7gg30r52z2em****
InvokeIdstring

待修改任務的命令執(zhí)行 ID。

t-hz0jdfwd9f****
CommandContentstring

待修改后的命令內容。命令內容可以是明文內容或 Base64 編碼后的內容。您需要注意:

  • 若創(chuàng)建待修改任務時選擇了保存命令,命令內容在 Base64 編碼后的大小不能超過 18 KB;若選擇了不保存命令,命令內容在 Base64 編碼后的大小不能超過 24 KB。

  • 如果您的命令內容是 Base64 編碼后的內容,則必須設置ContentEncoding=Base64

  • 指定參數EnableParameter=true可在命令內容中啟用自定義參數功能:

    • {{}}包含的方式定義自定義參數,在{{}}內參數名前后的空格以及換行符會被忽略。
    • 自定義參數個數不能超過 20 個。
    • 自定義參數名允許 a-zA-Z0-9-_的組合,不支持 acs::前綴指定非內置環(huán)境參數,不支持其余字符,參數名不區(qū)分大小寫。
    • 單個自定義參數名不能超過 64 字節(jié)。
  • 您可以指定內置環(huán)境參數作為自定義參數,執(zhí)行命令時無需手動對參數賦值,云助手將為您自動替換為環(huán)境中對應的值。支持指定以下內置環(huán)境參數:

    • {{ACS::RegionId}}:地域 ID。
    • {{ACS::AccountId}}:阿里云主賬號 UID。
    • {{ACS::InstanceId}}:實例 ID。命令下發(fā)到多個實例時,如需指定{{ACS::InstanceId}}作為內置環(huán)境參數,需確保云助手 Agent 不低于以下版本:
      • Linux:2.2.3.309
      • Windows:2.1.3.309
    • {{ACS::InstanceName}}:實例名稱。命令下發(fā)到多個實例時,如需指定{{ACS::InstanceName}}作為內置環(huán)境參數,需確保云助手 Agent 不低于以下版本:
      • Linux:2.2.3.344
      • Windows:2.1.3.344
    • {{ACS::InvokeId}}:命令執(zhí)行 ID。如需指定{{ACS::InvokeId}}作為內置環(huán)境參數,需確保云助手 Agent 不低于以下版本:
      • Linux:2.2.3.309
      • Windows:2.1.3.309
    • {{ACS::CommandId}}:命令 ID。通過調用本接口執(zhí)行命令時,如需指定{{ACS::CommandId}}作為內置環(huán)境參數,需確保云助手 Agent 不低于以下版本:
      • Linux:2.2.3.309
      • Windows:2.1.3.309
ZWNobyAxMjM=
EnableParameterboolean

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

  • 當您啟用自定義參數或修改自定義參數Parameters時,該參數需設置為true
  • 當您不修改自定義參數Parameters時,不設置該參數或設置為false
false
Parametersobject

命令中包含自定義參數時,修改執(zhí)行命令時傳入的自定義參數的鍵值對。

自定義參數的個數范圍為 0~10,且您需要注意:

  • 鍵不允許為空字符串,最多支持 64 個字符。
  • 值允許為空字符串。
  • 自定義參數與原始命令內容在 Base64 編碼后,若創(chuàng)建待修改任務時選擇了保存命令,命令內容在 Base64 編碼后的大小不能超過 18 KB;若選擇了不保存命令,命令內容在 Base64 編碼后的大小不能超過 24 KB。
  • 設置的自定義參數名集合必須為創(chuàng)建命令時定義的參數集的子集。對于未傳入的參數,您可以使用空字符串代替。

默認值為空,表示不涉及自定義參數鍵值對的修改。

{"name":"Jack", "accessKey":"LTAIdyvdIqaRY****"}
Frequencystring

待修改的定時執(zhí)行頻率。僅當RepeatModePeriod時生效。目前支持三種定時執(zhí)行方式:固定時間間隔執(zhí)行(基于 Rate 表達式)、僅在指定時間執(zhí)行一次、基于時鐘定時執(zhí)行(基于 Cron 表達式)。

  • 固定時間間隔執(zhí)行:基于 Rate 表達式,按照設置的時間間隔執(zhí)行命令。時間間隔支持按秒(s) 、分鐘(m) 、小時(h)和天(d)來選擇,適用于在固定時間間隔執(zhí)行任務的場景。格式為rate(<執(zhí)行間隔數值><執(zhí)行間隔單位>),如 5 分鐘執(zhí)行一次,格式為rate(5m)。使用固定時間間隔執(zhí)行有以下限制:

    • 設置的時間間隔不大于 7 天、不小于 60 秒,且需大于創(chuàng)建定時任務時指定的超時時間。
    • 執(zhí)行間隔只基于固定頻率,與任務實際執(zhí)行需要的時間無關。例如設置每 5 分鐘執(zhí)行一次命令,任務需要 2 分鐘執(zhí)行完成,則在任務完成 3 分鐘后繼續(xù)執(zhí)行下一輪。
    • 按照任務的創(chuàng)建時間(參見DescribeInvocations返回的 CreationTime ,請注意不是修改時間)及修改后的執(zhí)行間隔計算下一次執(zhí)行時間。
  • 僅在指定時間執(zhí)行一次:按照設置的時區(qū)和執(zhí)行時間點執(zhí)行一次命令。格式為at(yyyy-MM-dd HH:mm:ss <時區(qū)>),即at(年-月-日 時:分:秒 <時區(qū)>)。如果不指定時區(qū),默認為 UTC 時區(qū)。時區(qū)支持以下三種形式:

    • 時區(qū)全稱: 如Asia/Shanghai(中國/上海時間)、America/Los_Angeles(美國/洛杉磯時間)等。
    • 時區(qū)相對于格林威治時間的偏移量: 如GMT+8:00(東八區(qū))、GMT-7:00(西七區(qū))等。使用 GMT 格式時,小時位不支持添加前導零。
    • 時區(qū)縮寫: 僅支持 UTC(協(xié)調世界時間)。

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

  • 基于時鐘定時執(zhí)行(基于 Cron 表達式):基于 Cron 表達式,按照設置的定時任務執(zhí)行命令。格式為<秒> <分鐘> <小時> <日期> <月份> <星期> <年份(可選)> <時區(qū)>,即<Cron 表達式> <時區(qū)>。在指定的時區(qū)下,根據 Cron 表達式推算定時任務執(zhí)行時間并執(zhí)行。若不指定時區(qū),默認為執(zhí)行定時任務實例的系統(tǒng)內部時區(qū)。關于 Cron 表達式的更多信息,請參見 Cron 表達式。時區(qū)支持以下三種形式:

    • 時區(qū)全稱: 如Asia/Shanghai(中國/上海時間)、America/Los_Angeles(美國/洛杉磯時間)等。

    • 時區(qū)相對于格林威治時間的偏移量: 如GMT+8:00(東八區(qū))、GMT-7:00(西七區(qū))等。使用 GMT 格式時,小時位不支持添加前導零。

    • 時區(qū)縮寫: 僅支持 UTC(協(xié)調世界時間)。 例如,在中國/上海時間,2022 年每天上午 10:15 執(zhí)行一次命令,格式為0 15 10 ? * * 2022 Asia/Shanghai;在東八區(qū)時間,2022 年每天上午 10:00 到 11:30 每隔半小時執(zhí)行,格式為0 0/30 10-11 * * ? 2022 GMT+8:00;在 UTC 時間,從 2022 年開始,每隔兩年的 10 月每天下午 14:00 到下午 14:55 時間段內每隔 5 分鐘執(zhí)行,格式為0 0/5 14 * 10 ? 2022/2 UTC

    說明 設置的最小時間間隔需大于或等于創(chuàng)建定時任務時指定的超時時間,且不小于 10 秒。
0 */20 * * * *
ContentEncodingstring

命令內容(CommandContent)的編碼方式。取值范圍(不區(qū)分大小寫):

  • PlainText:不編碼,采用明文傳輸。
  • Base64:Base64 編碼。

默認值:PlainText,填寫錯誤時會當作 PlainText 處理。

PlainText

返回參數

名稱類型描述示例值
object
RequestIdstring

請求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
CommandIdstring

命令 ID。

  • 只有CommandContent發(fā)生變更,才新增一條命令,返回新增的CommandId
  • CommandContent未變更時,不會新增命令,將返回當前正在執(zhí)行命令的CommandId
  • 若調用 InvokeCommand ,或調用 RunCommand 時選擇了KeepCommandtrue,將會保留新增的命令;否則執(zhí)行完成或手動停止任務時,將刪除任務所有關聯(lián)的命令。
c-hz01272yr52****

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "CommandId": "c-hz01272yr52****"
}

錯誤碼

HTTP status code錯誤碼錯誤信息描述
400InvalidParameter.FrequencyThe specified parameter Frequency is not valid.指定的參數Frequency不合法。
400InvalidParameters.KeyDuplicateThe key in the parameter Parameters cannot be duplicated.參數Parameters中的鍵不能重復。
400InvalidParameters.KeyNotMatchThe key in the parameter Parameters do not match those defined when creating the command.參數Parameters中的鍵與創(chuàng)建命令時定義的不匹配。
400InvalidParameters.KeyMalformedThe key in the parameter Parameters is not valid.參數Parameters中的鍵不合法。
400InvalidParameters.KeyEmptyThe key in the parameter Parameters cannot be empty.參數Parameters中的鍵不能為空。
400InvalidCommandContent.DecodeErrorThe specified parameter CommandContent can not be Base64 decoded.參數CommandContent無法通過Base64解碼。
403InvalidInstanceId.OSTypeUnsupportedThe OS type of the instance corresponding to the parameter InstanceId does not support the specified command type.參數InstanceId對應實例的操作系統(tǒng)類型不支持指定的命令類型。
403InvalidOperation.RepeatModeUnsupportedThe operation is not supported for current repeat mode of invocation.當前命令執(zhí)行的方式不支持該操作。
403InvalidOperation.InvokeAlreadyFinishedThe operation is not supported for finished invocation.已執(zhí)行完成的任務不支持該操作。
403InvalidOperation.CloudAssistantVersionUnsupportedThe operation is not supported for current CloudAssistant version of instance.當前實例的云助手版本不支持該操作。
403InvalidOperation.ModifyPublicCommandUnsupportedModification of the content of Public Command is not supported.不支持修改公共命令的內容。
403InvalidCommandContent.LengthLimitExceededThe length of the parameter CommandContent exceeds the limit of %s KB characters.-
403InvalidParameters.CountLimitExceededThe count of the parameter Parameters exceeds the limit of 10.參數Parameters的數量超過了10的限制。
403InvalidParameters.KeyLengthLimitExceededThe length of the key in the parameter Parameters exceeds the limit of 64 characters.參數Parameters中鍵的長度超過了64個字符的限制。
403InvalidInstanceId.CountLimitExceededThe count of the parameter InstanceId exceeds the limit of %s.-
403CommandLimitExceededThe count of command in current region exceeds the limit of %s.-
403InvalidParameters.ValueTypeUnsupportedThe type of the value in the parameter Parameters is not supported.不支持參數Parameters中值的類型。
404InvalidInvokeId.NotFoundThe specified parameter InvokeId does not exist.指定的命令執(zhí)行ID不存在。
404InvalidInstanceId.NotFoundThe specified parameter InstanceId does not exist.指定的實例ID不存在。
404InvalidRegionId.NotFoundThe specified parameter RegionId does not exist.指定的地域ID不存在。
500InternalErrorAn error occurred when you dispatched the request.發(fā)送請求時發(fā)生錯誤,請稍后重試。

訪問錯誤中心查看更多錯誤碼。

變更歷史

變更時間變更內容概要操作
2024-12-05OpenAPI 錯誤碼發(fā)生變更查看變更詳情
2024-04-03OpenAPI 錯誤碼發(fā)生變更查看變更詳情