이 설명서는 의 버전 1 AWS CLI 전용입니다. 의 버전 2와 관련된 설명서는 버전 2 사용 설명서 를 AWS CLI참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AWS CLI 스켈레톤 및 입력 파일
대부분의 AWS CLI 명령은 파일의 모든 파라미터 입력을 허용합니다. 이러한 템플릿은 generate-cli-skeleton
옵션을 사용하여 생성할 수 있습니다.
AWS CLI 스켈레톤 및 입력 파일 정보
대부분의 AWS Command Line Interface(AWS CLI) 명령은 --cli-input-json
파라미터를 사용하여 파일에서 모든 파라미터 입력을 허용하는 기능을 지원합니다.
이러한 명령에는 --generate-cli-skeleton
파라미터가 있으므로 모든 파라미터를 편집하거나 입력할 수 있는 JSON 형식의 파일을 만들 수 있습니다. 그러면 관련된 --cli-input-json
파라미터를 사용하여 명령을 실행하고 입력된 파일을 가리킬 수 있습니다.
중요
aws s3
명령 등 몇 가지 AWS CLI 명령은 개별 AWS API 작업에 직접 매핑되지 않습니다. 이러한 명령은 이 주제에서 다루는 --generate-cli-skeleton
또는 --cli-input-json
파라미터를 지원하지 않습니다. 특정 명령이 이러한 파라미터를 지원하는지 여부를 모르는 경우 다음 명령을 실행하고 service
및 command
이름을 관심이 있는 항목으로 바꾸십시오.
$
aws service command
help
지정된 명령이 지원하는 파라미터를 보여주는 Synopsis
섹션이 출력에 포함됩니다.
$
aws iam list-users help
... SYNOPSIS list-users ... [--cli-input-json] ... [--generate-cli-skeleton <value>] ...
--generate-cli-skeleton
파라미터를 사용하면 명령이 실행되지 않지만, 사용자 지정하여 이후 명령에 입력으로 사용할 수 있는 파라미터 템플릿을 생성하고 표시할 수 있습니다. 생성된 템플릿에는 명령이 지원하는 모든 파라미터가 포함됩니다.
--generate-cli-skeleton
파라미터는 다음 값 중 하나를 허용합니다.
-
input
- 생성된 템플릿에 JSON 형식의 모든 입력 파라미터가 포함됩니다. 이것이 기본값입니다. -
output
- 생성된 템플릿에 JSON 형식의 모든 출력 파라미터가 포함됩니다.
AWS CLI는 본질적으로 서비스의 API를 둘러싼 "래퍼"이므로, 스켈레톤 파일은 사용자가 모든 파라미터를 기본 API 파라미터 이름으로 참조할 것이라고 예상합니다. 이는 AWS CLI 파라미터 이름과 다를 수 있습니다. 예를 들어 이름이 AWS CLI인 user-name
파라미터는 이름이 AWS인 UserName
서비스의 API 파라미터에 매핑될 수 있습니다(변경된 대소문자 표시와 누락된 대시에 유의). 실수를 방지하려면 --generate-cli-skeleton
옵션을 사용하여 “정확한” 파라미터 이름으로 템플릿을 생성하는 것이 좋습니다. 또한 서비스 API 참조 안내서를 참조하여 예상되는 파라미터 이름을 확인할 수도 있습니다. 템플릿에서 필요하지 않아 값을 지정하지 않을 파라미터를 모두 삭제할 수 있습니다.
예를 들어, 다음 명령을 실행하면 Amazon Elastic Compute Cloud(Amazon EC2) 명령 run-instances에 대한 파라미터 템플릿이 생성됩니다.
명령 스켈레톤 생성
파라미터 스켈레톤 파일을 생성하고 사용하려면
-
--generate-cli-skeleton
파라미터와 함께 명령을 실행하여JSON을 생성하고 출력을 파일로 전송하여 저장합니다. -
텍스트 편집기에서 파라미터 스켈레톤 파일을 열고 필요하지 않은 파라미터를 제거합니다. 예를 들어, 템플릿을 다음과 같이 줄일 수 있습니다. 불필요한 요소를 제거한 후에도 파일이 여전히 유효한 JSON인지 확인해야 합니다.
이 예제에서는 Amazon EC2 테스트 실행 기능을 사용하도록
DryRun
파라미터를true
로 설정된 상태로 유지합니다. 이 기능을 사용하면 실제로 리소스를 생성하거나 수정하지 않고도 명령을 안전하게 테스트할 수 있습니다. -
나머지 값을 시나리오에 적합한 값으로 채우십시오. 이 예제에서는 사용할 Amazon Machine Image(AMI)의 인스턴스 유형, 키 이름, 보안 그룹 및 식별자를 제공합니다. 이 예제에서는 기본 AWS 리전을 가정합니다.
ami-dfc39aef
AMI는us-west-2
리전에서 호스팅되는 64비트 Amazon Linux 이미지입니다. 다른 리전을 사용하는 경우 사용할 정확한 AMI ID를 찾아야합니다. -
file://
접두사를 사용해 완료된 템플릿 파일을--cli-input-json
파라미터로 전달하여 완료된 파라미터로 명령을 실행합니다. AWS CLI는 현재 작업 디렉터리를 기준으로 경로를 해석하므로, 경로 없이 파일 이름만 표시하는 다음 예제에서는 현재 작업 디렉터리에서 직접 파일이 검색됩니다.테스트 실행 오류는 JSON 이 올바르게 구성되었으며 파라미터 값이 유효함을 나타냅니다. 출력에 다른 문제가 보고되면 문제를 해결하고 "
Request would have succeeded
" 메시지가 표시될 때까지 이전 단계를 반복합니다. -
이제 테스트 실행을 비활성화하기 위해
DryRun
파라미터를false
로 설정할 수 있습니다. -
명령을 실행하면
run-instances
가 실제로 Amazon EC2 인스턴스를 실행하고 성공적인 실행으로 생성된 세부 정보를 표시합니다. 출력 형식은 입력 파라미터 템플릿의 형식과 별도로--output
파라미터에 의해 제어됩니다.