DescribeCommands - Elastic Compute Service

查詢您手動建立的雲端助手命令或阿里雲提供的公用命令。

介面說明

只輸入參數Action和RegionId，不輸入其他任何請求參數，則預設查詢您手動建立的所有可用的命令（CommandId）。
分頁查詢首頁時，僅需設定MaxResults以限制傳回資訊的條目數，傳回結果中的NextToken將作為查詢後續頁的憑證。查詢後續頁時，將NextToken參數設定為上一次傳回結果中獲取到的NextToken作為查詢憑證，並設定MaxResults限制傳回條目數。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ecs:DescribeCommands

get

Command

acs:ecs:{#regionId}:{#accountId}:command/*

Command

acs:ecs:{#regionId}:{#accountId}:command/{#commandId}

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	地域 ID。您可以呼叫 DescribeRegions 查看最新的阿里雲地域清單。	cn-hangzhou
Provider	string	否	公用命令的提供者。參數值的具體說明如下：當該參數不傳值時，預設查詢您手動建立的所有雲端助手命令。當該參數取值為`AlibabaCloud`時，查詢由阿里雲提供的所有公用命令。當該參數的取值為具體的公用命令提供者時，查詢該提供者提供的所有公用命令。例如：當`Provider=AlibabaCloud.ECS.GuestOS`時，查詢`AlibabaCloud.ECS.GuestOS`提供的公用命令。當`Provider=AlibabaCloud.ECS.GuestOSDiagnose`時，查詢`AlibabaCloud.ECS.GuestOSDiagnose`提供的公用命令。	AlibabaCloud
CommandId	string	否	命令 ID。	c-hz01272yr52****
Name	string	否	命令的名稱。當指定了`Provider`參數查詢公用命令時，預設支援模糊查詢。當未指定`Provider`參數查詢私有命令時，支援模糊查詢，例如輸入`command`，可以搜尋出所有名稱以`command`開頭的命令；輸入`command`，可以搜尋出所有名稱以`command`結尾的命令；輸入`command`，可以搜尋出所有名稱包含`command`的命令。	testName
Description	string	否	命令的描述。當指定了`Provider`參數查詢公用命令時，預設支援模糊查詢。當未指定`Provider`參數查詢私有命令時，支援模糊查詢，例如輸入`test`，可以搜尋出所有描述以`test`開頭的命令；例如輸入`test`，可以搜尋出所有描述以`test`結尾的命令；例如輸入`test`，可以搜尋出所有描述包含`test`的命令。	testDescription
Type	string	否	命令的類型。取值範圍： RunBatScript：命令為在 Windows 執行個體中執行的 Bat 指令碼。 RunPowerShellScript：命令為在 Windows 執行個體中執行的 PowerShell 指令碼。 RunShellScript：命令為在 Linux 執行個體中執行的 Shell 指令碼。	RunShellScript
ContentEncoding	string	否	設定傳回資料中`CommandContent`欄位和`Output`欄位的編碼方式。取值範圍： PlainText：傳回原始指令碼內容和輸出資訊。 Base64：傳回 Base64 編碼後的指令碼內容和輸出資訊。預設值為 Base64。	PlainText
PageNumber	integer	否	說明該參數即將淘汰，建議您使用 NextToken 與 MaxResults 完成分頁查詢操作。	1
PageSize	integer	否	說明該參數即將淘汰，建議您使用 NextToken 與 MaxResults 完成分頁查詢操作。	10
MaxResults	integer	否	分頁查詢時每頁的最大條目數。最大值為 50。預設值為 10。	10
NextToken	string	否	查詢憑證（Token），取值為上一次 API 呼叫傳回的 NextToken 參數值。	AAAAAdDWBF2
Latest	boolean	否	若查詢結果包含公用命令，是否只查詢最新版本的公用命令。該參數不影響私有命令的查詢。 true：只查詢最新版本的公用命令。 false：查詢所有版本的公用命令。預設值：false。	true
ResourceGroupId	string	否	命令所屬的資源群組 ID。	rg-123******
Tag	array<object>	否	標籤清單。
	object	否	標籤物件。
Key	string	否	命令的標籤鍵。N 的取值範圍為 1~20。一旦傳入該值，則不允許為空字串。使用一個標籤篩選資源，查詢到該標籤下的資源數量不能超過 1000 個；使用多個標籤篩選資源，查詢到同時綁定了多個標籤的資源數量不能超過 1000 個。如果資源數量超過 1000 個，您需要使用 ListTagResources 介面進行查詢。最多支援 64 個字元，不能以`aliyun`或`acs:`開頭，不能包含`http://`或`https://`。	TestKey
Value	string	否	命令的標籤值。N 的取值範圍為 1~20。該值可以為空字串。最多支援 128 個字元，不能包含`http://`或`https://`。	TestValue

返回參數

名稱	類型	描述	樣本值
	object
Commands	object
Command	array<object>	命令資料集。
	array<object>	命令物件。
Category	string	公用命令的類目。	“”
CommandContent	string	命令內容，以 Base64 編碼後傳輸。若 ContentEncoding 指定 PlainText，傳回原始指令碼內容。若 ContentEncoding 指定 Base64，傳回 Base64 編碼後的指令碼內容。	Y2QgL3Jvb3Q=
CommandId	string	命令 ID。	c-hz01272yr52****
CreationTime	string	命令建立時間。格式為 ISO 8601，時區為 UTC。	2020-11-17T06:52Z
Description	string	命令描述。	testDescription
EnableParameter	boolean	該命令是否啟用自訂參數。	true
InvokeTimes	integer	使用該命令建立的任務數。	2
Latest	boolean	公用命令是否是最新版本。如果多個命令屬於同一個`Provider`，且名稱與類目相同，則這些命令屬於同一個命令的不同版本。您手動建立的雲端助手命令不會傳回該值。	true
Launcher	string	指令碼執行的引導程式。長度不能超過 1 KB。	python3 -u {{ACS::ScriptFileName\|Ext(".py")}}
Name	string	命令名稱。	testName
ParameterDefinitions	object
ParameterDefinition	array<object>	自訂參數詳細資訊清單。
	array<object>	自訂參數物件。
DefaultValue	string	自訂參數的預設值。	https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm
Description	string	自訂參數描述。	雲端助手 Agent 安裝套件路徑
ParameterName	string	自訂參數名稱。	DownloadUrl
PatternRegex	string	自訂參數的正規表達式規則。	^[a-zA-Z0-9_-]{4,32}$
PossibleValues	object
PossibleValue	array	列舉類型自訂參數的可選值清單。
	string	列舉類型自訂參數的可選值。	"Linux","Windows"
Required	boolean	該自訂參數是否必填。 true：是。 false：否。預設值：false。	true
ParameterNames	object
ParameterName	array	透過建立命令時的 commandcontent 解析出的自訂參數名清單，以清單（list）的形式傳回。如未使用自訂參數功能，則傳回空值清單。
	string	自訂參數名。	['parameter1','parameter2']
Provider	string	公用命令的提供者。	AlibabaCloud.ECS.GuestOS
ResourceGroupId	string	命令所屬的資源群組 ID。	rg-123******
Tags	object
Tag	array<object>	命令的標籤資訊清單。
	object	命令的標籤資訊物件。
TagKey	string	命令的標籤鍵。	owner
TagValue	string	命令的標籤值。	zhangsan
Timeout	integer	逾時時間，單位：秒。	3600
Type	string	命令類型。	RunShellScript
Version	integer	公用命令的版本。如果多個命令屬於同一個`Provider`，且名稱與類目相同，則這些命令屬於同一個命令的不同版本。您手動建立的雲端助手命令不會傳回該值。	1
WorkingDir	string	執行路徑。	/home/
NextToken	string	本次呼叫傳回的查詢憑證值。	AAAAAdDWBF2
PageNumber	integer	命令清單頁碼。	1
PageSize	integer	每頁行數。	10
RequestId	string	請求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
TotalCount	integer	命令總個數。	5

樣本

正常返回樣本

JSON格式

{
  "Commands": {
    "Command": [
      {
        "Category": "“”",
        "CommandContent": "Y2QgL3Jvb3Q=",
        "CommandId": "c-hz01272yr52****",
        "CreationTime": "2020-11-17T06:52Z",
        "Description": "testDescription",
        "EnableParameter": true,
        "InvokeTimes": 2,
        "Latest": true,
        "Launcher": "python3 -u {{ACS::ScriptFileName|Ext(\".py\")}}\n",
        "Name": "testName",
        "ParameterDefinitions": {
          "ParameterDefinition": [
            {
              "DefaultValue": "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm",
              "Description": "雲端助手Agent安裝套件路徑",
              "ParameterName": "DownloadUrl",
              "PatternRegex": "^[a-zA-Z0-9_-]{4,32}$\u0000",
              "PossibleValues": {
                "PossibleValue": [
                  "\"Linux\",\"Windows\""
                ]
              },
              "Required": true
            }
          ]
        },
        "ParameterNames": {
          "ParameterName": [
            "['parameter1','parameter2']"
          ]
        },
        "Provider": "AlibabaCloud.ECS.GuestOS",
        "ResourceGroupId": "rg-123******",
        "Tags": {
          "Tag": [
            {
              "TagKey": "owner",
              "TagValue": "zhangsan"
            }
          ]
        },
        "Timeout": 3600,
        "Type": "RunShellScript",
        "Version": 1,
        "WorkingDir": "/home/"
      }
    ]
  },
  "NextToken": "AAAAAdDWBF2",
  "PageNumber": 1,
  "PageSize": 10,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "TotalCount": 5
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	RegionId.ApiNotSupported	The api is not supported in this region.	指定區域下不支援呼叫 API。請檢查 RegionId 參數取值是否正確。
400	NumberExceed.Tags	The Tags parameter number is exceed.	標籤個數超過最大限制，本操作最多可以操作 20 個標籤。
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	標籤中存在重複的鍵，請保持鍵的唯一性。
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	指定的標籤鍵參數有誤。
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	指定的標籤值參數有誤。
400	MissingParameter.TagKey	You must specify Tag.N.Key.	請指定標籤鍵。
400	InvalidParam.PageNumber	The specified parameter is invalid.
400	InvalidParam.PageSize	The specified parameter is invalid.
400	InvalidParameter.NextToken	The specified parameter NextToken is not valid.
400	InvalidParameter.MaxResults	The specified parameter MaxResults is not valid.	指定的參數MaxResults不合法。
500	InternalError.Dispatch	An error occurred when you dispatched the request.	傳送請求時發生錯誤，請稍後重試。
500	ServiceUnavailable	The request has failed due to a temporary failure of the server.
500	InternalError	The request processing has failed due to some unknown error.
403	Operation.Forbidden	The operation is not permitted.	該操作是不被允許的。
403	InvalidParameterCharacter	The specified parameter %s contains illegal characters.
403	InvalidName.LengthLimitExceeded	The length of the parameter Name exceeds the upper limit.
403	InvalidDescription.LengthLimitExceeded	The length of the parameter Description exceeds the upper limit.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	指定的 RegionId 不存在，請您檢查此產品在該地域是否可用。
404	InvalidCommandType.NotFound	The specified parameter Type does not exist.
404	InvalidCommandId.NotFound	The specified commandId does not exist

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

變更歷史

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