메뉴
AWS CloudFormation
사용 설명서 (API Version 2010-05-15)

스택 설명 및 나열

두 AWS CLI 명령(aws cloudformation list-stacksaws cloudformation describe-stacks)을 사용하여 AWS CloudFormation 스택에 대한 정보를 가져올 수 있습니다.

참고

IAM 정책을 통해 사용자가 두 AWS CLI 명령을 사용하여 수행할 수 있는 작업을 제한하는 방법에 대한 자세한 내용은 AWS CloudFormation 리소스 단원을 참조하십시오.

aws cloudformation list-stacks

aws cloudformation list-stacks 명령을 사용하면 최대 90일 이전에 삭제된 스택을 포함하여 생성된 스택 목록을 가져올 수 있습니다. 옵션을 사용하여 스택 상태(예: CREATE_COMPLETEDELETE_COMPLETE)별로 결과를 필터링할 수 있습니다. aws cloudformation list-stacks 명령은 이름, 스택 식별자, 템플릿, 상태 등 실행 중이거나 삭제된 스택에 대한 요약 정보를 반환합니다.

참고

aws cloudformation list-stacks 명령은 삭제 후 90일 동안 삭제된 스택에 대한 정보를 반환합니다.

다음 예에서는 상태가 CREATE_COMPLETE인 모든 스택에 대한 요약 내용을 보여줍니다.

Copy
PROMPT> aws cloudformation list-stacks --stack-status-filter CREATE_COMPLETE [ { "StackId": "arn:aws:cloudformation:us-east-2:123456789012:stack/myteststack/ 644df8e0-0dff-11e3-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" } ]

aws cloudformation describe-stacks

aws cloudformation describe-stacks 명령은 실행 중인 스택에 대한 정보를 제공합니다. 옵션을 사용하여 스택 이름에 대한 결과를 필터링할 수 있습니다. 이 명령은 이름, 스택 식별자, 상태를 비롯하여 스택에 대한 정보를 반환합니다.

다음 예에서는 myteststack 스택에 대한 요약 정보를 보여줍니다.

Copy
PROMPT> aws cloudformation describe-stacks --stack-name myteststack { "Stacks": [ { "StackId": "arn:aws:cloudformation:us-east-2:123456789012:stack/myteststack/a69442d0-0b8f-11e3-8b8a-500150b352e0", "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 } ] }

--stack-name 옵션을 사용하여 출력을 한 스택으로 제한하지 않은 경우 모든 실행 중인 스택에 대한 정보가 반환됩니다.

스택 상태 코드

하나 이상의 스택 상태 코드를 지정하여 지정된 상태 코드를 가진 스택만 나열할 수 있습니다. 다음 표에서는 각 스택 상태 코드를 설명합니다.

스택 상태 설명

CREATE_COMPLETE

하나 이상의 스택을 성공적으로 생성했습니다.

CREATE_IN_PROGRESS

하나 이상의 스택을 생성하고 있습니다.

CREATE_FAILED

하나 이상의 스택을 생성하지 못했습니다. 연결된 오류 메시지는 스택 이벤트를 참조하십시오. 생성 실패에 대한 가능한 원인은 스택 내의 모든 리소스에 대한 작업 권한이 없거나, AWS 서비스에서 파라미터 값을 거부했거나, 리소스 생성 중에 제한 시간을 초과했을 수 있습니다.

DELETE_COMPLETE

하나 이상의 스택을 성공적으로 삭제했습니다. 삭제된 스택은 90일 동안 유지되며 볼 수 있습니다.

DELETE_FAILED

하나 이상의 스택을 삭제하지 못했습니다. 삭제에 실패했으므로 일부 리소스가 아직 실행 중일 수 있습니다. 하지만 스택으로 작업하거나 스택을 업데이트할 수 없습니다. 스택을 다시 삭제하십시오. 연결된 오류 메시지는 스택 이벤트를 참조하십시오.

DELETE_IN_PROGRESS

하나 이상의 스택을 제거하고 있습니다.

REVIEW_IN_PROGRESS 템플릿 또는 리소스 없이 예상 StackId를 사용하여 하나 이상의 스택을 생성하고 있습니다.

중요

이 상태 코드를 가진 스택은 가능한 최대 스택 수에 포함됩니다.

ROLLBACK_COMPLETE

스택 생성이 실패하거나 스택 생성을 명시적으로 취소한 이후에 하나 이상의 스택을 성공적으로 제거했습니다. 스택 생성 작업 중에 생성된 모든 리소스가 삭제됩니다.

ROLLBACK_FAILED

스택 생성이 실패하거나 스택 생성을 명시적으로 취소한 이후에 하나 이상의 스택을 제거하지 못했습니다. 스택을 삭제하십시오. 연결된 오류 메시지는 스택 이벤트를 참조하십시오.

ROLLBACK_IN_PROGRESS

스택 생성이 실패하거나 스택 생성을 명시적으로 취소한 이후에 하나 이상의 스택을 제거하고 있습니다.

UPDATE_COMPLETE

하나 이상의 스택을 성공적으로 업데이트했습니다.

UPDATE_COMPLETE_CLEANUP_IN_PROGRESS

스택을 업데이트한 후 하나 이상의 스택에 대한 이전 리소스를 제거하고 있습니다. 스택 업데이트 중에 리소스를 대체해야 하는 경우 AWS CloudFormation에서는 새 리소스를 생성한 다음 이전 리소스를 삭제하여 스택 중단을 줄여줍니다. 이 상태에서는 스택이 업데이트되고 사용 가능하지만 AWS CloudFormation에서는 이전 리소스를 계속 삭제하고 있습니다.

UPDATE_IN_PROGRESS

하나 이상의 스택을 업데이트하고 있습니다.

UPDATE_ROLLBACK_COMPLETE

스택 업데이트를 실패한 이후에 하나 이상의 스택을 이전 작업 상태로 되돌렸습니다.

UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS

스택 업데이트를 실패한 후 하나 이상의 스택에 대한 새 리소스를 제거하고 있습니다. 이 상태에서는 스택이 이전 작업 상태로 롤백되고 사용 가능하지만 AWS CloudFormation에서는 스택 업데이트 중에 생성된 새 리소스를 계속 삭제하고 있습니다.

UPDATE_ROLLBACK_FAILED

스택 업데이트를 실패한 이후에 하나 이상의 스택을 이전 작업 상태로 되돌리지 못했습니다. 스택을 삭제하거나 고객 지원 센터에 문의하여 스택을 사용 가능한 상태로 복원할 수 있습니다.

UPDATE_ROLLBACK_IN_PROGRESS

스택 업데이트를 실패한 이후에 하나 이상의 스택을 이전 작업 상태로 되돌리고 있습니다.