使用AWS Java SDK v2构建SsmClient是否必须显式指定区域？

未指定区域的情况 #

你预期不设置区域会自动遍历所有区域搜索SSM参数？实际完全不是这样。AWS的SSM参数是区域级资源，不存在全局搜索的默认逻辑，而且AWS SDK要求所有区域相关的服务客户端必须明确指定区域——不管是通过代码里的.region()，还是环境变量、本地配置文件这类隐式方式。如果代码里完全不指定区域，创建SsmClient时直接就会抛出异常（比如SdkException或IllegalArgumentException），提示区域未配置，根本到不了搜索那一步。

指定错误区域的情况 #

如果指定的区域不存在（比如瞎写个us-fake-1），创建客户端时会直接抛出InvalidRegionException；要是区域存在但你的账号没权限访问该区域的SSM服务，后续调用getParameter这类查询接口时，会返回AccessDeniedException；如果区域有效但目标参数根本不在这个区域，就会返回ParameterNotFound异常。

关于跨区域搜索的说明 #

你的示例代码是指定区域创建客户端：

SsmClient ssmClient = SsmClient.builder()
                .region(region)
                .build();

如果确实需要跨区域找参数，得自己手动写逻辑：先列出来要查的区域列表，给每个区域单独创建SsmClient，逐个查询后再合并结果，SDK不会帮你自动完成这件事。

内容的提问来源于stack exchange，提问作者Sayan Halder