翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# コードでの AWS SDK for Ruby サービスクライアントの設定
<a name="setup-config"></a>

設定がコード内で直接処理される場合、設定のスコープは、そのコードを使用するアプリケーションに限定されます。そのアプリケーション内には、すべてのサービスクライアントに対するグローバル設定、特定の AWS のサービス タイプのすべてのクライアントに対する設定、特定のサービスクライアントインスタンスに対する設定のオプションがあります。

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

すべての AWS クラスのコード内にグローバル設定を提供するには、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-sdk-core` を使用します。

 `Aws.config` は、さまざまな用途に備えて 2 つの構文をサポートします。グローバル設定は、すべてまたは AWS のサービス 特定のサービスに適用できます。サポートされているすべての設定が記載されているリストについては、「*AWS SDK for Ruby 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 SDK for Ruby gem 名](https://github.com/aws/aws-sdk-ruby/tree/version-3/gems)の名前を確認して「`aws-sdk-`」の後に続くサフィックスを使用すると特定できます。例えば、次のようになります。
+ `aws-sdk-s3` の場合、サービス識別子文字列は「`s3`」です。
+ `aws-sdk-ecs` の場合、サービス識別子文字列は「`ecs`」です。