でエンドポイントを使用する AWS CLI - AWS Command Line Interface

このドキュメントは、 のバージョン 1 AWS CLI のみを対象としています。のバージョン 2 に関連するドキュメントについては AWS CLI、「 バージョン 2 ユーザーガイド」を参照してください。

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

でエンドポイントを使用する AWS CLI

にプログラムで接続するには AWS service、エンドポイントを使用します。エンドポイントは、 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 services

すべてのサービスのリクエストをカスタムエンドポイント にルーティングするにはURL、次のいずれかの設定を使用します。

  • 環境変数:

    • AWS_IGNORE_CONFIGURED_ENDPOINT_URLS - 設定されたエンドポイント を無視しますURLs。

      Linux or macOS
      $ export AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true
      Windows Command Prompt

      すべてのセッションに設定するには

      C:\> setx AWS_IGNORE_CONFIGURED_ENDPOINT_URLS true

      現在のセッションのみに設定するには

      C:\> set AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true
      PowerShell
      PS C:\> $Env:AWS_IGNORE_CONFIGURED_ENDPOINT_URLS="true"
    • AWS_ENDPOINT_URL - グローバルエンドポイント を設定しますURL。

      Linux or macOS
      $ export AWS_ENDPOINT_URL=http://localhost:4567
      Windows Command Prompt

      すべてのセッションに設定するには

      C:\> setx AWS_ENDPOINT_URL http://localhost:4567

      現在のセッションのみに設定するには

      C:\> set AWS_ENDPOINT_URL=http://localhost:4567
      PowerShell
      PS C:\> $Env:AWS_ENDPOINT_URL="http://localhost:4567"
  • config ファイル:

    • ignore_configure_endpoint_urls - 設定されたエンドポイント を無視しますURLs。

      ignore_configure_endpoint_urls = true
    • endpoint_url - グローバルエンドポイント を設定しますURL。

      endpoint_url = http://localhost:4567

サービス固有のエンドポイントと --endpoint-url コマンドラインオプションはすべてのグローバルエンドポイントよりも優先されます。

すべての のFIPsエンドポイントを使用するように を設定する AWS services

FIPs エンドポイントを使用するようにすべてのサービスのリクエストをルーティングするには、次のいずれかを使用します。

  • AWS_USE_FIPS_ENDPOINT 環境変数

    Linux or macOS
    $ export AWS_USE_FIPS_ENDPOINT=true
    Windows Command Prompt

    すべてのセッションに設定するには

    C:\> setx AWS_USE_FIPS_ENDPOINT true

    現在のセッションのみに設定するには

    C:\> set AWS_USE_FIPS_ENDPOINT=true
    PowerShell
    PS C:\> $Env:AWS_USE_FIPS_ENDPOINT="true"
  • use_fips_endpoint ファイルの設定。

    use_fips_endpoint = true

一部の AWS サービスでは、連邦情報処理規格 (FIPS) 140-2 をサポートするエンドポイントが一部の で提供されています AWS リージョン。 AWS サービスが をサポートする場合FIPS、この設定では、 が AWS CLI を使用するFIPSエンドポイントを指定します。標準 AWS エンドポイントとは異なり、FIPSエンドポイントは 140-2 FIPS に準拠したTLSソフトウェアライブラリを使用します。このエンドポイントは、米国政府とやり取りをする企業で必要とされる場合があります。

この設定が有効になっていても、 のサービスにFIPSエンドポイントが存在しない場合 AWS リージョン、 AWS コマンドは失敗する可能性があります。この場合は、--endpoint-url オプションを使用してコマンドで使用するエンドポイントを手動で指定するか、サービス固有のエンドポイントを使用します。

によるFIPSエンドポイントの指定の詳細については AWS リージョン、FIPS「サービスによるエンドポイント」を参照してください。

すべての AWS servicesでデュアルスタックのエンドポイントを使用するように設定

利用可能な場合に、すべてのサービスでデュアルスタックエンドポイントを使用するようにリクエストをルーティングするには、以下の設定のいずれかを使用します。

  • AWS_USE_DUALSTACK_ENDPOINT 環境変数

    Linux or macOS
    $ export AWS_USE_DUALSTACK_ENDPOINT=true
    Windows Command Prompt

    すべてのセッションに設定するには

    C:\> setx AWS_USE_DUALSTACK_ENDPOINT true

    現在のセッションのみに設定するには

    C:\> set AWS_USE_DUALSTACK_ENDPOINT=true
    PowerShell
    PS C:\> $Env:AWS_USE_DUALSTACK_ENDPOINT="true"
  • use_dualstack_endpoint ファイルの設定。

    use_dualstack_endpoint = true

デュアルスタックのエンドポイントを使用して AWS リクエストを送信できるようにします。IPv4 と の両方のIPv6トラフィックをサポートするデュアルスタックエンドポイントの詳細については、Amazon Simple Storage Service Amazon S3 デュアルスタックエンドポイントの使用」を参照してください。デュアルスタックのエンドポイントは、一部のリージョンでは一部のサービスで利用できます。サービスまたは にデュアルスタックのエンドポイントが存在しない場合 AWS リージョン、リクエストは失敗します。これはデフォルトでは無効になっています。

サービス固有のエンドポイントを設定します。

サービス固有のエンドポイント設定では、選択した永続エンドポイントを AWS CLI リクエストに使用するオプションが提供されます。これらの設定により、ローカルエンドポイント、VPCエンドポイント、およびサードパーティーのローカル AWS 開発環境を柔軟にサポートできます。テスト環境と本番環境には異なるエンドポイントを使用できます。URL 個々の のエンドポイントを指定できます AWS services。

サービス固有のエンドポイントは以下の方法で指定できます。

サービス固有のエンドポイントに関するトピック:

サービス固有のエンドポイント: 環境変数

環境変数は Config ファイルの設定を上書きしますが、コマンドラインで指定されたオプションは上書きしません。すべてのプロファイルにデバイス上の同じエンドポイントを使用させたい場合は、環境変数を使用してください。

サービス固有の環境変数は次のとおりです。

  • AWS_IGNORE_CONFIGURED_ENDPOINT_URLS - コマンドラインで指定されていない限りURLs、設定されたすべてのエンドポイント を無視します。

    Linux or macOS
    $ export AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true
    Windows Command Prompt

    すべてのセッションに設定するには

    C:\> setx AWS_IGNORE_CONFIGURED_ENDPOINT_URLS true

    現在のセッションのみに設定するには

    C:\> set AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true
    PowerShell
    PS C:\> $Env:AWS_IGNORE_CONFIGURED_ENDPOINT_URLS="true"
  • AWS_ENDPOINT_URL_<SERVICE> - 特定のサービスに使用されるカスタムエンドポイントを指定します。 <SERVICE> は AWS service 識別子に置き換えられます。すべてのサービス固有の変数については、「サービス固有のエンドポイント: サービス固有の識別子のリスト」を参照してください。

    次の環境変数の例では、 AWS Elastic Beanstalkのエンドポイントを設定します。

    Linux or macOS
    $ export AWS_ENDPOINT_URL_ELASTIC_BEANSTALK=http://localhost:4567
    Windows Command Prompt

    すべてのセッションに設定するには

    C:\> setx AWS_ENDPOINT_URL_ELASTIC_BEANSTALK http://localhost:4567

    現在のセッションのみに設定するには

    C:\> set AWS_ENDPOINT_URL_ELASTIC_BEANSTALK=http://localhost:4567
    PowerShell
    PS C:\> $Env:AWS_ENDPOINT_URL_ELASTIC_BEANSTALK="http://localhost:4567"

環境変数の設定については、「を設定する環境変数 AWS CLI」を参照してください。

サービス固有のエンドポイント: 共有 config ファイル

共有 config ファイルでは、endpoint_url は複数のセクションで使用されます。サービス固有のエンドポイントを設定するには、services セクション内のサービス ID キーの下にネストされた endpoint_url 設定を使用します。共有 config ファイル内の services セクションの定義について詳しくは、「セクションタイプ: services」を参照してください。

次の例では、 servicesセクションを使用して URL Amazon S3 のサービス固有のエンドポイントと、他のすべてのサービスに使用されるカスタムグローバルエンドポイントを設定します。

[profile dev1] endpoint_url = http://localhost:1234 services = s3-specific [services testing-s3] s3 = endpoint_url = http://localhost:4567

1 つのプロファイルで複数のサービスのエンドポイントを設定できます。次の例では、同じプロファイル AWS Elastic Beanstalk で Amazon S3 と URLsのサービス固有のエンドポイントを設定します。

services セクションで使用するすべてのサービス識別子キーのリストについては、「サービス固有の識別子のリスト」を参照してください。

[profile dev1] services = testing-s3-and-eb [services testing-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 [profile dev2] output = text services = testing-s3 [services testing-s3] s3 = endpoint_url = https://localhost:4567

サービス固有のエンドポイント: サービス固有の識別子のリスト

AWS service 識別子は、すべてのスペースをアンダースコアに置き換え、すべての文字を小文字に置き換えserviceIdることで、APIモデルの に基づいています。

次のサービス識別子の例では、 を使用しています AWS Elastic Beanstalk。 AWS Elastic Beanstalk は serviceIdの を持つためElastic Beanstalk、サービス識別子キーは ですelastic_beanstalk

次の表は、サービス固有の識別子、config ファイルキー、環境変数をすべて一覧にしたものです。

エンドポイント設定と設定の優先順位

エンドポイント設定は、システム環境変数やユーザー環境変数、ローカル AWS 設定ファイルなど複数の場所に配置され、コマンドラインでパラメータとして明示的に宣言されます。 AWS CLI エンドポイント構成設定は、次の順序で優先されます。

  1. --endpoint-url コマンドラインオプション。

  2. 有効にすると、AWS_IGNORE_CONFIGURED_ENDPOINT_URLS グローバルエンドポイント環境変数またはプロファイル設定 ignore_configure_endpoint_urls はカスタムエンドポイントを無視します。

  3. サービス固有の環境変数 AWS_ENDPOINT_URL_<SERVICE> (AWS_ENDPOINT_URL_DYNAMODB など) によって提供される値。

  4. AWS_USE_DUALSTACK_ENDPOINTAWS_USE_FIPS_ENDPOINT、および AWS_ENDPOINT_URL 環境変数によって提供される値。

  5. 共有 config ファイルの services セクション内の endpoint_url 設定によって提供されるサービス固有のエンドポイント値。

  6. 共有 config ファイルの profile 内の endpoint_url 設定によって提供される値。

  7. use_dualstack_endpointuse_fips_endpoint、および endpoint_url の設定。

  8. それぞれの URLのデフォルトエンドポイント AWS service が最後に使用されます。各リージョンで使用できる標準的なサービスエンドポイントについては、「Amazon Web Services 全般のリファレンス」の「AWS リージョンとエンドポイント」を参照してください。