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
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 queIAM, 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, voir 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 à AmazonEC2, 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 cas SDK (consultez votre SDK guide spécifique ou votre base SDK de code).
Configurez cette fonctionnalité à l'aide des méthodes suivantes :
region- réglage AWSconfigdu fichier partagéAWS_REGION- variable d'environnementaws.region- propriété JVM du système : 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 SDK service 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 votre guide AWS SDK du développeur spécifique.
Compatibilité avec AWS SDKs
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 des propriétés JVM du système sont pris en charge par le AWS SDK for 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. |
| SDKpour C++ | Oui | |
| SDKpour Go V2 (1.x) |
Oui | |
| SDKpour 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. |
| SDKpour Java 2.x | Oui | |
| SDKpour Java 1.x | Oui | |
| SDKpour JavaScript 3.x | Oui | |
| SDKpour JavaScript 2.x | Oui | |
| SDKpour Kotlin | Oui | |
| SDKpour. NET3. x | Oui | |
| SDKpour PHP 3.x | Oui | |
| SDKpour Python (Boto3) |
Oui | Cela SDK utilise une variable d'environnement nommée AWS_DEFAULT_REGION à cette fin. |
| SDKpour Ruby 3.x | Oui | |
| SDKpour Rust | Oui | |
| SDKpour Swift | Oui | |
| Outils pour PowerShell | Oui |
