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

設定 AWS 區域 適用於 Ruby 的 AWS 開發套件的

您可以使用 存取在特定地理區域中操作 AWS 服務 的 AWS 區域。這對於備援和讓資料和應用程式靠近您和使用者存取它們的位置，都很有用。

您必須為適用於 Ruby AWS 區域 的 SDK 設定預設值，以用於 AWS 請求。此預設值用於任何未指定 區域的 SDK 服務方法呼叫。

如需 region設定的詳細資訊，請參閱《 AWS SDKs與工具參考指南AWS 區域》中的 。這也包含如何透過共用 AWS config檔案或環境變數設定預設區域的範例。

解析的區域搜尋順序

您需要在使用大多數 時設定區域 AWS 服務。適用於 Ruby 的 AWS SDK 會依下列順序搜尋區域：

如何設定 區域

本節說明設定區域的不同方式，從最常見的方法開始。

使用共用config檔案設定區域

透過在共用 AWS config檔案中設定 region變數來設定區域。如需共用config檔案的詳細資訊，請參閱 AWS SDKs 和工具參考指南中的共用組態和登入資料檔案。

在 config 檔案中設定此值的範例：

[default]
region = us-west-2

如果AWS_SDK_CONFIG_OPT_OUT已設定環境變數，則不會檢查共用config檔案。

使用環境變數設定區域

透過設定 AWS_REGION環境變數來設定 區域。

使用 export命令在以 Unix 為基礎的系統上設定此變數，例如 Linux 或 macOS。下列範例會將 區域設定為 us-west-2。

export AWS_REGION=us-west-2

若要在 Windows 上設定此變數，請使用 set命令。下列範例會將 區域設定為 us-west-2。

set AWS_REGION=us-west-2

使用 設定 區域 Aws.config

將region值新增至Aws.config雜湊來設定區域。下列範例會更新Aws.config雜湊以使用 us-west-1區域。

Aws.config.update({region: 'us-west-1'})

您稍後建立的任何用戶端或資源都會繫結至此區域。

在用戶端或資源物件中設定區域

建立 AWS 用戶端或資源時設定 區域。下列範例會在 區域中建立 Amazon S3 資源物件us-west-1。為您的 AWS 資源選擇正確的區域。服務用戶端物件是不可變的，因此您必須為每個 服務建立新的用戶端，而您向這些服務提出請求，並使用不同的組態對相同服務提出請求。

s3 = Aws::S3::Resource.new(region: 'us-west-1')