

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

# AWS::Serverless::LayerVersion
<a name="sam-resource-layerversion"></a>

Membuat Lambda LayerVersion yang berisi pustaka atau kode runtime yang dibutuhkan oleh Fungsi Lambda.

[AWS::Serverless::LayerVersion](#sam-resource-layerversion)Resource juga mendukung atribut `Metadata` resource, sehingga Anda dapat menginstruksikan AWS SAM untuk membangun layer yang disertakan dalam aplikasi Anda. Untuk informasi selengkapnya tentang membangun lapisan, lihat [Membangun lapisan Lambda di AWS SAM](building-layers.md).

**Catatan Penting**: Karena rilis atribut [UpdateReplacePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-updatereplacepolicy.html)resource di CloudFormation, [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html)(disarankan) menawarkan manfaat yang sama seperti[AWS::Serverless::LayerVersion](#sam-resource-layerversion).

Ketika Tanpa Server LayerVersion diubah, SAM juga mengubah id logis sumber daya sehingga yang lama LayerVersions tidak dihapus secara otomatis CloudFormation ketika sumber daya diperbarui.

**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-layerversion-syntax"></a>

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

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

```
Type: AWS::Serverless::LayerVersion
Properties:
  [CompatibleArchitectures](#sam-layerversion-compatiblearchitectures): List
  [CompatibleRuntimes](#sam-layerversion-compatibleruntimes): List
  [ContentUri](#sam-layerversion-contenturi): String | LayerContent
  [Description](#sam-layerversion-description): String
  [LayerName](#sam-layerversion-layername): String
  [LicenseInfo](#sam-layerversion-licenseinfo): String
  [PublishLambdaVersion](#sam-layerversion-PublishLambdaVersion): Boolean
  [RetentionPolicy](#sam-layerversion-retentionpolicy): String
```

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

 `CompatibleArchitectures`   <a name="sam-layerversion-compatiblearchitectures"></a>
Menentukan arsitektur set instruksi yang didukung untuk versi lapisan.  
*Untuk informasi selengkapnya tentang properti ini, lihat [Arsitektur set instruksi Lambda di Panduan](https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html) Pengembang.AWS Lambda *  
*Nilai valid:* `x86_64`, `arm64`  
*Tipe*: Daftar  
*Wajib*: Tidak  
*Default*: `x86_64`  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[CompatibleArchitectures](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html#cfn-lambda-layerversion-compatiblearchitectures)` properti `AWS::Lambda::LayerVersion` sumber daya.

 `CompatibleRuntimes`   <a name="sam-layerversion-compatibleruntimes"></a>
Daftar runtime yang kompatibel dengan ini LayerVersion.  
*Tipe*: Daftar  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[CompatibleRuntimes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html#cfn-lambda-layerversion-compatibleruntimes)` properti `AWS::Lambda::LayerVersion` sumber daya.

 `ContentUri`   <a name="sam-layerversion-contenturi"></a>
Amazon S3 Uri, jalur ke folder lokal, atau LayerContent objek kode lapisan.  
[Jika Uri atau objek Amazon S3 disediakan, LayerContent Objek Amazon S3 yang direferensikan harus berupa arsip ZIP yang valid yang berisi konten lapisan Lambda.](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)  
Jika jalur ke folder lokal disediakan, untuk konten yang akan diubah dengan benar templat harus melalui alur kerja yang mencakup [sam build](sam-cli-command-reference-sam-build.md) diikuti oleh salah satu [sam deploy](sam-cli-command-reference-sam-deploy.md) atau [sam package](sam-cli-command-reference-sam-package.md). Secara default, jalur relatif diselesaikan sehubungan dengan lokasi AWS SAM template.  
*Jenis*: String \$1 [LayerContent](sam-property-layerversion-layercontent.md)  
*Wajib*: Ya  
*CloudFormation kompatibilitas*: Properti ini mirip dengan `[Content](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html#cfn-lambda-layerversion-content)` properti `AWS::Lambda::LayerVersion` sumber daya. Properti Amazon S3 nest diberi nama berbeda.

 `Description`   <a name="sam-layerversion-description"></a>
Deskripsi dari lapisan ini.  
*Tipe*: String  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[Description](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html#cfn-lambda-layerversion-description)` properti `AWS::Lambda::LayerVersion` sumber daya.

 `LayerName`   <a name="sam-layerversion-layername"></a>
Amazon Resource Name (ARN) dari pengguna.  
*Tipe*: String  
*Wajib*: Tidak  
*Default*: Sumber daya id logis  
*CloudFormation kompatibilitas*: Properti ini mirip dengan `[LayerName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html#cfn-lambda-layerversion-layername)` properti `AWS::Lambda::LayerVersion` sumber daya. Jika Anda tidak menentukan nama, id logis dari sumber daya akan digunakan sebagai nama.

 `LicenseInfo`   <a name="sam-layerversion-licenseinfo"></a>
Informasi tentang lisensi untuk ini LayerVersion.  
*Tipe*: String  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[LicenseInfo](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html#cfn-lambda-layerversion-licenseinfo)` properti `AWS::Lambda::LayerVersion` sumber daya.

 `PublishLambdaVersion`   <a name="sam-layerversion-PublishLambdaVersion"></a>
Properti opt-in yang membuat versi Lambda baru setiap kali ada perubahan dalam sumber daya yang direferensikan`LayerVersion`. Ketika diaktifkan dengan `AutoPublishAlias` dan `AutoPublishAliasAllProperties` dalam fungsi Lambda yang terhubung, akan ada versi Lambda baru yang dibuat untuk setiap perubahan yang dilakukan pada sumber daya. `LayerVersion`  
*Tipe*: Boolean  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini unik AWS SAM dan tidak memiliki CloudFormation padanan.

 `RetentionPolicy`   <a name="sam-layerversion-retentionpolicy"></a>
Properti ini menentukan apakah versi lama Anda `LayerVersion` dipertahankan atau dihapus saat Anda menghapus sumber daya. Jika Anda perlu mempertahankan versi lama `LayerVersion` saat memperbarui atau mengganti sumber daya, Anda harus mengaktifkan `UpdateReplacePolicy` atribut tersebut. Untuk informasi tentang melakukan hal ini, lihat [`UpdateReplacePolicy`atribut](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-updatereplacepolicy.html) dalam *Panduan AWS CloudFormation Pengguna*.  
*Nilai yang valid*: `Retain` atau `Delete`  
*Tipe*: String  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini unik AWS SAM dan tidak memiliki CloudFormation padanan.  
*Catatan tambahan*: Saat Anda menentukan`Retain`, AWS SAM tambahkan a [Atribut sumber daya yang didukung oleh AWS SAM](sam-specification-resource-attributes.md) dari `DeletionPolicy: Retain` ke `AWS::Lambda::LayerVersion` sumber daya yang diubah.

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

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

Ketika ID logis dari sumber daya ini disediakan untuk fungsi `Ref` intrinsik, ia mengembalikan ARN sumber daya dari Lambda yang mendasarinya. LayerVersion

Untuk informasi lebih lanjut tentang menggunakan 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 *. 

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

### LayerVersionExample
<a name="sam-resource-layerversion--examples--layerversionexample"></a>

Contoh dari LayerVersion

#### YAML
<a name="sam-resource-layerversion--examples--layerversionexample--yaml"></a>

```
Properties:
  LayerName: MyLayer
  Description: Layer description
  ContentUri: 's3://sam-s3-demo-bucket/my-layer.zip'
  CompatibleRuntimes:
    - nodejs10.x
    - nodejs12.x
  LicenseInfo: 'Available under the MIT-0 license.'
  RetentionPolicy: Retain
```

# LayerContent
<a name="sam-property-layerversion-layercontent"></a>

Arsip ZIP yang berisi konten lapisan [lapisan Lambda](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html).

## Sintaksis
<a name="sam-property-layerversion-layercontent-syntax"></a>

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

### YAML
<a name="sam-property-layerversion-layercontent-syntax.yaml"></a>

```
  [Bucket](#sam-layerversion-layercontent-bucket): String
  [Key](#sam-layerversion-layercontent-key): String
  [Version](#sam-layerversion-layercontent-version): String
```

## Sifat-sifat
<a name="sam-property-layerversion-layercontent-properties"></a>

 `Bucket`   <a name="sam-layerversion-layercontent-bucket"></a>
Bucket Amazon S3 dari arsip lapisan.  
*Tipe*: String  
*Wajib*: Ya  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[S3Bucket](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-layerversion-content.html#cfn-lambda-layerversion-content-s3bucket)` properti tipe `AWS::Lambda::LayerVersion` `Content` data.

 `Key`   <a name="sam-layerversion-layercontent-key"></a>
Kunci Amazon S3 dari arsip lapisan.  
*Tipe*: String  
*Wajib*: Ya  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[S3Key](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-layerversion-content.html#cfn-lambda-layerversion-content-s3key)` properti tipe `AWS::Lambda::LayerVersion` `Content` data.

 `Version`   <a name="sam-layerversion-layercontent-version"></a>
Untuk objek berversi, versi objek arsip lapisan yang digunakan.  
*Tipe*: String  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[S3ObjectVersion](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-layerversion-content.html#cfn-lambda-layerversion-content-s3objectversion)` properti tipe `AWS::Lambda::LayerVersion` `Content` data.

## Contoh
<a name="sam-property-layerversion-layercontent--examples"></a>

### LayerContent
<a name="sam-property-layerversion-layercontent--examples--layercontent"></a>

Contoh konten lapisan

#### YAML
<a name="sam-property-layerversion-layercontent--examples--layercontent--yaml"></a>

```
LayerContent:
  Bucket: amzn-s3-demo-bucket-name
  Key: mykey-name
  Version: 121212
```