AWS 區域 - AWS SDKs 和 工具

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

AWS 區域

AWS 區域 是使用 時需要了解的重要概念 AWS 服務。

透過 AWS 區域,您可以存取實際位於特定地理區域 AWS 服務 的 。這對於讓您的資料和應用程式在接近您和您的使用者將存取它們的位置時保持執行很有用。區域提供容錯能力、穩定性和恢復能力,也可降低延遲。使用 區域,您可以建立備援資源,以保持可用且不受區域中斷影響。

大多數 AWS 服務 請求都與特定地理區域相關聯。除非您明確使用 提供的複寫功能,否則您在一個 區域中建立的資源不存在於任何其他 區域 AWS 服務。例如,Amazon S3 和 Amazon EC2支援跨區域複寫。有些服務,例如 IAM,沒有區域資源。

AWS 一般參考 包含下列資訊:

  • 若要了解區域和端點之間的關係,以及檢視現有區域端點的清單,請參閱AWS 服務端點

  • 若要檢視每個 所有支援的區域和端點的目前清單 AWS 服務,請參閱服務端點和配額

建立服務用戶端

若要以程式設計方式存取 AWS 服務,請為每個 SDKs使用用戶端類別/物件 AWS 服務。例如EC2,如果您的應用程式需要存取 Amazon ,您的應用程式會建立 Amazon EC2用戶端物件以與該服務進行界面。

如果程式碼本身未明確指定用戶端的區域,則用戶端會使用透過下列設定設定的區域,預設為 region。不過,可以針對任何個別用戶端物件明確設定用戶端的作用中區域。以此方式設定區域優先於該特定服務用戶端的任何全域設定。替代區域是在該用戶端的實例化期間指定,具體針對您的 SDK(請查看您的特定SDK指南或 SDK的程式碼基礎)。

使用下列項目設定此功能:

region - 共用 AWS config檔案設定
AWS_REGION - 環境變數
aws.region - JVM系統屬性:僅限 Java/Kotlin

指定 AWS 區域 要用於 AWS 請求的預設值。此區域用於未隨附要使用的特定區域SDK的服務請求。

預設值:無。您必須明確指定此值。

有效值

  • 所選服務可用的任何區域代碼,如AWS 一般參考 中的AWS 服務端點中所列。例如, 值us-east-1會將端點設定為 AWS 區域 美國東部 (維吉尼亞北部)。

  • aws-global 指定除了區域端點之外,支援個別全域端點的服務全域端點,例如 AWS Security Token Service (AWS STS) 和 Amazon Simple Storage Service (Amazon S3)。

config 檔案中設定此值的範例:

[default] region = us-west-2

透過命令列設定環境變數的 Linux/macOS 範例:

export AWS_REGION=us-west-2

透過命令列設定環境變數的 Windows 範例:

setx AWS_REGION us-west-2

大多數 SDKs都具有「組態」物件,可用於從應用程式程式碼內設定預設區域。如需詳細資訊,請參閱您的特定 AWS SDK開發人員指南。

與 的相容性 AWS SDKs

以下SDKs支援本主題所述的功能和設定。會記下任何部分例外狀況。 AWS SDK for Java 和 適用於 Kotlin 的 AWS SDK 僅支援任何JVM系統屬性設定。

SDK 支援 備註或更多資訊
AWS CLI v2 AWS CLI v2 在 中的任何值AWS_REGION之前,會先使用 中的任何值 AWS_DEFAULT_REGION(會檢查兩個變數)。
AWS CLI v1 AWS CLI v1 AWS_DEFAULT_REGION會為此目的使用名為 的環境變數。
SDK 適用於 C++
SDK for Go V2 (1.x)
SDK for Go 1.x (V1) 若要使用共用config檔案設定,您必須開啟從組態檔案載入;請參閱工作階段
SDK 適用於 Java 2.x
SDK 適用於 Java 1.x
SDK 適用於 JavaScript 3.x
SDK 適用於 JavaScript 2.x
SDK 適用於 Kotlin
SDK 適用於 。NET 3.x
SDK 適用於 PHP 3.x
SDK for Python (Boto3) 這SDK會使用名為 的環境變數AWS_DEFAULT_REGION來達成此目的。
SDK 適用於 Ruby 3.x
SDK for Rust
SDK 適用於 Swift
適用於 的工具 PowerShell