Questa è la nuova *Guida di riferimento ai modelli CloudFormation *. Aggiorna i segnalibri e i link. Per informazioni su come iniziare CloudFormation, consulta la [Guida AWS CloudFormation per l'utente](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Trasformazione `AWS::ServiceCatalog`
<a name="transform-aws-servicecatalog"></a>

Questo argomento descrive come utilizzare la `AWS::ServiceCatalog` trasformazione per fare riferimento agli output di un prodotto AWS Service Catalog predisposto esistente nel modello. CloudFormation

## Utilizzo
<a name="aws-servicecatalog-usage"></a>

Per utilizzare la `AWS::ServiceCatalog` trasformazione, è necessario dichiararla al livello più alto del modello. CloudFormation Non è possibile utilizzare `AWS::ServiceCatalog` come trasformazione incorporata in qualsiasi altra sezione 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 con provisioning di riferimento, sostituendo il valore di output nel modello CloudFormation .

La dichiarazione deve utilizzare la stringa letterale `AWS::ServiceCatalog` come valore. Non è possibile utilizzare un parametro o una funzione per specificare un valore di trasformazione.

### Sintassi
<a name="aws-servicecatalog-syntax"></a>

Per dichiarare questa trasformazione nel CloudFormation modello, utilizzate la seguente sintassi:

#### JSON
<a name="aws-servicecatalog-syntax.json"></a>

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

#### YAML
<a name="aws-servicecatalog-syntax.yaml"></a>

```
Transform: AWS::ServiceCatalog
Resources:
  ...
```

La trasformazione `AWS::ServiceCatalog` è una dichiarazione autonoma senza parametri aggiuntivi.

## Esempi
<a name="aws-servicecatalog-examples"></a>

Gli esempi seguenti mostrano come è possibile fare riferimento agli output di un prodotto esistente fornito da Service Catalog in un CloudFormation modello.

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

### JSON
<a name="aws-servicecatalog-example.json.json"></a>

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
<a name="aws-servicecatalog-example.yaml"></a>

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