AWS::ServiceCatalogTransformation - AWS CloudFormation
UtilisationExemples

Il s’agit du nouveau Guide de référence des modèles CloudFormation. Veuillez mettre à jour vos favoris et vos liens. Pour obtenir de l'aide pour démarrer CloudFormation, consultez le guide de AWS CloudFormation l'utilisateur.

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.

AWS::ServiceCatalogTransformation

Cette rubrique décrit comment utiliser la transformation AWS::ServiceCatalog pour référencer les sorties d’un produit provisionné existant du AWS Service Catalog dans votre modèle CloudFormation.

Utilisation

Pour utiliser la transformation AWS::ServiceCatalog, vous devez la déclarer au niveau supérieur de votre modèle CloudFormation. Vous ne pouvez pas utiliser AWS::ServiceCatalog comme transformation incorporée dans une autre section de 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 récupère la valeur de chaque clé et produit alloué référencé, en substituant la valeur de sortie dans votre modèle CloudFormation.

La déclaration doit utiliser la chaîne littérale AWS::ServiceCatalog comme valeur. Vous ne pouvez pas utiliser de paramètre ou de fonction pour spécifier la valeur de transformation.

Syntaxe

Pour déclarer cette transformation dans votre modèle CloudFormation, utilisez la syntaxe suivante :

JSON

{
  "Transform":"AWS::ServiceCatalog",
  "Resources":{
    ...
  }
}

YAML

Transform: AWS::ServiceCatalog
Resources:
  ...

La transformation AWS::ServiceCatalog est une déclaration autonome sans paramètres supplémentaires.

Exemples

Les exemples suivants montrent comment référencer les sorties d’un produit provisionné existant du catalogue de services dans un modèle CloudFormation.

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