Spécifier AWS les régions

Il existe deux manières de spécifier la AWS région à utiliser lors de l'exécution de AWS Tools for PowerShell commandes :

• Utilisez le paramètre commun -Region pour les commandes individuelles.

• Utilisez la commande Set-DefaultAWSRegion pour définir une région par défaut pour toutes les commandes.

De nombreuses AWS applets de commande échouent si les Outils pour Windows ne PowerShell parviennent pas à déterminer la région à utiliser. Les exceptions incluent les applets de commande pour Amazon S3, Amazon SES et Amazon AWS Identity and Access Management, qui utilisent automatiquement par défaut un point de terminaison global.

Pour spécifier la région pour une seule AWS commande

Ajoutez le paramètre -Region à votre commande, par exemple :

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

Pour définir une région par défaut pour toutes les commandes AWS CLI de la session en cours

À partir de l'invite de PowerShell commande, tapez la commande suivante.

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

Note

Cette valeur n'est valable que pour la session en cours. Pour appliquer le paramètre à toutes vos PowerShell sessions, ajoutez cette commande à votre PowerShell profil comme vous l'avez fait pour la Import-Module commande.

Pour afficher la région par défaut actuelle pour toutes les commandes de la AWS CLI

À partir de l'invite de PowerShell commande, tapez la commande suivante.

PS > Get-DefaultAWSRegion

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

Pour effacer la région par défaut actuelle pour toutes les commandes AWS CLI

À partir de l'invite de PowerShell commande, tapez la commande suivante.

PS > Clear-DefaultAWSRegion

Pour consulter la liste de toutes les AWS régions disponibles

À partir de l'invite de PowerShell commande, tapez la commande suivante. Notez que la troisième colonne identifie la région par défaut de votre session en cours.

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

Note

Certaines régions peuvent être prises en charge, mais elles ne sont pas incluses dans les résultats de l'applet de commande Get-AWSRegion. Par exemple, c'est parfois le cas des régions qui ne sont pas encore à l'échelle mondiale. Si vous ne pouvez pas spécifier une région en ajoutant le paramètre -Region, essayez plutôt d'indiquer la région dans un point de terminaison personnalisé, comme indiqué dans la section suivante.

Spécification d'un point de terminaison personnalisé ou non standard

Spécifiez un point de terminaison personnalisé sous forme d'URL en ajoutant le paramètre -EndpointUrl commun à votre PowerShell commande Outils pour Windows, dans le format d'exemple suivant.

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

Voici un exemple de commande à l'aide de l'applet de commande Get-EC2Instance. Le point de terminaison personnalisé se trouve dans la région us-west-2 ou US West (Oregon) dans cet exemple, mais vous pouvez utiliser n'importe quelle autre région AWS prise en charge, y compris les régions qui ne sont pas répertoriées par Get-AWSRegion.

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

Informations supplémentaires

Pour plus d'informations sur AWS les régions, consultez AWS la section Région dans le Guide de référence AWS des SDK et des outils.