クライアントコンストラクター - AWS SDK for JavaScript

AWS SDK for JavaScript V3 APIリファレンスガイドでは、バージョン 3 (V3) のすべてのAPIオペレーションについて詳しく説明しています AWS SDK for JavaScript 。

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

クライアントコンストラクター

このリストは v2 設定パラメータ によってインデックス化されます。

  • computeChecksums

    • v2: サービスがペイロードボディを受け入れるときに、ペイロードボディのMD5チェックサムを計算するかどうか (現在 S3 でのみサポートされています)。

    • v3: S3 の該当するコマンド ( など) はPutObject PutBucketCors、リクエストペイロードの のMD5チェックサムを自動的に計算します。コマンドの ChecksumAlgorithmパラメータで別のチェックサムアルゴリズムを指定して、別のチェックサムアルゴリズムを使用することもできます。詳細については、S3 機能のお知らせ」を参照してください。

  • convertResponseTypes

    • v2: レスポンスデータを解析するときに型が変換されるかどうか。

    • v3: を廃止しました。このオプションは、タイムスタンプや base64 バイナリなどのタイプをJSONレスポンスから変換しないため、型安全ではないと見なされます。

  • correctClockSkew

    • v2: クライアントクロックが歪んでいるために失敗したクロックスキュー修正および再試行リクエストを適用するかどうか。

    • v3: を廃止しました。SDK は常にクロックスキュー補正を適用します。

  • systemClockOffset

    • v2: すべての署名時間に適用されるミリ秒単位のオフセット値。

    • v3: 変更なし。

  • credentials

    • v2: AWS リクエストに署名するための認証情報。

    • v3: 変更なし。認証情報を返す非同期関数にすることもできます。関数が を返す場合expiration (Date)、有効期限の日時が近づくと、関数は再び呼び出されます。AwsAuthInputConfig 認証情報については、「v3 APIリファレンス」を参照してください。

  • endpointCacheSize

    • v2: エンドポイント検出オペレーションからエンドポイントを保存するグローバルキャッシュのサイズ。

    • v3: 変更なし。

  • endpointDiscoveryEnabled

    • v2: サービスによって指定されたエンドポイントを使用して オペレーションを動的に呼び出すかどうか。

    • v3: 変更なし。

  • hostPrefixEnabled

    • v2: リクエストパラメータをホスト名のプレフィックスにマーシャリングするかどうか。

    • v3: を廃止しました。SDK 必要に応じて、 は常にホスト名プレフィックスを挿入します。

  • httpOptions

    低レベルHTTPリクエストに渡す一連のオプション。これらのオプションは v3 では異なる方法で集計されます。新しい を指定することで設定できますrequestHandler。Node.js ランタイムで http オプションを設定する例を次に示します。詳細については、 の v3 APIリファレンスを参照してください NodeHttpHandler

    すべての v3 リクエストHTTPSはデフォルトで を使用します。カスタム を提供するだけで済みますhttpsAgent。

    const { Agent } = require("https"); const { Agent: HttpAgent } = require("http"); const { NodeHttpHandler } = require("@smithy/node-http-handler"); const dynamodbClient = new DynamoDBClient({ requestHandler: new NodeHttpHandler({ httpsAgent: new Agent({ /*params*/ }), connectionTimeout: /*number in milliseconds*/, socketTimeout: /*number in milliseconds*/ }), });

    http を使用するカスタムエンドポイントを渡す場合は、 を指定する必要がありますhttpAgent。

    const { Agent } = require("http"); const { NodeHttpHandler } = require("@smithy/node-http-handler"); const dynamodbClient = new DynamoDBClient({ requestHandler: new NodeHttpHandler({ httpAgent: new Agent({ /*params*/ }), }), endpoint: "http://example.com", });

    クライアントがブラウザで実行されている場合、別のオプションセットを使用できます。詳細については、 の v3 APIリファレンスを参照してください FetchHttpHandler

    const { FetchHttpHandler } = require("@smithy/fetch-http-handler"); const dynamodbClient = new DynamoDBClient({ requestHandler: new FetchHttpHandler({ requestTimeout: /* number in milliseconds */ }), });

    の各オプションhttpOptionsを以下に示します。

    • proxy

      • v2: リクエストURLをプロキシするための 。

      • v3: エージェントを使用してプロキシをセットアップするには、「Node.js のプロキシの設定」に従います。

    • agent

      • v2: HTTPリクエストを実行する エージェントオブジェクト。接続プーリングに使用されます。

      • v3: 上記の例httpsAgentに示すように、 httpAgentまたは を設定できます。

    • connectTimeout

      • v2: connectTimeoutミリ秒後にサーバーとの接続を確立できなかった後、ソケットをタイムアウトに設定します。

      • v3: connectionTimeoutNodeHttpHandlerオプション で使用できます。

    • timeout

    • xhrAsync

      • v2: SDKが非同期HTTPリクエストを送信するかどうか。

      • v3: を廃止しました。リクエストは常に非同期です。

    • xhrWithCredentials

  • logger

    • v2: リクエストに関する情報をログに記録するために .write() (ストリームなど) または .log() (コンソールオブジェクトなど) に応答するオブジェクト。

    • v3: 変更なし。より詳細なログは v3 で利用できます。

  • maxRedirects

    • v2: サービスリクエストに従うリダイレクトの最大量。

    • v3: を廃止しました。SDK は、意図しないクロスリージョンリクエストを回避するためにリダイレクトに従いません。

  • maxRetries

    • v2: サービスリクエストに対して実行する最大再試行回数。

    • v3: を に変更しましたmaxAttempts。の詳細については、「 の v3 APIリファレンス RetryInputConfig」を参照してください。は にmaxAttemptsする必要がありますmaxRetries + 1

  • paramValidation

    • v2: リクエストを送信する前に、入力パラメータをオペレーションの説明に対して検証する必要があるかどうか。

    • v3: を廃止しました。SDK は、実行時にクライアント側で検証を行いません。

  • region

    • v2: サービスリクエストの送信先のリージョン。

    • v3: 変更なし。リージョン文字列を返す非同期関数にすることもできます。

  • retryDelayOptions

    • v2: 再試行可能なエラーの再試行遅延を設定するための一連のオプション。

    • v3: を廃止しました。SDK は、retryStrategyクライアントコンストラクタオプションを使用して、より柔軟な再試行戦略をサポートします。詳細については、「v3 APIリファレンス」を参照してください。

  • s3BucketEndpoint

    • v2: 指定されたエンドポイントが個々のバケットをアドレス指定しているかどうか (ルートAPIエンドポイントをアドレス指定している場合は失敗)。

    • v3: を に変更しましたbucketEndpoint。の詳細については、「 の v3 APIリファレンスbucketEndpoint」を参照してください。に設定するとtrue、リクエストパラメータでBucketリクエストエンドポイントを指定すると、元のエンドポイントが上書きされることに注意してください。v2 では、クライアントコンストラクタのリクエストエンドポイントがBucketリクエストパラメータを上書きします。

  • s3DisableBodySigning

    • v2: 署名バージョン v4 の使用時に S3 本文署名を無効にするかどうか。

    • v3: の名前を に変更しましたapplyChecksum

  • s3ForcePathStyle

    • v2: S3 オブジェクトURLsのパススタイルを強制するかどうか。

    • v3: の名前を に変更しましたforcePathStyle

  • s3UseArnRegion

    • v2: リクエストリージョンを、リクエストされたリソースの から推測されたリージョンで上書きするかどうかARN。

    • v3: の名前を に変更しましたuseArnRegion

  • s3UsEast1RegionalEndpoint

    • v2: region が「us-east-1」に設定されている場合、s3 リクエストをグローバルエンドポイントに送信するか、「us-east-1」リージョンエンドポイントに送信するか。

    • v3: を廃止しました。region が に設定されている場合、S3 クライアントは常にリージョンエンドポイントを使用しますus-east-1。リージョンを に設定aws-globalして、S3 グローバルエンドポイントにリクエストを送信できます。

  • signatureCache

    • v2: でリクエストに署名する署名 (API設定の上書き) がキャッシュされるかどうか。

    • v3: を廃止しました。SDK は常にハッシュされた署名キーをキャッシュします。

  • signatureVersion

    • v2: リクエストに署名する署名バージョン (API設定を上書き)。

    • v3: を廃止しました。vV2サポートされている署名 V2 SDKは によって非推奨になりました AWS。v3 は署名 v4 のみをサポートしています。

  • sslEnabled

    • v2: リクエストに対して SSL が有効になっているかどうか。

    • v3: の名前を に変更しましたtls

  • stsRegionalEndpoints

    • v2: グローバルエンドポイントまたはリージョンエンドポイントに sts リクエストを送信するかどうか。

    • v3: を廃止しました。STS クライアントは、特定のリージョンに設定されている場合、常にリージョンエンドポイントを使用します。リージョンを に設定aws-globalして、STSグローバルエンドポイントにリクエストを送信できます。

  • useAccelerateEndpoint

    • v2: S3 サービスで Accelerate エンドポイントを使用するかどうか。

    • v3: 変更なし。