Trasformazione AWS::ServiceCatalog

La AWS::ServiceCatalog trasformazione consente agli utenti di Service Catalog di fare riferimento agli output di un prodotto fornito da Service Catalog esistente nel proprio CloudFormation modello.

Per fare riferimento a un output di un prodotto con provisioning esistente, è necessario includere la trasformazione AWS::ServiceCatalog nella parte superiore del modello. Se è necessario un valore di output, occorre specificare il nome del prodotto sottoposto a provisioning e il nome della chiave di output.

È possibile fare riferimento a più prodotti con provisioning e nomi chiave nel modello, un massimo di 20 per modello. Durante il provisioning, la trasformazione recupera il valore da ogni prodotto e chiave forniti di riferimento, sostituendo il valore di output nel modello. CloudFormation

Utilizzo

Utilizzare la trasformazione AWS::ServiceCatalog al livello superiore del modello. Non è possibile utilizzare AWS::ServiceCatalog come trasformazione incorporata in qualsiasi altra sezione del modello.

Il valore della dichiarazione della trasformazione deve essere una stringa letterale. Non è possibile utilizzare un parametro o una funzione per specificare un valore di trasformazione.

Sintassi al livello superiore di un modello

Per includere la trasformazione AWS::ServiceCatalog al livello superiore di un modello, nella sezione Trasformazione, utilizza la sintassi riportata di seguito.

JSON

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

YAML

Transform: AWS::ServiceCatalog

Parametri

La trasformazione AWS::ServiceCatalog non accetta alcun parametro.

Esempio

Gli esempi JSON e YAML riportati di seguito mostrano come un utente può fare riferimento agli output di un prodotto esistente fornito da Service Catalog in un modello. CloudFormation

In questi esempi, SampleProvisionedProduct è un prodotto precedentemente creato con provisioning. SampleOutputKey è una chiave di output di questo prodotto sottoposto a provisioning.

JSON

Questo esempio è una versione funzionante.

Le versioni del modello che non integrano il valore come stringa letterale avranno esito negativo.

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

YAML

Gli esempi 1–4 sono modelli validi. Negli esempi 1 e 2, la trasformazione e il valore sono stringhe letterali.

L'esempio 5 non è un modello valido. Il valore deve essere integrato in una stringa ' o " o >-. In caso contrario, l'utente riceve un errore.

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