

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

# CloudFormation Outputssintaks template
<a name="outputs-section-structure"></a>

`Outputs`Bagian opsional mendeklarasikan nilai output untuk tumpukan. Nilai output ini dapat digunakan dengan berbagai cara:
+ **Tangkap detail penting tentang sumber daya Anda** — Output adalah cara mudah untuk menangkap informasi penting tentang sumber daya Anda. Misalnya, Anda dapat menampilkan nama bucket S3 untuk tumpukan agar bucket lebih mudah ditemukan. Anda dapat melihat nilai output di tab **Output** CloudFormation konsol atau dengan menggunakan perintah [describe-stacks](service_code_examples.md#describe-stacks-sdk)CLI. 
+ **Referensi cross-stack** — Anda dapat mengimpor nilai output ke tumpukan lain untuk [membuat referensi antar](using-cfn-stack-exports.md) tumpukan. Ini sangat membantu ketika Anda perlu berbagi sumber daya atau konfigurasi di beberapa tumpukan.

**penting**  
CloudFormation tidak menyunting atau mengaburkan informasi apa pun yang Anda sertakan di bagian ini. `Outputs` Kami sangat merekomendasikan Anda untuk tidak menggunakan bagian ini untuk menampilkan informasi sensitif, seperti kata sandi atau rahasia.  
Nilai output tersedia setelah operasi tumpukan selesai. Nilai keluaran tumpukan tidak tersedia saat status tumpukan berada di salah satu `IN_PROGRESS` [status.](view-stack-events.md#cfn-console-view-stack-data-resources-status-codes) Kami tidak merekomendasikan membuat dependensi antara waktu aktif layanan dan nilai output tumpukan karena nilai output mungkin tidak tersedia setiap saat.

## Sintaksis
<a name="outputs-section-syntax"></a>

Bagian `Outputs` terdiri dari nama kunci `Outputs`. Anda dapat mendeklarasikan maksimum 200 output dalam sebuah templat.

Contoh berikut menunjukkan struktur bagian `Outputs`.

### JSON
<a name="outputs-section-structure-syntax.json"></a>

Gunakan tanda kurung untuk menutup seluruh deklarasi output. Membatasi beberapa output dengan koma.

```
"Outputs" : {
  "OutputLogicalID" : {
    "Description" : "Information about the value",
    "Value" : "Value to return",
    "Export" : {
      "Name" : "Name of resource to export"
    }
  }
}
```

### YAML
<a name="outputs-section-structure-syntax.yaml"></a>

```
Outputs:
  OutputLogicalID:
    Description: Information about the value
    Value: Value to return
    Export:
      Name: Name of resource to export
```

### Bidang output
<a name="outputs-section-structure-output-fields"></a>

Bagian `Outputs` dapat mencakup bidang berikut.

**Logical ID (juga disebut *nama logis*)**  
Sebuah pengidentifikasi untuk output saat ini. ID logis harus berupa alfanumerik (`a–z`, `A–Z`, `0–9`) dan unik dalam templat.

**`Description` (opsional)**  
Jenis `String` yang menjelaskan nilai output. Nilai untuk deklarasi deskripsi harus berupa string literal yang panjangnya antara 0 dan 1024 byte. Anda tidak dapat menggunakan parameter atau fungsi untuk menentukan deskripsi. 

**`Value`(Diperlukan)**  
Nilai properti yang dikembalikan oleh perintah [describe-stacks](service_code_examples.md#describe-stacks-sdk). Nilai output dapat mencakup literal, referensi parameter, parameter semu, nilai pemetaan, atau fungsi intrinsik.

**`Export` (opsional)**  
Nama output sumber daya yang akan diekspor untuk Referensi lintas tumpukan.  
Anda dapat menggunakan fungsi intrinsik untuk menyesuaikan nilai `Name` ekspor.  
Untuk informasi selengkapnya, lihat [Dapatkan output yang diekspor dari tumpukan yang diterapkan CloudFormation](using-cfn-stack-exports.md).

Untuk mengasosiasikan syarat dengan output, tentukan syarat di bagian [Conditions](conditions-section-structure.md) dari templat.

## Contoh
<a name="outputs-section-structure-examples"></a>

Contoh berikut menggambarkan cara kerja output tumpukan.

**Topics**
+ [Output tumpukan](#outputs-section-structure-examples-stack-output)
+ [Sesuaikan nama ekspor menggunakan `Fn::Sub`](#outputs-section-structure-examples-cross-stack)
+ [Sesuaikan nama ekspor menggunakan `Fn::Join`](#outputs-section-structure-examples-join-export-name)
+ [Kembalikan URL yang dibuat menggunakan `Fn::Join`](#outputs-section-structure-examples-join-export-url)

### Output tumpukan
<a name="outputs-section-structure-examples-stack-output"></a>

Dalam contoh berikut, output bernama `BackupLoadBalancerDNSName` mengembalikan nama DNS untuk sumber daya dengan ID logis `BackupLoadBalancer` hanya ketika kondisi `CreateProdResources` benar. Output bernama `InstanceID` mengembalikan ID dari contoh EC2 dengan ID `EC2Instance` logis.

#### JSON
<a name="outputs-section-structure-example.json"></a>

```
"Outputs" : {
  "BackupLoadBalancerDNSName" : {
    "Description": "The DNSName of the backup load balancer",  
    "Value" : { "Fn::GetAtt" : [ "BackupLoadBalancer", "DNSName" ]},
    "Condition" : "CreateProdResources"
  },
  "InstanceID" : {
    "Description": "The Instance ID",  
    "Value" : { "Ref" : "EC2Instance" }
  }
}
```

#### YAML
<a name="outputs-section-structure-example.yaml"></a>

```
Outputs:
  BackupLoadBalancerDNSName:
    Description: The DNSName of the backup load balancer
    Value: !GetAtt BackupLoadBalancer.DNSName
    Condition: CreateProdResources
  InstanceID:
    Description: The Instance ID
    Value: !Ref EC2Instance
```

### Sesuaikan nama ekspor menggunakan `Fn::Sub`
<a name="outputs-section-structure-examples-cross-stack"></a>

Dalam contoh berikut, output bernama `StackVPC` mengembalikan ID dari VPC, dan kemudian mengekspor nilai untuk referensi lintas tumpukan dengan nama `VPCID` ditambahkan ke nama tumpukan.

#### JSON
<a name="outputs-section-structure-cross-stack-example.json"></a>

```
"Outputs" : {
  "StackVPC" : {
    "Description" : "The ID of the VPC",
    "Value" : { "Ref" : "MyVPC" },
    "Export" : {
      "Name" : {"Fn::Sub": "${AWS::StackName}-VPCID" }
    }
  }
}
```

#### YAML
<a name="outputs-section-structure-cross-stack-example.yaml"></a>

```
Outputs:
  StackVPC:
    Description: The ID of the VPC
    Value: !Ref MyVPC
    Export:
      Name: !Sub "${AWS::StackName}-VPCID"
```

Untuk informasi selengkapnya tentang fungsi `Fn::Sub`, lihat [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-sub.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-sub.html).

### Sesuaikan nama ekspor menggunakan `Fn::Join`
<a name="outputs-section-structure-examples-join-export-name"></a>

Anda juga dapat menggunakan `Fn::Join` fungsi untuk membangun nilai berdasarkan parameter, atribut sumber daya, dan string lainnya.

Contoh berikut menggunakan `Fn::Join` fungsi untuk menyesuaikan nama ekspor alih-alih `Fn::Sub` fungsi. `Fn::Join`Fungsi contoh menggabungkan nama tumpukan dengan nama `VPCID` menggunakan titik dua sebagai pemisah.

#### JSON
<a name="outputs-section-structure-join-export-name-example.json"></a>

```
"Outputs" : {
  "StackVPC" : {
    "Description" : "The ID of the VPC",
    "Value" : { "Ref" : "MyVPC" },
    "Export" : {
      "Name" : { "Fn::Join" : [ ":", [ { "Ref" : "AWS::StackName" }, "VPCID" ] ] }
    }
  }
}
```

#### YAML
<a name="outputs-section-structure-join-export-name-example.yaml"></a>

```
Outputs:
  StackVPC:
    Description: The ID of the VPC
    Value: !Ref MyVPC
    Export:
      Name: !Join [ ":", [ !Ref "AWS::StackName", VPCID ] ]
```

Untuk informasi selengkapnya tentang fungsi `Fn::Join`, lihat [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-join.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-join.html).

### Kembalikan URL yang dibuat menggunakan `Fn::Join`
<a name="outputs-section-structure-examples-join-export-url"></a>

Dalam contoh berikut untuk template yang membuat WordPress situs, `InstallURL` adalah string yang dikembalikan oleh panggilan `Fn::Join` fungsi yang menggabungkan`http://`, nama DNS sumber daya, dan. `ElasticLoadBalancer` `/wp-admin/install.php` Nilai output akan serupa dengan berikut ini:

```
http://mywptests-elasticl-1gb51l6sl8y5v-206169572.aws-region.elb.amazonaws.com/wp-admin/install.php
```

#### JSON
<a name="outputs-section-structure-examples-join-export-url.json"></a>

```
{
    "Outputs": {
        "InstallURL": {
            "Value": {
                "Fn::Join": [
                    "",
                    [
                        "http://",
                        {
                            "Fn::GetAtt": [
                                "ElasticLoadBalancer",
                                "DNSName"
                            ]
                        },
                        "/wp-admin/install.php"
                    ]
                ]
            },
            "Description": "Installation URL of the WordPress website"
        }
    }
}
```

#### YAML
<a name="outputs-section-structure-examples-join-export-url.yaml"></a>

```
Outputs:
  InstallURL:
    Value: !Join 
      - ''
      - - 'http://'
        - !GetAtt 
          - ElasticLoadBalancer
          - DNSName
        - /wp-admin/install.php
    Description: Installation URL of the WordPress website
```

Untuk informasi selengkapnya tentang fungsi `Fn::Join`, lihat [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-join.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-join.html).