Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Transformation AWS::ServiceCatalog
La AWS::ServiceCatalog
transformation permet aux utilisateurs de Service Catalog de référencer les sorties d'un produit fourni par Service Catalog existant dans leur CloudFormation modèle.
Pour référencer une sortie d'un produit alloué existant, vous devez inclure la transformation AWS::ServiceCatalog
en haut de votre modèle. Lorsqu'une valeur de sortie est requise, vous indiquez le nom du produit alloué et le nom de la clé de sortie.
Vous pouvez référencer plusieurs produits alloués et noms de clés dans votre modèle, avec un maximum de 20 par modèle. Pendant le provisionnement, la transformation extrait la valeur de chaque produit et clé provisionnés référencés, en remplaçant la valeur de sortie dans votre modèle. CloudFormation
Utilisation
Utilisez la transformation AWS::ServiceCatalog
en haut du modèle. Vous ne pouvez pas utiliser AWS::ServiceCatalog
comme transformation incorporée dans une autre section de modèle.
La valeur de la déclaration de transformation doit être une chaîne littérale. Vous ne pouvez pas utiliser de paramètre ou de fonction pour spécifier la valeur de transformation.
Syntaxe au niveau supérieur d'un modèle
Pour inclure AWS::ServiceCatalog
au niveau supérieur d'un modèle, dans la section Transformation, utilisez la syntaxe suivante :
JSON
{ "Transform": "AWS::ServiceCatalog", . . . }
YAML
Transform: AWS::ServiceCatalog
Paramètres
La transformation AWS::ServiceCatalog
n'accepte aucun paramètre.
Exemple
Les exemples JSON et YAML ci-dessous montrent comment un utilisateur peut référencer les sorties d'un produit existant fourni par Service Catalog dans un CloudFormation modèle.
Dans ces exemples, SampleProvisionedProduct
est un produit alloué précédemment créé. SampleOutputKey
est une clé de sortie de ce produit alloué.
JSON
Cet exemple est une version de travail.
Les versions du modèle qui n'enveloppent pas la valeur sous forme de littéral de chaîne échoueront.
{ "AWSTemplateFormatVersion": "2010-09-09", "Transform": "AWS::ServiceCatalog", "Resources": { "ExampleParameter": { "Type": "AWS::SSM::Parameter", "Properties": { "Type": "String", "Value": "[[servicecatalog:provisionedproduct:SampleProvisionedProduct:SampleOutputKey]]" } } } }
YAML
Les exemples 1–4 sont des modèles valides. Dans les exemples 1 et 2, la transformation et la valeur sont des littéraux de chaîne.
L'exemple 5 n'est pas un modèle valide. La valeur doit être enveloppée dans une chaîne '
, "
ou >-
. Si ce n'est pas le cas, l'utilisateur reçoit une erreur.
// Example 1 AWSTemplateFormatVersion: 2010-09-09 Transform: 'AWS::ServiceCatalog' Resources: ExampleParameter: Type: 'AWS::SSM::Parameter' Properties: Type: String Value: '[[servicecatalog:provisionedproduct:SampleProvisionedProduct:SampleOutputKey]]' // Example 2 AWSTemplateFormatVersion: 2010-09-09 Transform: 'AWS::ServiceCatalog' Resources: ExampleParameter: Type: 'AWS::SSM::Parameter' Properties: Type: String Value: '[[servicecatalog:provisionedproduct:SampleProvisionedProduct:SampleOutputKey]]' // Example 3 AWSTemplateFormatVersion: 2010-09-09 Transform: AWS::ServiceCatalog Resources: ExampleParameter: Type: 'AWS::SSM::Parameter' Properties: Type: String Value: "[[servicecatalog:provisionedproduct:SampleProvisionedProduct:SampleOutputKey]]" // Example 4 AWSTemplateFormatVersion: 2010-09-09 Transform: AWS::ServiceCatalog Resources: ExampleParameter: Type: 'AWS::SSM::Parameter' Properties: Type: String Value: >- [[servicecatalog:provisionedproduct:SampleProvisionedProduct:SampleOutputKey]] // Example 5 AWSTemplateFormatVersion: 2010-09-09 Transform: AWS::ServiceCatalog Resources: ExampleParameter2: Type: 'AWS::SSM::Parameter' Properties: Type: String Value: [[servicecatalog:provisionedproduct:SSMProductProvisionedProduct:SampleOutputKey]]