일반 구성 설정
참고
설정 페이지의 레이아웃을 이해하거나, 이어지는 AWS SDK 및 도구 지원 표를 해석하는 데 도움이 되는 정보는 이 안내서의 설정 페이지의 이해에서 확인하세요.
SDK는 전체 SDK 동작을 구성하는 몇 가지 일반 설정을 지원합니다.
다음을 사용하여 이 기능을 구성하십시오.
api_versions- 공유 AWSconfig파일 설정-
일부 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-01cloudfront =2015-09-017 ca_bundle- 공유 AWSconfig파일 설정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_BUNDLEC:\dev\apps\ca-certs\cabundle-2019mar05.pem output- 공유 AWSconfig파일 설정-
AWS CLI 및 기타 AWS SDK와 도구에서 결과 형식을 지정하는 방법을 지정합니다.
기본값:
json유효값:
-
yaml-stream- 출력은 스트리밍되고 YAML문자열로 형식이 지정됩니다. 스트리밍을 통해 대용량 데이터 유형을 빠르게 처리할 수 있습니다. -
text- 출력은 여러 줄의 탭으로 구분된 문자열 값으로 형식이 지정됩니다. 출력을grep,sed또는awk와 같은 텍스트 프로세서로 전달하는 데 사용할 수 있습니다. -
table- 출력은 셀 테두리를 형성하기 위해 +|- 문자를 사용하여 표로 형식이 지정됩니다. 일반적으로 읽기는 쉽지만 프로그래밍 방식으로는 유용하지 않은 ‘인간 친화적’ 형식으로 정보를 표시합니다.
parameter_validation- 공유 AWSconfig파일 설정-
SDK 또는 도구가 AWS 서비스 엔드포인트에 보내기 전에 명령줄 파라미터를 검증할지 여부를 지정합니다.
기본값:
true유효값:
-
true– 기본값입니다. SDK 또는 도구는 명령줄 파라미터를 클라이언트측에서 검증합니다. 이렇게 하면 SDK 또는 도구가 파라미터가 유효한지 확인하고 일부 오류를 포착하는 데 도움이 됩니다. SDK 또는 도구는 AWS 서비스 엔드포인트로 요청을 보내기 전에 유효하지 않은 요청을 거부할 수 있습니다. -
false– SDK 또는 도구는 AWS 서비스 엔드포인트로 보내기 전에 명령줄 파라미터를 검증하지 않습니다. AWS 서비스 엔드포인트는 모든 요청의 유효성을 검증하고 유효하지 않은 요청은 거부합니다.
-
AWS SDK 및 도구 지원
다음 SDK는 이 주제에서 설명하는 기능 및 설정을 지원합니다. 모든 일부 예외가 기록됩니다. 모든 JVM 시스템 속성 설정은 AWS SDK for Java 및 AWS SDK for Kotlin에서만 지원됩니다.
| SDK | 지원 | 참고 또는 추가 정보 |
|---|---|---|
| AWS CLI v2 | 부분 | api_versions이 지원되지 않음. |
| SDK for C++ | 예 | |
| SDK for Go V2 (1.x) |
부분 | api_versions 및 parameter_validation이 지원되지 않음. |
| SDK for Go 1.x (V1) | 부분 | api_versions 및 parameter_validation이 지원되지 않음. 공유 config 파일 설정을 사용하려면 구성 파일에서 로드를 켜야 합니다. 세션을 참조하십시오. |
| SDK for Java 2.x | 아니요 | |
| SDK for Java 1.x | 아니요 | |
| SDK for JavaScript 3.x | 예 | |
| SDK for JavaScript 2.x | 예 | |
| SDK for Kotlin | 아니요 | |
| SDK for .NET 4.x | 아니요 | |
| SDK for .NET 3.x | 아니요 | |
| SDK for PHP 3.x | 예 | |
| SDK for Python (Boto3) |
예 | |
| SDK for Ruby 3.x | 예 | |
| SDK for Rust | 아니요 | |
| SDK for Swift | 아니요 | |
| Tools for PowerShell V5 | 아니요 | |
| Tools for PowerShell V4 | 아니요 |