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

DescribeInvocationResults - 查詢云助手命令執行結果

調用DescribeInvocationResults查看一條或多條云助手命令的執行結果,即在ECS實例中的實際執行結果。

接口說明

  • 當您執行命令后,不代表命令一定成功執行,并且一定有預期的命令效果。您需要通過本接口查看實際的具體執行結果,以實際輸出結果為準。

  • 您可以查詢最近 4 周的執行信息,執行信息的保留上限為 10 萬條。

  • 您可以通過云助手任務狀態事件訂閱的方式,通過事件獲取任務結果,避免頻繁輪詢,用以提升效率。

  • 分頁查詢首頁時,僅需設置MaxResults以限制返回信息的條目數,返回結果中的NextToken將作為查詢后續頁的憑證。查詢后續頁時,將NextToken參數設置為上一次返回結果中獲取到的NextToken作為查詢憑證,并設置MaxResults限制返回條目數。

  • DescribeInvocationsDescribeInvocationResults差異點:

    • 當一次RunCommand/InvokeCommand調用指定有多個實例時:
      • 使用DescribeInvocations可以獲得任務在各個實例上的執行狀態、多個實例任務狀態的聚合狀態;
      • 使用DescribeInvocationResults僅能獲得各個實例上的單獨的執行狀態,不包含多實例的聚合狀態;
    • 當一次RunCommand/InvokeCommand調用指定有一個實例時:
      • DescribeInvocationsDescribeInvocationResults區別不大,完全可以互相替換。
    • 當需要查看定時性(周期性)任務、開機自動執行任務(RepeatMode=Period, EveryReboot)的每一次執行情況時,僅能用DescribeInvocationResults可以查詢獲得執行的過往歷史記錄(需指定IncludeHistory=true),而DescribeInvocations僅支持返回最新的任務狀態。
    • 當需要查看命令的內容、參數時,僅有DescribeInvocations返回CommandContent

調試

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

授權信息

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

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

請求參數

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

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

cn-hangzhou
ResourceGroupIdstring

命令執行的資源組 ID。傳入該參數后,需要在執行命令時指定 ResourceGroupId,支持篩選出對應的命令執行結果。

rg-bp67acfmxazb4p****
InvokeIdstring

命令執行 ID。您可以通過接口 DescribeInvocations 查詢 InvokeId。

t-hz0jdfwd9f****
InstanceIdstring

實例 ID。

i-bp1i7gg30r52z2em****
CommandIdstring

命令 ID。

c-hz0jdfwcsr****
InvokeRecordStatusstring

命令執行狀態。取值范圍:

  • Running:運行中。
    • 定時執行:未手動停止定時執行命令前,執行狀態一直為進行中。
    • 單次執行:一旦有進行中的命令進程,總的執行狀態就為進行中。
  • Finished:已完成。
    • 定時執行:命令進程不可能為執行完成。
    • 單次執行:所有實例全部完成執行。或者手動停止部分實例的命令進程,其余實例全部執行完成。
  • Success:
    • 單次執行的命令:命令執行完成,且退出碼為 0。
    • 定時執行的命令:上一次執行成功且退出碼為 0,且指定的執行時間已結束。
  • Failed:執行失敗。
    • 定時執行:命令進程不可能為執行失敗。
    • 單次執行:所有實例全部執行失敗。
  • PartialFailed:部分執行失敗。
    • 定時執行:命令進程不可能為部分失敗。
    • 單次執行:部分實例有執行失敗的命令進程,則總執行狀態為部分失敗。
  • Stopped:命令執行已停止。
  • Stopping:正在停止執行的命令。
Running
IncludeHistoryboolean

是否返回命令定時執行的歷史記錄。取值范圍:

  • true:表示返回命令定時執行的結果。當取值為 true 時,參數 InvokeId 的取值不能為空,且必須為定時執行(RepeatMode 為 Period)或系統每一次啟動后執行(RepeatMode 為 EveryReboot)的命令執行 ID。
  • false:表示不返回。

默認值為 false。

false
ContentEncodingstring

設置返回數據中CommandContent字段和Output字段的編碼方式,取值范圍:

  • PlainText:返回原始命令內容和輸出信息。
  • Base64:返回 Base64 編碼后的命令內容和輸出信息。

默認值為 Base64。

PlainText
PageNumberlong
說明 該參數即將下線,推薦您使用 NextToken 與 MaxResults 完成分頁查詢操作。
1
PageSizelong
說明 該參數即將下線,推薦您使用 NextToken 與 MaxResults 完成分頁查詢操作。
1
MaxResultsinteger

分頁查詢時每頁的最大條目數。

最大值為 50。

默認值為 10。

10
NextTokenstring

查詢憑證(Token),取值為上一次 API 調用返回的 NextToken 參數值。

AAAAAdDWBF2
Tagarray<object>

標簽列表

object

標簽列表

Keystring

命令執行的標簽鍵。N 的取值范圍為 1~20。一旦傳入該值,則不允許為空字符串。

使用一個標簽過濾資源,查詢到該標簽下的資源數量不能超過 1000 個;使用多個標簽過濾資源,查詢到同時綁定了多個標簽的資源數量不能超過 1000 個。如果資源數量超過 1000 個,您需要使用 ListTagResources 接口進行查詢。

最多支持 64 個字符,不能以aliyunacs:開頭,不能包含http://https://

TestKey
Valuestring

命令執行的標簽值。N 的取值范圍為 1~20。該值可以為空字符串。

最多支持 128 個字符,不能包含http://https://

TestValue

返回參數

名稱類型描述示例值
object
RequestIdstring

請求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE*****
Invocationobject

命令執行結果的集合。

PageSizelong

分頁查詢時設置的每頁行數。

1
PageNumberlong

當前頁碼。

1
TotalCountlong

命令總個數。

1
NextTokenstring

本次調用返回的查詢憑證值。

AAAAAdDWBF2
InvocationResultsarray<object>

命令執行結果集。

InvocationResultobject
InvocationStatusstring

單臺實例的命令進度狀態,可能值:

  • Pending:系統正在校驗或發送命令。
  • Invalid:指定命令類型或參數有誤。
  • Aborted:向實例發送命令失敗。實例必須在運行中,且命令可以 1 分鐘內發送完成。
  • Running:命令正在實例上執行。
  • Success:
    • 單次執行的命令:命令執行完成,且退出碼為 0。
    • 定時執行的命令:上一次執行成功且退出碼為 0,且指定的執行時間已結束。
  • Failed:
    • 單次執行的命令:命令執行完成,且退出碼非 0。
    • 定時執行的命令:上一次執行成功且退出碼非 0,且指定的執行時間將中止。
  • Error:命令執行時發生異常無法繼續。
  • Timeout:命令執行超時。
  • Cancelled:命令的執行動作已經取消,命令未曾啟動。
  • Stopping:正在停止執行的命令。
  • Terminated:命令執行時被終止。
  • Scheduled:
    • 單次執行的命令:不適用,不會出現。
    • 定時執行的命令:等待執行。
Success
Repeatsinteger

命令在該實例上執行的次數。

  • 若執行方式為立即執行,則值為 0 或 1。
  • 若執行方式為定時執行,則值為執行過多少次。
0
CommandIdstring

命令 ID。

c-hz0jdfwcsr****
InstanceIdstring

實例 ID。

i-bp1i7gg30r52z2em****
Outputstring

命令執行后的輸出信息。

  • 若 ContentEncoding 指定 PlainText,返回原始輸出信息。
  • 若 ContentEncoding 指定 Base64,返回 Base64 編碼后的輸出信息。
MTU6MzA6MDEK
Droppedinteger

Output字段中文字長度超出 24 KB 后,截斷并丟棄的文字長度。

0
StopTimestring

若調用了StopInvocation以停止命令執行,表示調用的時間。

2020-01-19T09:15:47Z
ExitCodelong

命令的退出碼。

  • Linux 實例為 Shell 命令的退出碼。
  • Windows 實例為 Bat 或者 PowerShell 命令的退出碼。
0
StartTimestring

命令在實例中開始執行的時間。

2019-12-20T06:15:55Z
ErrorInfostring

命令的下發失敗或執行失敗原因的詳情,可能值:

  • 空:命令運行正常。
  • The security group rules denied access to the aliyun service:安全組規則拒絕訪問云助手服務。
  • The specified instance does not exist:指定的實例不存在或已釋放。
  • The specified instance was released during task execution:執行命令期間,該實例被釋放。
  • The specified instance was not running during task execution:開始執行命令時,該實例不在運行中。
  • The OS type of the instance does not support the specified command type:命令不適用于指定的實例。
  • The specified account does not exist:指定的賬號不存在。
  • The specified directory does not exist:指定的目錄不存在。
  • The cron expression is invalid:指定的執行時間表達式不合法。
  • The aliyun service is not running on the instance:云助手 Agent 未運行。
  • The aliyun service in the instance does not response:云助手 Agent 無響應。
  • The aliyun service in the instance is upgrading during task execution:云助手 Agent 正在升級中。
  • The aliyun service in the instance need to be upgraded to at least version to support the feature:云助手 Agent 需要升級。為該特性最低支持版本號,為具體特性。
  • The command delivery has been timeout:發送命令超時。
  • The command execution has been timeout:命令執行超時。
  • The command execution got an exception:命令執行發生異常。
  • The command execution exit code is not zero:命令執行結束,退出碼非 0。
  • The specified instance was released during task execution:下發文件期間,該實例被釋放。
the specified instance does not exists
ErrorCodestring

命令下發失敗或執行失敗原因的代碼,可能值:

  • 空:命令執行正常。
  • InstanceNotExists:指定的實例不存在或已釋放。
  • InstanceReleased:執行命令期間,該實例被釋放。
  • InstanceNotRunning:命令執行時,該實例不在運行中。
  • CommandNotApplicable:命令不適用于指定的實例。
  • AccountNotExists:指定的執行命令的用戶名不存在。
  • DirectoryNotExists:指定的目錄不存在。
  • BadCronExpression:指定的執行時間表達式不合法。
  • ClientNotRunning:云助手 Agent 未運行。
  • ClientNotResponse:云助手 Agent 無響應。
  • ClientIsUpgrading:云助手 Agent 正在升級中。
  • ClientNeedUpgrade:云助手 Agent 需要升級。
  • DeliveryTimeout:發送命令超時。
  • ExecutionTimeout:命令執行超時。
  • ExecutionException:命令執行發生異常。
  • ExecutionInterrupted:命令執行被中斷。
  • ExitCodeNonzero:命令執行結束,退出碼非 0。
  • SecurityGroupRuleDenied:安全組規則拒絕訪問云助手服務。
InstanceNotExists
FinishedTimestring

命令執行的完成時間。如果命令執行出現超時情況,命令執行的完成時間以StartTime延遲執行命令的超時時間Timeout為準。

2019-12-20T06:15:56Z
InvokeIdstring

命令執行 ID。

t-hz0jdfwd9f****
InvokeRecordStatusstring

命令執行狀態。可能值:

  • Running:運行中。
    • 定時執行:未手動停止定時執行命令前,執行狀態一直為進行中。
    • 單次執行:一旦有進行中的命令進程,總的執行狀態就為進行中。
  • Finished:已完成。
    • 定時執行:命令進程不可能為執行完成。
    • 單次執行:所有實例全部完成執行。或者手動停止部分實例的命令進程,其余實例全部執行完成。
  • Failed:執行失敗。
    • 定時執行:命令進程不可能為執行失敗。
    • 單次執行:所有實例全部執行失敗。
  • PartialFailed:部分執行失敗。
    • 定時執行:命令進程不可能為部分失敗。
    • 單次執行:部分實例有執行失敗的命令進程,則總執行狀態為部分失敗。
  • Stopped:命令執行已停止。
  • Stopping:正在停止執行的命令。
Running
Usernamestring

在 ECS 實例中執行命令的用戶名稱。

test
ContainerIdstring

容器 ID。

ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****
ContainerNamestring

容器名稱。

test-container
TerminationModestring

停止任務(手動停止或執行超時打斷)時的模式。可能值:

  • Process:停止當前腳本進程。
  • ProcessTree:停止當前進程樹(腳本進程以及它創建的所有子進程的集合)。
ProcessTree
Launcherstring

腳本執行的引導程序。長度不能超過 1 KB。

python3 -u {{ACS::ScriptFileName|Ext(".py")}}
Tagsarray<object>

命令執行的標簽信息。

Tagobject

命令執行的標簽信息。

TagKeystring

命令執行的標簽鍵。

owner
TagValuestring

命令執行的標簽值。

zhangsan

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE*****",
  "Invocation": {
    "PageSize": 1,
    "PageNumber": 1,
    "TotalCount": 1,
    "NextToken": "AAAAAdDWBF2",
    "InvocationResults": {
      "InvocationResult": [
        {
          "InvocationStatus": "Success",
          "Repeats": 0,
          "CommandId": "c-hz0jdfwcsr****",
          "InstanceId": "i-bp1i7gg30r52z2em****",
          "Output": "MTU6MzA6MDEK",
          "Dropped": 0,
          "StopTime": "2020-01-19T09:15:47Z",
          "ExitCode": 0,
          "StartTime": "2019-12-20T06:15:55Z",
          "ErrorInfo": "the specified instance does not exists",
          "ErrorCode": "InstanceNotExists",
          "FinishedTime": "2019-12-20T06:15:56Z",
          "InvokeId": "t-hz0jdfwd9f****",
          "InvokeRecordStatus": "Running",
          "Username": "test",
          "ContainerId": "ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****",
          "ContainerName": "test-container",
          "TerminationMode": "ProcessTree",
          "Launcher": "python3 -u {{ACS::ScriptFileName|Ext(\".py\")}}",
          "Tags": {
            "Tag": [
              {
                "TagKey": "owner",
                "TagValue": "zhangsan"
              }
            ]
          }
        }
      ]
    }
  }
}

錯誤碼

HTTP status code錯誤碼錯誤信息描述
400RegionId.ApiNotSupportedThe api is not supported in this region.指定地域下不支持調用 API。請檢查 RegionId 參數取值是否正確。
400NumberExceed.TagsThe Tags parameter number is exceed.標簽個數超過最大限制。
400Duplicate.TagKeyThe Tag.N.Key contain duplicate key.標簽中存在重復的鍵,請保持鍵的唯一性。
400InvalidTagKey.MalformedThe specified Tag.n.Key is not valid.指定的標簽鍵參數有誤。
400InvalidTagValue.MalformedThe specified Tag.n.Value is not valid.指定的標簽值參數有誤。
400MissingParameter.TagKeyYou must specify Tag.N.Key.請指定標簽鍵。
400InvalidParam.PageNumberThe specified parameter is invalid.指定的 PageNumber 參數無效。
400InvalidParam.PageSizeThe specified parameter is invalid.指定的 PageSize 參數無效。
400InvalidParameter.NextTokenThe specified parameter NextToken is not valid.指定的參數NextToken不合法。
400InvalidParameter.MaxResultsThe specified parameter MaxResults is not valid.指定的參數MaxResults不合法。
403Operation.ForbiddenThe operation is not permitted.該操作是不被允許的。
404InvalidRegionId.NotFoundThe RegionId provided does not exist in our records.提供的RegionId不存在
500InternalError.DispatchAn error occurred when you dispatched the request.發送請求時發生錯誤,請稍后重試。
500ServiceUnavailableThe request has failed due to a temporary failure of the server.請求后端超時,請稍后重試。
500InternalErrorThe request processing has failed due to some unknown error.內部錯誤,請重試。

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

變更歷史

變更時間變更內容概要操作
2024-12-05OpenAPI 描述信息更新、OpenAPI 錯誤碼發生變更查看變更詳情
2024-08-01OpenAPI 錯誤碼發生變更、OpenAPI 返回結構發生變更查看變更詳情
2024-05-14OpenAPI 錯誤碼發生變更、OpenAPI 返回結構發生變更查看變更詳情
2023-12-21OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更、OpenAPI 返回結構發生變更查看變更詳情
2023-05-12OpenAPI 錯誤碼發生變更查看變更詳情
2022-02-25OpenAPI 錯誤碼發生變更查看變更詳情