AWS 區域 - AWS 軟體開發套件和工具

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

AWS 區域

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

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

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

AWS 一般參考包含有關以下內容的資訊:

  • 若要瞭解區域與端點之間的關係,並檢視現有地區端點的清單,請參閱AWS 服務端點

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

建立服務用戶端

為了以編程方式訪問 AWS 服務,SDK 使用每個客戶端類/對象。 AWS 服務例如,如果您的應用程式需要存取 Amazon EC2,您的應用程式會建立一個 Amazon EC2 用戶端物件,以便與該服務進行交流。

如果沒有為用戶端明確指定 [區域],用戶端會預設使用透過下列region設定所設定的 [地區]。但是,可以為任何單獨的客戶端對象明確設置客戶端的活動區域。以這種方式設定區域的優先順序高於該特定服務用戶端的任何全域設定。替代區域是在實例化該客戶端期間指定的,特定於您的 SDK(請查看您的特定 SDK 指南或 SDK 的代碼庫)。

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

region-共享 AWS config文件設置
AWS_REGION-環境變量
aws.region-JVM 系統屬性:僅限爪哇/科特林

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

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

有效值

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

  • aws-global指定除區域端點 AWS Security Token Service (AWS STS) 和 Amazon 簡單儲存服務 (Amazon S3) 等區域端點之外,還支援個別全球端點的服務的全球端點。

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

[default] region = us-west-2

通過命令行設置環境變量的 Linux/macOS 示例:

export AWS_REGION=us-west-2

通過命令行設置環境變量的 Windows 示例:

setx AWS_REGION us-west-2

大多數 SDK 都有一個「配置」對象,可用於從應用程序代碼中設置默認區域。如需詳細資訊,請參閱特定的 AWS SDK 開發人員指南。

與 AWS 開發套件的相容性

下列 SDK 支援本主題中描述的功能和設定。注意到任何部分例外情況。和唯一支援任何 JVM 系統屬 AWS SDK for Java 性設 適用於 Kotlin 的 AWS SDK 定。

SDK 支援 備註或更多資訊
AWS CLI v2 AWS CLI v2 在中的任何值之AWS_REGION前使用中的任何值AWS_DEFAULT_REGION(兩個變量都被檢查)。
AWS CLI V1 AWS CLI v1 使用AWS_DEFAULT_REGION為此目的命名的環境變量。
SDK for C++
適用於轉到 V2 的開發套件 (1.x)
適用於 Go 1.x 的開發套件 (V1) 若要使用共用config檔案設定,您必須開啟從設定檔載入功能;請參閱工作階段
適用於 Java 2.x 的開發套件
適用於 Java 1.x 的開發套件
適用於 JavaScript 3.x 的開發套
適用於 JavaScript 2.x 的 SDK
SDK 的科特林
適用於 .NET 3.x 的開發套
適用於 PHP 3.x 的開發套件
SDK for Python (Boto3) 此 SDK 使用AWS_DEFAULT_REGION為此目的命名的環境變數。
適用於紅寶石 3.x 的 SDK
適用於鏽蝕的 SDK
適用的工具 PowerShell