이 설명서는 의 버전 1 AWS CLI 전용입니다. 의 버전 2와 관련된 설명서는 버전 2 사용 설명서 를 AWS CLI참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
명령줄 옵션
에서 명령줄 옵션은 해당 단일 명령에 대한 기본 구성 설정, 해당 프로필 설정 또는 환경 변수 설정을 재정의하는 데 사용할 수 있는 글로벌 매개 변수입니다. AWS CLI명령줄 옵션을 통해 사용할 프로필을 지정할 수 있지만, 해당 옵션으로 보안 인증을 직접 지정할 수 없습니다.
명령줄 옵션 사용 방법
대부분의 명령줄 옵션은 다음 예에 나온 프로파일 이름 profile1과 같은 단순한 문자열입니다.
$aws s3 ls --profileprofile1example-bucket-1 example-bucket-2 ...
인수를 가져오는 각 옵션에서는 공백이나 등호(=)를 사용하여 인수를 옵션 이름과 구분해야 합니다. 인수 값이 공백이 포함된 문자열인 경우 해당 인수의 앞뒤에 따옴표를 사용해야 합니다. 파라미터의 인수 유형 및 형식에 대한 자세한 내용은 에 대한 매개변수 값을 지정합니다. AWS CLI 단원을 참조하세요.
AWS CLI 지원되는 글로벌 명령줄 옵션
에서 다음 명령줄 옵션을 사용하여 해당 단일 명령에 대한 기본 구성 설정, 해당 프로필 설정 또는 환경 변수 설정을 재정의할 수 있습니다. AWS CLI
- --ca-bundle
<string> -
인증서를 확인할 때 사용할 인증 기관 (CA) 인증서 번들을 지정합니다. SSL
정의된 경우 이 옵션은 프로파일 설정
ca_bundle의 값 및AWS_CA_BUNDLE환경 변수를 재정의합니다. - --cli-connect-timeout
<integer> -
최대 소켓 연결 시간을 초 단위로 지정합니다. 이 값이 0으로 설정되어 있으면 소켓 연결이 무한 대기 상태(차단 상태)가 되고 제한 시간이 적용되지 않습니다.
- --cli-read-timeout
<integer> -
최대 소켓 읽기 시간을 초 단위로 지정합니다. 이 값이 0으로 설정되어 있으면 소켓 읽기가 무한 대기 상태(차단 상태)가 되고 제한 시간이 적용되지 않습니다.
- --color
<string> -
색상 출력에 대한 지원 여부를 지정합니다. 유효 값은
on,off및auto입니다. 기본 값은auto입니다. - --디버그
-
디버그 로깅을 활성화하는 부울 스위치입니다. AWS CLI 기본적으로 명령 출력의 명령 결과와 관련된 성공 또는 실패에 대한 정리된 정보가 제공됩니다.
--debug옵션은 전체 Python 로그를 제공합니다. 여기에는 해당 명령의 작동에 대한 추가적인stderr진단 정보가 포함되어 있는데, 이는 명령이 예기치 않은 결과를 제공하는 이유를 해결할 때 유용할 수 있습니다. 디버그 로그를 쉽게 보려면 정보를 쉽게 검색할 수 있도록 로그를 파일로 보내는 것이 좋습니다. 이를 위해 다음 중 하나를 사용할 수 있습니다.stderr진단 정보만 보내려면2> debug.txt를 추가합니다. 여기서debug.txt는 디버그 파일에 사용할 이름입니다.$aws2>servicenamecommandnameoptions--debugdebug.txt출력과
stderr진단 정보둘 다 보내려면&> debug.txt를 추가합니다. 여기서debug.txt는 디버그 파일에 사용할 이름입니다.$aws&>servicenamecommandnameoptions--debugdebug.txt - --엔드포인트-url
<string> -
요청을 URL 보낼 대상을 지정합니다. 대부분의 명령의 경우 는 선택한 서비스와 지정된 AWS 지역을 URL 기반으로 AWS CLI 자동으로 결정합니다. 하지만 일부 명령의 경우 계정별로 지정해야 합니다. URL 프라이빗 VPC 내에서 엔드포인트를 직접 호스팅하도록 일부 AWS 서비스를 구성할 수도 있습니다. 그런 다음 해당 엔드포인트를 지정해야 할 수도 있습니다.
다음 명령 예제는 사용자 지정 Amazon S3 엔드포인트를 사용합니다URL.
$aws s3 ls --endpoint-urlhttp://localhost:4567엔드포인트 구성 설정은 시스템 또는 사용자 환경 변수, 로컬 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설정입니다. -
각 AWS 서비스 엔드포인트의 모든 기본 엔드포인트가 URL 마지막에 사용됩니다. 각 리전에서 사용할 수 있는 표준 서비스 엔드포인트 목록은 Amazon Web Services 일반 참조의 AWS 리전 및 엔드포인트를 참조하세요.
-
- --no-paginate
-
출력의 페이지 매김을 생성하는 모든 명령 결과를 수신하기 위해 자동으로 AWS CLI 여러 번 호출하는 것을 비활성화하는 부울 스위치입니다. 즉, 출력의 첫 번째 페이지만 표시됩니다.
- --no-sign-request
-
서비스 엔드포인트에 대한 HTTP 요청 서명을 비활성화하는 부울 스위치입니다. AWS 이렇게 하면 보안 인증이 로드되는 것을 방지할 수 있습니다.
- --no-verify-ssl
-
기본적으로 서비스와 SSL AWS 통신할 때 AWS CLI 사용합니다. 는 각 SSL 연결 및 호출에 대해 SSL 인증서를 AWS CLI 확인합니다. 이 옵션을 사용하면 인증서를 확인하는 기본 동작이 무시됩니다. SSL
주의
이 옵션은 모범 사례가 아닙니다. 를 사용하면
--no-verify-ssl클라이언트와 AWS 서비스 간의 트래픽이 더 이상 보호되지 않습니다. 즉, 트래픽은 보안 위험이며 man-in-the-middle 악용에 취약합니다. 인증서에 문제가 있는 경우 대신 해당 문제를 해결하는 것이 좋습니다. 인증서 문제 해결 단계는 SSL인증서 오류 섹션을 참조하세요. - --출력
<string> -
이 명령에 사용할 출력 형식을 지정합니다. 다음 값 중 하나를 지정할 수 있습니다.
- --profile
<string> -
이 명령에 사용할 명명된 프로필을 지정합니다. 명명된 프로필을 추가로 설정하려면
aws configure명령을--profile옵션과 함께 사용하면 됩니다.$aws configure --profile<profilename> - --query
<string> -
응답 데이터를 필터링하는 데 사용할 JMESPath쿼리를
지정합니다. 자세한 내용은 필터 AWS CLI 출력 단원을 참조하십시오. - --region
<string> -
이 명령의 AWS 요청을 보낼 AWS 지역을 지정합니다. 지정할 수 있는 모든 리전 목록은 Amazon Web Services 일반 참조의 AWS 리전 및 엔드포인트를 참조하세요.
- --version
-
실행 중인 AWS CLI 프로그램의 현재 버전을 표시하는 부울 스위치입니다.
명령줄 옵션의 일반적인 용도
명령줄 옵션의 일반적인 용도는 AWS 리전에서 리소스를 확인하고 읽기 쉽게 또는 스크립팅할 때 사용하기 쉽게 출력 형식을 변경하는 것입니다. 다음 예제에서는 인스턴스가 있는 리전을 찾을 때까지 각 리전에 대해 describe-instances 명령을 실행합니다.
$aws ec2 describe-instances --output table --regionus-west-1------------------- |DescribeInstances| +-----------------+$aws ec2 describe-instances --output table --regionus-west-2------------------------------------------------------------------------------ | DescribeInstances | +----------------------------------------------------------------------------+ || Reservations || |+-------------------------------------+------------------------------------+| || OwnerId | 012345678901 || || ReservationId | r-abcdefgh || |+-------------------------------------+------------------------------------+| ||| Instances ||| ||+------------------------+-----------------------------------------------+|| ||| AmiLaunchIndex | 0 ||| ||| Architecture | x86_64 ||| ...
