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

# AWS::Serverless::Application
<a name="sam-resource-application"></a>

Menyematkan aplikasi nirserver dari [AWS Serverless Application Repository](https://serverlessrepo.aws.amazon.com/applications) atau dari bucket Amazon S3 sebagai aplikasi yang di-nest. Aplikasi bersarang digunakan sebagai [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stack.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stack.html)sumber daya bersarang, yang dapat berisi beberapa sumber daya lain termasuk sumber daya lainnya. [AWS::Serverless::Application](#sam-resource-application)

**catatan**  
Ketika Anda menyebarkan ke AWS CloudFormation, AWS SAM mengubah AWS SAM sumber daya Anda menjadi CloudFormation sumber daya. Untuk informasi selengkapnya, lihat [CloudFormation Sumber daya yang dihasilkan untuk AWS SAM](sam-specification-generated-resources.md).

## Sintaksis
<a name="sam-resource-application-syntax"></a>

Untuk mendeklarasikan entitas ini dalam template AWS Serverless Application Model (AWS SAM) Anda, gunakan sintaks berikut.

### YAML
<a name="sam-resource-application-syntax.yaml"></a>

```
Type: AWS::Serverless::Application
Properties:
  [Location](#sam-application-location): String | ApplicationLocationObject
  [NotificationARNs](#sam-application-notificationarns): List
  [Parameters](#sam-application-parameters): Map
  [Tags](#sam-application-tags): Map
  [TimeoutInMinutes](#sam-application-timeoutinminutes): Integer
```

## Sifat-sifat
<a name="sam-resource-application-properties"></a>

 `Location`   <a name="sam-application-location"></a>
URL templat, jalur file, atau lokasi objek dari aplikasi yang di-nest.  
Jika URL template disediakan, itu harus mengikuti format yang ditentukan dalam [CloudFormation TemplateUrl dokumentasi](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-templateurl) dan berisi template yang valid CloudFormation atau SAM. [ApplicationLocationObject](sam-property-application-applicationlocationobject.md) dapat digunakan untuk menentukan aplikasi yang telah diterbitkan ke [AWS Serverless Application Repository](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/what-is-serverlessrepo.html).  
Jika jalur file lokal tersedia, templat harus melalui alur kerja yang mencakup perintah `sam deploy` atau `sam package`, agar aplikasi dapat diubah dengan benar.  
*Jenis*: String \$1 [ApplicationLocationObject](sam-property-application-applicationlocationobject.md)  
*Wajib*: Ya  
*CloudFormation kompatibilitas*: Properti ini mirip dengan `[TemplateURL](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-templateurl)` properti `AWS::CloudFormation::Stack` sumber daya. CloudFormation Versi tidak mengambil [ApplicationLocationObject](sam-property-application-applicationlocationobject.md) untuk mengambil aplikasi dari file. AWS Serverless Application Repository

 `NotificationARNs`   <a name="sam-application-notificationarns"></a>
Daftar topik Amazon SNS yang ada tempat notifikasi tentang peristiwa tumpukan dikirim.  
*Tipe*: Daftar  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[NotificationARNs](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-notificationarns)` properti `AWS::CloudFormation::Stack` sumber daya.

 `Parameters`   <a name="sam-application-parameters"></a>
Nilai parameter aplikasi.  
*Tipe*: Peta  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[Parameters](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-parameters)` properti `AWS::CloudFormation::Stack` sumber daya.

 `Tags`   <a name="sam-application-tags"></a>
Sebuah peta (string ke string) yang menentukan tanda yang akan ditambahkan ke aplikasi ini. Kunci dan nilai terbatas pada karakter alfanumerik. Kunci dapat berisi 1 hingga 127 karakter Unicode dan tidak boleh diawali dengan aws:. Nilai dapat berisi 1 hingga 255 karakter Unicode.  
*Tipe*: Peta  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini mirip dengan `[Tags](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-tags)` properti `AWS::CloudFormation::Stack` sumber daya. Properti Tags di SAM terdiri dari pasangan Key:Value; di CloudFormation dalamnya terdiri dari daftar objek Tag. Ketika tumpukan dibuat, SAM secara otomatis akan menambahkan tanda `lambda:createdBy:SAM` untuk aplikasi ini. Selain itu, jika aplikasi ini dari AWS Serverless Application Repository, maka SAM juga akan otomatis dua tag tambahan `serverlessrepo:applicationId:ApplicationId` dan`serverlessrepo:semanticVersion:SemanticVersion`.

 `TimeoutInMinutes`   <a name="sam-application-timeoutinminutes"></a>
Lamanya waktu, dalam hitungan menit, yang CloudFormation menunggu tumpukan bersarang mencapai status. `CREATE_COMPLETE` Default tidak memiliki waktu habis. Ketika CloudFormation mendeteksi bahwa tumpukan bersarang telah mencapai `CREATE_COMPLETE` status, itu menandai sumber daya tumpukan bersarang seperti `CREATE_COMPLETE` pada tumpukan induk dan melanjutkan pembuatan tumpukan induk. Jika periode batas waktu berakhir sebelum tumpukan bersarang mencapai`CREATE_COMPLETE`, CloudFormation tandai tumpukan bersarang sebagai gagal dan memutar kembali tumpukan bersarang dan tumpukan induk.  
*Tipe*: Integer  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[TimeoutInMinutes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-timeoutinminutes)` properti `AWS::CloudFormation::Stack` sumber daya.

## Nilai Pengembalian
<a name="sam-resource-application-return-values"></a>

### Ref
<a name="sam-resource-application-return-values-ref"></a>

Ketika ID logis dari sumber daya ini disediakan untuk fungsi intrinsik `Ref`, ia mengembalikan nama sumber daya dari sumber daya `AWS::CloudFormation::Stack` utama.

Untuk informasi lebih lanjut tentang penggunaan fungsi `Ref`, lihat [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html) di *Panduan Pengguna AWS CloudFormation *. 

### Fn:: GetAtt
<a name="sam-resource-application-return-values-fn--getatt"></a>

`Fn::GetAtt` mengembalikan nilai untuk atribut yang ditentukan dari jenis ini. Berikut ini adalah atribut yang tersedia dan nilai-nilai kembali sampel. 

Untuk informasi lebih lanjut tentang menggunakan `Fn::GetAtt`, lihat [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html) di *Panduan Pengguna AWS CloudFormation *. 

`Outputs.ApplicationOutputName`  <a name="Outputs.ApplicationOutputName-fn::getatt"></a>
Nilai output tumpukan dengan nama `ApplicationOutputName`.

## Contoh
<a name="sam-resource-application--examples"></a>

### Aplikasi SAR
<a name="sam-resource-application--examples--sar-application"></a>

Aplikasi yang menggunakan templat dari Serverless Application Repository

#### YAML
<a name="sam-resource-application--examples--sar-application--yaml"></a>

```
Type: AWS::Serverless::Application
Properties:
  Location:
    ApplicationId: 'arn:aws:serverlessrepo:us-east-1:012345678901:applications/my-application'
    SemanticVersion: 1.0.0
  Parameters:
    StringParameter: parameter-value
    IntegerParameter: 2
```

### Aplikasi-Normal
<a name="sam-resource-application--examples--normal-application"></a>

Aplikasi dari url S3

#### YAML
<a name="sam-resource-application--examples--normal-application--yaml"></a>

```
Type: AWS::Serverless::Application
Properties:
  Location: https://s3.amazonaws.com/sam-s3-demo-bucket/template.yaml
```

# ApplicationLocationObject
<a name="sam-property-application-applicationlocationobject"></a>

Aplikasi yang telah diterbitkan ke [AWS Serverless Application Repository](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/what-is-serverlessrepo.html).

## Sintaksis
<a name="sam-property-application-applicationlocationobject-syntax"></a>

Untuk mendeklarasikan entitas ini dalam template AWS Serverless Application Model (AWS SAM) Anda, gunakan sintaks berikut.

### YAML
<a name="sam-property-application-applicationlocationobject-syntax.yaml"></a>

```
  [ApplicationId](#sam-application-applicationlocationobject-applicationid): String
  [SemanticVersion](#sam-application-applicationlocationobject-semanticversion): String
```

## Sifat-sifat
<a name="sam-property-application-applicationlocationobject-properties"></a>

 `ApplicationId`   <a name="sam-application-applicationlocationobject-applicationid"></a>
Amazon Resource Name (ARN) dari aplikasi.  
*Tipe*: String  
*Wajib*: Ya  
*CloudFormation kompatibilitas*: Properti ini unik AWS SAM dan tidak memiliki CloudFormation padanan.

 `SemanticVersion`   <a name="sam-application-applicationlocationobject-semanticversion"></a>
Versi semantik aplikasi.  
*Tipe*: String  
*Wajib*: Ya  
*CloudFormation kompatibilitas*: Properti ini unik AWS SAM dan tidak memiliki CloudFormation padanan.

## Contoh
<a name="sam-property-application-applicationlocationobject--examples"></a>

### my-application
<a name="sam-property-application-applicationlocationobject--examples--my-application"></a>

Contoh objek lokasi aplikasi

#### YAML
<a name="sam-property-application-applicationlocationobject--examples--my-application--yaml"></a>

```
Location:
  ApplicationId: 'arn:aws:serverlessrepo:us-east-1:012345678901:applications/my-application'
  SemanticVersion: 1.0.0
```