指定 AWS 区域 - 适用于 PowerShell 的 AWS 工具
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

指定 AWS 区域

在运行适用于 PowerShell 的 AWS 工具时,可以使用两种方法指定 AWS 区域:

  • 对单个命令使用 -Region 通用参数。

  • 使用 Set-DefaultAWSRegion 命令为所有命令设置默认区域。

如果适用于 Windows PowerShell 的工具无法确定要使用的区域,许多 AWS cmdlet 会失败。例外情况包括Amazon S3、Amazon SES 和AWS Identity and Access Management (IAM),它会自动默认为全局终端节点。

为单个 AWS 命令指定区域

-Region 参数添加到命令中,如下所示。

PS > Get-EC2Image -Region us-west-2

为当前会话中的所有 AWS CLI 命令设置默认区域

从 PowerShell 命令提示符键入以下命令。

PS > Set-DefaultAWSRegion -Region us-west-2
注意

此设置仅为当前会话保留。要将设置应用到所有 PowerShell 会话,请将该命令添加到您的 PowerShell 配置文件,就像在 Import-Module 命令中一样。

查看所有 AWS CLI 命令的当前默认区域

从 PowerShell 命令提示符键入以下命令。

PS > Get-DefaultAWSRegion Region Name IsShellDefault ------ ---- -------------- us-west-2 US West (Oregon) True

清除所有 AWS CLI 命令的当前默认区域

从 PowerShell 命令提示符键入以下命令。

PS > Clear-DefaultAWSRegion

查看所有可用 AWS 区域的列表

从 PowerShell 命令提示符键入以下命令。示例输出中的第三列标识哪个区域是您当前会话的默认区域。

PS > Get-AWSRegion Region Name IsShellDefault ------ ---- -------------- ap-east-1 Asia Pacific (Hong Kong) False ap-northeast-1 Asia Pacific (Tokyo) False ... us-east-2 US East (Ohio) False us-west-1 US West (N. California) False us-west-2 US West (Oregon) True ...
注意

某些区域可能受支持,但不包含在Get-AWSRegioncmdlet。例如,对于尚未全局的区域有时也是如此。如果您无法通过添加-Region参数添加到某个命令中,请尝试在一个自定义终端节点中指定该区域,如以下部分中所述。

指定自定义或非标准终端节点

按照 URL 形式指定一个自定义终端节点,方法是在-EndpointUrl通用参数添加到适用于 Windows PowerShell 的工具中,按照如下示例格式进行。

PS > Some-AWS-PowerShellCmdlet -EndpointUrl "custom endpoint URL" -Other -Parameters

下面是一个使用 Get-EC2Instance cmdlet 的示例。自定义终端节点位于us-west-2或美国西部(俄勒冈)区域,但您可以使用任何其他支持的 AWS 区域,包括未列出的区域Get-AWSRegion

PS > Get-EC2Instance -EndpointUrl "https://service-custom-url.us-west-2.amazonaws.com" -InstanceID "i-0555a30a2000000e1"