描述並列出您的堆疊

您可以使用兩個 AWS CLI 命令來獲取有關 AWS CloudFormation 堆棧的信息：aws cloudformation list-stacks和aws cloudformation describe-stacks。

注意

如AWS CloudFormation 資源需 IAM 政策如何限制使用者可以使用這兩個 AWS CLI 命令執行的動作，請參閱。

aws cloudformation list-stacks

aws cloudformation list-stacks 命令可讓您取得您已建立之任何堆疊的清單 (包含 90 天內已經刪除的堆疊)。您可以使用選項依堆疊狀態篩選結果，例如 CREATE_COMPLETE 和 DELETE_COMPLETE。aws cloudformation list-stacks 命令會傳回任何執行中或已刪除之堆疊的摘要資訊，包括名稱、堆疊識別碼、範本和狀態。

注意

aws cloudformation list-stacks 命令會傳回於 90 天內刪除之堆疊的資訊。

以下範例顯示狀態為 CREATE_COMPLETE 之所有堆疊的摘要：

$ 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 堆疊的摘要資訊：

$ 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	成功更新堆疊之後，持續移除一或多個堆疊的舊資源。對於需要取代資源的堆疊更新，請先 CloudFormation 建立新資源，然後刪除舊資源，以協助減少堆疊中斷的情況。在這種狀態下，堆棧已更新並且可以使用，但 CloudFormation 仍在刪除舊資源。
UPDATE_FAILED	一或多個堆疊更新不成功。檢視堆疊事件，查看任何相關聯的錯誤訊息。
UPDATE_IN_PROGRESS	持續更新一或多個堆疊。
UPDATE_ROLLBACK_COMPLETE	堆疊更新失敗之後，成功將一或多個堆疊返回到之前的運作狀態。
UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS	更新堆疊失敗之後，持續移除一或多個堆疊的新資源。在這種狀態下，堆棧已回滾到其先前的工作狀態並且可以使用，但 CloudFormation 仍在刪除堆棧更新期間創建的任何新資源。
UPDATE_ROLLBACK_FAILED	堆疊更新失敗之後，將一或多個堆疊返回到之前的運作狀態失敗。在此狀態時，您可以刪除堆疊或繼續復原。您可能需要先修正錯誤，您的堆疊才能回到運作狀態。或者，您可以聯繫 AWS Support 以將堆棧恢復到可用狀態。
UPDATE_ROLLBACK_IN_PROGRESS	堆疊更新失敗之後，持續將一或多個堆疊返回到之前的運作狀態。
IMPORT_IN_PROGRESS	匯入操作正在進行。
IMPORT_COMPLETE	已針對支援 resource import 堆疊中的所有資源順利完成匯入操作。
IMPORT_ROLLBACK_IN_PROGRESS	匯入將復原回先前的範本組態。
IMPORT_ROLLBACK_FAILED	堆疊中至少一個資源的匯入復原操作失敗。 CloudFormation 成功匯入的資源將可使用結果。
IMPORT_ROLLBACK_COMPLETE	匯入已成功復原回先前的範本組態。