在 describe-stream 下 AWS CLI 中的 page-size 参数有什么用

Question

我需要了解与 describe-stream AWS CLI 命令一起使用的 page-size 参数的用途是什么？

AWS 文档只是说 - 每页的大小

来源：Kinesis describe-stream @ docs.aws.amazon.com

Answer 1

当我们迁移到 AWS 云中的任何服务时，数据大部分都是批量的，元数据也是。每个对象都有自己的空间和元数据。 AWS CLI 有一种很酷的方法可以将响应数据分页到分区中（外行语言）。

每个响应都有一个键来获取下一个分区，因此这就是检索批量数据的方式，直到响应中的最后一个键不可用，这将是最后一个分区或数据结束。

因此在 AWS CLI 中，我们可以设置 --page-size n，因为它指示要进行的可用数据的分区，以便我们以更少的延迟获得响应，并允许顺利处理数据，而不会在传输过程中丢失数据。 因此我们有一个称为起始令牌的密钥，它附加在每个响应中。

Answer 2

已更新

page-size

参数用于控制AWSCLI和服务之间的结果分页。 AWSCLI 通常会为您处理分页。它将请求服务的响应页面，然后将完整列表返回给您。默认情况下，它使用 1000 的

page-size

，但在某些情况下，这可能太大，并可能导致服务在生成响应时超时。在这种罕见的情况下，您可以使用

--page-size

选项告诉 AWSCLI 在与服务通信时使用较小的页面大小。请注意，这不会影响 AWSCLI 返回的实际结果，因为它仍会根据需要请求页面并将数据返回给您，就好像它们是连续的一样。

Answer 3

我认为简单的答案是 --page-size 限制了每次服务调用返回的项目数，但这并不能控制 CLI 输出中显示的内容。要设置显示的项目数，可以使用参数--max-items。

因此，--page-size 通过每次 API 调用检索少于 1,000 个项目来真正帮助您避免超时问题，并且 --max-items 限制输出中显示的项目数作为分页的一部分。因此，在视觉上您可以看到使用 --max-items 的结果，而 --page-size 是在后台发生的事情。

Answer 4

--page-size

：指定 AWS CLI 检索完整的项目列表，但具有更大的 API 调用的数量而不是一次 API 调用（默认值：1000 项）。这可以帮助您通过每次 API 调用检索少于 1,000 项来避免超时问题。

使用

--max-items

进行分页