Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Région AWS
Note
Pour vous aider à comprendre la mise en page des pages de paramètres ou à interpréter le tableau Support by AWS SDKs et outils ci-dessous, voirComprendre les pages de paramètres de ce guide.
Régions AWS sont un concept important à comprendre lorsque vous travaillez avec Services AWS.
Avec Régions AWS, vous pouvez accéder à Services AWS ceux qui résident physiquement dans une zone géographique spécifique. Cela peut être utile pour que vos données et applications fonctionnent à proximité de l'endroit où vous et vos utilisateurs y accéderez. Les régions fournissent une tolérance aux pannes, une stabilité et une résilience, et peuvent également réduire la latence. Avec les régions, vous pouvez créer des ressources redondantes qui restent disponibles et qui ne sont pas affectées par une panne régionale.
La plupart des Service AWS demandes sont associées à une région géographique particulière. Les ressources que vous créez dans une région n'existent dans aucune autre région, sauf si vous utilisez explicitement une fonctionnalité de réplication proposée par un Service AWS. Par exemple, Amazon S3 et Amazon EC2 prennent en charge la réplication entre régions. Certains services, tels que IAM, ne disposent pas de ressources régionales.
Références générales AWSIl contient des informations sur les points suivants :
-
Pour comprendre la relation entre les régions et les points de terminaison, et pour consulter la liste des points de terminaison régionaux existants, consultez la section Points de terminaison de AWS service.
-
Pour consulter la liste actuelle de toutes les régions et points de terminaison pris en charge pour chacune d'entre elles Service AWS, voir Points de terminaison et quotas de service.
Création de clients de service
Pour y accéder par programmation Services AWS, SDKs utilisez une classe/un objet client pour chacun. Service AWS Si votre application doit accéder à Amazon EC2, par exemple, elle créera un objet EC2 client Amazon pour interagir avec ce service.
Si aucune région n'est explicitement spécifiée pour le client dans le code lui-même, le client utilise par défaut la région définie par le biais du region paramètre suivant. Cependant, la région active d'un client peut être définie explicitement pour n'importe quel objet client individuel. La définition de la région de cette manière a priorité sur tout paramètre global pour ce client de service en particulier. La région alternative est spécifiée lors de l'instanciation de ce client, en fonction de votre SDK (consultez votre guide SDK spécifique ou la base de code de votre SDK).
Configurez cette fonctionnalité à l'aide des méthodes suivantes :
region- réglage AWSconfigdu fichier partagéAWS_REGION- variable d'environnementaws.region- Propriété du système JVM : Java/Kotlin uniquement-
Spécifie la valeur par défaut Région AWS à utiliser pour les AWS demandes. Cette région est utilisée pour les demandes de service du SDK qui ne sont pas fournies avec une région spécifique à utiliser.
Valeur par défaut : Aucune. Vous devez spécifier cette valeur de manière explicite.
Valeurs valides:
-
N'importe quel code de région disponible pour le service choisi, tel qu'indiqué dans les points de terminaison du AWS service dans la référence AWS générale. Par exemple, la valeur
us-east-1définit le point de terminaison sur l'est des Région AWS États-Unis (Virginie du Nord). -
aws-globalspécifie le point de terminaison global pour les services qui prennent en charge un point de terminaison mondial distinct en plus des points de terminaison régionaux, tels que AWS Security Token Service (AWS STS) et Amazon Simple Storage Service (Amazon S3).
-
Exemple de définition de cette valeur dans le config fichier :
[default] region = us-west-2
Exemple Linux/macOS de définition de variables d'environnement via la ligne de commande :
export AWS_REGION=us-west-2
Exemple Windows de définition de variables d'environnement via la ligne de commande :
setx AWS_REGION us-west-2
La plupart SDKs disposent d'un objet de « configuration » qui permet de définir la région par défaut à partir du code de l'application. Pour plus de détails, consultez le guide du développeur de votre AWS SDK spécifique.
Support par AWS SDKs et outils
Les éléments suivants SDKs prennent en charge les fonctionnalités et les paramètres décrits dans cette rubrique. Toute exception partielle est notée. Tous les paramètres de propriété du système JVM sont pris en charge par le AWS SDK pour Java et le Kit AWS SDK pour Kotlin seul.
| SDK | Pris en charge | Remarques ou informations supplémentaires |
|---|---|---|
| AWS CLI v2 | Oui | AWS CLI v2 utilise n'importe quelle valeur in AWS_REGION avant toute valeur in AWS_DEFAULT_REGION (les deux variables sont cochées). |
| AWS CLI v1 | Oui | AWS CLI v1 utilise une variable d'environnement nommée AWS_DEFAULT_REGION à cette fin. |
| SDK pour C++ | Oui | |
| SDK pour Go V2 (1.x) |
Oui | |
| SDK pour Go 1.x (V1) | Oui | Pour utiliser les paramètres des config fichiers partagés, vous devez activer le chargement à partir du fichier de configuration ; voir Sessions. |
| SDK pour Java 2.x | Oui | |
| SDK pour Java 1.x | Oui | |
| SDK pour 3.x JavaScript | Oui | |
| SDK pour 2.x JavaScript | Oui | |
| SDK pour Kotlin | Oui | |
| SDK pour .NET 3.x | Oui | |
| SDK pour PHP 3.x | Oui | |
| SDK pour Python (Boto3) |
Oui | Ce SDK utilise une variable d'environnement nommée AWS_DEFAULT_REGION à cette fin. |
| SDK pour Ruby 3.x | Oui | |
| SDK pour Rust | Oui | |
| SDK pour Swift | Oui | |
| Outils pour PowerShell | Oui |
