Utilisation de CreateStack avec une CLI

Les exemples de code suivants illustrent comment utiliser CreateStack.

CLI

AWS CLI

Pour créer une pile AWS CloudFormation

La commande create-stacks suivante crée une pile portant le nom myteststack à l’aide du modèle sampletemplate.json :

aws cloudformation create-stack --stack-name myteststack --template-body file://sampletemplate.json --parameters ParameterKey=KeyPairName,ParameterValue=TestKey ParameterKey=SubnetIDs,ParameterValue=SubnetID1\\,SubnetID2

Sortie :

{
    "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896"
}

Pour plus d’informations, consultez Piles dans le Guide de l’utilisateur AWS CloudFormation.

• Pour plus de détails sur l’API, consultez CreateStack dans la Référence des commandes de l’AWS CLI.

PowerShell

Outils pour PowerShell V4

Exemple 1 : crée une nouvelle pile avec le nom spécifié. Le modèle est analysé à partir du contenu fourni avec des paramètres de personnalisation (« PK1 » et « PK2 » représentent les noms des paramètres déclarés dans le contenu du modèle, « PV1 » et « PV2 » représentent les valeurs de ces paramètres. Les paramètres de personnalisation peuvent également être spécifiés en utilisant « Key » et « Value » au lieu de « ParameterKey » et « ParameterValue ». Si la création de la pile échoue, elle ne sera pas annulée.

New-CFNStack -StackName "myStack" `
             -TemplateBody "{TEMPLATE CONTENT HERE}" `
             -Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" }) `
             -DisableRollback $true

Exemple 2 : crée une nouvelle pile avec le nom spécifié. Le modèle est analysé à partir du contenu fourni avec des paramètres de personnalisation (« PK1 » et « PK2 » représentent les noms des paramètres déclarés dans le contenu du modèle, « PV1 » et « PV2 » représentent les valeurs de ces paramètres. Les paramètres de personnalisation peuvent également être spécifiés en utilisant « Key » et « Value » au lieu de « ParameterKey » et « ParameterValue ». Si la création de la pile échoue, elle sera annulée.

$p1 = New-Object -Type Amazon.CloudFormation.Model.Parameter
$p1.ParameterKey = "PK1"
$p1.ParameterValue = "PV1"

$p2 = New-Object -Type Amazon.CloudFormation.Model.Parameter
$p2.ParameterKey = "PK2"
$p2.ParameterValue = "PV2"

New-CFNStack -StackName "myStack" `
             -TemplateBody "{TEMPLATE CONTENT HERE}" `
             -Parameter @( $p1, $p2 ) `
             -OnFailure "ROLLBACK"

Exemple 3 : crée une nouvelle pile avec le nom spécifié. Le modèle est obtenu à partir de l’URL Amazon S3 avec des paramètres de personnalisation (« PK1 » représente le nom d’un paramètre déclaré dans le contenu du modèle, « PV1 » représente la valeur du paramètre). Les paramètres de personnalisation peuvent également être spécifiés en utilisant « Key » et « Value » au lieu de « ParameterKey » et « ParameterValue ». Si la création de la pile échoue, elle sera annulée (comme si vous spécifiez -DisableRollback $false).

New-CFNStack -StackName "myStack" `
             -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template `
             -Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" }

Exemple 4 : crée une nouvelle pile avec le nom spécifié. Le modèle est obtenu à partir de l’URL Amazon S3 avec des paramètres de personnalisation (« PK1 » représente le nom d’un paramètre déclaré dans le contenu du modèle, « PV1 » représente la valeur du paramètre). Les paramètres de personnalisation peuvent également être spécifiés en utilisant « Key » et « Value » au lieu de « ParameterKey » et « ParameterValue ». Si la création de la pile échoue, elle sera annulée (comme si vous spécifiez -DisableRollback $false). Les AEN de notification spécifiés recevront les événements publiés liés à la pile.

New-CFNStack -StackName "myStack" `
             -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template `
             -Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" } `
             -NotificationARN @( "arn1", "arn2" )

• Pour plus de détails sur l’API, consultez CreateStack dans la Référence des cmdlets d’Outils AWS pour PowerShell (V4).

Outils pour PowerShell V5

Exemple 1 : crée une nouvelle pile avec le nom spécifié. Le modèle est analysé à partir du contenu fourni avec des paramètres de personnalisation (« PK1 » et « PK2 » représentent les noms des paramètres déclarés dans le contenu du modèle, « PV1 » et « PV2 » représentent les valeurs de ces paramètres. Les paramètres de personnalisation peuvent également être spécifiés en utilisant « Key » et « Value » au lieu de « ParameterKey » et « ParameterValue ». Si la création de la pile échoue, elle ne sera pas annulée.

New-CFNStack -StackName "myStack" `
             -TemplateBody "{TEMPLATE CONTENT HERE}" `
             -Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" }) `
             -DisableRollback $true

Exemple 2 : crée une nouvelle pile avec le nom spécifié. Le modèle est analysé à partir du contenu fourni avec des paramètres de personnalisation (« PK1 » et « PK2 » représentent les noms des paramètres déclarés dans le contenu du modèle, « PV1 » et « PV2 » représentent les valeurs de ces paramètres. Les paramètres de personnalisation peuvent également être spécifiés en utilisant « Key » et « Value » au lieu de « ParameterKey » et « ParameterValue ». Si la création de la pile échoue, elle sera annulée.

$p1 = New-Object -Type Amazon.CloudFormation.Model.Parameter
$p1.ParameterKey = "PK1"
$p1.ParameterValue = "PV1"

$p2 = New-Object -Type Amazon.CloudFormation.Model.Parameter
$p2.ParameterKey = "PK2"
$p2.ParameterValue = "PV2"

New-CFNStack -StackName "myStack" `
             -TemplateBody "{TEMPLATE CONTENT HERE}" `
             -Parameter @( $p1, $p2 ) `
             -OnFailure "ROLLBACK"

Exemple 3 : crée une nouvelle pile avec le nom spécifié. Le modèle est obtenu à partir de l’URL Amazon S3 avec des paramètres de personnalisation (« PK1 » représente le nom d’un paramètre déclaré dans le contenu du modèle, « PV1 » représente la valeur du paramètre). Les paramètres de personnalisation peuvent également être spécifiés en utilisant « Key » et « Value » au lieu de « ParameterKey » et « ParameterValue ». Si la création de la pile échoue, elle sera annulée (comme si vous spécifiez -DisableRollback $false).

New-CFNStack -StackName "myStack" `
             -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template `
             -Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" }

Exemple 4 : crée une nouvelle pile avec le nom spécifié. Le modèle est obtenu à partir de l’URL Amazon S3 avec des paramètres de personnalisation (« PK1 » représente le nom d’un paramètre déclaré dans le contenu du modèle, « PV1 » représente la valeur du paramètre). Les paramètres de personnalisation peuvent également être spécifiés en utilisant « Key » et « Value » au lieu de « ParameterKey » et « ParameterValue ». Si la création de la pile échoue, elle sera annulée (comme si vous spécifiez -DisableRollback $false). Les AEN de notification spécifiés recevront les événements publiés liés à la pile.

New-CFNStack -StackName "myStack" `
             -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template `
             -Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" } `
             -NotificationARN @( "arn1", "arn2" )

• Pour plus de détails sur l’API, consultez CreateStack dans la Référence des cmdlets d’Outils AWS pour PowerShell (V5).