이 설명서는 의 버전 1 AWS CLI 전용입니다. 의 버전 2와 관련된 설명서는 버전 2 사용 설명서 를 AWS CLI참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AWS CloudFormation 사용 예제 AWS CLI
다음 코드 예제에서는 AWS Command Line Interface 와 함께 를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다 AWS CloudFormation.
작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
각 예제에는 컨텍스트에서 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있는 전체 소스 코드에 대한 링크가 포함되어 있습니다.
주제
작업
다음 코드 예시에서는 activate-type
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
유형을 활성화하려면
다음
activate-type
예제에서는 퍼블릭 타사 확장을 활성화하여 스택 템플릿에서 사용할 수 있도록 합니다.aws cloudformation activate-type \ --region
us-west-2
\ --typeRESOURCE
\ --type-nameExample::Test::1234567890abcdef0
\ --type-name-aliasExample::Test::Alias
출력:
{ "Arn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/Example-Test-Alias" }
자세한 내용은 AWS CloudFormation 사용 설명서의 AWS CloudFormation 레지스트리 사용을 참조하세요.
-
자세한 API 내용은 명령 참조ActivateType
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 batch-describe-type-configurations
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
유형 구성을 일괄 설명하는 방법
다음
batch-describe-type-configurations
예제에서는 유형에 대한 데이터를 구성합니다.aws cloudformation batch-describe-type-configurations \ --region
us-west-2
\ --type-configuration-identifiers TypeArn="arn:aws:cloudformation:us-west-2:123456789012:type/resource/Example-Test-Type,TypeConfigurationAlias=MyConfiguration"출력:
{ "Errors": [], "UnprocessedTypeConfigurations": [], "TypeConfigurations": [ { "Arn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/Example-Test-Type", "Alias": "MyConfiguration", "Configuration": "{\n \"Example\": {\n \"ApiKey\": \"examplekey\",\n \"ApplicationKey\": \"examplekey1\",\n \"ApiURL\": \"exampleurl\"\n }\n}", "LastUpdated": "2021-10-01T15:25:46.210000+00:00", "TypeArn": "arn:aws:cloudformation:us-east-1:123456789012:type/resource/Example-Test-Type" } ] }
자세한 내용은 AWS CloudFormation 사용 설명서의 AWS CloudFormation 레지스트리 사용을 참조하세요.
-
자세한 API 내용은 명령 참조BatchDescribeTypeConfigurations
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 cancel-update-stack
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
진행 중인 스택 업데이트를 취소하려면
다음
cancel-update-stack
명령은myteststack
스택의 스택 업데이트를 취소합니다.aws cloudformation cancel-update-stack --stack-name
myteststack
-
자세한 API 내용은 명령 참조CancelUpdateStack
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 continue-update-rollback
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
업데이트 롤백을 재시도하려면
다음
continue-update-rollback
예제는 이전에 실패한 스택 업데이트에서 롤백 작업을 재개합니다.aws cloudformation continue-update-rollback \ --stack-name
my-stack
이 명령은 출력을 생성하지 않습니다.
-
자세한 API 내용은 명령 참조ContinueUpdateRollback
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 create-change-set
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
변경 세트를 생성하려면
다음
create-change-set
예제에서는CAPABILITY_IAM
기능을 사용하여 변경 세트를 생성합니다. 파일은 현재 폴더의 AWS CloudFormation 템플릿template.yaml
으로, IAM 리소스가 포함된 스택을 정의합니다.aws cloudformation create-change-set \ --stack-name
my-application
\ --change-set-namemy-change-set
\ --template-bodyfile://template.yaml
\ --capabilitiesCAPABILITY_IAM
출력:
{ "Id": "arn:aws:cloudformation:us-west-2:123456789012:changeSet/my-change-set/bc9555ba-a949-xmpl-bfb8-f41d04ec5784", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-application/d0a825a0-e4cd-xmpl-b9fb-061c69e99204" }
-
자세한 API 내용은 명령 참조CreateChangeSet
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 create-stack-instances
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 인스턴스를 생성하려면
다음
create-stack-instances
예제에서는 두 계정과 네 리전에 스택 세트의 인스턴스를 생성합니다. 내결함성 설정을 사용하면 일부 스택을 생성할 수 없더라도 모든 계정과 리전에서 업데이트를 시도할 수 있습니다.aws cloudformation create-stack-instances \ --stack-set-name
my-stack-set
\ --accounts123456789012
223456789012
\ --regionsus-east-1
us-east-2
us-west-1
us-west-2
\ --operation-preferencesFailureToleranceCount=7
출력:
{ "OperationId": "d7995c31-83c2-xmpl-a3d4-e9ca2811563f" }
스택 세트를 생성하려면
create-stack-set
명령을 사용합니다.-
자세한 API 내용은 명령 참조CreateStackInstances
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 create-stack-set
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 세트를 생성하려면
다음
create-stack-set
예제에서는 지정된 YAML 파일 temlplate를 사용하여 스택 세트를 생성합니다.template.yaml
는 스택을 정의하는 현재 폴더의 AWS CloudFormation 템플릿입니다.aws cloudformation create-stack-set \ --stack-set-name
my-stack-set
\ --template-bodyfile://template.yaml
\ --description"SNS topic"
출력:
{ "StackSetId": "my-stack-set:8d0f160b-d157-xmpl-a8e6-c0ce8e5d8cc1" }
스택 세트에 스택 인스턴스를 추가하려면
create-stack-instances
명령을 사용합니다.-
자세한 API 내용은 명령 참조CreateStackSet
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 create-stack
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
AWS CloudFormation 스택을 생성하려면
다음
create-stacks
명령에서는sampletemplate.json
템플릿을 사용하여 이름이myteststack
인 스택을 생성합니다.aws cloudformation create-stack --stack-name
myteststack
--template-bodyfile://sampletemplate.json
--parametersParameterKey=KeyPairName,ParameterValue=TestKey
ParameterKey=SubnetIDs,ParameterValue=SubnetID1\\,SubnetID2출력:
{ "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896" }
자세한 내용은 AWS CloudFormation 사용 설명서의 스택을 참조하세요.
-
자세한 API 내용은 명령 참조CreateStack
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 deactivate-type
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
유형을 비활성화하려면
다음
deactivate-type
예제에서는 이 계정 및 리전에서 이전에 활성화된 퍼블릭 확장을 비활성화합니다.aws cloudformation deactivate-type \ --region
us-west-2
\ --typeMODULE
\ --type-nameExample::Test::Type::MODULE
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 AWS CloudFormation 사용 설명서의 AWS CloudFormation 레지스트리 사용을 참조하세요.
-
자세한 API 내용은 명령 참조DeactivateType
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 delete-change-set
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
변경 세트를 삭제하려면
다음
delete-change-set
예제에서는 변경 세트 이름과 스택 이름을 지정하여 변경 세트를 삭제합니다.aws cloudformation delete-change-set \ --stack-name
my-stack
\ --change-set-namemy-change-set
이 명령은 출력을 생성하지 않습니다.
다음
delete-change-set
예제에서는 변경 세트ARN의 전체 를 지정하여 변경 세트를 삭제합니다.aws cloudformation delete-change-set \ --change-set-name
arn:aws:cloudformation:us-east-2:123456789012:changeSet/my-change-set/4eca1a01-e285-xmpl-8026-9a1967bfb4b0
이 명령은 출력을 생성하지 않습니다.
-
자세한 API 내용은 명령 참조DeleteChangeSet
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 delete-stack-instances
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 인스턴스를 삭제하려면
다음
delete-stack-instances
예제에서는 두 리전의 두 계정에 있는 스택 세트의 인스턴스를 삭제하고 스택을 종료합니다.aws cloudformation delete-stack-instances \ --stack-set-name
my-stack-set
\ --accounts123456789012
567890123456
\ --regionsus-east-1
us-west-1
\ --no-retain-stacks출력:
{ "OperationId": "ad49f10c-fd1d-413f-a20a-8de6e2fa8f27" }
빈 스택 세트를 삭제하려면
delete-stack-set
명령을 사용합니다.-
자세한 API 내용은 명령 참조DeleteStackInstances
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 delete-stack-set
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 세트를 삭제하려면
다음 명령은 지정된 빈 스택 세트를 삭제합니다. 스택 세트는 비어 있어야 합니다.
aws cloudformation delete-stack-set \ --stack-set-name
my-stack-set
이 명령은 출력을 생성하지 않습니다.
스택 세트에서 인스턴스를 삭제하려면
delete-stack-instances
명령을 사용합니다.-
자세한 API 내용은 명령 참조DeleteStackSet
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 delete-stack
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택을 삭제하려면
다음
delete-stack
예제에서는 지정된 스택을 삭제합니다.aws cloudformation delete-stack \ --stack-name
my-stack
이 명령은 출력을 생성하지 않습니다.
-
자세한 API 내용은 명령 참조DeleteStack
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 deploy
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
다음 명령은 라는 스택
template.json
에 라는 템플릿을 배포합니다my-new-stack
.aws cloudformation deploy --template-file
/path_to_template/template.json
--stack-namemy-new-stack
--parameter-overridesKey1=Value1
Key2=Value2
--tagsKey1=Value1
Key2=Value2
-
API 자세한 내용은 AWS CLI 명령 참조의 배포
를 참조하세요.
-
다음 코드 예시에서는 deregister-type
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
유형 버전 등록을 취소하려면
다음
deregister-type
예제에서는 지정된 유형 버전을 CloudFormation 레지스트리의 활성 사용에서 제거하여 CloudFormation 작업에 더 이상 사용할 수 없도록 합니다.aws cloudformation deregister-type \ --type
RESOURCE
\ --type-nameMy::Logs::LogGroup
\ --version-id00000002
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 AWS CloudFormation 사용 설명서의 CloudFormation 레지스트리 사용을 참조하세요.
-
자세한 API 내용은 명령 참조DeregisterType
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 describe-account-limits
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
계정 한도에 대한 정보를 가져오려면
다음 명령은 현재 계정에 대한 리전 제한 목록을 검색합니다.
aws cloudformation describe-account-limits
출력:
{ "AccountLimits": [ { "Name": "StackLimit", "Value": 200 }, { "Name": "StackOutputsLimit", "Value": 60 }, { "Name": "ConcurrentResourcesLimit", "Value": 2500 } ] }
-
자세한 API 내용은 명령 참조DescribeAccountLimits
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 describe-change-set
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
변경 세트에 대한 정보를 가져오려면
다음
describe-change-set
예제에서는 변경 세트 이름 및 스택 이름으로 지정된 변경 세트의 세부 정보를 표시합니다.aws cloudformation describe-change-set \ --change-set-name
my-change-set
\ --stack-namemy-stack
다음
describe-change-set
예제에서는 전체 변경 집합에서 지정한 변경 집합ARN의 세부 정보를 표시합니다.aws cloudformation describe-change-set \ --change-set-name
arn:aws:cloudformation:us-west-2:123456789012:changeSet/my-change-set/bc9555ba-a949-xmpl-bfb8-f41d04ec5784
출력:
{ "Changes": [ { "Type": "Resource", "ResourceChange": { "Action": "Modify", "LogicalResourceId": "function", "PhysicalResourceId": "my-function-SEZV4XMPL4S5", "ResourceType": "AWS::Lambda::Function", "Replacement": "False", "Scope": [ "Properties" ], "Details": [ { "Target": { "Attribute": "Properties", "Name": "Timeout", "RequiresRecreation": "Never" }, "Evaluation": "Static", "ChangeSource": "DirectModification" } ] } } ], "ChangeSetName": "my-change-set", "ChangeSetId": "arn:aws:cloudformation:us-west-2:123456789012:changeSet/my-change-set/4eca1a01-e285-xmpl-8026-9a1967bfb4b0", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "StackName": "my-stack", "Description": null, "Parameters": null, "CreationTime": "2019-10-02T05:20:56.651Z", "ExecutionStatus": "AVAILABLE", "Status": "CREATE_COMPLETE", "StatusReason": null, "NotificationARNs": [], "RollbackConfiguration": {}, "Capabilities": [ "CAPABILITY_IAM" ], "Tags": null }
-
자세한 API 내용은 명령 참조DescribeChangeSet
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 describe-publisher
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
게시자를 설명하려면
다음
describe-publisher
예제에서는 게시자에 대한 정보를 구성합니다.aws cloudformation describe-publisher \ --region
us-west-2
\ --publisher-id000q6TfUovXsEMmgKowxDZLlwqr2QUsh
출력:
{ "PublisherId": "000q6TfUovXsEMmgKowxDZLlwqr2QUshd2e75c8c", "PublisherStatus": "VERIFIED", "IdentityProvider": "AWS_Marketplace", "PublisherProfile": "https://aws.amazon.com/marketplace/seller-profile?id=2c5dc1f0-17cd-4259-8e46-822a83gdtegd" }
자세한 내용은 AWS CloudFormation 사용 설명서의 AWS CloudFormation 레지스트리 사용을 참조하세요.
-
자세한 API 내용은 명령 참조DescribePublisher
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 describe-stack-drift-detection-status
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
드리프트 감지 작업의 상태를 확인하려면
다음
describe-stack-drift-detection-status
예제에서는 드리프트 감지 작업의 상태를 표시합니다.detect-stack-drift
명령을 실행하는 ID로 를 가져옵니다.aws cloudformation describe-stack-drift-detection-status \ --stack-drift-detection-id
1a229160-e4d9-xmpl-ab67-0a4f93df83d4
출력:
{ "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "StackDriftDetectionId": "1a229160-e4d9-xmpl-ab67-0a4f93df83d4", "StackDriftStatus": "DRIFTED", "DetectionStatus": "DETECTION_COMPLETE", "DriftedStackResourceCount": 1, "Timestamp": "2019-10-02T05:54:30.902Z" }
-
자세한 API 내용은 명령 참조DescribeStackDriftDetectionStatus
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 describe-stack-events
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 이벤트를 설명하려면
다음
describe-stack-events
예제에서는 지정된 스택의 가장 최근 이벤트 2개를 표시합니다.aws cloudformation describe-stack-events \ --stack-name
my-stack
\ --max-items2
{
"StackEvents":[
{
"StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "EventId": "4e1516d0-e4d6-xmpl-b94f-0a51958a168c", "StackName": "my-stack", "LogicalResourceId": "my-stack", "PhysicalResourceId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "ResourceType": "AWS::CloudFormation::Stack", "Timestamp": "2019-10-02T05:34:29.556Z", "ResourceStatus":"UPDATE_COMPLETE"
},
{
"StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "EventId": "4dd3c810-e4d6-xmpl-bade-0aaf8b31ab7a", "StackName": "my-stack", "LogicalResourceId": "my-stack", "PhysicalResourceId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "ResourceType": "AWS::CloudFormation::Stack", "Timestamp": "2019-10-02T05:34:29.127Z", "ResourceStatus":"UPDATE_COMPLETE_CLEANUP_IN_PROGRESS"
}
],
"NextToken":"eyJOZXh0VG9XMPLiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyfQ=="
}
-
자세한 API 내용은 명령 참조DescribeStackEvents
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 describe-stack-instance
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 인스턴스를 설명하려면
다음 명령은 지정된 계정 및 리전에서 지정된 스택 세트의 인스턴스를 설명합니다. 스택 세트는 현재 리전 및 계정에 있고 인스턴스는 계정 의
us-west-2
리전에 있습니다123456789012
.:aws cloudformation describe-stack-instance \ --stack-set-name
my-stack-set
\ --stack-instance-account123456789012
\ --stack-instance-regionus-west-2
출력:
{ "StackInstance": { "StackSetId": "enable-config:296a3360-xmpl-40af-be78-9341e95bf743", "Region": "us-west-2", "Account": "123456789012", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/StackSet-enable-config-e6cac20f-xmpl-46e9-8314-53e0d4591532/4287f9a0-e615-xmpl-894a-12b31d3117be", "ParameterOverrides": [], "Status": "OUTDATED", "StatusReason": "ResourceLogicalId:ConfigBucket, ResourceType:AWS::S3::Bucket, ResourceStatusReason:You have attempted to create more buckets than allowed (Service: Amazon S3; Status Code: 400; Error Code: TooManyBuckets; Request ID: F7F21CXMPL580224; S3 Extended Request ID: egd/Fdt89BXMPLyiqbMNljVk55Yqqvi3NYW2nKLUVWhUGEhNfCmZdyj967lhriaG/dWMobSO40o=)." } }
-
자세한 API 내용은 명령 참조DescribeStackInstance
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 describe-stack-resource-drifts
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 정의에서 드리프트된 리소스에 대한 정보를 가져오려면
다음 명령은 지정된 스택의 드리프트된 리소스에 대한 정보를 표시합니다. 드리프트 감지를 시작하려면
detect-stack-drift
명령을 사용합니다.aws cloudformation describe-stack-resource-drifts \ --stack-name
my-stack
출력은 수정된 AWS Lambda 함수를 보여줍니다 out-of-band.
{ "StackResourceDrifts": [ { "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "LogicalResourceId": "function", "PhysicalResourceId": "my-function-SEZV4XMPL4S5", "ResourceType": "AWS::Lambda::Function", "ExpectedProperties": "{\"Description\":\"Write a file to S3.\",\"Environment\":{\"Variables\":{\"bucket\":\"my-stack-bucket-1vc62xmplgguf\"}},\"Handler\":\"index.handler\",\"MemorySize\":128,\"Role\":\"arn:aws:iam::123456789012:role/my-functionRole-HIZXMPLEOM9E\",\"Runtime\":\"nodejs10.x\",\"Tags\":[{\"Key\":\"lambda:createdBy\",\"Value\":\"SAM\"}],\"Timeout\":900,\"TracingConfig\":{\"Mode\":\"Active\"}}", "ActualProperties": "{\"Description\":\"Write a file to S3.\",\"Environment\":{\"Variables\":{\"bucket\":\"my-stack-bucket-1vc62xmplgguf\"}},\"Handler\":\"index.handler\",\"MemorySize\":256,\"Role\":\"arn:aws:iam::123456789012:role/my-functionRole-HIZXMPLEOM9E\",\"Runtime\":\"nodejs10.x\",\"Tags\":[{\"Key\":\"lambda:createdBy\",\"Value\":\"SAM\"}],\"Timeout\":22,\"TracingConfig\":{\"Mode\":\"Active\"}}", "PropertyDifferences": [ { "PropertyPath": "/MemorySize", "ExpectedValue": "128", "ActualValue": "256", "DifferenceType": "NOT_EQUAL" }, { "PropertyPath": "/Timeout", "ExpectedValue": "900", "ActualValue": "22", "DifferenceType": "NOT_EQUAL" } ], "StackResourceDriftStatus": "MODIFIED", "Timestamp": "2019-10-02T05:54:44.064Z" } ] }
-
자세한 API 내용은 명령 참조DescribeStackResourceDrifts
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 describe-stack-resource
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 리소스에 대한 정보를 가져오려면
다음
describe-stack-resource
예제에서는 지정된 스택의 이름이MyFunction
인 리소스에 대한 세부 정보를 표시합니다.aws cloudformation describe-stack-resource \ --stack-name
MyStack
\ --logical-resource-idMyFunction
출력:
{ "StackResourceDetail": { "StackName": "MyStack", "StackId": "arn:aws:cloudformation:us-east-2:123456789012:stack/MyStack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "LogicalResourceId": "MyFunction", "PhysicalResourceId": "my-function-SEZV4XMPL4S5", "ResourceType": "AWS::Lambda::Function", "LastUpdatedTimestamp": "2019-10-02T05:34:27.989Z", "ResourceStatus": "UPDATE_COMPLETE", "Metadata": "{}", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } } }
-
자세한 API 내용은 명령 참조DescribeStackResource
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 describe-stack-resources
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 리소스에 대한 정보를 가져오려면
다음
describe-stack-resources
예제에서는 지정된 스택의 리소스에 대한 세부 정보를 표시합니다.aws cloudformation describe-stack-resources \ --stack-name
my-stack
출력:
{ "StackResources": [ { "StackName": "my-stack", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "LogicalResourceId": "bucket", "PhysicalResourceId": "my-stack-bucket-1vc62xmplgguf", "ResourceType": "AWS::S3::Bucket", "Timestamp": "2019-10-02T04:34:11.345Z", "ResourceStatus": "CREATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } }, { "StackName": "my-stack", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "LogicalResourceId": "function", "PhysicalResourceId": "my-function-SEZV4XMPL4S5", "ResourceType": "AWS::Lambda::Function", "Timestamp": "2019-10-02T05:34:27.989Z", "ResourceStatus": "UPDATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } }, { "StackName": "my-stack", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "LogicalResourceId": "functionRole", "PhysicalResourceId": "my-functionRole-HIZXMPLEOM9E", "ResourceType": "AWS::IAM::Role", "Timestamp": "2019-10-02T04:34:06.350Z", "ResourceStatus": "CREATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } } ] }
-
자세한 API 내용은 명령 참조DescribeStackResources
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 describe-stack-set-operation
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 세트 작업에 대한 정보를 가져오려면
다음 describe-stack-set-operation` 예제는 지정된 스택 세트에 대한 업데이트 작업에 대한 세부 정보를 표시합니다.
aws cloudformation describe-stack-set-operation \ --stack-set-name
enable-config
\ --operation-id35d45ebc-ed88-xmpl-ab59-0197a1fc83a0
출력:
{ "StackSetOperation": { "OperationId": "35d45ebc-ed88-xmpl-ab59-0197a1fc83a0", "StackSetId": "enable-config:296a3360-xmpl-40af-be78-9341e95bf743", "Action": "UPDATE", "Status": "SUCCEEDED", "OperationPreferences": { "RegionOrder": [ "us-east-1", "us-west-2", "eu-west-1", "us-west-1" ], "FailureToleranceCount": 7, "MaxConcurrentCount": 2 }, "AdministrationRoleARN": "arn:aws:iam::123456789012:role/AWSCloudFormationStackSetAdministrationRole", "ExecutionRoleName": "AWSCloudFormationStackSetExecutionRole", "CreationTimestamp": "2019-10-03T16:28:44.377Z", "EndTimestamp": "2019-10-03T16:42:08.607Z" } }
-
자세한 API 내용은 명령 참조DescribeStackSetOperation
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 describe-stack-set
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 세트에 대한 정보를 가져오려면
다음 describe-stack-set` 예제는 지정된 스택 세트에 대한 세부 정보를 표시합니다.
aws cloudformation describe-stack-set \ --stack-set-name
my-stack-set
출력:
{ "StackSet": { "StackSetName": "my-stack-set", "StackSetId": "my-stack-set:296a3360-xmpl-40af-be78-9341e95bf743", "Description": "Create an Amazon SNS topic", "Status": "ACTIVE", "TemplateBody": "AWSTemplateFormatVersion: '2010-09-09'\nDescription: An AWS SNS topic\nResources:\n topic:\n Type: AWS::SNS::Topic", "Parameters": [], "Capabilities": [], "Tags": [], "StackSetARN": "arn:aws:cloudformation:us-west-2:123456789012:stackset/enable-config:296a3360-xmpl-40af-be78-9341e95bf743", "AdministrationRoleARN": "arn:aws:iam::123456789012:role/AWSCloudFormationStackSetAdministrationRole", "ExecutionRoleName": "AWSCloudFormationStackSetExecutionRole" } }
-
자세한 API 내용은 명령 참조DescribeStackSet
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 describe-stacks
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
AWS CloudFormation 스택을 설명하려면
다음
describe-stacks
명령에서는myteststack
스택에 대한 요약 정보를 보여줍니다.aws cloudformation describe-stacks --stack-name
myteststack
출력:
{ "Stacks": [ { "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "Description": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create a publicly accessible S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", "Tags": [], "Outputs": [ { "Description": "Name of S3 bucket to hold website content", "OutputKey": "BucketName", "OutputValue": "myteststack-s3bucket-jssofi1zie2w" } ], "StackStatusReason": null, "CreationTime": "2013-08-23T01:02:15.422Z", "Capabilities": [], "StackName": "myteststack", "StackStatus": "CREATE_COMPLETE", "DisableRollback": false } ] }
자세한 내용은 AWS CloudFormation 사용 설명서의 스택을 참조하세요.
-
자세한 API 내용은 명령 참조DescribeStacks
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 describe-type-registration
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
유형 등록 정보를 표시하려면
다음
describe-type-registration
예제에서는 유형의 현재 상태, 유형 및 버전을 포함하여 지정된 유형 등록에 대한 정보를 표시합니다.aws cloudformation describe-type-registration \ --registration-token
a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
출력:
{ "ProgressStatus": "COMPLETE", "TypeArn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Logs-LogGroup", "Description": "Deployment is currently in DEPLOY_STAGE of status COMPLETED; ", "TypeVersionArn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Logs-LogGroup/00000001" }
자세한 내용은 AWS CloudFormation 사용 설명서의 CloudFormation 레지스트리 사용을 참조하세요.
-
자세한 API 내용은 명령 참조DescribeTypeRegistration
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 describe-type
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
유형 정보를 표시하려면
다음
describe-type
예제에서는 지정된 유형에 대한 정보를 표시합니다.aws cloudformation describe-type \ --type-name
My::Logs::LogGroup
\ --typeRESOURCE
출력:
{ "SourceUrl": "https://github.com/aws-cloudformation/aws-cloudformation-resource-providers-logs.git", "Description": "Customized resource derived from AWS::Logs::LogGroup", "TimeCreated": "2019-12-03T23:29:33.321Z", "Visibility": "PRIVATE", "TypeName": "My::Logs::LogGroup", "LastUpdated": "2019-12-03T23:29:33.321Z", "DeprecatedStatus": "LIVE", "ProvisioningType": "FULLY_MUTABLE", "Type": "RESOURCE", "Arn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Logs-LogGroup/00000001", "Schema": "[details omitted]" }
자세한 내용은 AWS CloudFormation 사용 설명서의 CloudFormation 레지스트리 사용을 참조하세요.
-
자세한 API 내용은 명령 참조DescribeType
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 detect-stack-drift
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
드리프트된 리소스를 감지하려면
다음
detect-stack-drift
예제에서는 지정된 스택에 대한 드리프트 감지를 시작합니다.aws cloudformation detect-stack-drift \ --stack-name
my-stack
출력:
{ "StackDriftDetectionId": "1a229160-e4d9-xmpl-ab67-0a4f93df83d4" }
그런 다음 이 ID를
describe-stack-resource-drifts
명령과 함께 사용하여 드리프트된 리소스를 설명할 수 있습니다.-
자세한 API 내용은 명령 참조DetectStackDrift
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 detect-stack-resource-drift
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
리소스의 드리프트를 감지하려면
다음
detect-stack-resource-drift
예제에서는 드리프트에MyStack
대해 이름이 지정된 스택MyFunction
에 이름이 지정된 리소스를 확인합니다.aws cloudformation detect-stack-resource-drift \ --stack-name
MyStack
\ --logical-resource-idMyFunction
출력은 수정된 AWS Lambda 함수를 보여줍니다 out-of-band.
{ "StackResourceDrift": { "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/MyStack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "LogicalResourceId": "MyFunction", "PhysicalResourceId": "my-function-SEZV4XMPL4S5", "ResourceType": "AWS::Lambda::Function", "ExpectedProperties": "{\"Description\":\"Write a file to S3.\",\"Environment\":{\"Variables\":{\"bucket\":\"my-stack-bucket-1vc62xmplgguf\"}},\"Handler\":\"index.handler\",\"MemorySize\":128,\"Role\":\"arn:aws:iam::123456789012:role/my-functionRole-HIZXMPLEOM9E\",\"Runtime\":\"nodejs10.x\",\"Tags\":[{\"Key\":\"lambda:createdBy\",\"Value\":\"SAM\"}],\"Timeout\":900,\"TracingConfig\":{\"Mode\":\"Active\"}}", "ActualProperties": "{\"Description\":\"Write a file to S3.\",\"Environment\":{\"Variables\":{\"bucket\":\"my-stack-bucket-1vc62xmplgguf\"}},\"Handler\":\"index.handler\",\"MemorySize\":256,\"Role\":\"arn:aws:iam::123456789012:role/my-functionRole-HIZXMPLEOM9E\",\"Runtime\":\"nodejs10.x\",\"Tags\":[{\"Key\":\"lambda:createdBy\",\"Value\":\"SAM\"}],\"Timeout\":22,\"TracingConfig\":{\"Mode\":\"Active\"}}", "PropertyDifferences": [ { "PropertyPath": "/MemorySize", "ExpectedValue": "128", "ActualValue": "256", "DifferenceType": "NOT_EQUAL" }, { "PropertyPath": "/Timeout", "ExpectedValue": "900", "ActualValue": "22", "DifferenceType": "NOT_EQUAL" } ], "StackResourceDriftStatus": "MODIFIED", "Timestamp": "2019-10-02T05:58:47.433Z" } }
-
자세한 API 내용은 명령 참조DetectStackResourceDrift
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 detect-stack-set-drift
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 세트 및 연결된 모든 스택 인스턴스에서 드리프트를 감지하려면
다음
detect-stack-set-drift
예제에서는 해당 스택 세트와 연결된 모든 스택 인스턴스를 포함하여 지정된 스택 세트에서 드리프트 감지 작업을 시작하고 드리프트 작업의 상태를 추적하는 데 사용할 수 있는 작업 ID를 반환합니다.aws cloudformation detect-stack-set-drift \ --stack-set-name
stack-set-drift-example
출력:
{ "OperationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }
자세한 내용은 AWS CloudFormation 사용 설명서의 스택 세트에서 관리되지 않는 구성 변경 사항 감지를 참조하세요.
-
자세한 API 내용은 명령 참조DetectStackSetDrift
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 estimate-template-cost
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
템플릿 비용을 추정하려면
다음
estimate-template-cost
예제에서는 현재 폴더에서 이름이template.yaml
인 템플릿에 대한 예상 비용을 생성합니다.aws cloudformation estimate-template-cost \ --template-body
file://template.yaml
출력:
{ "Url": "http://calculator.s3.amazonaws.com/calc5.html?key=cloudformation/7870825a-xmpl-4def-92e7-c4f8dd360cca" }
-
자세한 API 내용은 명령 참조EstimateTemplateCost
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 execute-change-set
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
변경 세트를 실행하려면
다음
execute-change-set
예제에서는 변경 세트 이름 및 스택 이름으로 지정된 변경 세트를 실행합니다.aws cloudformation execute-change-set \ --change-set-name
my-change-set
\ --stack-namemy-stack
다음
execute-change-set
예제에서는 전체 변경 세트에서 지정한 ARN 변경 세트를 실행합니다.aws cloudformation execute-change-set \ --change-set-name
arn:aws:cloudformation:us-west-2:123456789012:changeSet/my-change-set/bc9555ba-a949-xmpl-bfb8-f41d04ec5784
-
자세한 API 내용은 명령 참조ExecuteChangeSet
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 get-stack-policy
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 정책을 보려면
다음
get-stack-policy
예제에서는 지정된 스택에 대한 스택 정책을 표시합니다. 스택에 정책을 연결하려면set-stack-policy
명령을 사용합니다.aws cloudformation get-stack-policy \ --stack-name
my-stack
출력:
{ "StackPolicyBody": "{\n \"Statement\" : [\n {\n \"Effect\" : \"Allow\",\n \"Action\" : \"Update:*\",\n \"Principal\": \"*\",\n \"Resource\" : \"*\"\n },\n {\n \"Effect\" : \"Deny\",\n \"Action\" : \"Update:*\",\n \"Principal\": \"*\",\n \"Resource\" : \"LogicalResourceId/bucket\"\n }\n ]\n}\n" }
-
자세한 API 내용은 명령 참조GetStackPolicy
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 get-template-summary
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
템플릿 요약을 표시하려면
다음 명령은 지정된 템플릿 파일의 리소스 및 메타데이터에 대한 요약 정보를 표시합니다.
aws cloudformation get-template-summary \ --template-body
file://template.yaml
출력:
{ "Parameters": [], "Description": "A VPC and subnets.", "ResourceTypes": [ "AWS::EC2::VPC", "AWS::EC2::Subnet", "AWS::EC2::Subnet", "AWS::EC2::RouteTable", "AWS::EC2::VPCEndpoint", "AWS::EC2::SubnetRouteTableAssociation", "AWS::EC2::SubnetRouteTableAssociation", "AWS::EC2::VPCEndpoint" ], "Version": "2010-09-09" }
-
자세한 API 내용은 명령 참조GetTemplateSummary
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 get-template
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
AWS CloudFormation 스택의 템플릿 본문을 보려면
다음
get-template
명령에서는myteststack
스택에 대한 템플릿을 보여줍니다.aws cloudformation get-template --stack-name
myteststack
출력:
{ "TemplateBody": { "AWSTemplateFormatVersion": "2010-09-09", "Outputs": { "BucketName": { "Description": "Name of S3 bucket to hold website content", "Value": { "Ref": "S3Bucket" } } }, "Description": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create a publicly accessible S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", "Resources": { "S3Bucket": { "Type": "AWS::S3::Bucket", "Properties": { "AccessControl": "PublicRead" } } } } }
-
자세한 API 내용은 명령 참조GetTemplate
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 list-change-sets
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
변경 세트를 나열하려면
다음
list-change-sets
예제에서는 지정된 스택에 대해 보류 중인 변경 세트 목록을 표시합니다.aws cloudformation list-change-sets \ --stack-name
my-stack
출력:
{ "Summaries": [ { "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204", "StackName": "my-stack", "ChangeSetId": "arn:aws:cloudformation:us-west-2:123456789012:changeSet/my-change-set/70160340-7914-xmpl-bcbf-128a1fa78b5d", "ChangeSetName": "my-change-set", "ExecutionStatus": "AVAILABLE", "Status": "CREATE_COMPLETE", "CreationTime": "2019-10-02T05:38:54.297Z" } ] }
-
자세한 API 내용은 명령 참조ListChangeSets
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 list-exports
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
내보내기를 나열하려면
다음
list-exports
예제에서는 현재 리전의 스택에서 내보내기 목록을 표시합니다.aws cloudformation list-exports
출력:
{ "Exports": [ { "ExportingStackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/private-vpc/99764070-b56c-xmpl-bee8-062a88d1d800", "Name": "private-vpc-subnet-a", "Value": "subnet-07b410xmplddcfa03" }, { "ExportingStackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/private-vpc/99764070-b56c-xmpl-bee8-062a88d1d800", "Name": "private-vpc-subnet-b", "Value": "subnet-075ed3xmplebd2fb1" }, { "ExportingStackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/private-vpc/99764070-b56c-xmpl-bee8-062a88d1d800", "Name": "private-vpc-vpcid", "Value": "vpc-011d7xmpl100e9841" } ] }
-
자세한 API 내용은 명령 참조ListExports
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 list-imports
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
가져오기를 나열하려면
다음
list-imports
예제에서는 지정된 내보내기를 가져오는 스택을 나열합니다. 사용 가능한 내보내기 목록을 가져오려면list-exports
명령을 사용합니다.aws cloudformation list-imports \ --export-name
private-vpc-vpcid
출력:
{ "Imports": [ "my-database-stack" ] }
-
자세한 API 내용은 명령 참조ListImports
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 list-stack-instances
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택의 인스턴스를 나열하려면
다음
list-stack-instances
예제에서는 지정된 스택 세트에서 생성된 인스턴스를 나열합니다.aws cloudformation list-stack-instances \ --stack-set-name
enable-config
예제 출력에는 오류로 인해 업데이트하지 못한 스택에 대한 세부 정보가 포함됩니다.
{ "Summaries": [ { "StackSetId": "enable-config:296a3360-xmpl-40af-be78-9341e95bf743", "Region": "us-west-2", "Account": "123456789012", "StackId": "arn:aws:cloudformation:ap-northeast-1:123456789012:stack/StackSet-enable-config-35a6ac50-d9f8-4084-86e4-7da34d5de4c4/a1631cd0-e5fb-xmpl-b474-0aa20f14f06e", "Status": "CURRENT" }, { "StackSetId": "enable-config:296a3360-xmpl-40af-be78-9341e95bf743", "Region": "us-west-2", "Account": "123456789012", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/StackSet-enable-config-e6cac20f-xmpl-46e9-8314-53e0d4591532/eab53680-e5fa-xmpl-ba14-0a522351f81e", "Status": "OUTDATED", "StatusReason": "ResourceLogicalId:ConfigDeliveryChannel, ResourceType:AWS::Config::DeliveryChannel, ResourceStatusReason:Failed to put delivery channel 'StackSet-enable-config-e6cac20f-xmpl-46e9-8314-53e0d4591532-ConfigDeliveryChannel-1OJWJ7XD59WR0' because the maximum number of delivery channels: 1 is reached. (Service: AmazonConfig; Status Code: 400; Error Code: MaxNumberOfDeliveryChannelsExceededException; Request ID: d14b34a0-ef7c-xmpl-acf8-8a864370ae56)." } ] }
-
자세한 API 내용은 명령 참조ListStackInstances
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 list-stack-resources
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택의 리소스를 나열하려면
다음 명령은 지정된 스택의 리소스 목록을 표시합니다.
aws cloudformation list-stack-resources \ --stack-name
my-stack
출력:
{ "StackResourceSummaries": [ { "LogicalResourceId": "bucket", "PhysicalResourceId": "my-stack-bucket-1vc62xmplgguf", "ResourceType": "AWS::S3::Bucket", "LastUpdatedTimestamp": "2019-10-02T04:34:11.345Z", "ResourceStatus": "CREATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } }, { "LogicalResourceId": "function", "PhysicalResourceId": "my-function-SEZV4XMPL4S5", "ResourceType": "AWS::Lambda::Function", "LastUpdatedTimestamp": "2019-10-02T05:34:27.989Z", "ResourceStatus": "UPDATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } }, { "LogicalResourceId": "functionRole", "PhysicalResourceId": "my-functionRole-HIZXMPLEOM9E", "ResourceType": "AWS::IAM::Role", "LastUpdatedTimestamp": "2019-10-02T04:34:06.350Z", "ResourceStatus": "CREATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } } ] }
-
자세한 API 내용은 명령 참조ListStackResources
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 list-stack-set-operation-results
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 세트 작업 결과를 나열하려면
다음 명령은 지정된 스택 세트의 인스턴스에 대한 업데이트 작업 결과를 표시합니다.
aws cloudformation list-stack-set-operation-results \ --stack-set-name
enable-config
\ --operation-id35d45ebc-ed88-xmpl-ab59-0197a1fc83a0
출력:
{ "Summaries": [ { "Account": "223456789012", "Region": "us-west-2", "Status": "SUCCEEDED", "AccountGateResult": { "Status": "SKIPPED", "StatusReason": "Function not found: arn:aws:lambda:eu-west-1:223456789012:function:AWSCloudFormationStackSetAccountGate" } }, { "Account": "223456789012", "Region": "ap-south-1", "Status": "CANCELLED", "StatusReason": "Cancelled since failure tolerance has exceeded" } ] }
참고: 계정 게이트 함수를 생성하지 않는 한 의
SKIPPED
상태는 성공적인 작업에 대해AccountGateResult
예상됩니다.-
자세한 API 내용은 명령 참조ListStackSetOperationResults
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 list-stack-set-operations
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 세트 작업을 나열하려면
다음
list-stack-set-operations
예제에서는 지정된 스택 세트에 대한 최신 작업 목록을 표시합니다.aws cloudformation list-stack-set-operations \ --stack-set-name
my-stack-set
출력:
{ "Summaries": [ { "OperationId": "35d45ebc-ed88-xmpl-ab59-0197a1fc83a0", "Action": "UPDATE", "Status": "SUCCEEDED", "CreationTimestamp": "2019-10-03T16:28:44.377Z", "EndTimestamp": "2019-10-03T16:42:08.607Z" }, { "OperationId": "891aa98f-7118-xmpl-00b2-00954d1dd0d6", "Action": "UPDATE", "Status": "FAILED", "CreationTimestamp": "2019-10-03T15:43:53.916Z", "EndTimestamp": "2019-10-03T15:45:58.925Z" } ] }
-
자세한 API 내용은 명령 참조ListStackSetOperations
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 list-stack-sets
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 세트를 나열하려면
다음
list-stack-sets
예제에서는 현재 리전 및 계정의 스택 세트 목록을 표시합니다.aws cloudformation list-stack-sets
출력:
{ "Summaries": [ { "StackSetName": "enable-config", "StackSetId": "enable-config:296a3360-xmpl-40af-be78-9341e95bf743", "Description": "Enable AWS Config", "Status": "ACTIVE" } ] }
-
자세한 API 내용은 명령 참조ListStackSets
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 list-stacks
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
AWS CloudFormation 스택을 나열하려면
다음
list-stacks
명령에서는 상태가CREATE_COMPLETE
인 모든 스택에 대한 요약 내용을 보여줍니다.aws cloudformation list-stacks --stack-status-filter
CREATE_COMPLETE
출력:
[ { "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "TemplateDescription": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create a publicly accessible S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", "StackStatusReason": null, "CreationTime": "2013-08-26T03:27:10.190Z", "StackName": "myteststack", "StackStatus": "CREATE_COMPLETE" } ]
-
자세한 API 내용은 명령 참조ListStacks
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 list-type-registrations
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
유형의 완료된 등록을 나열하려면
다음
list-type-registrations
예제에서는 지정된 유형에 대해 완료된 유형 등록 목록을 표시합니다.aws cloudformation list-type-registrations \ --type
RESOURCE
\ --type-nameMy::Logs::LogGroup
\ --registration-status-filterCOMPLETE
출력:
{ "RegistrationTokenList": [ "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333" ] }
자세한 내용은 AWS CloudFormation 사용 설명서의 CloudFormation 레지스트리 사용을 참조하세요.
-
자세한 API 내용은 명령 참조ListTypeRegistrations
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 list-type-versions
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
익스텐션 버전을 나열하려면
다음
list-type-versions
예제에서는 확장 버전에 대한 요약 정보를 반환합니다.aws cloudformation list-type-versions \ --endpoint
https://example.com
\ --regionus-west-2
\ --typeRESOURCE
\ --type-nameMy::Resource::Example
\ --publisher-id123456789012
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 AWS CloudFormation 사용 설명서의 AWS CloudFormation 레지스트리 사용을 참조하세요.
-
자세한 API 내용은 명령 참조ListTypeVersions
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 list-types
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
계정의 프라이빗 리소스 유형을 나열하려면
다음
list-types
예제에서는 현재 AWS 계정에 현재 등록된 프라이빗 리소스 유형의 목록을 표시합니다.aws cloudformation list-types
출력:
{ "TypeSummaries": [ { "Description": "WordPress blog resource for internal use", "LastUpdated": "2019-12-04T18:28:15.059Z", "TypeName": "My::WordPress::BlogExample", "TypeArn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-WordPress-BlogExample", "DefaultVersionId": "00000005", "Type": "RESOURCE" }, { "Description": "Customized resource derived from AWS::Logs::LogGroup", "LastUpdated": "2019-12-04T18:28:15.059Z", "TypeName": "My::Logs::LogGroup", "TypeArn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Logs-LogGroup", "DefaultVersionId": "00000003", "Type": "RESOURCE" } ] }
자세한 내용은 AWS CloudFormation 사용 설명서의 CloudFormation 레지스트리 사용을 참조하세요.
-
자세한 API 내용은 명령 참조ListTypes
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 package
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
다음 명령은 로컬 아티팩트를 S3 버킷에 업로드
template.json
하여 라는 템플릿을 내보내bucket-name
고 내보낸 템플릿을 에 씁니다packaged-template.json
.aws cloudformation package --template-file
/path_to_template/template.json
--s3-bucketbucket-name
--output-template-filepackaged-template.json
--use-json-
자세한 API 내용은 명령 참조의 패키지를
참조하세요. AWS CLI
-
다음 코드 예시에서는 publish-type
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
확장을 게시하려면
다음
publish-type
예제에서는 지정된 확장을 이 리전의 퍼블릭 확장으로 CloudFormation 레지스트리에 게시합니다.aws cloudformation publish-type \ --region
us-west-2
\ --typeRESOURCE
\ --type-nameExample::Test::1234567890abcdef0
출력:
{ "PublicTypeArn":"arn:aws:cloudformation:us-west-2::type/resource/000q6TfUovXsEMmgKowxDZLlwqr2QUshd2e75c8c/Example-Test-1234567890abcdef0/1.0.0" }
자세한 내용은 AWS CloudFormation 사용 설명서의 AWS CloudFormation 레지스트리 사용을 참조하세요.
-
자세한 API 내용은 명령 참조PublishType
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 register-publisher
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
게시자를 등록하려면
다음
register-publisher
예제에서는 게시자를 등록하고 용어 및 조건 파라미터를 수락합니다.aws cloudformation register-publisher \ --region
us-west-2
\ --accept-terms-and-conditions출력:
{ "PublisherId": "000q6TfUovXsEMmgKowxDZLlwqr2QUshd2e75c8c" }
자세한 내용은 AWS CloudFormation 사용 설명서의 AWS CloudFormation 레지스트리 사용을 참조하세요.
-
자세한 API 내용은 명령 참조RegisterPublisher
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 register-type
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
리소스 유형을 등록하려면
다음
register-type
예제에서는 지정된 리소스 유형을 사용자 계정의 프라이빗 리소스 유형으로 등록합니다.aws cloudformation register-type \ --type-name
My::Organization::ResourceName
\ --schema-handler-packages3://bucket_name/my-organization-resource_name.zip
\ --typeRESOURCE
출력:
{ "RegistrationToken": "f5525280-104e-4d35-bef5-8f1f1example" }
자세한 내용은 CloudFormation 유형 개발을 위한 명령줄 인터페이스 사용 설명서의 리소스 공급자 등록을 참조하세요.
-
자세한 API 내용은 명령 참조RegisterType
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 set-stack-policy
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 정책을 적용하려면
다음
set-stack-policy
예제에서는 지정된 스택의 지정된 리소스에 대한 업데이트를 비활성화합니다.stack-policy.json
는 스택의 리소스에 허용되는 작업을 정의하는 JSON 문서입니다.aws cloudformation set-stack-policy \ --stack-name
my-stack
\ --stack-policy-bodyfile://stack-policy.json
출력:
{ "Statement" : [ { "Effect" : "Allow", "Action" : "Update:*", "Principal": "*", "Resource" : "*" }, { "Effect" : "Deny", "Action" : "Update:*", "Principal": "*", "Resource" : "LogicalResourceId/bucket" } ] }
-
자세한 API 내용은 명령 참조SetStackPolicy
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 set-type-configuration
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
데이터를 구성하려면
다음
set-type-configuration
예제에서는 지정된 계정 및 리전의 등록된 CloudFormation 확장에 대한 구성 데이터를 지정합니다.aws cloudformation set-type-configuration \ --region
us-west-2
\ --typeRESOURCE
\ --type-nameExample::Test::Type
\ --configuration-aliasdefault
\ --configuration "{\"CredentialKey\": \"testUserCredential\"}"출력:
{ "ConfigurationArn": "arn:aws:cloudformation:us-west-2:123456789012:type-configuration/resource/Example-Test-Type/default" }
자세한 내용은 AWS CloudFormation 사용 설명서의 AWS CloudFormation 레지스트리 사용을 참조하세요.
-
자세한 API 내용은 명령 참조SetTypeConfiguration
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 set-type-default-version
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
유형의 기본 버전을 설정하려면
다음
set-type-default-version
예제에서는 지정된 유형 버전을 이 유형의 기본값으로 설정합니다.aws cloudformation set-type-default-version \ --type
RESOURCE
\ --type-nameMy::Logs::LogGroup
\ --version-id00000003
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 AWS CloudFormation 사용 설명서의 CloudFormation 레지스트리 사용을 참조하세요.
-
자세한 API 내용은 명령 참조SetTypeDefaultVersion
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 signal-resource
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
리소스에 신호를 보내려면
다음
signal-resource
예제는 라는 스택MyWaitCondition
에 라는 대기 조건을 충족success
하도록 신호를 보냅니다my-stack
.aws cloudformation signal-resource \ --stack-name
my-stack
\ --logical-resource-idMyWaitCondition
\ --unique-id1234
\ --statusSUCCESS
이 명령은 출력을 생성하지 않습니다.
-
자세한 API 내용은 명령 참조SignalResource
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 stop-stack-set-operation
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 세트 작업을 중지하려면
다음
stop-stack-set-operation
예제에서는 지정된 스택 세트에 대한 프로모션 내 업데이트 작업을 중지합니다.aws cloudformation stop-stack-set-operation \ --stack-set-name
my-stack-set
\ --operation-id1261cd27-490b-xmpl-ab42-793a896c69e6
이 명령은 출력을 생성하지 않습니다.
-
자세한 API 내용은 명령 참조StopStackSetOperation
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 test-type
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
확장을 테스트하려면
다음
test-type
예제에서는 등록된 확장을 테스트하여 CloudFormation 레지스트리에 게시하는 데 필요한 모든 요구 사항을 충족하는지 확인합니다.aws cloudformation test-type \ --arn
arn:aws:cloudformation:us-west-2:123456789012:type/resource/Sample-Test-Resource123/00000001
출력:
{ "TypeVersionArn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/Sample-Test-Resource123/00000001" }
자세한 내용은 AWS CloudFormation 사용 설명서의 AWS CloudFormation 레지스트리 사용을 참조하세요.
-
자세한 API 내용은 명령 참조TestType
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 update-stack-instances
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 인스턴스를 업데이트하려면
다음
update-stack-instances
예제에서는 최신 설정을 사용하여 두 리전의 두 계정에 있는 스택 인스턴스에 대한 업데이트를 재시도합니다. 지정된 내결함성 설정을 사용하면 일부 스택을 업데이트할 수 없더라도 모든 계정과 리전에서 업데이트를 시도할 수 있습니다.aws cloudformation update-stack-instances \ --stack-set-name
my-stack-set
\ --accounts123456789012
567890123456
\ --regionsus-east-1
us-west-2
\ --operation-preferencesFailureToleranceCount=3
출력:
{ "OperationId": "103ebdf2-21ea-xmpl-8892-de5e30733132" }
-
자세한 API 내용은 명령 참조UpdateStackInstances
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 update-stack-set
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
스택 세트를 업데이트하려면
다음
update-stack-set
예제에서는 키 이름과 값이Owner
인 태그를 지정된 스택 세트IT
의 스택 인스턴스에 추가합니다.aws cloudformation update-stack-set \ --stack-set-name
my-stack-set
\ --use-previous-template \ --tagsKey=Owner,Value=IT
출력:
{ "OperationId": "e2b60321-6cab-xmpl-bde7-530c6f47950e" }
-
자세한 API 내용은 명령 참조UpdateStackSet
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 update-stack
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
AWS CloudFormation 스택을 업데이트하려면
다음
update-stack
명령에서는mystack
스택의 템플릿 및 입력 파라미터를 업데이트합니다.aws cloudformation update-stack --stack-name
mystack
--template-urlhttps://s3.amazonaws.com/sample/updated.template
--parametersParameterKey=KeyPairName,ParameterValue=SampleKeyPair
ParameterKey=SubnetIDs,ParameterValue=SampleSubnetID1\\,SampleSubnetID2다음
update-stack
명령에서는mystack
스택의SubnetIDs
파라미터값만 업데이트합니다. 파라미터값을 지정하지 않으면 템플릿에 지정된 기본값이 사용됩니다.aws cloudformation update-stack --stack-name
mystack
--template-urlhttps://s3.amazonaws.com/sample/updated.template
--parametersParameterKey=KeyPairName,UsePreviousValue=true
ParameterKey=SubnetIDs,ParameterValue=SampleSubnetID1\\,UpdatedSampleSubnetID2다음
update-stack
명령에서는mystack
스택에 스택 알림 주제 2개를 추가합니다.aws cloudformation update-stack --stack-name
mystack
--use-previous-template --notification-arns"arn:aws:sns:use-east-1:123456789012:mytopic1"
"arn:aws:sns:us-east-1:123456789012:mytopic2"
자세한 내용은 AWS CloudFormation 사용 설명서의 AWS CloudFormation 스택 업데이트를 참조하세요.
-
자세한 API 내용은 명령 참조UpdateStack
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 update-termination-protection
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
종료 방지를 활성화하려면
다음
update-termination-protection
예제에서는 지정된 스택에서 종료 보호를 활성화합니다.aws cloudformation update-termination-protection \ --stack-name
my-stack
\ --enable-termination-protection출력:
{ "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204" }
-
자세한 API 내용은 명령 참조UpdateTerminationProtection
의 섹션을 참조하세요. AWS CLI
-
다음 코드 예시에서는 validate-template
을 사용하는 방법을 보여 줍니다.
- AWS CLI
-
AWS CloudFormation 템플릿을 검증하려면
다음
validate-template
명령은sampletemplate.json
템플릿의 유효성을 확인합니다.aws cloudformation validate-template --template-body
file://sampletemplate.json
출력:
{ "Description": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create a publicly accessible S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", "Parameters": [], "Capabilities": [] }
자세한 내용은 AWS CloudFormation 사용 설명서의 AWS CloudFormation 템플릿 작업을 참조하세요.
-
자세한 API 내용은 명령 참조ValidateTemplate
의 섹션을 참조하세요. AWS CLI
-