Especificar AWS regiões

Há duas maneiras de especificar a AWS região a ser usada ao executar AWS Tools for PowerShell comandos:

• Use o parâmetro -Region comum em comandos individuais.

• Use o comando Set-DefaultAWSRegion para definir uma região padrão para todos os comandos.

Muitos AWS cmdlets falham se o Tools for Windows não PowerShell conseguir descobrir qual região usar. As exceções incluem cmdlets para Amazon S3, Amazon SES AWS Identity and Access Management e, que automaticamente assumem como padrão um endpoint global.

Para especificar a região para um único AWS comando

Adicione o parâmetro -Region ao seu comando, como o seguinte.

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

Para definir uma região padrão para todos os comandos da AWS CLI na sessão atual

No prompt de PowerShell comando, digite o comando a seguir.

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

nota

Essa configuração é persistida apenas durante a sessão atual. Para aplicar a configuração a todas as suas PowerShell sessões, adicione esse comando ao seu PowerShell perfil da mesma forma que você fez com o Import-Module comando.

Para visualizar a região padrão atual para todos os comandos da AWS CLI

No prompt de PowerShell comando, digite o comando a seguir.

PS > Get-DefaultAWSRegion

Region    Name             IsShellDefault
------    ----             --------------
us-west-2 US West (Oregon) True

Para limpar a região padrão atual para todos os comandos da AWS CLI

No prompt de PowerShell comando, digite o comando a seguir.

PS > Clear-DefaultAWSRegion

Para ver uma lista de todas as AWS regiões disponíveis

No prompt de PowerShell comando, digite o comando a seguir. A terceira coluna na saída de exemplo identifica qual região é a padrão para a sessão atual.

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
...

nota

Algumas regiões podem ser compatíveis, mas não estão incluídas na saída do cmdlet Get-AWSRegion. Por exemplo, isso às vezes acontece em regiões que ainda não são globais. Se você não puder especificar uma região adicionando o parâmetro -Region a um comando, tente especificar a região em um endpoint personalizado, conforme mostrado na próxima seção.

Especificar um endpoint não padrão ou personalizado

Especifique um endpoint personalizado como URL adicionando o parâmetro -EndpointUrl comum ao PowerShell comando do Tools for Windows, no formato de exemplo a seguir.

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

Veja a seguir um comando de exemplo que usa o cmdlet Get-EC2Instance. Neste exemplo, o endpoint personalizado está na região us-west-2 ou Oeste dos EUA (Oregon), mas você poderá usar qualquer outra região da AWS compatível, incluindo regiões que não são enumeradas pelo Get-AWSRegion.

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

Mais informações

Para obter informações adicionais sobre AWS regiões, consulte AWS Região no Guia de referência de AWS SDKs e ferramentas.