Transformation AWS::ServiceCatalog

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

Utilisation

Pour utiliser la AWS::ServiceCatalog transformation, vous devez la déclarer au niveau supérieur de votre CloudFormation modèle. 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 CloudFormation modèle, utilisez la syntaxe suivante :

JSON

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

YAML

Transform: AWS::ServiceCatalog
Resources:
  ...

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

Exemples

Les exemples suivants montrent comment vous pouvez 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]]