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

# AWS::Serverless::MicrovmImage
<a name="sam-resource-microvmimage"></a>

 Membuat gambar AWS Lambda microVM dari artefak kode yang disimpan di Amazon S3. Gambar microVM adalah Firecracker snapshot yang dibuat dari kode aplikasi Dockerfile dan, memungkinkan startup sub-detik untuk instance microVM. 

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

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

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

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

```
Type: AWS::Serverless::MicrovmImage
Properties:
  [AdditionalOsCapabilities](#sam-microvmimage-additionaloscapabilities): {{List}}
  [BaseImageArn](#sam-microvmimage-baseimagearn): {{String}}
  [BaseImageVersion](#sam-microvmimage-baseimageversion): {{String}}
  [BuildRoleArn](#sam-microvmimage-buildrolearn): {{String}}
  [CodeUri](#sam-microvmimage-codeuri): {{String}}
  [CpuConfigurations](#sam-microvmimage-cpuconfigurations): {{List}}
  [Description](#sam-microvmimage-description): {{String}}
  [EgressNetworkConnectors](#sam-microvmimage-egressnetworkconnectors): {{List}}
  [EnvironmentVariables](#sam-microvmimage-environmentvariables): {{Map}}
  [Hooks](#sam-microvmimage-hooks): {{[Hooks](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-microvmimage-hooks.html)}}
  [Logging](#sam-microvmimage-logging): {{[Logging](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-microvmimage-logging.html)}}
  [Name](#sam-microvmimage-name): {{String}}
  [PropagateTags](#sam-microvmimage-propagatetags): {{Boolean}}
  [Resources](#sam-microvmimage-resources): {{List}}
  [Tags](#sam-microvmimage-tags): {{Map}}
```

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

 `AdditionalOsCapabilities`   <a name="sam-microvmimage-additionaloscapabilities"></a>
Kemampuan OS tambahan untuk diberikan ke lingkungan runtime microVM. Jika Anda tidak menentukan nilai, layanan tidak memberikan kemampuan OS tambahan.  
*Nilai yang valid*: `ALL`  
*Tipe*: Daftar  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[AdditionalOsCapabilities](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-additionaloscapabilities)` properti `AWS::Lambda::MicrovmImage` sumber daya. 

 `BaseImageArn`   <a name="sam-microvmimage-baseimagearn"></a>
ARN dari gambar microVM dasar untuk dibangun.  
*Tipe*: String  
*Wajib*: Ya  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[BaseImageArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-baseimagearn)` properti `AWS::Lambda::MicrovmImage` sumber daya. 

 `BaseImageVersion`   <a name="sam-microvmimage-baseimageversion"></a>
Versi gambar microVM dasar yang akan digunakan.  
*Tipe*: String  
*Wajib*: Ya  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[BaseImageVersion](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-baseimageversion)` properti `AWS::Lambda::MicrovmImage` sumber daya. 

 `BuildRoleArn`   <a name="sam-microvmimage-buildrolearn"></a>
ARN dari peran IAM yang diasumsikan oleh layanan build microVM untuk mengunduh artefak kode Anda dari Amazon S3 dan menulis log build.  
*Tipe*: String  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini mirip dengan `[BuildRoleArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-buildrolearn)` properti `AWS::Lambda::MicrovmImage` sumber daya. Ini wajib diisi di CloudFormation tapi bukan di AWS SAM. Jika Anda tidak menentukan peran, AWS SAM buat peran dengan ID logis`{{<resource-logical-id>}}BuildRole`. Jika artefak kode Anda dienkripsi dengan kunci yang dikelola pelanggan AWS KMS, Anda harus memberikan peran Anda sendiri dengan izin yang sesuai. `kms:Decrypt` 

 `CodeUri`   <a name="sam-microvmimage-codeuri"></a>
URI Amazon S3 dari artefak zip yang berisi kode Dockerfile dan aplikasi.  
*Tipe*: String  
*Wajib*: Ya  
*CloudFormation kompatibilitas*: Properti ini diubah menjadi `[CodeArtifact](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-codeartifact)` properti `AWS::Lambda::MicrovmImage` sumber daya. AWS SAM membungkus URI ke dalam `CodeArtifact.Uri` struktur. 

 `CpuConfigurations`   <a name="sam-microvmimage-cpuconfigurations"></a>
Daftar [CpuConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-microvmimage-cpuconfiguration.html)objek yang menentukan arsitektur CPU yang didukung untuk microVM. Jika Anda tidak menentukan nilai, layanan menggunakan arsitektur CPU default.  
*Tipe*: Daftar  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[CpuConfigurations](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-cpuconfigurations)` properti `AWS::Lambda::MicrovmImage` sumber daya. 

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

 `EgressNetworkConnectors`   <a name="sam-microvmimage-egressnetworkconnectors"></a>
Daftar ARN konektor jaringan keluar yang tersedia untuk microVM saat runtime.  
*Tipe*: Daftar  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[EgressNetworkConnectors](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-egressnetworkconnectors)` properti `AWS::Lambda::MicrovmImage` sumber daya. 

 `EnvironmentVariables`   <a name="sam-microvmimage-environmentvariables"></a>
Variabel lingkungan diatur dalam lingkungan runtime microVM.  
*Tipe*: Peta  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini mirip dengan `[EnvironmentVariables](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-environmentvariables)` properti `AWS::Lambda::MicrovmImage` sumber daya. Dalam AWS SAM, tentukan sebagai peta (misalnya,`KEY: value`). AWS SAM mengkonversi ke format CloudFormation `[{Key: KEY, Value: value}]` array. 

 `Hooks`   <a name="sam-microvmimage-hooks"></a>
Konfigurasi kait siklus hidup untuk gambar microVMS dan microVM.  
*Tipe*: [Hook](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-microvmimage-hooks.html)  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[Hooks](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-hooks)` properti `AWS::Lambda::MicrovmImage` sumber daya. 

 `Logging`   <a name="sam-microvmimage-logging"></a>
Konfigurasi untuk output logging microVM. Tentukan tepat satu: `CloudWatch` untuk mengaktifkan CloudWatch logging, atau `Disabled` untuk mematikan logging.  
*Jenis*: [Logging](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-microvmimage-logging.html)  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[Logging](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-logging)` properti `AWS::Lambda::MicrovmImage` sumber daya. 

 `Name`   <a name="sam-microvmimage-name"></a>
Nama gambar microVM.  
*Tipe*: String  
*Wajib*: Ya  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-name)` properti `AWS::Lambda::MicrovmImage` sumber daya. 

 `PropagateTags`   <a name="sam-microvmimage-propagatetags"></a>
Menentukan apakah akan meneruskan tag dari `Tags` properti ke sumber daya yang dihasilkan, seperti peran build yang dibuat secara otomatis.  
*Tipe*: Boolean  
*Wajib*: Tidak  
*Default*: `False`  
*CloudFormation kompatibilitas*: Properti ini unik AWS SAM dan tidak memiliki CloudFormation padanan.

 `Resources`   <a name="sam-microvmimage-resources"></a>
Daftar objek [Resources](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-microvmimage-resources.html) yang menentukan persyaratan sumber daya untuk microVM.  
*Tipe*: Daftar  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[Resources](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-resources)` properti `AWS::Lambda::MicrovmImage` sumber daya. 

 `Tags`   <a name="sam-microvmimage-tags"></a>
Peta pasangan kunci-nilai yang menentukan tag yang ditambahkan ke gambar microVM ini.  
*Tipe*: Peta  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini mirip dengan `[Tags](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-tags)` properti `AWS::Lambda::MicrovmImage` sumber daya. `Tags`Properti di AWS SAM terdiri dari pasangan kunci-nilai (sedangkan dalam properti CloudFormation ini terdiri dari daftar `Tag` objek). Selain itu, AWS SAM secara otomatis menambahkan `lambda:createdBy:SAM` tag ke gambar microVM ini, dan ke peran default yang dihasilkan untuknya. 

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

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

Ketika ID logis dari sumber daya ini disediakan untuk fungsi `Ref` intrinsik, ia mengembalikan ARN dari gambar microVM.

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

### Fn:: GetAtt
<a name="sam-resource-microvmimage-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 `Fn::GetAtt`, lihat [`Fn::GetAtt`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html) di *Panduan Pengguna AWS CloudFormation *

`CreatedAt`  <a name="sam-microvmimage-getatt-createdat"></a>
Stempel waktu saat versi gambar microVM dibuat.

`ImageArn`  <a name="sam-microvmimage-getatt-imagearn"></a>
ARN dari gambar microVM.

`LatestActiveImageVersion`  <a name="sam-microvmimage-getatt-latestactiveimageversion"></a>
Versi aktif terbaru dari gambar microVM.

`LatestFailedImageVersion`  <a name="sam-microvmimage-getatt-latestfailedimageversion"></a>
Versi gagal terbaru dari gambar microVM, jika ada.

`State`  <a name="sam-microvmimage-getatt-state"></a>
Keadaan gambar microVM saat ini.

`UpdatedAt`  <a name="sam-microvmimage-getatt-updatedat"></a>
Stempel waktu saat versi gambar microVM terakhir diperbarui.

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

### Gambar microVM minimal
<a name="sam-resource-microvmimage-example-minimal"></a>

Contoh berikut membuat gambar microVM dengan hanya properti yang diperlukan. AWS SAM secara otomatis menghasilkan peran build.

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31

Resources:
  MyMicroVM:
    Type: AWS::Serverless::MicrovmImage
    Properties:
      Name: my-app
      CodeUri: s3://my-bucket/app.zip
      BaseImageArn: arn:aws:lambda:us-east-2:aws:microvm-image:al2023-1
      BaseImageVersion: "0"
```

### Konfigurasi gambar MicroVM penuh
<a name="sam-resource-microvmimage-example-full"></a>

Contoh berikut membuat gambar microVM dengan semua properti yang tersedia dikonfigurasi.

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31

Resources:
  MyMicroVM:
    Type: AWS::Serverless::MicrovmImage
    Properties:
      Name: my-app
      CodeUri: s3://my-bucket/app.zip
      BaseImageArn: arn:aws:lambda:us-east-2:aws:microvm-image:al2023-1
      BaseImageVersion: "0"
      Description: "Production MicroVM application"
      CpuConfigurations:
        - Architecture: ARM_64
      Resources:
        - MinimumMemoryInMiB: 1024
      AdditionalOsCapabilities:
        - ALL
      EgressNetworkConnectors:
        - arn:aws:lambda:us-east-2:aws:network-connector:aws-network-connector:INTERNET_EGRESS
      Hooks:
        Port: 9000
        MicrovmHooks:
          Run: ENABLED
          RunTimeoutInSeconds: 30
          Suspend: ENABLED
          Resume: ENABLED
        MicrovmImageHooks:
          Ready: ENABLED
          ReadyTimeoutInSeconds: 60
      EnvironmentVariables:
        LOG_LEVEL: info
        APP_ENV: production
      Logging:
        CloudWatch:
          LogGroup: /aws/lambda-microvms/my-app
      Tags:
        Environment: Production
        Team: Platform
```