全部產品
Search

搜尋本產品

    Simple Application Server：CreateCommand - 建立命令

    文件中心

    Simple Application Server：CreateCommand - 建立命令

    更新時間：Nov 07, 2025

    建立一條命令助手命令。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    swas-open:CreateCommand

    create

    *Command

    acs:swas-open:{#regionId}:{#accountId}:command/*

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    地區 ID。您可以調用 ListRegions 查詢可用地區。

    cn-hangzhou
    Name

    string

    是

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

    testName
    Description

    string

    否

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

    test
    Type

    string

    是

    命令的語言類型。取值範圍：

    • RunBatScript：適用於 Windows 執行個體的 Bat 命令。

    • RunPowerShellScript：適用於 Windows 執行個體的 PowerShell 命令。

    • RunShellScript：適用於 Linux 執行個體 Shell 命令。

    RunShellScript
    CommandContent

    string

    是

    命令內容。您需要注意：

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

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

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

    • 自訂參數名允許 a-zA-Z0-9-_的組合，不支援其餘字元，參數名不區分大小寫。

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

    ifconfig -s
    WorkingDir

    string

    否

    您建立的命令在 ECS 執行個體中啟動並執行目錄。

    預設值：

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

    • Windows 執行個體：雲助手用戶端進程所在目錄，例如C:\Windows\System32。

    /root/
    Timeout

    integer

    否

    設定命令在伺服器執行個體中的逾時時間，單位為秒。

    當執行命令的任務逾時後，命令助手將強制終止任務進程。可設定逾時時間取值範圍為 10～86400 秒（24 小時）。

    預設值：60。

    60
    EnableParameter

    boolean

    否

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

    預設值為 false。

    false
    Tag

    array<object>

    否

    標籤列表，最多包含 20 個子項。

    object

    否

    標籤。

    Key

    string

    否

    為命令指定的標籤鍵。N 的取值範圍：1~20。

    一旦傳入該值，則不允許為空白字串。最多支援 64 個字元，不能以 aliyun 和 acs:開頭，不能包含 http://或者 https://。

    TestKey
    Value

    string

    否

    為命令指定的標籤值。N 的取值範圍：1~20。

    一旦傳入該值，可以為空白字串。最多支援 64 個字元，不能包含 http://或者 https://。

    TestValue
    ResourceGroupId

    string

    否

    資源群組 ID。

    rg-aek2bti7cf7****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response.

    RequestId

    string

    請求 ID。

    20758A-585D-4A41-A9B2-28DA8F4****
    CommandId

    string

    命令 ID。

    c-sh02yh0932w****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "20758A-585D-4A41-A9B2-28DA8F4****",
  "CommandId": "c-sh02yh0932w****"
}

    錯誤碼

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

    變更歷史

    更多資訊，參考變更詳情。