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

# 在程式碼中設定適用於 Ruby 服務用戶端的 AWS SDK
<a name="setup-config"></a>

直接在程式碼中處理組態時，組態範圍僅限於使用該程式碼的應用程式。在該應用程式中，有所有服務用戶端的全域組態、特定 AWS 服務 類型之所有用戶端的組態，或特定服務用戶端執行個體的組態等選項。

## `Aws.config`
<a name="config"></a>

若要在所有 AWS 類別的程式碼中提供全域組態，請使用 `aws-sdk-core` Gem [https://github.com/aws/aws-sdk-ruby/blob/version-3/gems/aws-sdk-core/lib/aws-sdk-core/plugins/global_configuration.rb](https://github.com/aws/aws-sdk-ruby/blob/version-3/gems/aws-sdk-core/lib/aws-sdk-core/plugins/global_configuration.rb) 套件中提供的 。

 `Aws.config` 支援兩種不同用途的語法。全域設定可以套用至所有 AWS 服務 或特定服務。如需支援設定的完整清單，請參閱 *適用於 Ruby 的 AWS SDK API 參考*`Client`[https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/MachineLearning/Client.html#initialize-instance_method](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/MachineLearning/Client.html#initialize-instance_method)中的 。

### 透過 進行全域設定 `Aws.config`
<a name="global-config"></a>

若要透過 設定服務無關的設定`Aws.config`，請使用下列語法：

```
Aws.config[:<global setting name>] = <value>
```

這些設定會合併到任何建立的服務用戶端。

 全域設定的範例：

```
Aws.config[:region] = 'us-west-2'
```

 如果您嘗試使用全域不支援的設定名稱，當您嘗試建立不支援該名稱的服務類型的執行個體時，就會引發錯誤。如果發生這種情況，請改用服務特定的語法。

### 透過 的服務特定設定 `Aws.config`
<a name="service-config"></a>

 若要透過 設定服務特定的設定`Aws.config`，請使用下列語法：

```
Aws.config[:<service identifier>] = { <global setting name>: <value> }
```

 這些設定會合併到該服務類型的所有已建立服務用戶端。

 僅適用於 Amazon S3 的設定範例：

```
 Aws.config[:s3] = { force_path_style: true }
```

 `<service identifier>` 可以透過查看[AWS 適用於 Ruby Gem 的對應 SDK](https://github.com/aws/aws-sdk-ruby/tree/version-3/gems) 名稱，以及使用後面的尾碼 "`aws-sdk-`" 來識別 。例如：
+ 對於 `aws-sdk-s3`，服務識別符字串為 "`s3`"。
+ 對於 `aws-sdk-ecs`，服務識別符字串為 "`ecs`"。