getParametersByPath 页面大小

Question

在 AWS-SDK for Node.js getParametersByPath() SSM 方法返回分页数据，这意味着我必须在循环中进行多次调用。有没有办法禁用分页或增加页面大小（超过 10，这是 MaxNumberparameter 的最大值）？

或者，如果必须进行多次调用 - 是否可以将结果收集到 Promise 数组中以立即解决？

基本上，我们需要在 Lambda 启动时加载大约 12 个参数。目前获取参数大约需要 2 秒 - 因为连续调用了 2 次。理想情况下，它必须是 1 个调用或 2 个并行调用。

Answer 1

这是个好问题。让我概述一些概念、AWS 设计决策以及我将如何解决它们施加的限制。

1。 AWS 服务器端 SSM API

所有 AWS 客户端 SDK，包括适用于 Node.js 的 AWS-SDK，都会对相应 AWS 服务的 REST API 进行 API 调用，例如AWS Systems Manager 端点 [1] 的 API 操作 GetParametersByPath。

2。分页

AWS API 通常实现所谓的基于光标的分页 概念。这种类型的分页具有基于页面的分页（即经典的偏移限制分页）之外的其他特征 - 在几篇 Medium 文章 [2][3] 中进行了描述。

基于光标的分页的一个主要限制是：它不允许发送不同批次的并行请求。没有办法跳转到特定页面，它需要遍历所有前几页。

查看每种分页类型的优缺点后，AWS 工程师可能会以性能为代价进行权衡以支持一致性。

3。 API 限制

AWS 声明 MaxResults 参数的有效范围是 1-10。这意味着，客户端无法将页面大小扩展到 10 以上。所有 SDK 在实现分页时都必须遵守该限制。禁用分页 [4] 的唯一效果是返回最多 10 个项目的单页。

4。可能的解决方法

1. 您可以将 SSM API 结果同步到自定义 DynamoDB 表并查询 DynamoDB 而不是 SSM。该解决方案是否可行取决于几个特征，例如一致性要求、SSM 参数更改的频率以及 SSM 参数值的机密性（或 Lambda 函数读取哪些参数属性）。

2. 如果您正确拆分预期结果集并使用 ParameterFilters API 参数 [1]，您可以向 API 发送并发请求。您可以通过以下键进行拆分：tag:.+|Name|Type|KeyId|Path|Label|Tier|DataType 使用 BeginsWith 或 Equals 选项。 [5]

   此解决方案要求您可以对预期收到的结果做出假设。您必须确保特定子集包含的条目不超过 10 个。如果有例如最大限度。每个部门 10 个 SSM 参数，您可以执行以下操作：通过 getParametersByPath() 每个部门发送一个请求，指定 MaxResults=10 和 Path=/department/<name> 或 ParameterFilters=[{Key=tag:department,Option=Equals,Values=["<name>"]}]。这些特定于部门的请求可以同时发送。

解决方法 2 可以被视为您在问题中提到的“两个并发请求”方法，解决方法 1 是“一个请求”方法。变通方法需要删除一致性属性或对数据分区做出假设。

参考文献

[1]https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParametersByPath.html#systemsmanager-GetParametersByPath-request-NextToken
[2]https://medium.com/innomizetech/how-to-build-an-api-with-aws-lambda-to-paginate-data-using-serverless-41c4b6b676a4
[3]https://medium.com/swlh/paginating-requests-in-apis-d4883d4c1c4c
[4]https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html#cli-usage-pagination-serverside
[5]https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_ParameterStringFilter.html#systemsmanager-Type-ParameterStringFilter-Option

Answer 2

我将给你一个简单的答案和一个我不得不解决几次的问题：

或者，如果必须进行多次调用 - 是否可以将结果收集到 Promise 数组中以立即解决？

是的，方法如下 -

const { SSM } = require('aws-sdk');
const ssm = new SSM();

function getSSMStuff(path, memo = [], nextToken) {
  return ssm
.getParametersByPath({ Path: path, WithDecryption: true, Recursive: true, NextToken: nextToken, MaxResults: 10 })
.promise()
.then(({ Parameters, NextToken }) => {
  const newMemo = memo.concat(Parameters);
  return NextToken ? getSSMStuff(path, newMemo, NextToken) : newMemo;
});
}

如果您使用路径调用它，它将递归调用自身以获取该路径中的所有参数，最终解析为完整参数的数组。显然，您应该按照自己的方式处理错误，但这就是要点。