

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 일반 구성 설정
<a name="feature-gen-config"></a>

**참고**  
설정 페이지의 레이아웃을 이해하거나 다음에 나오는 **Support AWS SDKs**[이 안내서의 설정 페이지의 이해](settings-reference.md#settingsPages).

SDK는 전체 SDK 동작을 구성하는 몇 가지 일반 설정을 지원합니다.

다음을 사용하여 이 기능을 구성하십시오.

**`api_versions` - 공유 AWS `config` 파일 설정**  
일부 AWS 서비스는 이전 버전과의 호환성을 지원하기 위해 여러 API 버전을 유지 관리합니다. 기본적으로 SDK 및 AWS CLI 작업은 최신 API 버전을 사용합니다. 요청에 사용할 특정 API 버전을 요구하려면 프로파일에 `api_versions` 설정을 포함하십시오.  
**기본값:** 없음. (SDK에는 최신 API 버전이 사용합니다.)   
**유효한 값:** 중첩된 설정으로, 그 뒤에 사용할 AWS 서비스와 API 버전을 각각 식별하는 하나 이상의 들여쓰기된 줄이 옵니다. 사용 가능한 API 버전을 알아보려면 AWS 서비스 설명서를 참조하세요.  
 이 예제에서는 `config` 파일의 두 AWS 서비스에 대해 특정 API 버전을 설정합니다. 이러한 API 버전은 이러한 설정이 포함된 프로파일 하에서 실행되는 명령에서만 사용됩니다. 다른 서비스의 명령은 해당 서비스 API의 최신 버전을 사용합니다.  

```
api_versions =
    ec2 = {{2015-03-01}}
    cloudfront = {{2015-09-017}}
```

**`ca_bundle` - 공유 AWS `config` 파일 설정`AWS_CA_BUNDLE` - 환경 변수**  
SSL/TLS 연결을 설정할 때 사용할 사용자 지정 인증서 번들(`.pem` 확장명이 있는 파일)의 경로를 지정합니다.  
**기본값:** 없음  
**유효한 값:** 전체 경로 또는 기본 파일 이름을 지정합니다. 기본 파일 이름이 있는 경우, 시스템은 `PATH` 환경 변수로 지정된 폴더 내에서 프로그램을 찾으려고 시도합니다.  
 `config` 파일에서 이 값을 설정하는 예:  

```
[default]
ca_bundle = {{dev/apps/ca-certs/cabundle-2019mar05.pem}}
```
운영체제마다 경로 처리 방식과 경로 문자 이스케이프 방식이 다르기 때문에, 다음은 Windows의 `config` 파일에서 이 값을 설정하는 예시입니다.  

```
[default]
ca_bundle = {{C:\\Users\\username\\.aws\\aws-custom-bundle.pem}}
```
명령 행을 통한 환경 변수 설정의 Linux/macOS 예제:  

```
export AWS_CA_BUNDLE={{/dev/apps/ca-certs/cabundle-2019mar05.pem}}
```
명령줄을 통해 환경 변수를 설정하는 Windows 예제:  

```
setx AWS_CA_BUNDLE {{C:\dev\apps\ca-certs\cabundle-2019mar05.pem}}
```

**`output` - 공유 AWS `config` 파일 설정**  
 AWS CLI 및 기타 AWS SDKs 및 도구에서 결과의 형식을 지정하는 방법을 지정합니다.  
**기본값:** `json`  
**유효값:**  
+ **[https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#json-output](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#json-output)** - 출력은 [JSON](https://json.org/) 문자열로 형식이 지정됩니다.
+  **[https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#yaml-output](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#yaml-output)** - 출력은 [YAML](https://yaml.org/) 문자열로 형식이 지정됩니다.
+ **[https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#yaml-stream-output](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#yaml-stream-output)** - 출력은 스트리밍되고 [YAML](https://yaml.org/) 문자열로 형식이 지정됩니다. 스트리밍을 통해 대용량 데이터 유형을 빠르게 처리할 수 있습니다.
+ **[https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#text-output](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#text-output)** - 출력은 여러 줄의 탭으로 구분된 문자열 값으로 형식이 지정됩니다. 출력을 `grep`, `sed` 또는 `awk`와 같은 텍스트 프로세서로 전달하는 데 사용할 수 있습니다.
+ **[https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#table-output](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#table-output)** - 출력은 셀 테두리를 형성하기 위해 \+\|- 문자를 사용하여 표로 형식이 지정됩니다. 일반적으로 읽기는 쉽지만 프로그래밍 방식으로는 유용하지 않은 ‘인간 친화적’ 형식으로 정보를 표시합니다.

**`parameter_validation` - 공유 AWS `config` 파일 설정**  
SDK 또는 도구가 AWS 서비스 엔드포인트에 보내기 전에 명령줄 파라미터를 검증할지 여부를 지정합니다.  
**기본값:** `true`  
**유효값:**  
+ **`true`** – 기본값입니다. SDK 또는 도구는 명령줄 파라미터를 클라이언트측에서 검증합니다. 이렇게 하면 SDK 또는 도구가 파라미터가 유효한지 확인하고 일부 오류를 포착하는 데 도움이 됩니다. SDK 또는 도구는 요청을 AWS 서비스 엔드포인트로 보내기 전에 유효하지 않은 요청을 거부할 수 있습니다.
+  **`false`** - SDK 또는 도구는 AWS 서비스 엔드포인트로 전송하기 전에 명령줄 파라미터를 검증하지 않습니다. AWS 서비스 엔드포인트는 모든 요청을 검증하고 유효하지 않은 요청을 거부할 책임이 있습니다.

## AWS SDKs 도구 지원
<a name="feature-gen-config-sdk-compat"></a>

다음 SDK는 이 주제에서 설명하는 기능 및 설정을 지원합니다. 모든 일부 예외가 기록됩니다. 모든 JVM 시스템 속성 설정은 AWS SDK for Java 및 AWS SDK for Kotlin 에서만 지원됩니다.


| SDK | 지원됨 | 참고 또는 추가 정보 | 
| --- | --- | --- | 
| [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) v2 | 부분적 | api\_versions이 지원되지 않음. | 
| [SDK for C\+\+](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | 예 |  | 
| [SDK for Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | 부분적 | api\_versions 및 parameter\_validation이 지원되지 않음. | 
| [SDK for Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | 부분적 | api\_versions 및 parameter\_validation이 지원되지 않음. 공유 config 파일 설정을 사용하려면 구성 파일에서 로드를 켜야 합니다. [세션](https://docs.aws.amazon.com/sdk-for-go/api/aws/session/)을 참조하십시오. | 
| [SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | 아니요 |  | 
| [SDK for Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | 아니요 |  | 
| [SDK for JavaScript 3.x](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | 예 |  | 
| [SDK for JavaScript 2.x](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | 예 |  | 
| [SDK for Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | 아니요 |  | 
| [.NET 4.x용 SDK](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | 아니요 |  | 
| [SDK for .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | 아니요 |  | 
| [SDK for PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | 예 |  | 
| [SDK for Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | 예 |  | 
| [SDK for Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | 예 |  | 
| [SDK for Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | 아니요 |  | 
| [SDK for Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | 아니요 |  | 
| [PowerShell V5용 도구](https://docs.aws.amazon.com/powershell/latest/userguide/) | 아니요 |  | 
| [PowerShell V4용 도구](https://docs.aws.amazon.com/powershell/v4/userguide/) | 아니요 |  | 