단일 명령에 대한 엔드포인트 설정 모든 에 대한 전역 엔드포인트 설정 AWS 서비스 모든 에 대해 FIPs 엔드포인트를 사용하도록 설정 AWS 서비스 모든 AWS 서비스에 이중 스택 엔드포인트를 사용하도록 설정 서비스별 엔드포인트 설정 엔드포인트 구성 및 설정 우선 순위

에서 엔드포인트 사용 AWS CLI

에 프로그래밍 방식으로 연결하려면 엔드포인트를 AWS 서비스사용합니다. 엔드포인트는 AWS 웹 서비스에 대한 진입점URL의 입니다. AWS Command Line Interface (AWS CLI)는 의 각 서비스에 대해 기본 엔드포인트를 자동으로 사용하지 AWS 리전만 API 요청에 대해 대체 엔드포인트를 지정할 수 있습니다.

엔드포인트 주제

단일 명령에 대한 엔드포인트 설정

단일 명령에 대한 엔드포인트 설정이나 환경 변수를 재정의하려면 --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 엔드포인트를 사용할 모든 서비스에 대한 요청을 라우팅하려면 다음 중 하나를 사용합니다.

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 엔드포인트는 FIPS 140-2를 준수하는 TLS 소프트웨어 라이브러리를 사용합니다. 이러한 엔드포인트는 미국 정부와 상호 작용하는 기업에 필요할 수 있습니다.

이 설정이 활성화되었지만 의 서비스에 대한 FIPS 엔드포인트가 없는 경우 AWS 명령 AWS 리전이 실패할 수 있습니다. 이 경우 --endpoint-url 옵션을 사용하여 명령에 사용할 엔드포인트를 수동으로 지정하거나 서비스별 엔드포인트를 사용합니다.

로 FIPS 엔드포인트를 지정하는 방법에 대한 자세한 내용은 서비스별 엔드포인트 를 AWS 리전참조하세요. FIPS

모든 AWS 서비스에 이중 스택 엔드포인트를 사용하도록 설정

모든 서비스에 대한 요청을 사용 가능한 이중 스택 엔드포인트로 라우팅하려면 다음 설정 중 하나를 사용하세요.

AWS_USE_DUALSTACK_ENDPOINT 환경 변수

use_dualstack_endpoint 파일 설정
```
use_dualstack_endpoint = true
```

듀얼 스택 엔드포인트를 사용하여 AWS 요청을 보낼 수 있습니다. IPv4 및 IPv6 트래픽을 모두 지원하는 듀얼 스택 엔드포인트에 대한 자세한 내용은 Amazon Simple Storage Service 사용 설명서의 Amazon S3 듀얼 스택 엔드포인트 사용을 참조하세요. 이중 스택 엔드포인트는 일부 리전에 사용할 수 있는 서비스입니다. 서비스 또는 에 대한 듀얼 스택 엔드포인트가 없는 경우 요청이 실패 AWS 리전합니다. 이 옵션은 기본적으로 비활성화되어 있습니다.

서비스별 엔드포인트 설정

서비스별 엔드포인트 구성은 AWS CLI 요청에 대해 선택한 영구 엔드포인트를 사용할 수 있는 옵션을 제공합니다. 이러한 설정은 로컬 엔드포인트, VPC 엔드포인트 및 타사 로컬 AWS 개발 환경을 지원할 수 있는 유연성을 제공합니다. 테스트 환경과 프로덕션 환경에 서로 다른 엔드포인트를 사용할 수 있습니다. 개별 에 URL 대한 엔드포인트를 지정할 수 있습니다 AWS 서비스.

서비스별 엔드포인트는 다음과 같은 방법으로 지정할 수 있습니다.

단일 명령에 대한 명령줄 옵션 --endpoint-url.
환경 변수:
- AWS_IGNORE_CONFIGURED_ENDPOINT_URLS - 명령줄에 지정URLs되지 않은 한 구성된 모든 엔드포인트를 무시합니다.
- AWS_ENDPOINT_URL_<SERVICE> - 특정 서비스에 사용되는 사용자 지정 엔드포인트를 지정하며, 여기서 <SERVICE>는 AWS 서비스 서비스 식별자로 대체됩니다. 모든 서비스별 변수에 대해서는 서비스별 엔드포인트: 서비스별 식별자 목록를 참조하세요
config 파일:
- ignore_configure_endpoint_urls - 환경 변수를 사용하거나 명령줄에 지정URLs하지 않는 한 구성된 모든 엔드포인트를 무시합니다.
- config 파일의 services 섹션과 endpoint_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_<SERVICE> - 특정 서비스에 사용되는 사용자 지정 엔드포인트를 지정합니다. 여기서 <SERVICE> 는 AWS 서비스 식별자로 대체됩니다. 모든 서비스별 변수에 대해서는 서비스별 엔드포인트: 서비스별 식별자 목록를 참조하세요

다음 환경 변수 예제는 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 섹션 내의 서비스 식별자 키 아래에 중첩된 endpoint_url 설정을 사용하세요. 공유 config 파일에서 services 섹션을 정의하는 방법에 대한 자세한 내용은 섹션 유형: services를 참조하세요.

다음 예제에서는 services 섹션을 사용하여 Amazon S3에 URL 대한 서비스별 엔드포인트와 다른 모든 서비스에 사용되는 사용자 지정 글로벌 엔드포인트를 구성합니다.


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

[services testing-s3]
s3 = 
  endpoint_url = http://localhost:4567

단일 프로파일로 여러 서비스에 대한 엔드포인트를 구성할 수 있습니다. 다음 예제에서는 Amazon S3 및 에 URLs 대한 서비스별 엔드포인트를 동일한 프로파일 AWS Elastic Beanstalk 에 설정합니다.

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

서비스 구성 섹션은 여러 프로파일에서 사용할 수 있습니다. 다음 예제에서는 두 개의 프로파일이 동일한 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 서비스 식별자는 모든 공백을 밑줄로 바꾸고 모든 문자를 소문자로 표시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 리전 및 엔드포인트를 참조하세요.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

에 대한 HTTP 프록시 사용 AWS CLI

인증 및 액세스 보안 인증