AWS::ServiceCatalog-Transformation

Die AWS::ServiceCatalog-Transformation ermöglicht es Service-Catalog-Benutzern, in ihrer CloudFormation-Vorlage auf Ausgaben eines vorhandenen bereitgestellten Service-Catalog-Produkts zu verweisen.

Um auf eine Ausgabe eines vorhandenen bereitgestellten Produkts zu verweisen, müssen Sie die AWS::ServiceCatalog-Transformation oben in Ihre Vorlage aufnehmen. Wenn ein Ausgabewert erforderlich ist, geben Sie den Namen des bereitgestellten Produkts und den Namen des Ausgabeschlüssels an.

Sie können in Ihrer Vorlage auf mehrere bereitgestellte Produkte und Schlüsselnamen verweisen, maximal 20 pro Vorlage. Während der Bereitstellung ruft die Transformation den Wert von jedem referenzierten bereitgestellten Produkt und Schlüssel ab und ersetzt den Ausgabewert in Ihrer CloudFormation-Vorlage.

Verwendung

Verwenden Sie die AWS::ServiceCatalog-Transformation auf der obersten Ebene der Vorlage. Sie können AWS::ServiceCatalog nicht als Transformation verwenden, die in einem anderen Vorlagenabschnitt eingebettet ist.

Der Wert der Transformationsdeklaration muss eine Literalzeichenfolge sein. Parameter oder Funktionen dürfen nicht zur Angabe eines Transformationswerts verwendet werden.

Syntax der obersten Ebene einer Vorlage

Um AWS::ServiceCatalogn auf der obersten Ebene einer Vorlage einzuschließen, verwenden Sie die folgende Syntax:

JSON

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

YAML

Transform: AWS::ServiceCatalog

Parameter

Die AWS::ServiceCatalog-Transformation akzeptiert keine Parameter.

Beispiel

Die folgenden JSON- und YAML-Beispiele zeigen, wie ein Benutzer in einer CloudFormation-Vorlage auf Ausgaben eines vorhandenen von Service Catalog bereitgestellten Produkts verweisen kann.

In diesen Beispielen ist SampleProvisionedProduct ein zuvor erstelltes Produkt. SampleOutputKey ist ein Ausgabeschlüssel dieses bereitgestellten Produkts.

JSON

Dieses Beispiel ist eine Arbeitsversion.

Vorlagenversionen, die den Wert nicht als String-Literal umschließen, schlagen fehl.

    {
        "AWSTemplateFormatVersion": "2010-09-09",
        "Transform": "AWS::ServiceCatalog",
        "Resources": {
            "ExampleParameter": {
                "Type": "AWS::SSM::Parameter",
                "Properties": {
                    "Type": "String",
                    "Value": "[[servicecatalog:provisionedproduct:SampleProvisionedProduct:SampleOutputKey]]"
                }
            }
        }
    }    

YAML

Beispiele 1–4 sind gültige Vorlagen. In den Beispielen 1 und 2 sind Transformation und Wert String-Literale.

Beispiel 5 ist keine gültige Vorlage. Der Wert muss in einer Zeichenfolge ' oder " oder >- umschlossen sein. Wenn nicht, erhält der Benutzer eine Fehlermeldung.

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