Especificar regiões da AWS - Ferramentas da AWS para PowerShell (versão 4)
Especificar um endpoint não padrão ou personalizadoMais informações

A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada!

Para começar a usar a nova versão do SDK, consulte o Guia do usuário do Ferramentas da AWS para PowerShell (V5), especialmente o tópico Migração para V5.

Especificar regiões da AWS

Há duas maneiras de especificar a região da AWS a ser usada ao executar comandos do Ferramentas da AWS para PowerShell:

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

Haverá falhas em muitos cmdlets da AWS se o Tools for Windows PowerShell não conseguir entender qual região deverá usar. As exceções incluem cmdlets para o Amazon S3, Amazon SES e AWS Identity and Access Management, que usam automaticamente um endpoint global como padrão.

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

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 comando do PowerShell, 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 sessões do PowerShell, adicione esse comando ao seu perfil do PowerShell como você fez para o comando Import-Module.

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

No prompt de comando do PowerShell, 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 comando do PowerShell, digite o comando a seguir.

PS > Clear-DefaultAWSRegion

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

No prompt de comando do PowerShell, 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 um URL adicionando o parâmetro comum -EndpointUrl ao comando do Tools for Windows PowerShell, no formato do 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 regiões da AWS, consulte Região da AWS no Guia de referência de ferramentas e SDKs da AWS.