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

# ホストプレフィックスインジェクション
<a name="feature-host-prefix"></a>

**注記**  
設定ページのレイアウトの理解、または以下の ** AWS SDKs**「」を参照してください[このガイドの設定ページについて](settings-reference.md#settingsPages)。

ホストプレフィックスインジェクションは、 AWS SDKsが特定の API オペレーションのサービスエンドポイントのホスト名にプレフィックスを自動的に付加する機能です。このプレフィックスは、静的文字列でも、リクエストパラメータのデータを含む動的な値でもかまいません。

例えば、Amazon Simple Storage Service を使用して Amazon S3 オブジェクトまたはバケットに対してアクションを実行する場合、SDK は最終的な API エンドポイントでバケット名と AWS アカウント ID を置き換えます。

この動作は通常の AWS サービスエンドポイントで必要ですが、VPC エンドポイントやローカルテストツールなどのカスタムエンドポイントを使用すると問題が発生する可能性があります。このような場合は、ホストプレフィックスインジェクションの無効化が必要になる場合があります。

この機能を設定するには、以下のように使用します。

**`disable_host_prefix_injection` - 共有 AWS `config`ファイル設定`AWS_DISABLE_HOST_PREFIX_INJECTION` - 環境変数`aws.disableHostPrefixInjection` - JVM システムプロパティ: Java/Kotlin のみ**  
この設定は、SDK またはツールが SDK のクライアントオブジェクトまたは変数で定義されているホストプレフィックスを付加してエンドポイントホスト名を変更するかどうかを制御します。  
**デフォルト値**: `false`  
**有効な値:**  
+ **`true`** - ホストプレフィックスインジェクションを無効にします。SDK はエンドポイントのホスト名を変更しません。
+ **`false`** – ホストプレフィックスインジェクションを有効にします。SDK は、エンドポイントのホスト名の先頭にホストプレフィックスを付加します。

`config` ファイルにこの値を設定する例を以下に示します。

```
[default]
disable_host_prefix_injection = true
```

Linux/macOS のコマンドラインによる環境変数の設定の例を以下に示します。

```
export AWS_DISABLE_HOST_PREFIX_INJECTION=true
```

Windows のコマンドラインによる環境変数の設定の例を以下に示します。

```
setx AWS_DISABLE_HOST_PREFIX_INJECTION true
```

## ホストプレフィックスインジェクションの例
<a name="hostprefix_examples"></a>

次の例の表は、ホストプレフィックスインジェクションが有効になっている場合と無効になっている場合に SDK が最後のエンドポイントを変更する方法を示しています。
+ **ホストプレフィックス**: SDK のクライアントオブジェクトまたはコード内の変数に設定されたホストプレフィックスプロパティ文字列のテンプレート。
+ **入力**: SDK のクライアントオブジェクトまたはコード内の変数に設定された追加の入力。
+ **クライアントエンドポイント**: クライアントの派生エンドポイント。
+ **設定値**: 前の設定の解決された値。
+ **結果のエンドポイント**: SDK クライアントが API コールを行うために使用する結果のエンドポイント。


| ホストプレフィックス | 入力 | クライアントエンドポイント | 設定値 | 結果のエンドポイント | 
| --- |--- |--- |--- |--- |
| "data." | {} | "https://service.us-west-2.amazonaws.com" | false | "https://data.service.us-west-2.amazonaws.com" | 
| "{Bucket}-{AccountId}." | Bucket: "amzn-s3-demo-bucket1", AccountId:"123456789012" | "https://service.us-west-2.amazonaws.com" | false | "https://amzn-s3-demo-bucket1-123456789012.service.us-west-2.amazonaws.com" | 
| "data." | {} | "https://override.us-west-2.amazonaws.com" (as an override endpoint) | true | "https://override.us-west-2.amazonaws.com" | 

## AWS SDKsとツールによるサポート
<a name="host-prefix-sdk-compat"></a>

以下の SDK は、このトピックで説明する機能と設定をサポートします。部分的な例外があれば、すべて記載されています。JVM システムプロパティ設定は、 AWS SDK for Java と AWS SDK for Kotlin でのみサポートされます。


| SDK | サポート | 注意または詳細情報 | 
| --- | --- | --- | 
| [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) v2 | はい |  | 
| [SDK for C\+\+](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | いいえ | 設定はサポートされていませんが、[https://sdk.amazonaws.com/cpp/api/LATEST/aws-cpp-sdk-core/html/struct_aws_1_1_client_1_1_client_configuration.html](https://sdk.amazonaws.com/cpp/api/LATEST/aws-cpp-sdk-core/html/struct_aws_1_1_client_1_1_client_configuration.html) を使用してクライアントのコードで設定できます。 | 
| [SDK for Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | いいえ | [ミドルウェアを使用して](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/configure-endpoints.html)無効にできます。 | 
| [SDK for Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | いいえ |  | 
| [SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | いいえ | 設定はサポートされていませんが、[https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/core/client/config/SdkAdvancedClientOption.html#DISABLE_HOST_PREFIX_INJECTION](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/core/client/config/SdkAdvancedClientOption.html#DISABLE_HOST_PREFIX_INJECTION) を使用してクライアントのコードで設定できます。 | 
| [SDK for Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | いいえ | 設定はサポートされていませんが、[https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/ClientConfiguration.html](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/ClientConfiguration.html) を使用してクライアントのコードで設定できます。 | 
| [SDK for JavaScript 3.x](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | いいえ | 設定はサポートされていませんが、[https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/s3-control/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/s3-control/) を使用してクライアントのコードで設定できます。 | 
| [SDK for JavaScript 2.x](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | いいえ | 設定はサポートされていませんが、[https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Config.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Config.html) を使用してクライアントのコードで設定できます。 | 
| [SDK for Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | いいえ |  | 
| [SDK for .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | いいえ | 設定はサポートされていませんが、[https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Runtime/TClientConfig.html](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Runtime/TClientConfig.html) を使用してクライアントのコードで設定できます。 | 
| [SDK for .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | いいえ | 設定はサポートされていませんが、[https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TClientConfig.html](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TClientConfig.html) を使用してクライアントのコードで設定できます。 | 
| [SDK for PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | いいえ | 設定はサポートされていませんが、[https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.AwsClient.html](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.AwsClient.html) を使用してクライアントのコードで設定できます。 | 
| [SDK for Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | はい | [https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html](https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html) を使用してクライアントのコードで設定できます。 | 
| [SDK for Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | いいえ | 設定はサポートされていませんが、[https://github.com/aws/aws-sdk-ruby/blob/version-3/gems/aws-sdk-core/lib/aws-sdk-core/plugins/endpoint_pattern.rb#L8](https://github.com/aws/aws-sdk-ruby/blob/version-3/gems/aws-sdk-core/lib/aws-sdk-core/plugins/endpoint_pattern.rb#L8) を使用してクライアントのコードで設定できます。 | 
| [SDK for Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | いいえ |  | 
| [SDK for Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | いいえ |  | 
| [PowerShell V5 のツール](https://docs.aws.amazon.com/powershell/latest/userguide/) | いいえ | 設定はサポートされていませんが、パラメータ -ClientConfig @{DisableHostPrefixInjection = $true} を使用して特定のコマンドレットに含めることができます。 | 
| [PowerShell V4 のツール](https://docs.aws.amazon.com/powershell/v4/userguide/) | いいえ | 設定はサポートされていませんが、パラメータ -ClientConfig @{DisableHostPrefixInjection = $true} を使用して特定のコマンドレットに含めることができます。 |