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]]