このドキュメントは、 のバージョン 1 AWS CLI 専用です。のバージョン 2 に関連するドキュメントについては AWS CLI、バージョン 2 ユーザーガイド を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
でのエンドポイントの使用 AWS CLI
プログラムで に接続するには AWS のサービス、エンドポイントを使用します。エンドポイントは、 AWS ウェブサービスのエントリポイントURLの です。 AWS Command Line Interface (AWS CLI) は、 内の各サービスのデフォルトエンドポイントを自動的に使用しますが AWS リージョン、APIリクエストに代替エンドポイントを指定できます。
エンドポイントのトピック
1 つのコマンドのエンドポイントを設定する
1 つのコマンドのエンドポイント設定や環境変数を上書きするには、--endpoint-url
コマンドラインオプションを使用します。次のコマンド例では、カスタム Amazon S3 エンドポイント を使用しますURL。
$
aws s3 ls --endpoint-url
http://localhost:4567
すべての のグローバルエンドポイントを設定する AWS のサービス
すべてのサービスのリクエストをカスタムエンドポイント にルーティングするにはURL、次のいずれかの設定を使用します。
-
環境変数:
-
AWS_IGNORE_CONFIGURED_ENDPOINT_URLS
- 設定されたエンドポイント を無視しますURLs。 -
AWS_ENDPOINT_URL
- グローバルエンドポイント を設定しますURL。
-
-
config
ファイル:-
ignore_configure_endpoint_urls
- 設定されたエンドポイント を無視しますURLs。ignore_configure_endpoint_urls = true
-
endpoint_url
- グローバルエンドポイント を設定しますURL。endpoint_url =
http://localhost:4567
-
サービス固有のエンドポイントと --endpoint-url
コマンドラインオプションはすべてのグローバルエンドポイントよりも優先されます。
すべての にFIPsエンドポイントを使用するように を設定する AWS のサービス
エンドポイントを使用するすべてのサービスのリクエストをルーティングするにはFIPs、次のいずれかを使用します。
-
-
use_fips_endpoint
ファイルの設定。use_fips_endpoint = true
一部の AWS サービスでは、 の一部で連邦情報処理標準 (FIPS) 140-2
この設定が有効になっていても、 のサービスにFIPSエンドポイントが存在しない場合 AWS リージョン、 AWS コマンドは失敗する可能性があります。この場合は、--endpoint-url
オプションを使用してコマンドで使用するエンドポイントを手動で指定するか、サービス固有のエンドポイントを使用します。
によるFIPSエンドポイントの指定の詳細については AWS リージョン、FIPS「サービスによるエンドポイント
すべての AWS のサービスでデュアルスタックのエンドポイントを使用するように設定
利用可能な場合に、すべてのサービスでデュアルスタックエンドポイントを使用するようにリクエストをルーティングするには、以下の設定のいずれかを使用します。
-
AWS_USE_DUALSTACK_ENDPOINT
環境変数 -
use_dualstack_endpoint
ファイルの設定。use_dualstack_endpoint = true
デュアルスタックエンドポイントを使用して AWS リクエストを送信できるようにします。IPv4 と の両方のIPv6トラフィックをサポートするデュアルスタックエンドポイントの詳細については、Amazon S3 デュアルスタックエンドポイントの使用」を参照してください。 デュアルスタックのエンドポイントは、一部のリージョンでは一部のサービスで利用できます。サービスまたは にデュアルスタックエンドポイントが存在しない場合 AWS リージョン、リクエストは失敗します。これはデフォルトでは無効になっています。
サービス固有のエンドポイントを設定します。
サービス固有のエンドポイント設定では、 AWS CLI リクエストに選択した永続エンドポイントを使用するオプションが提供されます。これらの設定により、ローカルエンドポイント、VPCエンドポイント、およびサードパーティーのローカル AWS 開発環境を柔軟にサポートできます。テスト環境と本番環境には異なるエンドポイントを使用できます。個々の URLのエンドポイントを指定できます AWS のサービス。
サービス固有のエンドポイントは以下の方法で指定できます。
-
1 つのコマンドコマンドラインオプション
--endpoint-url
。 -
環境変数:
-
AWS_IGNORE_CONFIGURED_ENDPOINT_URLS
- コマンドラインで指定されていない限りURLs、設定されたすべてのエンドポイント を無視します。 -
AWS_ENDPOINT_URL_<SERVICE>
- 特定のサービスに使用されるカスタムエンドポイントを指定します。<SERVICE>
は AWS のサービス 識別子に置き換えられます。すべてのサービス固有の変数については、「サービス固有のエンドポイント: サービス固有の識別子のリスト」を参照してください。
-
-
config
ファイル:-
ignore_configure_endpoint_urls
- 環境変数を使用して、またはコマンドラインで指定されていない限りURLs、設定されたすべてのエンドポイント を無視します。 -
endpoint_url
ファイル設定と組み合わされたconfig
ファイルの services セクション。
-
サービス固有のエンドポイントに関するトピック:
サービス固有のエンドポイント: 環境変数
環境変数は Config ファイルの設定を上書きしますが、コマンドラインで指定されたオプションは上書きしません。すべてのプロファイルにデバイス上の同じエンドポイントを使用させたい場合は、環境変数を使用してください。
サービス固有の環境変数は次のとおりです。
-
AWS_IGNORE_CONFIGURED_ENDPOINT_URLS
- コマンドラインで指定されていない限りURLs、設定されたすべてのエンドポイント を無視します。 -
AWS_ENDPOINT_URL_<SERVICE>
- 特定のサービスに使用されるカスタムエンドポイントを指定します。<SERVICE>
は AWS のサービス 識別子に置き換えられます。すべてのサービス固有の変数については、「サービス固有のエンドポイント: サービス固有の識別子のリスト」を参照してください。次の環境変数の例では、 AWS Elastic Beanstalkのエンドポイントを設定します。
環境変数の設定については、「の環境変数の設定 AWS CLI」を参照してください。
サービス固有のエンドポイント: 共有 config
ファイル
共有 config
ファイルでは、endpoint_url
は複数のセクションで使用されます。サービス固有のエンドポイントを設定するには、services
セクション内のサービス ID キーの下にネストされた endpoint_url
設定を使用します。共有 config
ファイル内の services
セクションの定義について詳しくは、「セクションタイプ: services」を参照してください。
次の例では、 services
セクションを使用して、URLAmazon S3 のサービス固有のエンドポイントと、他のすべてのサービスに使用されるカスタムグローバルエンドポイントを設定します。
[profile
dev1
] endpoint_url =http://localhost:1234
services =s3-specific
[servicestesting-s3
] s3 = endpoint_url =http://localhost:4567
1 つのプロファイルで複数のサービスのエンドポイントを設定できます。次の例では、Amazon S3 と URLsのサービス固有のエンドポイントを同じプロファイル AWS Elastic Beanstalk に設定します。
services
セクションで使用するすべてのサービス識別子キーのリストについては、「サービス固有の識別子のリスト」を参照してください。
[profile
dev1
] services =testing-s3-and-eb
[servicestesting-s3-and-eb
] s3 = endpoint_url =http://localhost:4567
elastic_beanstalk = endpoint_url =http://localhost:8000
サービス設定セクションは複数のプロファイルで使用できます。次の例では、2 つのプロファイルが同じ services
定義を使用しています。
[profile
dev1
] output = json services =testing-s3
[profiledev2
] output = text services =testing-s3
[servicestesting-s3
] s3 = endpoint_url =https://localhost:4567
サービス固有のエンドポイント: サービス固有の識別子のリスト
AWS のサービス 識別子は、すべてのスペースをアンダースコアに置き換え、すべての文字を小文字serviceId
に置き換えることでAPI、モデルの に基づいています。
次のサービス識別子の例では を使用しています AWS Elastic Beanstalk。 AWS Elastic Beanstalk は serviceId
の を持つためElastic Beanstalk
、サービス識別子キーは ですelastic_beanstalk
。
次の表は、サービス固有の識別子、config
ファイルキー、環境変数をすべて一覧にしたものです。
エンドポイント設定と設定の優先順位
エンドポイント設定は、システム環境変数やユーザー環境変数、ローカル AWS 設定ファイルなど複数の場所に配置され、コマンドラインでパラメータとして明示的に宣言されます。 AWS CLI エンドポイント構成設定は、次の順序で優先されます。
-
--endpoint-url
コマンドラインオプション。 -
有効にすると、
AWS_IGNORE_CONFIGURED_ENDPOINT_URLS
グローバルエンドポイント環境変数またはプロファイル設定ignore_configure_endpoint_urls
はカスタムエンドポイントを無視します。 -
サービス固有の環境変数
AWS_ENDPOINT_URL_<SERVICE>
(AWS_ENDPOINT_URL_DYNAMODB
など) によって提供される値。 -
AWS_USE_DUALSTACK_ENDPOINT
、AWS_USE_FIPS_ENDPOINT
、およびAWS_ENDPOINT_URL
環境変数によって提供される値。 -
共有
config
ファイルのservices
セクション内のendpoint_url
設定によって提供されるサービス固有のエンドポイント値。 -
共有
config
ファイルのprofile
内のendpoint_url
設定によって提供される値。 -
use_dualstack_endpoint
、use_fips_endpoint
、およびendpoint_url
の設定。 -
それぞれの URLのデフォルトエンドポイント AWS のサービス が最後に使用されます。各リージョンで使用できる標準的なサービスエンドポイントについては、「Amazon Web Services 全般のリファレンス」の「AWS リージョンとエンドポイント」を参照してください。