Ini adalah *Panduan Referensi CloudFormation Template* baru. Harap perbarui bookmark dan tautan Anda. Untuk bantuan memulai CloudFormation, lihat [Panduan AWS CloudFormation Pengguna](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

Topik ini menjelaskan cara menggunakan `AWS::ServiceCatalog` transformasi untuk referensi output dari produk yang AWS Service Catalog disediakan yang ada di template Anda. CloudFormation

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

Untuk menggunakan `AWS::ServiceCatalog` transformasi, Anda harus mendeklarasikannya di tingkat atas template Anda CloudFormation . Anda tidak dapat menggunakan `AWS::ServiceCatalog` sebagai perubahan yang tertanam di bagian templat lainnya.

Saat nilai output diperlukan, Anda memberikan nama produk tersedia dan nama kunci output.

Anda dapat mereferensikan beberapa produk tersedia dan nama kunci di templat Anda, maksimum 20 per templat. Selama penyediaan, perubahan mengambil nilai dari setiap produk tersedia dan kunci yang direferensikan, menggantikan nilai output di templat CloudFormation Anda.

Deklarasi harus menggunakan string literal `AWS::ServiceCatalog` sebagai nilainya. Anda tidak dapat menggunakan parameter atau fungsi untuk menentukan nilai perubahan.

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

Untuk mendeklarasikan transformasi ini di CloudFormation template Anda, gunakan sintaks berikut:

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

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

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

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

`AWS::ServiceCatalog`Transformasi adalah deklarasi mandiri tanpa parameter tambahan.

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

Contoh berikut menunjukkan bagaimana Anda dapat mereferensikan output dari produk yang disediakan Service Catalog yang ada dalam template. CloudFormation 

Dalam contoh ini, `SampleProvisionedProduct` adalah produk tersedia yang telah dibuat sebelumnya. `SampleOutputKey` adalah kunci output dari produk tersedia ini.

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

Contoh ini adalah versi yang berfungsi.

Versi templat yang tidak mengemas nilai sebagai literal string akan gagal.

```
{
  "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>

Contoh 1-4 adalah template yang valid. Di Contoh 1 dan 2, perubahan dan nilai berupa literal string.

Contoh 5 bukan merupakan templat yang valid. Nilai harus dikemas di string `'` atau `"` atau `>-`. Jika tidak, pengguna menerima kesalahan.

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