Spécification des régions AWS - AWS Tools for PowerShell

Spécification des régions AWS

Il existe deux façons de spécifier la région AWS à utiliser lors de l'exécution de commandes AWS Tools for PowerShell :

  • 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 applets de commande AWS échouent si les Tools for Windows PowerShell ne peuvent pas déterminer la région à utiliser. Les exceptions incluent les applets de commande pour Amazon S3, Amazon SES, et IAM et Tools for PowerShell, qui sont automatiquement affectées par défaut à un point de terminaison global.

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

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 CLI AWS de la session en cours

Depuis l'invite de commande PowerShell, entrez la commande suivante :

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

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

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

Depuis l'invite de commande PowerShell, entrez la commande suivante :

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

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

Depuis l'invite de commande PowerShell, entrez la commande suivante :

PS > Clear-DefaultAWSRegion

Pour afficher une liste de toutes les régions AWS disponibles

Depuis l'invite de commande PowerShell, saisissez 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é en tant qu'URL en ajoutant le paramètre commun -EndpointUrl à votre commande Tools for Windows PowerShell, dans l'exemple de format 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"