À utiliser DescribeStacks avec un AWS SDK ou CLI

Les exemples de code suivants montrent comment utiliserDescribeStacks.

CLI

AWS CLI

Pour décrire les AWS CloudFormation piles

La describe-stacks commande suivante affiche des informations récapitulatives pour la myteststack pile :

aws cloudformation describe-stacks --stack-name myteststack

Sortie :

{
    "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
        }
    ]
}

Pour plus d'informations, consultez Stacks dans le guide de l'AWS CloudFormation utilisateur.

• Pour API plus de détails, voir DescribeStacksla section Référence des AWS CLI commandes.

Go

SDKpour Go V2

Note

Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le référentiel d’exemples de code AWS.

// StackOutputs defines a map of outputs from a specific stack.
type StackOutputs map[string]string

type CloudFormationActions struct {
	CfnClient *cloudformation.Client
}

// GetOutputs gets the outputs from a CloudFormation stack and puts them into a structured format.
func (actor CloudFormationActions) GetOutputs(stackName string) StackOutputs {
	output, err := actor.CfnClient.DescribeStacks(context.TODO(), &cloudformation.DescribeStacksInput{
		StackName: aws.String(stackName),
	})
	if err != nil || len(output.Stacks) == 0 {
		log.Panicf("Couldn't find a CloudFormation stack named %v. Here's why: %v\n", stackName, err)
	}
	stackOutputs := StackOutputs{}
	for _, out := range output.Stacks[0].Outputs {
		stackOutputs[*out.OutputKey] = *out.OutputValue
	}
	return stackOutputs
}

• Pour API plus de détails, voir DescribeStacksla section AWS SDK for Go APIRéférence.

PowerShell

Outils pour PowerShell

Exemple 1 : renvoie une collection d'instances Stack décrivant toutes les piles de l'utilisateur.

Get-CFNStack

Exemple 2 : Renvoie une instance de Stack décrivant la pile spécifiée

Get-CFNStack -StackName "myStack"

Exemple 3 : renvoie une collection d'instances Stack décrivant toutes les piles de l'utilisateur à l'aide de la pagination manuelle. Le jeton de départ pour la page suivante est récupéré après chaque appel avec $null indiquant qu'il ne reste plus de détails à récupérer.

$nextToken = $null
do {
    Get-CFNStack -NextToken $nextToken
    $nextToken = $AWSHistory.LastServiceResponse.NextToken
} while ($nextToken -ne $null)

• Pour API plus de détails, consultez la section DescribeStacksRéférence des AWS Tools for PowerShell applets de commande.