IMDS クライアント
注記
設定ページのレイアウトを理解したり、以下の AWS SDK とツールによるサポートの表を解釈したりするには、「このガイドの設定ページについて」を参照してください。
SDK は、セッション指向リクエストを使用してインスタンスメタデータサービスのバージョン 2 (IMDSv2) クライアントを実装します。IMDSv2 の詳細については、「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。
大半の SDK では以下のオペレーションがサポートされています。詳細については、特定の SDK コードベースを参照してください。
endpoint_mode- クライアント設定オブジェクトメンバー-
IMDS のエンドポイントモード。
デフォルト値:
IPv4有効な値:
IPv4、IPv6 http_open_timeout- クライアント設定オブジェクトメンバー (名前は異なる場合があります)-
接続が開くのを待つ秒数。
デフォルト値: 1 秒。
有効な値: 0 より大きい数値。
http_read_timeout- クライアント設定オブジェクトメンバー (名前は異なる場合があります)-
1 つのデータチャンクが読み取られるまでの秒数。
デフォルト値: 1 秒。
有効な値: 0 より大きい数値。
http_debug_output- クライアント設定オブジェクトメンバー (名前は異なる場合があります)-
デバッグ用の出力ストリームを設定します。
デフォルト値: なし。
有効な値: STDOUT のような有効な I/O ストリーム。
backoff- クライアント設定オブジェクトメンバー (名前は異なる場合があります)-
リトライ間またはお客様が用意したバックオフ関数を呼び出すまでの間にスリープする秒数。これは、デフォルトのエクスポネンシャルバックオフ戦略を使用するよう置き換えます。
デフォルト値: サービスによって異なります。
有効な値: SDK によって異なります。数値でも、カスタム関数の呼び出しでもかまいません。
AWS SDK とツールによるサポート
以下の SDK は、このトピックで説明する機能と設定をサポートします。部分的な例外があれば、すべて記載されています。JVM システムプロパティ設定は、AWS SDK for Java と AWS SDK for Kotlin でのみサポートされます。
| SDK | サポート | 注意または詳細情報 |
|---|---|---|
| AWS CLI v2 | あり | |
| SDK for C++ | なし | |
| SDK for Go V2 (1.x) |
あり | |
| SDK for Go 1.x (V1) | あり | |
| SDK for Java 2.x | あり | |
| SDK for Java 1.x | あり | |
| SDK for JavaScript 3.x | あり | |
| SDK for JavaScript 2.x | あり | |
| SDK for Kotlin | なし | |
| SDK for .NET 4.x | あり | |
| SDK for .NET 3.x | あり | |
| SDK for PHP 3.x | あり | |
| SDK for Python (Boto3) |
あり | |
| SDK for Ruby 3.x | あり | |
| SDK for Rust | あり | |
| SDK for Swift | あり | |
| Tools for PowerShell V5 | あり | |
| Tools for PowerShell V4 | あり |