调用DescribeInvocations查询云助手脚本的执行列表和状态。

接口说明

  • 当您执行命令后，不代表命令一定成功执行，并且一定有预期的命令效果。您需要通过接口返回值来查看实际执行结果，以实际输出结果为准。
  • 您可以查询最近2周的执行信息，执行信息的保留上限为10万条。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeInvocations

系统规定参数。取值：DescribeInvocations。

RegionId String 是 cn-hangzhou

地域ID。
InvokeId String 否 t-hz0jdfwd9f****

脚本进程执行ID。
CommandType String 否 RunPowerShellScript

脚本类型。取值范围：

  • RunBatScript
  • RunPowerShellScript
InvokeStatus String 否 Finished

脚本执行的总执行状态。总执行状态取决于创建执行中的一台或多台云桌面的共同执行状态。取值范围：

  • Running：一旦有进行中的脚本进程，总的执行状态就为进行中。
  • Finished：所有云桌面全部完成执行。或者手动停止部分云桌面的脚本进程，其余云桌面全部执行完成。
  • Failed：所有云桌面全部执行失败。
  • PartialFailed：部分云桌面有执行失败的脚本进程，则总执行状态为部分失败。
  • Stopped：停止执行脚本。

默认值：Running。
DesktopId String 否 ecd-7w78ozhjcwa3u****

云桌面ID。如果指定了云桌面，则查询该桌面所有的脚本执行记录。
IncludeOutput Boolean 否 false

是否在结果中返回脚本运行的输出信息。取值范围：

  • true：返回。
  • false：不返回。

默认值：false。
ContentEncoding String 否 PlainText

返回数据的编码方式。取值范围：

  • PlainText：返回原始脚本内容和输出信息。
  • Base64：返回Base64编码后的脚本内容和输出信息。

默认值：Base64。
MaxResults Integer 否 10

分页查询时每页行数。

默认值：100。

NextToken String 否 AAAAAV3MpHK1AP0pfERHZN5pu6nmB7qrRFJ8vmttjxPL****

查询凭证（Token），取值为上一次API调用返回的NextToken参数值。

返回数据

名称 类型 示例值 描述
NextToken String AAAAAV3MpHK1AP0pfERHZN5pu6nmB7qrRFJ8vmttjxPL****

本次调用返回的查询凭证值。
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。
Invocations Array of Invocation

脚本执行记录信息集合。
CreationTime String 2020-12-19T09:15:46Z

任务的创建时间。
InvocationStatus String Pending

脚本执行的总执行状态，总执行状态取决于本次调用的全部云桌面的共同执行状态，可能值：

  • Pending：系统正在校验或发送命令。存在至少一台云桌面的脚本执行状态为Pending，则总执行状态为Pending。
  • Running：命令正在云桌面上运行。存在至少一台云桌面的脚本执行状态为Running，则总执行状态为Running。
  • Success：各个云桌面上的脚本执行状态均为Stopped或Success，且至少一个云桌面的脚本执行状态是Success，则总执行状态为Success。
  • Failed：各个云桌面上的脚本执行状态均为Stopped或Failed，则总执行状态为Failed。云桌面上的脚本执行状态一项或多项为以下状态时，返回值均为Failed状态：
    • 命令校验失败（Invalid）
    • 命令发送失败（Aborted）
    • 命令执行完成但退出码非0（Failed）
    • 命令执行超时（Timeout）
    • 命令执行异常（Error）
  • Stopping：正在停止任务。存在至少一台实例的脚本执行状态为Stopping，则总执行状态为Stopping。
  • Stopped：任务已停止。所有实例的脚本执行状态是Stopped，则总执行状态为Stopped。实例上的脚本执行状态为以下状态时，返回值均为Stopped状态：
    • 任务已取消（Cancelled）
    • 任务已终止（Terminated）
  • PartialFailed：部分实例执行成功且部分实例执行失败。各个实例的脚本执行状态均为Success、Failed或Stopped，则总执行状态为PartialFailed。
InvokeId String t-hz0jdfwd9f****

执行ID。
CommandType String RunPowerShellScript

脚本类型。
CommandContent String cnBtIC1xYSB8IGdyZXAgdnNm****

脚本内容，以Base64编码后传输。
InvokeDesktops Array of InvokeDesktop

执行目标云桌面集合。
CreationTime String 2020-12-20T06:15:54Z

脚本进程的创建时间。
InvocationStatus String Success

单台云桌面的脚本进度状态。
FinishTime String 2020-12-20T06:15:56Z

脚本进程的结束时间。
UpdateTime String 2020-12-25T06:15:56Z

任务状态的更新时间。
Repeats Integer 0

命令在该桌面上执行的次数。
DesktopId String ecd-7w78ozhjcwa3u****

云桌面ID。
Output String OutPutTestmsg

脚本进程的输出信息。

  • 如果请参IncludeOutput设置为false，则不返回Output。
  • 如果请参ContentEncoding设置为Base64，则Output为Base64编码后的输出信息。
Dropped Integer 0

Output字段中文字长度超出24 KB后，截断丢弃的文字长度。
StopTime String 2020-12-25T09:15:47Z

如果调用了stopInvocation，表示调用的时间。

ExitCode Long 0

脚本进程的退出代码。
StartTime String 2020-12-20T06:15:55Z

脚本进程在桌面中开始执行的时间。
ErrorInfo String the specified instance does not exists

命令的下发失败或执行失败原因的详情，可能值：

  • 空：命令运行正常。
  • the specified instance does not exists：指定的云桌面不存在或已释放。
  • the instance has released when create task：执行任务期间，该云桌面被释放。
  • the instance is not running when create task：创建任务时，该云桌面不在运行中。
  • the command is not applicable：命令不适用于指定的云桌面。
  • the aliyun service is not running on the instance：云助手客户端未运行。
  • the aliyun service in the instance does not response：云助手客户端无响应。
  • the aliyun service in the instance is upgrading now：云助手客户端正在升级中。
  • the aliyun service in the instance need upgrade：云助手客户端需要升级。
  • the command delivery has been timeout：发送命令超时。
  • the command execution has been timeout：命令运行超时。
  • the command execution got an exception：命令运行发生异常。
  • the command execution has been interrupted：命令运行任务中断。
  • the command execution exit code is not zero：命令执行结束，退出码非0。
ErrorCode String InstanceNotExists

命令的下发失败或执行失败原因的代码，可能值：

  • 空：命令运行正常。
  • InstanceNotExists：指定的云桌面不存在或已释放。
  • InstanceReleased：执行任务期间，该云桌面被释放。
  • InstanceNotRunning：创建任务时，该云桌面不在运行中。
  • CommandNotApplicable：命令不适用于指定的云桌面。
  • ClientNotRunning：云助手客户端未运行。
  • ClientNotResponse：云助手客户端无响应。
  • ClientIsUpgrading：云助手客户端正在升级中。
  • ClientNeedUpgrade：云助手客户端需要升级。
  • DeliveryTimeout：发送命令超时。
  • ExecutionTimeout：命令运行超时。
  • ExecutionException：命令运行发生异常。
  • ExecutionInterrupted：命令运行任务中断。
  • ExitCodeNonzero：命令执行结束，退出码非0。

示例

请求示例

https://ecd.cn-hangzhou.aliyuncs.com/?Action=DescribeInvocations
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeInvocationsResponse>
    <NextToken>AAAAAV3MpHK1AP0pfERHZN5pu6nmB7qrRFJ8vmttjxPL****</NextToken>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <Invocations>
        <CreationTime>2020-12-19T09:15:46Z</CreationTime>
        <CommandContent>cnBtIC1xYSB8IGdyZXAgdnNm****</CommandContent>
        <InvocationStatus>Pending</InvocationStatus>
        <CommandType>RunPowerShellScript</CommandType>
        <InvokeId>t-hz0jdfwd9f****</InvokeId>
    </Invocations>
    <Invocations>
        <InvokeDesktops>
            <Dropped>0</Dropped>
            <InvocationStatus>Success</InvocationStatus>
            <ErrorInfo>the specified instance does not exists</ErrorInfo>
            <ExitCode>0</ExitCode>
            <StartTime>2020-12-20T06:15:55Z</StartTime>
            <DesktopId>ecd-7w78ozhjcwa3u****</DesktopId>
            <Repeats>0</Repeats>
            <FinishTime>2020-12-20T06:15:56Z</FinishTime>
            <Output>OutPutTestmsg</Output>
            <UpdateTime>2020-12-25T06:15:56Z</UpdateTime>
            <CreationTime>2020-12-20T06:15:54Z</CreationTime>
            <ErrorCode>InstanceNotExists</ErrorCode>
            <StopTime>2020-12-25T09:15:47Z</StopTime>
        </InvokeDesktops>
    </Invocations>
</DescribeInvocationsResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "NextToken" : "AAAAAV3MpHK1AP0pfERHZN5pu6nmB7qrRFJ8vmttjxPL****",
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Invocations" : [ {
    "CreationTime" : "2020-12-19T09:15:46Z",
    "CommandContent" : "cnBtIC1xYSB8IGdyZXAgdnNm****",
    "InvocationStatus" : "Pending",
    "CommandType" : "RunPowerShellScript",
    "InvokeId" : "t-hz0jdfwd9f****"
  }, {
    "InvokeDesktops" : [ {
      "Dropped" : "0",
      "InvocationStatus" : "Success",
      "ErrorInfo" : "the specified instance does not exists",
      "ExitCode" : "0",
      "StartTime" : "2020-12-20T06:15:55Z",
      "DesktopId" : "ecd-7w78ozhjcwa3u****",
      "Repeats" : "0",
      "FinishTime" : "2020-12-20T06:15:56Z",
      "Output" : "OutPutTestmsg",
      "UpdateTime" : "2020-12-25T06:15:56Z",
      "CreationTime" : "2020-12-20T06:15:54Z",
      "ErrorCode" : "InstanceNotExists",
      "StopTime" : "2020-12-25T09:15:47Z"
    } ]
  } ]
}