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

AI 助理
備案控制臺(tái)
文檔
產(chǎn)品文檔
輸入文檔關(guān)鍵字查找
首頁 云服務(wù)器 ECS 開發(fā)參考 API參考（ECS） API目錄 云助手 CreateCommand - 新建一條云助手命令

CreateCommand - 新建一條云助手命令

更新時(shí)間：
一鍵部署
產(chǎn)品詳情
相關(guān)技術(shù)圈
我的收藏

調(diào)用CreateCommand接口，并指定Name、Type、CommandContent等參數(shù)，新建一條Shell、PowerShell或者Bat腳本類型的云助手命令。

接口說明

  • 您可以創(chuàng)建以下類型的命令：
    • Windows 實(shí)例適用的 Bat 腳本（RunBatScript）。
    • Windows 實(shí)例適用的 PowerShell 腳本（RunPowerShellScript）。
    • Linux 實(shí)例適用的 Shell 腳本（RunShellScript）。
  • 您可以通過指定參數(shù) Timeout 為命令設(shè)置在 ECS 實(shí)例中執(zhí)行時(shí)最大的超時(shí)時(shí)間，命令執(zhí)行超時(shí)后，云助手 Agent會(huì)強(qiáng)制終止命令進(jìn)程，即取消命令的 PID。
    • 對(duì)于單次執(zhí)行，超時(shí)后，該命令針對(duì)指定的 ECS 實(shí)例的執(zhí)行狀態(tài)（ InvokeRecordStatus ）變?yōu)閳?zhí)行失?。‵ailed）。
    • 對(duì)于定時(shí)執(zhí)行：
      • 定時(shí)執(zhí)行的超時(shí)時(shí)間對(duì)每一次執(zhí)行記錄均有效。
      • 某次執(zhí)行超時(shí)后，該次執(zhí)行記錄的狀態(tài)（ InvokeRecordStatus ）變?yōu)閳?zhí)行失?。‵ailed）。
      • 上次執(zhí)行超時(shí)與否不影響下一次執(zhí)行。
  • 在一個(gè)地域下，您最多可以保有 500～50,000 條云助手命令，您也可以申請(qǐng)?zhí)嵘漕~，關(guān)于如何查詢及提升配額，請(qǐng)參見配額管理。
  • 您可以通過指定參數(shù) WorkingDir 為命令指定執(zhí)行路徑。對(duì)于 Linux 實(shí)例，默認(rèn)在管理員 root 用戶的 home 目錄下，具體為/root目錄。對(duì)于 Windows 實(shí)例，默認(rèn)在云助手 Agent 進(jìn)程所在目錄，例如：C:\Windows\System32。
  • 您可以通過指定參數(shù) EnableParameter=true 啟用自定義參數(shù)功能。在設(shè)置 CommandContent 時(shí)可以通過{{parameter}}的形式表示自定義參數(shù)，并在運(yùn)行命令（ InvokeCommand ）時(shí)，傳入自定義參數(shù)鍵值對(duì)。例如，您在創(chuàng)建命令時(shí)，創(chuàng)建了echo {{name}}命令，在 InvokeCommand 時(shí)，通過 Parameters 參數(shù)傳入鍵值對(duì)<name, Jack>。則自定義參數(shù)將自動(dòng)替換命令，您會(huì)得到一條新的命令，并在實(shí)例中執(zhí)行echo Jack。

調(diào)試

您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。

授權(quán)信息

下表是API對(duì)應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：

  • 操作：是指具體的權(quán)限點(diǎn)。
  • 訪問級(jí)別：是指每個(gè)操作的訪問級(jí)別，取值為寫入（Write）、讀取（Read）或列出（List）。
  • 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
    • 對(duì)于必選的資源類型，用背景高亮的方式表示。
    • 對(duì)于不支持資源級(jí)授權(quán)的操作，用全部資源表示。
  • 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
  • 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
操作訪問級(jí)別資源類型條件關(guān)鍵字關(guān)聯(lián)操作
ecs:CreateCommandcreate
  • Command
    acs:ecs:{#regionId}:{#accountId}:command/*
    無
無

請(qǐng)求參數(shù)

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

地域 ID。您可以調(diào)用 DescribeRegions 查看最新的阿里云地域列表。

cn-hangzhou
Namestring是

命令名稱，支持全字符集。長度不得超過 128 個(gè)字符。

testName
Descriptionstring否

命令描述，支持全字符集。長度不得超過 512 個(gè)字符。

testDescription
Typestring是

命令的類型。取值范圍：

  • RunBatScript：創(chuàng)建一個(gè)在 Windows 實(shí)例中運(yùn)行的 Bat 腳本。
  • RunPowerShellScript：創(chuàng)建一個(gè)在 Windows 實(shí)例中運(yùn)行的 PowerShell 腳本。
  • RunShellScript：創(chuàng)建一個(gè)在 Linux 實(shí)例中運(yùn)行的 Shell 腳本。
RunShellScript
CommandContentstring是

命令 Base64 編碼后的內(nèi)容。

  • 該參數(shù)的值必須使用 Base64 編碼后傳輸，且腳本內(nèi)容的大小在 Base64 編碼之后不能超過 18 KB。

  • 命令內(nèi)容支持使用自定義參數(shù)形式，具體通過指定參數(shù)EnableParameter=true啟用自定義參數(shù)功能：

    • 自定義參數(shù)用{{}}包含的方式定義，在{{}}內(nèi)參數(shù)名前后的空格以及換行符會(huì)被忽略。
    • 自定義參數(shù)個(gè)數(shù)不能超過 20 個(gè)。
    • 自定義參數(shù)名允許 a-zA-Z0-9-_的組合，不支持 acs::前綴指定非內(nèi)置環(huán)境參數(shù)，不支持其余字符，參數(shù)名不區(qū)分大小寫。
    • 單個(gè)參數(shù)名不能超過 64 字節(jié)。

  • 您可以指定內(nèi)置環(huán)境參數(shù)作為自定義參數(shù)，執(zhí)行命令時(shí)無需手動(dòng)對(duì)參數(shù)賦值，云助手將為您自動(dòng)替換為環(huán)境中對(duì)應(yīng)的值。支持指定以下內(nèi)置環(huán)境參數(shù)：

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

    • {{ACS::AccountId}}：阿里云主賬號(hào) UID。

    • {{ACS::InstanceId}}：實(shí)例 ID。命令下發(fā)到多個(gè)實(shí)例時(shí)，如需指定{{ACS::InstanceId}}作為內(nèi)置環(huán)境參數(shù)，需確保云助手 Agent 不低于以下版本：

      • Linux：2.2.3.309
      • Windows：2.1.3.309

    • {{ACS::InstanceName}}：實(shí)例名稱。命令下發(fā)到多個(gè)實(shí)例時(shí)，如需指定{{ACS::InstanceName}}作為內(nèi)置環(huán)境參數(shù)，需確保云助手 Agent 不低于以下版本：

      • Linux：2.2.3.344
      • Windows：2.1.3.344

    • {{ACS::InvokeId}}：命令執(zhí)行 ID。如需指定{{ACS::InvokeId}}作為內(nèi)置環(huán)境參數(shù)，需確保云助手 Agent 不低于以下版本：

      • Linux：2.2.3.309
      • Windows：2.1.3.309

    • {{ACS::CommandId}} ：命令 ID。通過調(diào)用 RunCommand 接口執(zhí)行命令時(shí)，如需指定{{ACS::CommandId}}作為內(nèi)置環(huán)境參數(shù)，需確保云助手 Agent 不低于以下版本：

      • Linux：2.2.3.309
      • Windows：2.1.3.309
ZWNobyAxMjM=
WorkingDirstring否

您創(chuàng)建的命令在 ECS 實(shí)例中運(yùn)行的目錄。長度不得超過 200 個(gè)字符。

默認(rèn)值：

  • Linux 實(shí)例：管理員 root 用戶的 home 目錄下，具體為/root目錄。
  • Windows 實(shí)例：云助手 Agent 進(jìn)程所在目錄，例如C:\Windows\System32。
說明 設(shè)置為其他目錄時(shí)，請(qǐng)確保實(shí)例中存在該目錄。
/home/user
Timeoutlong否

您創(chuàng)建的命令在 ECS 實(shí)例中執(zhí)行時(shí)最大的超時(shí)時(shí)間，單位為秒。當(dāng)因?yàn)槟撤N原因無法運(yùn)行您創(chuàng)建的命令時(shí)，會(huì)出現(xiàn)超時(shí)現(xiàn)象。超時(shí)后，會(huì)強(qiáng)制終止命令進(jìn)程，即取消命令的 PID。

默認(rèn)值：60。

60
EnableParameterboolean否

創(chuàng)建的命令是否使用自定義參數(shù)。

默認(rèn)值：false。

false
ContentEncodingstring否

命令內(nèi)容（CommandContent）的編碼方式。取值范圍：

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

  • Base64：Base64 編碼。

默認(rèn)值：Base64。

說明 錯(cuò)填該取值會(huì)當(dāng)作 Base64 處理。
PlainText
ResourceGroupIdstring否

命令所屬的資源組 ID。

rg-123******
Tagarray<object>否

標(biāo)簽列表。

object否

標(biāo)簽列表。

Keystring否

命令的標(biāo)簽鍵。N 的取值范圍為 1~20。一旦傳入該值，則不允許為空字符串。

使用一個(gè)標(biāo)簽過濾資源，查詢到該標(biāo)簽下的資源數(shù)量不能超過 1000 個(gè)。使用多個(gè)標(biāo)簽過濾資源，查詢到同時(shí)綁定了多個(gè)標(biāo)簽的資源數(shù)量不能超過 1000 個(gè)。如果資源數(shù)量超過 1000 個(gè)，您需要使用 ListTagResources 接口進(jìn)行查詢。

最多支持 64 個(gè)字符，不能以aliyun或acs:開頭，不能包含http://或https://。

TestKey
Valuestring否

命令的標(biāo)簽值。N 的取值范圍為 1~20。該值可以為空字符串。

最多支持 128 個(gè)字符，不能包含http://或https://。

TestValue

返回參數(shù)

名稱類型描述示例值
object
CommandIdstring

命令 ID。

c-7d2a745b412b4601b2d47f6a768d****
RequestIdstring

請(qǐng)求 ID。

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

示例

正常返回示例

JSON格式

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

錯(cuò)誤碼

HTTP status code錯(cuò)誤碼錯(cuò)誤信息描述
400RegionId.ApiNotSupportedThe api is not supported in this region.指定地域下不支持調(diào)用 API。請(qǐng)檢查 RegionId 參數(shù)取值是否正確。
400CmdParam.EmptyKeyYou must specify the parameter names.請(qǐng)檢查您的參數(shù)是否完整，是否有參數(shù)名未填寫的情況。
400CmdParam.InvalidParamNameInvalid parameter name. The name can contain only lowercase letters (a to z), uppercase letters (A to Z), numbers (0 to 9), hyphens (-), and underscores (_).自定義參數(shù)的參數(shù)名無效，只允許 a-zA-Z0-9-_ 的組合。
400CmdContent.DecodeErrorThe CommandContent can not be base64 decoded.命令內(nèi)容無法通過Base64解碼。
400InvalidParameter.WorkingDirThe specified parameter WorkingDir is not valid.指定的參數(shù)WorkingDir不合法。
403CmdContent.ExceedLimitThe length of the command content exceeds the upper limit.命令內(nèi)容長度超過上限。
403CmdName.ExceedLimitThe length of the command name exceeds the upper limit.命令名稱長度超過上限。
403CmdDesc.ExceedLimitThe length of the command description exceeds the upper limit.命令描述長度超過上限。
403CmdCount.ExceedQuotaThe total number of commands in the current region exceeds the quota.當(dāng)前地域下的云助手命令數(shù)量已超出限制。
403CmdParamCount.ExceedLimitThe maximum number of custom parameters is exceeded.參數(shù)數(shù)量超出最大可設(shè)置數(shù)量。
403CmdParamName.ExceedLimitThe maximum length of a parameter name is exceeded.您的自定義參數(shù)的參數(shù)名長度超過限制。
403Operation.ForbiddenThe operation is not permitted.該操作是不被允許的。
403InvalidStatus.ResourceGroupYou cannot perform an operation on a resource group that is being created or deleted.資源組正在創(chuàng)建或刪除時(shí)不允許操作。
403InvalidParameterCharacter.CommandNameThe command Name contains illegal characters.命令名稱包含非法字符。
403InvalidParameterCharacter.CommandDescriptionThe command Description contains illegal characters.命令描述包含非法字符。
403InvalidParameterCharacter.CommandWorkingDirThe command WorkingDir contains illegal characters.命令執(zhí)行路徑包含非法字符。
404InvalidCmdType.NotFoundThe specified command type does not exist.指定的命令類型不存在。
404InvalidRegionId.NotFoundThe RegionId provided does not exist in our records.提供的RegionId不存在
404InvalidResourceGroup.NotFoundThe ResourceGroup provided does not exist in our records.資源組并不在記錄中。
500InternalError.DispatchAn error occurred when you dispatched the request.發(fā)送請(qǐng)求時(shí)發(fā)生錯(cuò)誤，請(qǐng)稍后重試。

訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。

變更歷史

變更時(shí)間變更內(nèi)容概要操作
2024-05-11OpenAPI 錯(cuò)誤碼發(fā)生變更查看變更詳情
2023-10-24OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更查看變更詳情
2023-05-12OpenAPI 錯(cuò)誤碼發(fā)生變更查看變更詳情
2022-02-25OpenAPI 錯(cuò)誤碼發(fā)生變更查看變更詳情