AWS CLI에서 간편 구문 사용 - AWS Command Line Interface
구조 파라미터간편 구문

이 문서는 AWS CLI의 버전 1에만 해당합니다. AWS CLI의 버전 2와 관련된 문서는 버전 2 사용 설명서를 참조하세요.

AWS CLI에서 간편 구문 사용

AWS Command Line Interface(AWS CLI)는 JSON 형식으로 많은 옵션 파라미터를 허용할 수 있습니다. 그러나 긴 JSON 목록이나 구조를 명령줄에 입력하려면 지루할 수 있습니다. 입력을 쉽게 하기 위해 AWS CLI는 전체 JSON 형식을 사용하는 것보다 더 간단하게 옵션 파라미터를 표시할 수 있는 간편 구문도 지원합니다.

구조 파라미터

AWS CLI에서 간편 구문을 사용하면 사용자가 플랫(중첩되지 않은 구조) 파라미터를 더 쉽게 입력할 수 있습니다. 형식은 쉼표로 구분된 키 값 페어 목록입니다. 간편 구문은 문자열이므로 해당 터미널에 적용되는 인용 및 이스케이프 규칙을 사용해야 합니다.

Linux or macOS
--option key1=value1,key2=value2,key3=value3
PowerShell
--option "key1=value1,key2=value2,key3=value3"

이 구문은 모두 JSON 형식의 다음 예와 동등합니다.

--option '{"key1":"value1","key2":"value2","key3":"value3"}'

쉼표로 구분된 각 키 값 페어 사이에 공백이 없어야 합니다. 다음은 update-table 옵션이 간편 방식으로 지정되어 있는 Amazon DynamoDB --provisioned-throughput 명령입니다.

$ aws dynamodb update-table \
    --provisioned-throughput ReadCapacityUnits=15,WriteCapacityUnits=10 \
    --table-name MyDDBTable

이 구문은 JSON 형식의 다음 예와 동등합니다.

$ aws dynamodb update-table \
    --provisioned-throughput '{"ReadCapacityUnits":15,"WriteCapacityUnits":10}' \
    --table-name MyDDBTable

AWS Command Line Interface에서 간편 구문 사용

목록 형식의 입력 파라미터는 JSON 또는 간편 구문이라는 두 가지 방법으로 지정할 수 있습니다. AWS CLI의 간편 구문은 숫자, 문자열 또는 비중첩 구조가 있는 목록을 더 쉽게 입력할 수 있도록 하기 위해 설계되었습니다.

기본 형식은 여기에 표시됩니다. 여기서 목록의 값은 단일 공백으로 구분됩니다.

--option value1 value2 value3

이 구문은 JSON 형식의 다음 예와 동등합니다.

--option '[value1,value2,value3]'

앞에서 언급한 바와 같이, 숫자 목록, 문자열 목록 또는 비중첩 구조 목록을 간편 방식으로 지정할 수 있습니다. 다음은 Amazon Elastic Compute Cloud(Amazon EC2)에 대한 stop-instances 명령의 예입니다. 여기서 --instance-ids 옵션에 대한 입력 파라미터(문자열 목록)는 간편 방식으로 지정됩니다.

$ aws ec2 stop-instances \
    --instance-ids i-1486157a i-1286157c i-ec3a7e87

이 구문은 JSON 형식의 다음 예와 동등합니다.

$ aws ec2 stop-instances \
    --instance-ids '["i-1486157a","i-1286157c","i-ec3a7e87"]'

다음 예제는 Amazon EC2 create-tags 명령을 보여줍니다. 이 명령은 --tags 옵션에 대한 비중첩 구조 목록을 가져옵니다. --resources 옵션은 태깅할 인스턴스의 ID를 지정합니다.

$ aws ec2 create-tags \
    --resources i-1286157c \
    --tags Key=My1stTag,Value=Value1 Key=My2ndTag,Value=Value2 Key=My3rdTag,Value=Value3

이 구문은 JSON 형식의 다음 예와 동등합니다. JSON 파라미터는 쉽게 읽을 수 있도록 여러 줄로 작성됩니다.

$ aws ec2 create-tags \
    --resources i-1286157c \
    --tags '[
        {"Key": "My1stTag", "Value": "Value1"},
        {"Key": "My2ndTag", "Value": "Value2"},
        {"Key": "My3rdTag", "Value": "Value3"}
    ]'