DescribeInvocations_云服务器 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。