일반 구성 설정 - AWS SDK 및 도구

일반 구성 설정

참고

설정 페이지의 레이아웃을 이해하거나, 이어지는 AWS SDK 및 도구 지원 표를 해석하는 데 도움이 되는 정보는 이 안내서의 설정 페이지의 이해에서 확인하세요.

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 SDK와 도구에서 결과 형식을 지정하는 방법을 지정합니다.

기본값: json

유효값:

  • json - 출력은 JSON 문자열로 형식이 지정됩니다.

  • yaml - 출력은 YAML 문자열로 형식이 지정됩니다.

  • yaml-stream - 출력은 스트리밍되고 YAML 문자열로 형식이 지정됩니다. 스트리밍을 통해 대용량 데이터 유형을 빠르게 처리할 수 있습니다.

  • text - 출력은 여러 줄의 탭으로 구분된 문자열 값으로 형식이 지정됩니다. 출력을 grep, sed 또는 awk와 같은 텍스트 프로세서로 전달하는 데 사용할 수 있습니다.

  • table - 출력은 셀 테두리를 형성하기 위해 +|- 문자를 사용하여 표로 형식이 지정됩니다. 일반적으로 읽기는 쉽지만 프로그래밍 방식으로는 유용하지 않은 ‘인간 친화적’ 형식으로 정보를 표시합니다.

parameter_validation- 공유 AWS config 파일 설정

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_versionsparameter_validation이 지원되지 않음.
SDK for Go 1.x (V1) 부분 api_versionsparameter_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 아니요