aws-cli 实战使用 application-autoscaling describe-scheduled-actions 查询 Application Auto Scaling 定时扩缩容动作【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli导读Application Auto Scaling 允许你为 DynamoDB、ECS、EMR 等服务的资源预先配置定时扩缩容动作Scheduled Action在指定时间自动调整资源的最小/最大容量。本文以 aws-cli 仓库中的官方示例describe-scheduled-actions为主线完整讲解该子命令的用法、全部请求参数、响应字段含义、分页机制并结合仓库内打包的 API 模型文件说明 aws-cli 是如何把这条命令翻译成真实服务请求的。读完后你将能够独立查询、过滤指定服务命名空间下的所有定时扩缩容动作并读懂其 JSON 输出中的每个关键字段。命令基本用法aws-cli 仓库自带的官方示例位于 describe-scheduled-actions.rst其核心用法是描述指定服务命名空间下的所有定时动作aws application-autoscaling describe-scheduled-actions \ --service-namespace dynamodb该命令只要求一个必填参数--service-namespace指定资源所属服务的命名空间例如dynamodb其余过滤参数均可选。执行后会返回该命名空间下全部定时动作的详细信息完整示例输出如下{ ScheduledActions: [ { ScalableDimension: dynamodb:table:WriteCapacityUnits, Schedule: at(2019-05-20T18:35:00), ResourceId: table/my-table, CreationTime: 1561571888.361, ScheduledActionARN: arn:aws:autoscaling:us-west-2:123456789012:scheduledAction:2d36aa3b-cdf9-4565-b290-81db519b227d:resource/dynamodb/table/my-table:scheduledActionName/my-first-scheduled-action, ScalableTargetAction: { MinCapacity: 15, MaxCapacity: 20 }, ScheduledActionName: my-first-scheduled-action, ServiceNamespace: dynamodb }, { ScalableDimension: dynamodb:table:WriteCapacityUnits, Schedule: at(2019-05-20T18:40:00), ResourceId: table/my-table, CreationTime: 1561571946.021, ScheduledActionARN: arn:aws:autoscaling:us-west-2:123456789012:scheduledAction:2d36aa3b-cdf9-4565-b290-81db519b227d:resource/dynamodb/table/my-table:scheduledActionName/my-second-scheduled-action, ScalableTargetAction: { MinCapacity: 5, MaxCapacity: 10 }, ScheduledActionName: my-second-scheduled-action, ServiceNamespace: dynamodb } ] }示例中展示了两条针对同一张 DynamoDB 表table/my-table写入容量维度dynamodb:table:WriteCapacityUnits的at(...)一次性定时动作分别把容量调整到 15~20 和 5~10 的范围。请求参数详解结合仓库中打包的 Application Auto Scaling API 模型 service-2.jsonDescribeScheduledActions操作对应 HTTP POST 请求请求 URI 为/请求体DescribeScheduledActionsRequest支持以下参数CLI 参数说明取值/约束--service-namespace提供资源的服务命名空间若资源由你自己的应用或服务提供使用custom-resource必填枚举值ecs、elasticmapreduce、ec2、appstream、dynamodb、rds、sagemaker、custom-resource、comprehend、lambda、cassandra、kafka、elasticache、neptune、workspaces--resource-id定时动作关联的资源标识由资源类型和唯一标识组成与--scalable-dimension配套使用--scalable-dimension可伸缩维度由服务命名空间、资源类型和伸缩属性组成若指定了该参数必须同时指定--resource-id--scheduled-action-names要查询的定时动作名称列表用于精确过滤特定动作--max-results单次返回的最大结果数取值 1~50默认 50--next-token获取下一页结果的 token配合分页使用几个关键约束值得注意过滤组合API 官方文档说明可以用ResourceId、ScalableDimension、ScheduledActionNames三者对结果进行过滤。也就是说只传--service-namespace dynamodb会返回该命名空间下的全部动作再加上--resource-id table/my-table则缩小到某张表。ResourceId 格式以service/my-cluster/my-serviceECS 服务、instancegroup/j-2EEZNYKUA1NTV/ig-1791Y4E1L8YI0EMR 实例组、table/my-tableDynamoDB 表、table/my-table/index/my-table-indexDynamoDB 全局二级索引、cluster:my-db-clusterAurora 集群、function:my-function:prodLambda 预留并发、keyspace/mykeyspace/table/mytableAmazon Keyspaces 表等格式书写均遵循资源类型/唯一标识模式。ScalableDimension 常用取值ecs:service:DesiredCountECS 服务任务数、elasticmapreduce:instancegroup:InstanceCountEMR 实例组实例数、dynamodb:table:ReadCapacityUnits/dynamodb:table:WriteCapacityUnitsDynamoDB 表预留读写容量、rds:cluster:ReadReplicaCountAurora 只读副本数、lambda:function:ProvisionedConcurrencyLambda 预留并发、elasticache:replication-group:NodeGroupsElastiCache 节点组数等。因此一个更精确的查询示例为aws application-autoscaling describe-scheduled-actions \ --service-namespace dynamodb \ --resource-id table/my-table \ --scalable-dimension dynamodb:table:WriteCapacityUnits响应字段详解响应结构DescribeScheduledActionsResponse包含两个成员ScheduledActions动作列表和NextToken下一页 token无更多结果时为 null。列表中每个ScheduledAction对象的关键字段如下ScheduledActionName、ScheduledActionARN、ServiceNamespace、Schedule、ResourceId、CreationTime为必返回项ScheduledActionName定时动作名称示例中为my-first-scheduled-action。ScheduledActionARN动作的 ARN其中还内嵌了资源定位信息resource/dynamodb/table/my-table和动作名。Schedule调度表达式支持三种格式at(yyyy-mm-ddThh:mm:ss)一次性定时示例输出即使用at(2019-05-20T18:35:00)rate(value unit)固定间隔unit可为minute|minutes|hour|hours|day|dayscron(fields)周期调度由 6 个字段组成 [分] [时] [日] [月] [周] [年]。at与cron表达式默认使用 UTC 时区at/cron表达式还可配合Timezone字段指定时区。Timezone当动作使用 at 或 cron 表达式时其日期时间参照的时区。StartTime/EndTime动作计划开始/结束的时间UTC。ScalableTargetAction动作触发时设置的新容量范围包含MinCapacity最小容量与MaxCapacity最大容量两者可以只设其一。执行逻辑是定时到达时若当前容量低于最小容量则扩容到最小容量若高于最大容量则缩容到最大容量。注意即使指定了较大的最大容量各服务自身的配额仍可能施加更低的实际上限。CreationTime动作创建时间示例中为 Unix 时间戳如1561571888.361对应 2019-06-26 19:38:08 UTC 左右。分页机制与 --pager 支持从 paginators-1.json 中可以看到DescribeScheduledActions的分页配置{ input_token: NextToken, limit_key: MaxResults, output_token: NextToken, result_key: ScheduledActions }这意味着手动分页时把上一页响应中的NextToken作为下一次调用的--next-token传入而 aws-cli 的--pager全局参数会依据上述配置自动完成这个过程把多页结果合并为一个ScheduledActions列表输出。当某命名空间下定时动作较多超过单页上限 50 条时推荐写法为aws application-autoscaling describe-scheduled-actions \ --service-namespace dynamodb \ --max-results 20 --pageraws-cli 的分页逻辑由 paginate.py 中的定制逻辑负责它解析服务模型中的分页定义并驱动多次请求这正是--pager能透明翻页的底层机制。错误处理与配套命令该操作在 API 模型中声明了 4 类可能的错误响应遇到时 CLI 会返回相应退出码并输出错误信息ValidationException请求参数校验失败如缺少必填的ServiceNamespace、非法的MaxResults取值InvalidNextTokenException传入的NextToken无效或已过期ConcurrentUpdateException并发更新冲突InternalServiceException服务内部错误。describe-scheduled-actions属于 Application Auto Scaling 的查询族操作。结合 service-2.json 中声明的全部操作共 14 个与之形成闭环的典型流程是用put-scheduled-action为资源创建定时动作用describe-scheduled-actions本文主题核查动作配置是否正确用describe-scalable-targets确认底层可伸缩目标已注册用delete-scheduled-action移除不再需要的动作。小结aws application-autoscaling describe-scheduled-actions只需--service-namespace即可返回该命名空间全部定时动作可通过--resource-id、--scalable-dimension、--scheduled-action-names进一步过滤响应中Schedule支持 at/rate/cron 三种表达式ScalableTargetAction描述触发时容量将被钳制到的区间单页最多 50 条结果--max-results默认 50超过时用--next-token手动翻页或--pager自动翻页aws-cli 仓库内awscli/botocore/data/application-autoscaling/2016-02-06/下的service-2.json与paginators-1.json是这些参数、响应字段与分页行为的权威定义来源可据此自行核对任意细节。【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考