DescribeInvocationResults_云服务器 ECS_API文档

接口说明

• 当您执行命令后，不代表命令一定成功执行，并且一定有预期的命令效果。您需要通过本接口查看实际的具体执行结果，以实际输出结果为准。

• 您可以查询最近 4 周的执行信息，执行信息的保留上限为 10 万条。

• 您可以通过云助手任务状态事件订阅的方式，通过事件获取任务结果，避免频繁轮询，用以提升效率。

• 分页查询首页时，仅需设置MaxResults以限制返回信息的条目数，返回结果中的NextToken将作为查询后续页的凭证。查询后续页时，将NextToken参数设置为上一次返回结果中获取到的NextToken作为查询凭证，并设置MaxResults限制返回条目数。

• DescribeInvocations和DescribeInvocationResults差异点：

  • 当一次RunCommand/InvokeCommand调用指定有多个实例时：
    • 使用DescribeInvocations可以获得任务在各个实例上的执行状态、多个实例任务状态的聚合状态；
    • 使用DescribeInvocationResults仅能获得各个实例上的单独的执行状态，不包含多实例的聚合状态；
  • 当一次RunCommand/InvokeCommand调用指定有一个实例时：
    • DescribeInvocations与DescribeInvocationResults区别不大，完全可以互相替换。
  • 当需要查看定时性（周期性）任务、开机自动执行任务（RepeatMode=Period, EveryReboot）的每一次执行情况时，仅能用DescribeInvocationResults可以查询获得执行的过往历史记录（需指定IncludeHistory=true），而DescribeInvocations仅支持返回最新的任务状态。
  • 当需要查看命令的内容、参数时，仅有DescribeInvocations返回CommandContent。