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

# IMDS 用戶端
<a name="feature-imds-client"></a>

**注意**  
如需了解設定頁面配置或解譯以下 **Support AWS SDKs和工具**資料表的說明，請參閱 [了解本指南的設定頁面](settings-reference.md#settingsPages)。

SDKs使用工作階段導向請求實作執行個體中繼資料服務第 2 版 (IMDSv2) 用戶端。如需 IMDSv2 的詳細資訊，請參閱《Amazon EC2 使用者指南》中的[使用 IMDSv2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html)2。 *Amazon EC2 * IMDS 用戶端可透過 SDK 程式碼庫中提供的用戶端組態物件進行設定。

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

**`retries` - 用戶端組態物件成員**  
任何失敗請求的額外重試嘗試次數。  
**預設值：**3   
**有效值：**大於 0 的數字。

**`port` - 用戶端組態物件成員**  
端點的連接埠。  
**預設值：**80   
**有效值：**數字。

**`token_ttl` - 用戶端組態物件成員**  
字符的 TTL。  
**預設值：**21，600 秒 (6 小時，最大分配時間）。  
**有效值：**數字。

**`endpoint` - 用戶端組態物件成員**  
IMDS 的端點。  
**預設值：**如果 `endpoint_mode`等於 `IPv4`，則預設端點為 `http://169.254.169.254`。如果 `endpoint_mode`等於 `IPv6`，則預設端點為 `http://[fd00:ec2::254]`。  
**有效值：**有效 URI。



大多數 SDKs 支援下列選項。如需詳細資訊，請參閱您的特定 SDK 程式碼庫。

**`endpoint_mode` - 用戶端組態物件成員**  
IMDS 的端點模式。  
**預設值**：`IPv4`  
**有效值**：`IPv4`、`IPv6`

**`http_open_timeout` - 用戶端組態物件成員 （名稱可能有所不同）**  
等待連線開啟的秒數。  
**預設值：**1 秒。  
**有效值：**大於 0 的數字。

**`http_read_timeout` - 用戶端組態物件成員 （名稱可能有所不同）**  
要讀取的資料區塊的秒數。  
**預設值：**1 秒。  
**有效值：**大於 0 的數字。

**`http_debug_output` - 用戶端組態物件成員 （名稱可能有所不同）**  
設定用於偵錯的輸出串流。  
**預設值：**無。  
**有效值：**有效的 I/O 串流，例如 STDOUT。

**`backoff` - 用戶端組態物件成員 （名稱可能會有所不同）**  
重試或客戶提供的退避函數之間要呼叫的休眠秒數。這會覆寫預設指數退避策略。  
**預設值：**依 SDK 而異。  
**有效值：**依 SDK 而異。可以是數值或呼叫自訂函數。

## 支援 AWS SDKs和工具
<a name="feature-imds-client-sdk-compat"></a>

下列 SDKs 支援本主題中所述的功能和設定。會記下任何部分例外狀況。 適用於 Java 的 AWS SDK 和 適用於 Kotlin 的 AWS SDK 僅支援任何 JVM 系統屬性設定。


| SDK | 支援 | 備註或更多資訊 | 
| --- | --- | --- | 
| [AWS CLI  ](https://docs.aws.amazon.com/cli/latest/userguide/) v2 | 是 |  | 
| [適用於 C\+\+ 的 SDK](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | 否 |  | 
| [適用於 Go V2 的 SDK (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | 是 |  | 
| [適用於 Go 的 SDK 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | 是 |  | 
| [適用於 Java 的 SDK 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | 是 |  | 
| [適用於 Java 的 SDK 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | 是 |  | 
| [適用於 JavaScript 3.x 的 SDK](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | 是 |  | 
| [適用於 JavaScript 2.x 的 SDK](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | 是 |  | 
| [適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | 否 |  | 
| [適用於 .NET 4.x 的 SDK](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | 是 |  | 
| [適用於 .NET 3.x 的 SDK](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | 是 |  | 
| [適用於 PHP 的 SDK 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | 是 |  | 
| [適用於 Python 的 SDK (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | 是 |  | 
| [適用於 Ruby 的 SDK 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | 是 |  | 
| [適用於 Rust 的 SDK](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | 是 |  | 
| [適用於 Swift 的 SDK](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | 是 |  | 
| [PowerShell V5 的工具](https://docs.aws.amazon.com/powershell/latest/userguide/) | 是 |  | 
| [PowerShell V4 的工具](https://docs.aws.amazon.com/powershell/v4/userguide/) | 是 |  |