# Exemplos do CloudFormation usando a AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o CloudFormation.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `activate-type`
O código de exemplo a seguir mostra como usar `activate-type`.
**AWS CLI**
**Como ativar um tipo**
O exemplo `activate-type` a seguir ativa uma extensão pública de terceiros, tornando-a disponível para uso em modelos de pilha.
```
aws cloudformation activate-type \
--region us-west-2 \
--type RESOURCE \
--type-name Example::Test::1234567890abcdef0 \
--type-name-alias Example::Test::Alias
```
Resultado:
```
{
"Arn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/Example-Test-Alias"
}
```
Para obter mais informações, consulte [Usar o registro do AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [ActivateType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/activate-type.html) na *Referência de comandos da AWS CLI*.
### `batch-describe-type-configurations`
O código de exemplo a seguir mostra como usar `batch-describe-type-configurations`.
**AWS CLI**
**Para descrever uma configuração de tipo em lote**
O exemplo `batch-describe-type-configurations` a seguir configura os dados para o tipo.
```
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"
```
Resultado:
```
{
"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"
}
]
}
```
Para obter mais informações, consulte [Usar o registro do AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [BatchDescribeTypeConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/batch-describe-type-configurations.html) na *Referência de comandos da AWS CLI*.
### `cancel-update-stack`
O código de exemplo a seguir mostra como usar `cancel-update-stack`.
**AWS CLI**
**Para cancelar uma atualização de pilha que está em andamento**
O comando `cancel-update-stack` a seguir cancela uma atualização de pilha na pilha `myteststack`:
```
aws cloudformation cancel-update-stack --stack-name myteststack
```
+ Consulte detalhes da API em [CancelUpdateStack](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/cancel-update-stack.html) na *AWS CLI Command Reference*.
### `continue-update-rollback`
O código de exemplo a seguir mostra como usar `continue-update-rollback`.
**AWS CLI**
**Para fazer nova tentativa de reversão de atualização**
O exemplo `continue-update-rollback` a seguir retoma uma operação de reversão de uma atualização de pilha anterior em que houve falha.
```
aws cloudformation continue-update-rollback \
--stack-name my-stack
```
Este comando não produz saída.
+ Consulte detalhes da API em [ContinueUpdateRollback](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/continue-update-rollback.html) na *AWS CLI Command Reference*.
### `create-change-set`
O código de exemplo a seguir mostra como usar `create-change-set`.
**AWS CLI**
**Para criar um conjunto de alterações**
O exemplo `create-change-set` a seguir cria um conjunto de alterações com o recurso `CAPABILITY_IAM`. O arquivo `template.yaml` é um modelo do AWS CloudFormation na pasta atual que define uma pilha que inclui recursos do IAM.
```
aws cloudformation create-change-set \
--stack-name my-application \
--change-set-name my-change-set \
--template-body file://template.yaml \
--capabilities CAPABILITY_IAM
```
Resultado:
```
{
"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"
}
```
+ Para ver detalhes da API, consulte [CreateChangeSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/create-change-set.html) na *Referência de comandos da AWS CLI*.
### `create-generated-template`
O código de exemplo a seguir mostra como usar `create-generated-template`.
**AWS CLI**
**Como criar um modelo gerado de recursos verificados**
O exemplo de `create-generated-template` a seguir cria um modelo gerado de recursos verificados com o nome `MyTemplate`.
```
aws cloudformation create-generated-template \
--generated-template-name MyTemplate \
--resources file://resources.json
```
Conteúdo de `resources.json`:
```
[
{
"ResourceType": "AWS::EKS::Cluster",
"LogicalResourceId":"MyCluster",
"ResourceIdentifier": {
"ClusterName": "MyAppClusterName"
}
},
{
"ResourceType": "AWS::AutoScaling::AutoScalingGroup",
"LogicalResourceId":"MyASG",
"ResourceIdentifier": {
"AutoScalingGroupName": "MyAppASGName"
}
},
{
"ResourceType": "AWS::EKS::Nodegroup",
"LogicalResourceId":"MyNodegroup",
"ResourceIdentifier": {
"NodegroupName": "MyAppNodegroupName"
}
},
{
"ResourceType": "AWS::IAM::Role",
"LogicalResourceId":"MyRole",
"ResourceIdentifier": {
"RoleId": "arn:aws::iam::123456789012:role/MyAppIAMRole"
}
}
]
```
Resultado:
```
{
"Arn":
"arn:aws:cloudformation:us-east-1:123456789012:generatedtemplate/7fc8512c-d8cb-4e02-b266-d39c48344e48",
"Name": "MyTemplate"
}
```
Para ter mais informações, consulte [Criar um modelo do CloudFormation a partir de recursos verificados com o gerador de IaC](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/iac-generator-create-template-from-scanned-resources.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [CreateGeneratedTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/create-generated-template.html) na *Referência de comandos da AWS CLI*.
### `create-stack-instances`
O código de exemplo a seguir mostra como usar `create-stack-instances`.
**AWS CLI**
**Para criar instâncias da pilha**
O exemplo `create-stack-instances` a seguir cria instâncias de um conjunto de pilhas em duas contas e em quatro regiões. A configuração de tolerância a falhas garante que a atualização seja tentada em todas as contas e regiões, mesmo que algumas pilhas não possam ser criadas.
```
aws cloudformation create-stack-instances \
--stack-set-name my-stack-set \
--accounts 123456789012 223456789012 \
--regions us-east-1 us-east-2 us-west-1 us-west-2 \
--operation-preferences FailureToleranceCount=7
```
Resultado:
```
{
"OperationId": "d7995c31-83c2-xmpl-a3d4-e9ca2811563f"
}
```
Para criar um conjunto de pilhas, use o comando `create-stack-set`.
+ Para ver detalhes da API, consulte [CreateStackInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/create-stack-instances.html) na *Referência de comandos da AWS CLI*.
### `create-stack-refactor`
O código de exemplo a seguir mostra como usar `create-stack-refactor`.
**AWS CLI**
**Como criar a definição de pilha para uma operação de refatoração de pilhas**
O exemplo de `create-stack-refactor` a seguir cria a definição de pilha para refatoração de pilhas.
```
aws cloudformation create-stack-refactor \
--stack-definitions \
StackName=Stack1,TemplateBody@=file://template1-updated.yaml \
StackName=Stack2,TemplateBody@=file://template2-updated.yaml
```
Resultado:
```
{
"StackRefactorId": "9c384f70-4e07-4ed7-a65d-fee5eb430841"
}
```
Para ter mais informações, consulte [Refatoração de pilhas](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-refactoring.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [CreateStackRefactor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/create-stack-refactor.html) na *Referência de comandos da AWS CLI*.
### `create-stack-set`
O código de exemplo a seguir mostra como usar `create-stack-set`.
**AWS CLI**
**Para criar um conjunto de pilhas**
O exemplo `create-stack-set` a seguir cria um conjunto de pilhas usando o modelo de arquivo YAML especificado. `template.yaml` é um modelo do AWS CloudFormation na pasta atual que define uma pilha.
```
aws cloudformation create-stack-set \
--stack-set-name my-stack-set \
--template-body file://template.yaml \
--description "SNS topic"
```
Resultado:
```
{
"StackSetId": "my-stack-set:8d0f160b-d157-xmpl-a8e6-c0ce8e5d8cc1"
}
```
Para adicionar instâncias de pilha ao conjunto de pilhas, use o comando `create-stack-instances`.
+ Para ver detalhes da API, consulte [CreateStackSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/create-stack-set.html) na *Referência de comandos da AWS CLI*.
### `create-stack`
O código de exemplo a seguir mostra como usar `create-stack`.
**AWS CLI**
**Para criar uma pilha do AWS CloudFormation**
O exemplo de `create-stacks` a seguir cria uma pilha com o nome de `myteststack` usando o arquivo de modelo `sampletemplate.json`:
```
aws cloudformation create-stack --stack-name myteststack --template-body file://sampletemplate.json --parameters ParameterKey=KeyPairName,ParameterValue=TestKey ParameterKey=SubnetIDs,ParameterValue=SubnetID1\\,SubnetID2
```
Resultado:
```
{
"StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896"
}
```
Para obter mais informações, consulte Pilhas no *Guia do usuário do AWS CloudFormation*.
+ Consulte detalhes da API em [CreateStack](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/create-stack.html) na *AWS CLI Command Reference*.
### `deactivate-type`
O código de exemplo a seguir mostra como usar `deactivate-type`.
**AWS CLI**
**Para desativar um tipo**
O exemplo `deactivate-type` a seguir desativa uma extensão pública que foi ativada anteriormente nesta conta e região.
```
aws cloudformation deactivate-type \
--region us-west-2 \
--type MODULE \
--type-name Example::Test::Type::MODULE
```
Este comando não produz saída.
Para obter mais informações, consulte [Usar o registro do AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [DeactivateType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/deactivate-type.html) na *Referência de comandos da AWS CLI*.
### `delete-change-set`
O código de exemplo a seguir mostra como usar `delete-change-set`.
**AWS CLI**
**Para excluir um conjunto de alterações**
O exemplo `delete-change-set` a seguir exclui um conjunto de alterações especificando o nome do conjunto de alterações e o nome da pilha.
```
aws cloudformation delete-change-set \
--stack-name my-stack \
--change-set-name my-change-set
```
Este comando não produz saída.
O exemplo `delete-change-set` a seguir exclui um conjunto de alterações especificando o ARN completo do conjunto de alterações.
```
aws cloudformation delete-change-set \
--change-set-name arn:aws:cloudformation:us-east-2:123456789012:changeSet/my-change-set/4eca1a01-e285-xmpl-8026-9a1967bfb4b0
```
Este comando não produz saída.
+ Para ver detalhes da API, consulte [DeleteChangeSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/delete-change-set.html) na *Referência de comandos da AWS CLI*.
### `delete-generated-template`
O código de exemplo a seguir mostra como usar `delete-generated-template`.
**AWS CLI**
**Como excluir um modelo gerado**
O exemplo de `delete-generated-template` a seguir exclui o modelo especificado.
```
aws cloudformation delete-generated-template \
--generated-template-name MyTemplate
```
Este comando não produz saída.
Para ter mais informações, consulte [Gerar modelos a partir de recursos existentes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/generate-IaC.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [DeleteGeneratedTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/delete-generated-template.html) na *Referência de comandos da AWS CLI*.
### `delete-stack-instances`
O código de exemplo a seguir mostra como usar `delete-stack-instances`.
**AWS CLI**
**Para excluir instâncias de pilha**
O exemplo `delete-stack-instances` a seguir exclui instâncias de um conjunto de pilhas em duas contas em duas regiões e encerra as pilhas.
```
aws cloudformation delete-stack-instances \
--stack-set-name my-stack-set \
--accounts 123456789012 567890123456 \
--regions us-east-1 us-west-1 \
--no-retain-stacks
```
Resultado:
```
{
"OperationId": "ad49f10c-fd1d-413f-a20a-8de6e2fa8f27"
}
```
Para excluir um conjunto de pilhas vazio, use o comando `delete-stack-set`.
+ Para ver detalhes da API, consulte [DeleteStackInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/delete-stack-instances.html) na *Referência de comandos da AWS CLI*.
### `delete-stack-set`
O código de exemplo a seguir mostra como usar `delete-stack-set`.
**AWS CLI**
**Para excluir um conjunto de pilhas**
O comando a seguir exclui o conjunto de pilhas vazio especificado. O conjunto da pilha deve estar vazio.
```
aws cloudformation delete-stack-set \
--stack-set-name my-stack-set
```
Este comando não produz saída.
Para excluir instâncias do conjunto de pilhas, use o comando `delete-stack-instances`.
+ Para ver detalhes da API, consulte [DeleteStackSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/delete-stack-set.html) na *Referência de comandos da AWS CLI*.
### `delete-stack`
O código de exemplo a seguir mostra como usar `delete-stack`.
**AWS CLI**
**Para excluir uma pilha**
O exemplo de `delete-stack` a seguir exclui a pilha especificada.
```
aws cloudformation delete-stack \
--stack-name my-stack
```
Este comando não produz saída.
+ Consulte detalhes da API em [DeleteStack](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/delete-stack.html) na *AWS CLI Command Reference*.
### `deploy`
O código de exemplo a seguir mostra como usar `deploy`.
**AWS CLI**
O comando a seguir implanta o modelo chamado `template.json` em uma pilha chamada `my-new-stack`:
```
aws cloudformation deploy --template-file /path_to_template/template.json --stack-name my-new-stack --parameter-overrides Key1=Value1 Key2=Value2 --tags Key1=Value1 Key2=Value2
```
+ Para ver detalhes da API, consulte [Deploy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/deploy.html) na *Referência de comandos da AWS CLI*.
### `deregister-type`
O código de exemplo a seguir mostra como usar `deregister-type`.
**AWS CLI**
**Como cancelar o registro de uma versão de tipo**
O exemplo `deregister-type` a seguir remove a versão do tipo especificado do uso ativo no registro do CloudFormation, para que ela não possa mais ser usada nas operações do CloudFormation.
```
aws cloudformation deregister-type \
--type RESOURCE \
--type-name My::Logs::LogGroup \
--version-id 00000002
```
Este comando não produz saída.
Para obter mais informações, consulte [Usar o registro do CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [DeregisterType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/deregister-type.html) na *Referência de comandos da AWS CLI*.
### `describe-account-limits`
O código de exemplo a seguir mostra como usar `describe-account-limits`.
**AWS CLI**
**Para obter informações sobre os limites da sua conta**
O comando a seguir recupera uma lista de limites regionais para a conta atual.
```
aws cloudformation describe-account-limits
```
Resultado:
```
{
"AccountLimits": [
{
"Name": "StackLimit",
"Value": 200
},
{
"Name": "StackOutputsLimit",
"Value": 60
},
{
"Name": "ConcurrentResourcesLimit",
"Value": 2500
}
]
}
```
+ Para ver detalhes da API, consulte [DescribeAccountLimits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-account-limits.html) na *Referência de comandos da AWS CLI*.
### `describe-change-set`
O código de exemplo a seguir mostra como usar `describe-change-set`.
**AWS CLI**
**Para obter mais informações sobre um conjunto de alterações**
O exemplo `describe-change-set` a seguir exibe os detalhes do conjunto de alterações especificado pelo nome do conjunto de alterações e nome da pilha.
```
aws cloudformation describe-change-set \
--change-set-name my-change-set \
--stack-name my-stack
```
O exemplo `describe-change-set` a seguir exibe os detalhes do conjunto de alterações especificado pelo ARN completo do conjunto de alterações:
```
aws cloudformation describe-change-set \
--change-set-name arn:aws:cloudformation:us-west-2:123456789012:changeSet/my-change-set/bc9555ba-a949-xmpl-bfb8-f41d04ec5784
```
Resultado:
```
{
"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
}
```
+ Para ver detalhes da API, consulte [DescribeChangeSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-change-set.html) na *Referência de comandos da AWS CLI*.
### `describe-generated-template`
O código de exemplo a seguir mostra como usar `describe-generated-template`.
**AWS CLI**
**Como descrever um modelo gerado**
O exemplo de `describe-generated-template` a seguir descreve o modelo especificado.
```
aws cloudformation describe-generated-template \
--generated-template-name MyTemplate
```
Resultado:
```
{
"GeneratedTemplateId": "arn:aws:cloudformation:us-east-1:123456789012:generatedTemplate/7d881acf-f307-4ded-910e-f8fb49b96894",
"GeneratedTemplateName": "MyTemplate",
"Resources": [
{
"ResourceType": "AWS::EC2::SecurityGroup",
"LogicalResourceId": "EC2SecurityGroup",
"ResourceIdentifier": {
"Id": "sg-1234567890abcdef0"
},
"ResourceStatus": "COMPLETE",
"ResourceStatusReason": "Resource Template complete",
"Warnings": []
},
{
"ResourceType": "AWS::EC2::Instance",
"LogicalResourceId": "EC2Instance",
"ResourceIdentifier": {
"InstanceId": "i-1234567890abcdef0"
},
"ResourceStatus": "COMPLETE",
"ResourceStatusReason": "Resource Template complete",
"Warnings": []
},
{
"ResourceType": "AWS::EC2::KeyPair",
"LogicalResourceId": "EC2KeyPairSshkeypair",
"ResourceIdentifier": {
"KeyName": "sshkeypair"
},
"ResourceStatus": "COMPLETE",
"ResourceStatusReason": "Resource Template complete",
"Warnings": []
}
],
"Status": "COMPLETE",
"StatusReason": "All resources complete",
"CreationTime": "2025-09-23T19:38:06.435000+00:00",
"LastUpdatedTime": "2025-09-23T19:38:10.798000+00:00",
"Progress": {
"ResourcesSucceeded": 3,
"ResourcesFailed": 0,
"ResourcesProcessing": 0,
"ResourcesPending": 0
},
"TemplateConfiguration": {
"DeletionPolicy": "RETAIN",
"UpdateReplacePolicy": "RETAIN"
},
"TotalWarnings": 0
}
```
Para ter mais informações, consulte [Gerar modelos a partir de recursos existentes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/generate-IaC.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [DescribeGeneratedTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-generated-template.html) na *Referência de comandos da AWS CLI*.
### `describe-publisher`
O código de exemplo a seguir mostra como usar `describe-publisher`.
**AWS CLI**
**Para descrever um publicador**
O exemplo `describe-publisher` a seguir configura as informações de um publicador.
```
aws cloudformation describe-publisher \
--region us-west-2 \
--publisher-id 000q6TfUovXsEMmgKowxDZLlwqr2QUsh
```
Resultado:
```
{
"PublisherId": "000q6TfUovXsEMmgKowxDZLlwqr2QUshd2e75c8c",
"PublisherStatus": "VERIFIED",
"IdentityProvider": "AWS_Marketplace",
"PublisherProfile": "https://aws.amazon.com/marketplace/seller-profile?id=2c5dc1f0-17cd-4259-8e46-822a83gdtegd"
}
```
Para obter mais informações, consulte [Usar o registro do AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [DescribePublisher](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-publisher.html) na *Referência de comandos da AWS CLI*.
### `describe-resource-scan`
O código de exemplo a seguir mostra como usar `describe-resource-scan`.
**AWS CLI**
**Para descrever uma varredura de recursos**
O exemplo de `describe-resource-scan` a seguir descreve a verificação de recursos com o ID de verificação especificado.
```
aws cloudformation describe-resource-scan --region \
--resource-scan-id arn:aws:cloudformation:us-east-1:123456789012:resourceScan/0a699f15-489c-43ca-a3ef-3e6ecfa5da60
```
Resultado:
```
{
"ResourceScanId": "arn:aws:cloudformation:us-east-1:123456789012:resourceScan/0a699f15-489c-43ca-a3ef-3e6ecfa5da60",
"Status": "COMPLETE",
"StartTime": "2025-08-21T03:10:38.485000+00:00",
"EndTime": "2025-08-21T03:20:28.485000+00:00",
"PercentageCompleted": 100.0,
"ResourceTypes": [
"AWS::CloudFront::CachePolicy",
"AWS::CloudFront::OriginRequestPolicy",
"AWS::EC2::DHCPOptions",
"AWS::EC2::InternetGateway",
"AWS::EC2::KeyPair",
"AWS::EC2::NetworkAcl",
"AWS::EC2::NetworkInsightsPath",
"AWS::EC2::NetworkInterface",
"AWS::EC2::PlacementGroup",
"AWS::EC2::Route",
"AWS::EC2::RouteTable",
"AWS::EC2::SecurityGroup",
"AWS::EC2::Subnet",
"AWS::EC2::SubnetCidrBlock",
"AWS::EC2::SubnetNetworkAclAssociation",
"AWS::EC2::SubnetRouteTableAssociation",
...
],
"ResourcesRead": 676
}
```
Para ter mais informações, consulte [Gerar modelos a partir de recursos existentes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/generate-IaC.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [DescribeResourceScan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-resource-scan.html) na *Referência de comandos da AWS CLI*.
### `describe-stack-drift-detection-status`
O código de exemplo a seguir mostra como usar `describe-stack-drift-detection-status`.
**AWS CLI**
**Como verificar o status de uma operação de detecção de desvios**
O exemplo `describe-stack-drift-detection-status` a seguir exibe o status de uma operação de detecção de desvios. Para obter o ID, execute o comando `detect-stack-drift`.
```
aws cloudformation describe-stack-drift-detection-status \
--stack-drift-detection-id 1a229160-e4d9-xmpl-ab67-0a4f93df83d4
```
Resultado:
```
{
"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"
}
```
+ Para ver detalhes da API, consulte [DescribeStackDriftDetectionStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stack-drift-detection-status.html) na *Referência de comandos da AWS CLI*.
### `describe-stack-events`
O código de exemplo a seguir mostra como usar `describe-stack-events`.
**AWS CLI**
**Para descrever os eventos da pilha**
O exemplo `describe-stack-events` a seguir exibe os dois eventos mais recentes da pilha especificada.
```
aws cloudformation describe-stack-events \
--stack-name my-stack \
--max-items 2
{
"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=="
}
```
+ Consulte detalhes da API em [DescribeStackEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stack-events.html) na*AWS CLI Command Reference*.
### `describe-stack-instance`
O código de exemplo a seguir mostra como usar `describe-stack-instance`.
**AWS CLI**
**Para descrever uma instância de pilha**
O comando a seguir descreve uma instância do conjunto de pilhas especificado na conta e na região especificadas. O conjunto de pilhas está na região e na conta atuais, e a instância está na região `us-west-2` da conta `123456789012`:
```
aws cloudformation describe-stack-instance \
--stack-set-name my-stack-set \
--stack-instance-account 123456789012 \
--stack-instance-region us-west-2
```
Resultado:
```
{
"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=)."
}
}
```
+ Para ver detalhes da API, consulte [DescribeStackInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stack-instance.html) na *Referência de comandos da AWS CLI*.
### `describe-stack-refactor`
O código de exemplo a seguir mostra como usar `describe-stack-refactor`.
**AWS CLI**
**Como descrever uma operação de refatoração de pilha**
O exemplo de `describe-stack-refactor` a seguir descreve a operação de refatoração de pilha com o ID de refatoração de pilha especificado.
```
aws cloudformation describe-stack-refactor \
--stack-refactor-id 9c384f70-4e07-4ed7-a65d-fee5eb430841
```
Resultado:
```
{
"StackRefactorId": "9c384f70-4e07-4ed7-a65d-fee5eb430841",
"StackIds": [
"arn:aws:cloudformation:us-east-1:123456789012:stack/Stack1/3e6a1ff0-94b1-11f0-aa6f-0a88d2e03acf",
"arn:aws:cloudformation:us-east-1:123456789012:stack/Stack2/5da91650-94b1-11f0-81cf-0a23500e151b"
],
"ExecutionStatus": "AVAILABLE",
"Status": "CREATE_COMPLETE"
}
```
Para ter mais informações, consulte [Refatoração de pilhas](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-refactoring.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [DescribeStackRefactor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stack-refactor.html) na *Referência de comandos da AWS CLI*.
### `describe-stack-resource-drifts`
O código de exemplo a seguir mostra como usar `describe-stack-resource-drifts`.
**AWS CLI**
**Para obter informações sobre recursos que desviaram da definição da pilha**
O comando a seguir exibe informações sobre recursos desviados da pilha especificada. Para iniciar a detecção de desvios, use o comando `detect-stack-drift`:
```
aws cloudformation describe-stack-resource-drifts \
--stack-name my-stack
```
A saída mostra uma função do AWS Lambda que foi modificada fora de banda:
```
{
"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"
}
]
}
```
+ Para ver detalhes da API, consulte [DescribeStackResourceDrifts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stack-resource-drifts.html) na *Referência de comandos da AWS CLI*.
### `describe-stack-resource`
O código de exemplo a seguir mostra como usar `describe-stack-resource`.
**AWS CLI**
**Para obter informações detalhadas sobre o recurso de uma pilha**
O exemplo de `describe-stack-resource` a seguir exibe os detalhes do recurso denominado `MyFunction` da pilha especificada.
```
aws cloudformation describe-stack-resource \
--stack-name MyStack \
--logical-resource-id MyFunction
```
Resultado:
```
{
"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"
}
}
}
```
+ Consulte detalhes da API em [DescribeStackResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stack-resource.html) na *AWS CLI Command Reference*.
### `describe-stack-resources`
O código de exemplo a seguir mostra como usar `describe-stack-resources`.
**AWS CLI**
**Para obter informações detalhadas sobre o recurso de uma pilha**
O exemplo de `describe-stack-resources` a seguir exibe os detalhes dos recursos na pilha especificada.
```
aws cloudformation describe-stack-resources \
--stack-name my-stack
```
Resultado:
```
{
"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"
}
}
]
}
```
+ Consulte detalhes da API em [DescribeStackResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stack-resources.html) na *AWS CLI Command Reference*.
### `describe-stack-set-operation`
O código de exemplo a seguir mostra como usar `describe-stack-set-operation`.
**AWS CLI**
**Para obter informações sobre uma operação de conjunto de pilhas**
O exemplo describe-stack-set-operation` a seguir exibe detalhes de uma operação de atualização no conjunto de pilhas especificado.
```
aws cloudformation describe-stack-set-operation \
--stack-set-name enable-config \
--operation-id 35d45ebc-ed88-xmpl-ab59-0197a1fc83a0
```
Resultado:
```
{
"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"
}
}
```
+ Para ver detalhes da API, consulte [DescribeStackSetOperation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stack-set-operation.html) na *Referência de comandos da AWS CLI*.
### `describe-stack-set`
O código de exemplo a seguir mostra como usar `describe-stack-set`.
**AWS CLI**
**Para obter informações sobre um conjunto de pilhas**
O exemplo de describe-stack-set` a seguir exibe detalhes sobre o conjunto de pilhas especificado.
```
aws cloudformation describe-stack-set \
--stack-set-name my-stack-set
```
Resultado:
```
{
"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"
}
}
```
+ Para ver detalhes da API, consulte [DescribeStackSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stack-set.html) na *Referência de comandos da AWS CLI*.
### `describe-stacks`
O código de exemplo a seguir mostra como usar `describe-stacks`.
**AWS CLI**
**Para descrever as pilhas do AWS CloudFormation**
O comando `describe-stacks` a seguir mostra informações resumidas da pilha `myteststack`:
```
aws cloudformation describe-stacks --stack-name myteststack
```
Resultado:
```
{
"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
}
]
}
```
Para obter mais informações, consulte Pilhas no *Guia do usuário do AWS CloudFormation*.
+ Consulte detalhes da API em [DescribeStacks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-stacks.html) na *AWS CLI Command Reference*.
### `describe-type-registration`
O código de exemplo a seguir mostra como usar `describe-type-registration`.
**AWS CLI**
**Como exibir as informações de registro do tipo**
O exemplo `describe-type-registration` a seguir exibe informações sobre o registro de tipo especificado, incluindo o status atual, o tipo e a versão do tipo.
```
aws cloudformation describe-type-registration \
--registration-token a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Resultado:
```
{
"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"
}
```
Para obter mais informações, consulte [Usar o registro do CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [DescribeTypeRegistration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-type-registration.html) na *Referência de comandos da AWS CLI*.
### `describe-type`
O código de exemplo a seguir mostra como usar `describe-type`.
**AWS CLI**
**Como exibir as informações de tipo**
O exemplo `describe-type` a seguir mostra as informações do tipo especificado.
```
aws cloudformation describe-type \
--type-name My::Logs::LogGroup \
--type RESOURCE
```
Resultado:
```
{
"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]"
}
```
Para obter mais informações, consulte [Usar o registro do CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [DescribeType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/describe-type.html) na *Referência de comandos da AWS CLI*.
### `detect-stack-drift`
O código de exemplo a seguir mostra como usar `detect-stack-drift`.
**AWS CLI**
**Como detectar recursos desviados**
O exemplo `detect-stack-drift` a seguir inicia a detecção de desvios na pilha específica.
```
aws cloudformation detect-stack-drift \
--stack-name my-stack
```
Resultado:
```
{
"StackDriftDetectionId": "1a229160-e4d9-xmpl-ab67-0a4f93df83d4"
}
```
Em seguida, você pode usar esse ID com o comando `describe-stack-resource-drifts` para descrever recursos desviados.
+ Para ver detalhes da API, consulte [DetectStackDrift](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/detect-stack-drift.html) na *Referência de comandos da AWS CLI*.
### `detect-stack-resource-drift`
O código de exemplo a seguir mostra como usar `detect-stack-resource-drift`.
**AWS CLI**
**Como detectar o desvio de um recurso**
O exemplo `detect-stack-resource-drift` a seguir verifica se há desvios em um recurso chamado `MyFunction` em uma pilha chamada `MyStack`:
```
aws cloudformation detect-stack-resource-drift \
--stack-name MyStack \
--logical-resource-id MyFunction
```
A saída mostra uma função do AWS Lambda que foi modificada fora de banda:
```
{
"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"
}
}
```
+ Para ver detalhes da API, consulte [DetectStackResourceDrift](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/detect-stack-resource-drift.html) na *Referência de comandos da AWS CLI*.
### `detect-stack-set-drift`
O código de exemplo a seguir mostra como usar `detect-stack-set-drift`.
**AWS CLI**
**Como detectar desvios em um conjunto de pilhas e em todas as instâncias de pilha associadas**
O exemplo `detect-stack-set-drift` a seguir inicia as operações de detecção de desvio no conjunto de pilhas especificado, incluindo todas as instâncias de pilha associadas a esse conjunto de pilhas, e retorna um ID de operação que pode ser usado para rastrear o status da operação de desvio.
```
aws cloudformation detect-stack-set-drift \
--stack-set-name stack-set-drift-example
```
Resultado:
```
{
"OperationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
Para obter mais informações, consulte [Detectar alterações de configuração não gerenciadas em conjuntos de pilhas](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-drift.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [DetectStackSetDrift](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/detect-stack-set-drift.html) na *Referência de comandos da AWS CLI*.
### `estimate-template-cost`
O código de exemplo a seguir mostra como usar `estimate-template-cost`.
**AWS CLI**
**Para estimar o custo do modelo**
O exemplo de `estimate-template-cost` a seguir gera uma estimativa de custo para um modelo denominado `template.yaml` na pasta atual.
```
aws cloudformation estimate-template-cost \
--template-body file://template.yaml
```
Resultado:
```
{
"Url": "http://calculator.s3.amazonaws.com/calc5.html?key=cloudformation/7870825a-xmpl-4def-92e7-c4f8dd360cca"
}
```
+ Consulte detalhes da API em [EstimateTemplateCost](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/estimate-template-cost.html) na *AWS CLI Command Reference*.
### `execute-change-set`
O código de exemplo a seguir mostra como usar `execute-change-set`.
**AWS CLI**
**Para executar um conjunto de alterações**
O exemplo `execute-change-set` a seguir executa um conjunto de alterações especificado pelo nome do conjunto de alterações e nome da pilha.
```
aws cloudformation execute-change-set \
--change-set-name my-change-set \
--stack-name my-stack
```
O exemplo `execute-change-set` a seguir executa um conjunto de alterações especificado pelo ARN completo do conjunto de alterações.
```
aws cloudformation execute-change-set \
--change-set-name arn:aws:cloudformation:us-west-2:123456789012:changeSet/my-change-set/bc9555ba-a949-xmpl-bfb8-f41d04ec5784
```
+ Para ver detalhes da API, consulte [ExecuteChangeSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/execute-change-set.html) na *Referência de comandos da AWS CLI*.
### `execute-stack-refactor`
O código de exemplo a seguir mostra como usar `execute-stack-refactor`.
**AWS CLI**
**Como concluir uma operação de refatoração de pilha**
O exemplo de `execute-stack-refactor` a seguir conclui a operação de refatoração de pilha com o ID de refatoração de pilha especificado.
```
aws cloudformation execute-stack-refactor \
--stack-refactor-id 9c384f70-4e07-4ed7-a65d-fee5eb430841
```
Este comando não produz saída.
Para ter mais informações, consulte [Refatoração de pilhas](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-refactoring.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [ExecuteStackRefactor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/execute-stack-refactor.html) na *Referência de comandos da AWS CLI*.
### `get-stack-policy`
O código de exemplo a seguir mostra como usar `get-stack-policy`.
**AWS CLI**
**Como visualizar uma política de pilha**
O exemplo `get-stack-policy` a seguir exibe os detalhes da política de pilha da pilha especificada. Para anexar uma política a uma pilha, use o comando `set-stack-policy`.
```
aws cloudformation get-stack-policy \
--stack-name my-stack
```
Resultado:
```
{
"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"
}
```
+ Para ver detalhes da API, consulte [GetStackPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/get-stack-policy.html) na *Referência de comandos da AWS CLI*.
### `get-template-summary`
O código de exemplo a seguir mostra como usar `get-template-summary`.
**AWS CLI**
**Como exibir um resumo do modelo**
O comando a seguir exibe informações de resumo sobre os recursos e metadados do arquivo de modelo especificado.
```
aws cloudformation get-template-summary \
--template-body file://template.yaml
```
Resultado:
```
{
"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"
}
```
+ Para ver detalhes da API, consulte [GetTemplateSummary](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/get-template-summary.html) na *Referência de comandos da AWS CLI*.
### `get-template`
O código de exemplo a seguir mostra como usar `get-template`.
**AWS CLI**
**Para visualizar o corpo do modelo de uma pilha do AWS CloudFormation**
O comando `get-template` a seguir mostra o modelo da pilha `myteststack`:
```
aws cloudformation get-template --stack-name myteststack
```
Resultado:
```
{
"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"
}
}
}
}
}
```
+ Consulte detalhes da API em [GetTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/get-template.html) na *AWS CLI Command Reference*.
### `list-change-sets`
O código de exemplo a seguir mostra como usar `list-change-sets`.
**AWS CLI**
**Para listar conjuntos de alterações**
O exemplo `list-change-sets` a seguir exibe uma lista dos conjuntos de alterações pendentes da pilha especificada.
```
aws cloudformation list-change-sets \
--stack-name my-stack
```
Resultado:
```
{
"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"
}
]
}
```
+ Para ver detalhes da API, consulte [ListChangeSets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-change-sets.html) na *Referência de comandos da AWS CLI*.
### `list-exports`
O código de exemplo a seguir mostra como usar `list-exports`.
**AWS CLI**
**Para listar as exportações**
O exemplo `list-exports` a seguir exibe uma lista das exportações das pilhas na região atual.
```
aws cloudformation list-exports
```
Resultado:
```
{
"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"
}
]
}
```
+ Para ver detalhes da API, consulte [ListExports](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-exports.html) na *Referência de comandos da AWS CLI*.
### `list-generated-templates`
O código de exemplo a seguir mostra como usar `list-generated-templates`.
**AWS CLI**
**Como listar modelos gerados**
O exemplo de `list-generated-templates` a seguir lista todos os modelos gerados.
```
aws cloudformation list-generated-templates
```
Resultado:
```
{
"Summaries": [
{
"GeneratedTemplateId": "arn:aws:cloudformation:us-east-1:123456789012:generatedtemplate/7fc8512c-d8cb-4e02-b266-d39c48344e48",
"GeneratedTemplateName": "MyTemplate",
"Status": "COMPLETE",
"StatusReason": "All resources complete",
"CreationTime": "2025-09-23T20:13:24.283000+00:00",
"LastUpdatedTime": "2025-09-23T20:13:28.610000+00:00",
"NumberOfResources": 4
},
{
"GeneratedTemplateId": "arn:aws:cloudformation:us-east-1:123456789012:generatedTemplate/f10dd1c4-edc6-4823-8153-ab6112b8d051",
"GeneratedTemplateName": "MyEC2InstanceTemplate",
"Status": "COMPLETE",
"StatusReason": "All resources complete",
"CreationTime": "2024-08-08T19:35:49.790000+00:00",
"LastUpdatedTime": "2024-08-08T19:35:52.207000+00:00",
"NumberOfResources": 3
},
{
"GeneratedTemplateId": "arn:aws:cloudformation:us-east-1:123456789012:generatedTemplate/e5a1c89f-7ce2-41bd-9bdf-75b7c852e3ca",
"GeneratedTemplateName": "MyEKSNodeGroupTemplate",
"Status": "COMPLETE",
"StatusReason": "All resources complete",
"CreationTime": "2024-07-16T20:39:27.883000+00:00",
"LastUpdatedTime": "2024-07-16T20:39:35.766000+00:00",
"NumberOfResources": 4
}
]
}
```
Para ter mais informações, consulte [Gerar modelos a partir de recursos existentes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/generate-IaC.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [ListGeneratedTemplates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-generated-templates.html) na *Referência de comandos da AWS CLI*.
### `list-imports`
O código de exemplo a seguir mostra como usar `list-imports`.
**AWS CLI**
**Para listar as importações**
O exemplo `list-imports` a seguir lista as pilhas que importam a exportação especificada. Para obter a lista de exportações disponíveis, use o comando `list-exports`.
```
aws cloudformation list-imports \
--export-name private-vpc-vpcid
```
Resultado:
```
{
"Imports": [
"my-database-stack"
]
}
```
+ Para ver detalhes da API, consulte [ListImports](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-imports.html) na *Referência de comandos da AWS CLI*.
### `list-resource-scan-related-resources`
O código de exemplo a seguir mostra como usar `list-resource-scan-related-resources`.
**AWS CLI**
**Como listar recursos relacionados usando uma verificação de recursos**
O exemplo de `list-resource-scan-related-resources` a seguir lista os recursos da verificação especificada que estão relacionados aos recursos em `resources.json`.
```
aws cloudformation list-resource-scan-related-resources \
--resource-scan-id arn:aws:cloudformation:us-east-1:123456789012:resourceScan/0a699f15-489c-43ca-a3ef-3e6ecfa5da60 \
--resources file://resources.json
```
Conteúdo de `resources.json`:
```
[
{
"ResourceType": "AWS::EKS::Cluster",
"ResourceIdentifier": {
"ClusterName": "MyAppClusterName"
}
},
{
"ResourceType": "AWS::AutoScaling::AutoScalingGroup",
"ResourceIdentifier": {
"AutoScalingGroupName": "MyAppASGName"
}
}
]
```
Resultado:
```
{
"RelatedResources": [
{
"ResourceType": "AWS::EKS::Nodegroup",
"ResourceIdentifier": {
"NodegroupName": "MyAppNodegroupName"
},
"ManagedByStack": false
},
{
"ResourceType": "AWS::IAM::Role",
"ResourceIdentifier": {
"RoleId": "arn:aws::iam::123456789012:role/MyAppIAMRole"
},
"ManagedByStack": false
}
]
}
```
Para ter mais informações, consulte [Criar um modelo do CloudFormation a partir de recursos verificados com o gerador de IaC](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/iac-generator-create-template-from-scanned-resources.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [ListResourceScanRelatedResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-resource-scan-related-resources.html) na *Referência de comandos da AWS CLI*.
### `list-resource-scan-resources`
O código de exemplo a seguir mostra como usar `list-resource-scan-resources`.
**AWS CLI**
**Como listar recursos de uma verificação de recursos**
O exemplo de `list-resource-scan-resources` a seguir lista os recursos da verificação de recursos especificada, filtrados por identificador de recurso.
```
aws cloudformation list-resource-scan-resources \
--resource-scan-id arn:aws:cloudformation:us-east-1:123456789012:resourceScan/0a699f15-489c-43ca-a3ef-3e6ecfa5da60 \
--resource-identifier MyApp
```
Resultado:
```
{
"Resources": [
{
"ResourceType": "AWS::EKS::Cluster",
"ResourceIdentifier": {
"ClusterName": "MyAppClusterName"
},
"ManagedByStack": false
},
{
"ResourceType": "AWS::AutoScaling::AutoScalingGroup",
"ResourceIdentifier": {
"AutoScalingGroupName": "MyAppASGName"
},
"ManagedByStack": false
}
]
}
```
Para ter mais informações, consulte [Criar um modelo do CloudFormation a partir de recursos verificados com o gerador de IaC](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/iac-generator-create-template-from-scanned-resources.html) no *Guia do usuário do AWS CloudFormation*.
+ Consulte detalhes da API em [ListResourceScanResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-resource-scan-resources.html) na *Referência de comandos da AWS CLI*.
### `list-stack-instances`
O código de exemplo a seguir mostra como usar `list-stack-instances`.
**AWS CLI**
**Como listar instâncias para uma pilha**
O exemplo `list-stack-instances` a seguir lista as instâncias criadas a partir do conjunto de pilhas especificado.
```
aws cloudformation list-stack-instances \
--stack-set-name enable-config
```
O exemplo de saída inclui detalhes sobre uma pilha que falhou na atualização devido a um erro:
```
{
"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)."
}
]
}
```
+ Para ver detalhes da API, consulte [ListStackInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-stack-instances.html) na *Referência de comandos da AWS CLI*.
### `list-stack-refactor-actions`
O código de exemplo a seguir mostra como usar `list-stack-refactor-actions`.
**AWS CLI**
**Como listar ações para uma operação de refatoração de pilhas**
O exemplo de `list-stack-refactor-actions` a seguir lista ações para a operação de refatoração de pilhas com o ID de refatoração de pilhas especificado.
```
aws cloudformation list-stack-refactor-actions \
--stack-refactor-id 9c384f70-4e07-4ed7-a65d-fee5eb430841
```
Resultado:
```
{
"StackRefactorActions": [
{
"Action": "MOVE",
"Entity": "RESOURCE",
"PhysicalResourceId": "MyTestLambdaRole",
"Description": "No configuration changes detected.",
"Detection": "AUTO",
"TagResources": [],
"UntagResources": [],
"ResourceMapping": {
"Source": {
"StackName": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack1/3e6a1ff0-94b1-11f0-aa6f-0a88d2e03acf",
"LogicalResourceId": "MyLambdaRole"
},
"Destination": {
"StackName": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack2/5da91650-94b1-11f0-81cf-0a23500e151b",
"LogicalResourceId": "MyLambdaRole"
}
}
},
{
"Action": "MOVE",
"Entity": "RESOURCE",
"PhysicalResourceId": "MyTestFunction",
"Description": "Resource configuration changes will be validated during refactor execution.",
"Detection": "AUTO",
"TagResources": [
{
"Key": "aws:cloudformation:stack-name",
"Value": "Stack2"
},
{
"Key": "aws:cloudformation:logical-id",
"Value": "MyFunction"
},
{
"Key": "aws:cloudformation:stack-id",
"Value": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack2/5da91650-94b1-11f0-81cf-0a23500e151b"
}
],
"UntagResources": [
"aws:cloudformation:stack-name",
"aws:cloudformation:logical-id",
"aws:cloudformation:stack-id"
],
"ResourceMapping": {
"Source": {
"StackName": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack1/3e6a1ff0-94b1-11f0-aa6f-0a88d2e03acf",
"LogicalResourceId": "MyFunction"
},
"Destination": {
"StackName": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack2/5da91650-94b1-11f0-81cf-0a23500e151b",
"LogicalResourceId": "MyFunction"
}
}
}
]
}
```
Para ter mais informações, consulte [Refatoração de pilhas](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-refactoring.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [ListStackRefactorActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-stack-refactor-actions.html) na *Referência de comandos da AWS CLI*.
### `list-stack-resources`
O código de exemplo a seguir mostra como usar `list-stack-resources`.
**AWS CLI**
**Para listar os recursos de uma pilha**
O comando a seguir exibe a lista dos recursos da pilha especificada.
```
aws cloudformation list-stack-resources \
--stack-name my-stack
```
Resultado:
```
{
"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"
}
}
]
}
```
+ Consulte detalhes da API em [ListStackResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-stack-resources.html) na *AWS CLI Command Reference*.
### `list-stack-set-operation-results`
O código de exemplo a seguir mostra como usar `list-stack-set-operation-results`.
**AWS CLI**
**Para listar os resultados da operação do conjunto de pilhas**
O comando a seguir exibe os resultados de uma operação de atualização nas instâncias do conjunto de pilha especificado.
```
aws cloudformation list-stack-set-operation-results \
--stack-set-name enable-config \
--operation-id 35d45ebc-ed88-xmpl-ab59-0197a1fc83a0
```
Resultado:
```
{
"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"
}
]
}
```
**Observação:** o status `SKIPPED` de `AccountGateResult` é esperado para operações bem-sucedidas, a menos que você crie uma função de portão de conta.
+ Para ver detalhes da API, consulte [ListStackSetOperationResults](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-stack-set-operation-results.html) na *Referência de comandos da AWS CLI*.
### `list-stack-set-operations`
O código de exemplo a seguir mostra como usar `list-stack-set-operations`.
**AWS CLI**
**Para listar as operações do conjunto de pilhas**
O exemplo `list-stack-set-operations` a seguir exibe a lista das operações mais recentes no conjunto de pilhas especificado.
```
aws cloudformation list-stack-set-operations \
--stack-set-name my-stack-set
```
Resultado:
```
{
"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"
}
]
}
```
+ Para ver detalhes da API, consulte [ListStackSetOperations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-stack-set-operations.html) na *Referência de comandos da AWS CLI*.
### `list-stack-sets`
O código de exemplo a seguir mostra como usar `list-stack-sets`.
**AWS CLI**
**Para listar conjuntos de pilhas**
O exemplo `list-stack-sets` a seguir exibe a lista de conjuntos de pilhas na região e conta atuais.
```
aws cloudformation list-stack-sets
```
Resultado:
```
{
"Summaries": [
{
"StackSetName": "enable-config",
"StackSetId": "enable-config:296a3360-xmpl-40af-be78-9341e95bf743",
"Description": "Enable AWS Config",
"Status": "ACTIVE"
}
]
}
```
+ Para ver detalhes da API, consulte [ListStackSets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-stack-sets.html) na *Referência de comandos da AWS CLI*.
### `list-stacks`
O código de exemplo a seguir mostra como usar `list-stacks`.
**AWS CLI**
**Para listar as pilhas do AWS CloudFormation**
O comando `list-stacks` a seguir mostra um resumo de todas as pilhas que têm um status de `CREATE_COMPLETE`:
```
aws cloudformation list-stacks --stack-status-filter CREATE_COMPLETE
```
Resultado:
```
[
{
"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"
}
]
```
+ Consulte detalhes da API em [ListStacks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-stacks.html) na *AWS CLI Command Reference*.
### `list-type-registrations`
O código de exemplo a seguir mostra como usar `list-type-registrations`.
**AWS CLI**
**Para listar os registros concluídos de um tipo**
O exemplo `list-type-registrations` a seguir exibe uma lista dos registros de tipo concluídos para o tipo especificado.
```
aws cloudformation list-type-registrations \
--type RESOURCE \
--type-name My::Logs::LogGroup \
--registration-status-filter COMPLETE
```
Resultado:
```
{
"RegistrationTokenList": [
"a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"a1b2c3d4-5678-90ab-cdef-EXAMPLE33333"
]
}
```
Para obter mais informações, consulte [Usar o registro do CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [ListTypeRegistrations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-type-registrations.html) na *Referência de comandos da AWS CLI*.
### `list-type-versions`
O código de exemplo a seguir mostra como usar `list-type-versions`.
**AWS CLI**
**Para listar a versão de uma extensão**
O exemplo `list-type-versions` a seguir retorna informações de resumo sobre as versões de uma extensão.
```
aws cloudformation list-type-versions \
--endpoint https://example.com \
--region us-west-2 \
--type RESOURCE \
--type-name My::Resource::Example \
--publisher-id 123456789012
```
Este comando não produz saída.
Para obter mais informações, consulte [Usar o registro do AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [ListTypeVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-type-versions.html) na *Referência de comandos da AWS CLI*.
### `list-types`
O código de exemplo a seguir mostra como usar `list-types`.
**AWS CLI**
**Para listar os tipos de recursos privados em uma conta**
O exemplo `list-types` a seguir exibe uma lista dos tipos de recursos privados atualmente registrados na conta da AWS atual.
```
aws cloudformation list-types
```
Resultado:
```
{
"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"
}
]
}
```
Para obter mais informações, consulte [Usar o registro do CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [ListTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/list-types.html) na *Referência de comandos da AWS CLI*.
### `package`
O código de exemplo a seguir mostra como usar `package`.
**AWS CLI**
O comando a seguir exporta um modelo chamado `template.json` carregando artefatos locais para o bucket do S3 `bucket-name` e grava o modelo exportado em `packaged-template.json`:
```
aws cloudformation package --template-file /path_to_template/template.json --s3-bucket bucket-name --output-template-file packaged-template.json --use-json
```
+ Para ver detalhes da API, consulte [Package](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/package.html) na *Referência de comandos da AWS CLI*.
### `publish-type`
O código de exemplo a seguir mostra como usar `publish-type`.
**AWS CLI**
**Como publicar uma extensão**
O exemplo `publish-type` a seguir publica a extensão especificada no registro do CloudFormation como uma extensão pública nesta região.
```
aws cloudformation publish-type \
--region us-west-2 \
--type RESOURCE \
--type-name Example::Test::1234567890abcdef0
```
Resultado:
```
{
"PublicTypeArn":"arn:aws:cloudformation:us-west-2::type/resource/000q6TfUovXsEMmgKowxDZLlwqr2QUshd2e75c8c/Example-Test-1234567890abcdef0/1.0.0"
}
```
Para obter mais informações, consulte [Usar o registro do AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [PublishType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/publish-type.html) na *Referência de comandos da AWS CLI*.
### `register-publisher`
O código de exemplo a seguir mostra como usar `register-publisher`.
**AWS CLI**
**Para registrar um publicador**
O exemplo `register-publisher` a seguir registra um publicador e aceita o parâmetro de termos e condições.
```
aws cloudformation register-publisher \
--region us-west-2 \
--accept-terms-and-conditions
```
Resultado:
```
{
"PublisherId": "000q6TfUovXsEMmgKowxDZLlwqr2QUshd2e75c8c"
}
```
Para obter mais informações, consulte [Usar o registro do AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [RegisterPublisher](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/register-publisher.html) na *Referência de comandos da AWS CLI*.
### `register-type`
O código de exemplo a seguir mostra como usar `register-type`.
**AWS CLI**
**Para registrar um tipo de recurso**
O exemplo `register-type` a seguir registra o tipo de recurso especificado como um tipo de recurso privado na conta do usuário.
```
aws cloudformation register-type \
--type-name My::Organization::ResourceName \
--schema-handler-package s3://bucket_name/my-organization-resource_name.zip \
--type RESOURCE
```
Resultado:
```
{
"RegistrationToken": "f5525280-104e-4d35-bef5-8f1f1example"
}
```
Para obter mais informações, consulte [Registrar provedores de recursos](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-register.html) no *Guia do usuário da interface de linha de comando do CloudFormation para desenvolvimento de tipo*.
+ Para ver detalhes da API, consulte [RegisterType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/register-type.html) na *Referência de comandos da AWS CLI*.
### `set-stack-policy`
O código de exemplo a seguir mostra como usar `set-stack-policy`.
**AWS CLI**
**Como aplicar uma política de pilha**
O exemplo `set-stack-policy` a seguir desabilita as atualizações do recurso especificado na pilha especificada. `stack-policy.json` é um documento JSON que define quais operações são permitidas nos recursos da pilha.
```
aws cloudformation set-stack-policy \
--stack-name my-stack \
--stack-policy-body file://stack-policy.json
```
Resultado:
```
{
"Statement" : [
{
"Effect" : "Allow",
"Action" : "Update:*",
"Principal": "*",
"Resource" : "*"
},
{
"Effect" : "Deny",
"Action" : "Update:*",
"Principal": "*",
"Resource" : "LogicalResourceId/bucket"
}
]
}
```
+ Para ver detalhes da API, consulte [SetStackPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/set-stack-policy.html) na *Referência de comandos da AWS CLI*.
### `set-type-configuration`
O código de exemplo a seguir mostra como usar `set-type-configuration`.
**AWS CLI**
**Como configurar dados**
O exemplo `set-type-configuration` a seguir especifica os dados de configuração para uma extensão do CloudFormation registrada, na conta e na região especificadas.
```
aws cloudformation set-type-configuration \
--region us-west-2 \
--type RESOURCE \
--type-name Example::Test::Type \
--configuration-alias default \
--configuration "{\"CredentialKey\": \"testUserCredential\"}"
```
Resultado:
```
{
"ConfigurationArn": "arn:aws:cloudformation:us-west-2:123456789012:type-configuration/resource/Example-Test-Type/default"
}
```
Para obter mais informações, consulte [Usar o registro do AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [SetTypeConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/set-type-configuration.html) na *Referência de comandos da AWS CLI*.
### `set-type-default-version`
O código de exemplo a seguir mostra como usar `set-type-default-version`.
**AWS CLI**
**Como definir uma versão padrão do tipo**
O exemplo `set-type-default-version` a seguir define a versão do tipo especificado a ser usada como padrão para esse tipo.
```
aws cloudformation set-type-default-version \
--type RESOURCE \
--type-name My::Logs::LogGroup \
--version-id 00000003
```
Este comando não produz saída.
Para obter mais informações, consulte [Usar o registro do CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [SetTypeDefaultVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/set-type-default-version.html) na *Referência de comandos da AWS CLI*.
### `signal-resource`
O código de exemplo a seguir mostra como usar `signal-resource`.
**AWS CLI**
**Como sinalizar um recurso**
O exemplo `signal-resource` a seguir indica `success` para o cumprimento da condição de espera chamada `MyWaitCondition` na pilha chamada `my-stack`.
```
aws cloudformation signal-resource \
--stack-name my-stack \
--logical-resource-id MyWaitCondition \
--unique-id 1234 \
--status SUCCESS
```
Este comando não produz saída.
+ Para ver detalhes da API, consulte [SignalResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/signal-resource.html) na *Referência de comandos da AWS CLI*.
### `start-resource-scan`
O código de exemplo a seguir mostra como usar `start-resource-scan`.
**AWS CLI**
**Como iniciar uma verificação de recursos**
O exemplo de `start-resource-scan` a seguir inicia uma verificação de recursos que examina todos os recursos existentes na conta e região atuais.
```
aws cloudformation start-resource-scan
```
Resultado:
```
{
"ResourceScanId":
"arn:aws:cloudformation:us-east-1:123456789012:resourceScan/0a699f15-489c-43ca-a3ef-3e6ecfa5da60"
}
```
Para mais informações, consulte [Iniciar uma verificação de recursos com o gerador de IaC do CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/iac-generator-start-resource-scan.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [StartResourceScan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/start-resource-scan.html) na *Referência de comandos da AWS CLI*.
### `stop-stack-set-operation`
O código de exemplo a seguir mostra como usar `stop-stack-set-operation`.
**AWS CLI**
**Como interromper uma operação de conjunto de pilhas**
O exemplo `stop-stack-set-operation` a seguir interrompe uma operação de atualização em andamento no conjunto de pilhas especificado.
```
aws cloudformation stop-stack-set-operation \
--stack-set-name my-stack-set \
--operation-id 1261cd27-490b-xmpl-ab42-793a896c69e6
```
Este comando não produz saída.
+ Para obter detalhes a API, consulte [StopStackSetOperation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/stop-stack-set-operation.html) na *Referência de comandos da AWS CLI*.
### `test-type`
O código de exemplo a seguir mostra como usar `test-type`.
**AWS CLI**
**Para testar uma extensão**
O exemplo `test-type` a seguir testa uma extensão registrada para garantir que ela atenda a todos os requisitos necessários para ser publicada no registro do CloudFormation.
```
aws cloudformation test-type \
--arn arn:aws:cloudformation:us-west-2:123456789012:type/resource/Sample-Test-Resource123/00000001
```
Resultado:
```
{
"TypeVersionArn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/Sample-Test-Resource123/00000001"
}
```
Para obter mais informações, consulte [Usar o registro do AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/registry.html) no *Guia do usuário do AWS CloudFormation*.
+ Para ver detalhes da API, consulte [TestType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/test-type.html) na *Referência de comandos da AWS CLI*.
### `update-stack-instances`
O código de exemplo a seguir mostra como usar `update-stack-instances`.
**AWS CLI**
**Para atualizar instâncias de pilha**
O exemplo `update-stack-instances` a seguir repete uma atualização nas instâncias de pilha em duas contas em duas regiões com as configurações mais recentes. A configuração de tolerância a falhas especificada garante que a atualização seja tentada em todas as contas e regiões, mesmo que algumas pilhas não possam ser atualizadas.
```
aws cloudformation update-stack-instances \
--stack-set-name my-stack-set \
--accounts 123456789012 567890123456 \
--regions us-east-1 us-west-2 \
--operation-preferences FailureToleranceCount=3
```
Resultado:
```
{
"OperationId": "103ebdf2-21ea-xmpl-8892-de5e30733132"
}
```
+ Para ver detalhes da API, consulte [UpdateStackInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/update-stack-instances.html) na *Referência de comandos da AWS CLI*.
### `update-stack-set`
O código de exemplo a seguir mostra como usar `update-stack-set`.
**AWS CLI**
**Para atualizar um conjunto de pilhas**
O exemplo `update-stack-set` a seguir adiciona uma tag com o nome de chave `Owner` e um valor de `IT` às instâncias de pilha no conjunto de pilhas especificado.
```
aws cloudformation update-stack-set \
--stack-set-name my-stack-set \
--use-previous-template \
--tags Key=Owner,Value=IT
```
Resultado:
```
{
"OperationId": "e2b60321-6cab-xmpl-bde7-530c6f47950e"
}
```
+ Para ver detalhes da API, consulte [UpdateStackSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/update-stack-set.html) na *Referência de comandos da AWS CLI*.
### `update-stack`
O código de exemplo a seguir mostra como usar `update-stack`.
**AWS CLI**
**Para atualizar as pilhas do AWS CloudFormation**
O comando `update-stack` a seguir atualiza o modelo e os parâmetros de entrada para a pilha `mystack`:
```
aws cloudformation update-stack --stack-name mystack --template-url https://s3.amazonaws.com/sample/updated.template --parameters ParameterKey=KeyPairName,ParameterValue=SampleKeyPair ParameterKey=SubnetIDs,ParameterValue=SampleSubnetID1\\,SampleSubnetID2
```
O comando `update-stack` a seguir atualiza apenas o valor do parâmetro `SubnetIDs` da pilha `mystack`. Se você não especificar um valor para o parâmetro, o valor padrão especificado no modelo será usado:
```
aws cloudformation update-stack --stack-name mystack --template-url https://s3.amazonaws.com/sample/updated.template --parameters ParameterKey=KeyPairName,UsePreviousValue=true ParameterKey=SubnetIDs,ParameterValue=SampleSubnetID1\\,UpdatedSampleSubnetID2
```
O comando `update-stack` a seguir adiciona à pilha `mystack` dois tópicos de notificação de pilha:
```
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"
```
Para obter mais informações, consulte [Atualizações de pilhas do AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks.html) no *Guia do usuário do AWS CloudFormation*.
+ Consulte detalhes da API em [UpdateStack](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/update-stack.html) na *AWS CLI Command Reference*.
### `update-termination-protection`
O código de exemplo a seguir mostra como usar `update-termination-protection`.
**AWS CLI**
**Para habilitar a proteção contra encerramento**
O exemplo `update-termination-protection` a seguir ativa a proteção contra encerramento na pilha especificada.
```
aws cloudformation update-termination-protection \
--stack-name my-stack \
--enable-termination-protection
```
Resultado:
```
{
"StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204"
}
```
+ Para ver detalhes da API, consulte [UpdateTerminationProtection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/update-termination-protection.html) na *Referência de comandos da AWS CLI*.
### `validate-template`
O código de exemplo a seguir mostra como usar `validate-template`.
**AWS CLI**
**Para validar um modelo do AWS CloudFormation**
O comando `validate-template` a seguir valida o modelo `sampletemplate.json`:
```
aws cloudformation validate-template --template-body file://sampletemplate.json
```
Resultado:
```
{
"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": []
}
```
Para obter mais informações, consulte Trabalhar com modelos do AWS CloudFormation no *Guia do usuário do AWS CloudFormation*.
+ Consulte detalhes da API em [ValidateTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudformation/validate-template.html) na *AWS CLI Command Reference*.