Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

 Erstellt ein AWS Lambda MicroVM-Image aus einem in Amazon S3 gespeicherten Codeartefakt. Ein MicroVM-Image ist ein Firecracker Snapshot, der aus einem Anwendungscode erstellt wird Dockerfile und den Start von MicroVM-Instanzen in Sekundenbruchteilen ermöglicht. 

**Anmerkung**  
Bei der Bereitstellung auf werden Ihre AWS CloudFormation AWS SAM Ressourcen in AWS SAM Ressourcen umgewandelt. CloudFormation Weitere Informationen finden Sie unter [Generiert CloudFormation Ressourcen für AWS SAM](sam-specification-generated-resources.md). 

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

Verwenden Sie die folgende Syntax, um diese Entität in Ihrer Vorlage AWS Serverless Application Model (AWS SAM) zu deklarieren.

### 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}}
```

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

 `AdditionalOsCapabilities`   <a name="sam-microvmimage-additionaloscapabilities"></a>
Zusätzliche Betriebssystemfunktionen, die der MicroVM-Laufzeitumgebung gewährt werden sollen. Wenn Sie keinen Wert angeben, gewährt der Dienst keine zusätzlichen Betriebssystemfunktionen.  
*Gültige Werte*: `ALL`  
*Typ*: Liste  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[AdditionalOsCapabilities](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-additionaloscapabilities)` Eigenschaft einer `AWS::Lambda::MicrovmImage` Ressource übergeben. 

 `BaseImageArn`   <a name="sam-microvmimage-baseimagearn"></a>
Der ARN des MicroVM-Basisimages, aus dem erstellt werden soll.  
*Typ:* Zeichenfolge  
*Erforderlich*: Ja  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[BaseImageArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-baseimagearn)` Eigenschaft einer `AWS::Lambda::MicrovmImage` Ressource übergeben. 

 `BaseImageVersion`   <a name="sam-microvmimage-baseimageversion"></a>
Die Version des zu verwendenden MicroVM-Basisimages.  
*Typ:* Zeichenfolge  
*Erforderlich*: Ja  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[BaseImageVersion](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-baseimageversion)` Eigenschaft einer `AWS::Lambda::MicrovmImage` Ressource übergeben. 

 `BuildRoleArn`   <a name="sam-microvmimage-buildrolearn"></a>
Der ARN der IAM-Rolle, die der MicroVM-Build-Service annimmt, um Ihr Code-Artefakt von Amazon S3 herunterzuladen und Build-Logs zu schreiben.  
*Typ:* Zeichenfolge  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft ähnelt der `[BuildRoleArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-buildrolearn)` Eigenschaft einer Ressource. `AWS::Lambda::MicrovmImage` Dies ist in erforderlich CloudFormation , aber nicht in AWS SAM. Wenn Sie keine Rolle angeben, AWS SAM erstellt eine Rolle mit der logischen ID`{{<resource-logical-id>}}BuildRole`. Wenn Ihr Codeartefakt mit einem vom Kunden verwalteten Schlüssel verschlüsselt ist AWS KMS, müssen Sie Ihrer eigenen Rolle die entsprechenden `kms:Decrypt` Berechtigungen zuweisen. 

 `CodeUri`   <a name="sam-microvmimage-codeuri"></a>
Die Amazon S3 S3-URI des ZIP-Artefakts, das den Dockerfile und den Anwendungscode enthält.  
*Typ:* Zeichenfolge  
*Erforderlich*: Ja  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird in die `[CodeArtifact](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-codeartifact)` Eigenschaft einer `AWS::Lambda::MicrovmImage` Ressource umgewandelt. AWS SAM schließt den URI in die `CodeArtifact.Uri` Struktur ein. 

 `CpuConfigurations`   <a name="sam-microvmimage-cpuconfigurations"></a>
Eine Liste von [CpuConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-microvmimage-cpuconfiguration.html)Objekten, die die unterstützten CPU-Architekturen für die MicroVM spezifizieren. Wenn Sie keinen Wert angeben, verwendet der Dienst die Standard-CPU-Architektur.  
*Typ*: Liste  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[CpuConfigurations](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-cpuconfigurations)` Eigenschaft einer `AWS::Lambda::MicrovmImage` Ressource übergeben. 

 `Description`   <a name="sam-microvmimage-description"></a>
Eine Beschreibung des MicroVM-Images.  
*Typ:* Zeichenfolge  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[Description](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-description)` Eigenschaft einer `AWS::Lambda::MicrovmImage` Ressource übergeben. 

 `EgressNetworkConnectors`   <a name="sam-microvmimage-egressnetworkconnectors"></a>
Die Liste der ausgehenden Netzwerk-Connector-ARNs, die der microVM zur Laufzeit zur Verfügung stehen.  
*Typ*: Liste  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[EgressNetworkConnectors](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-egressnetworkconnectors)` Eigenschaft einer Ressource übergeben. `AWS::Lambda::MicrovmImage` 

 `EnvironmentVariables`   <a name="sam-microvmimage-environmentvariables"></a>
Umgebungsvariablen, die in der MicroVM-Laufzeitumgebung festgelegt sind.  
*Typ*: Karte  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft ähnelt der `[EnvironmentVariables](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-environmentvariables)` Eigenschaft einer `AWS::Lambda::MicrovmImage` Ressource. Geben Sie in AWS SAM als Map an (z. B.`KEY: value`). AWS SAM konvertiert in das CloudFormation Array-Format`[{Key: KEY, Value: value}]`. 

 `Hooks`   <a name="sam-microvmimage-hooks"></a>
Lifecycle-Hook-Konfiguration für MicroVMs und MicroVM-Images.  
*[Typ: Hooks](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-microvmimage-hooks.html)*  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[Hooks](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-hooks)` Eigenschaft einer `AWS::Lambda::MicrovmImage` Ressource übergeben. 

 `Logging`   <a name="sam-microvmimage-logging"></a>
Konfiguration für die MicroVM-Logging-Ausgabe. Geben Sie genau eine an: `CloudWatch` um die CloudWatch Protokollierung zu aktivieren oder `Disabled` um die Protokollierung zu deaktivieren.  
*Typ*: [Protokollierung](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-microvmimage-logging.html)  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[Logging](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-logging)` Eigenschaft einer `AWS::Lambda::MicrovmImage` Ressource übergeben. 

 `Name`   <a name="sam-microvmimage-name"></a>
Der Name des MicroVM-Images.  
*Typ:* Zeichenfolge  
*Erforderlich*: Ja  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-name)` Eigenschaft einer `AWS::Lambda::MicrovmImage` Ressource übergeben. 

 `PropagateTags`   <a name="sam-microvmimage-propagatetags"></a>
Gibt an, ob Tags von der `Tags` Eigenschaft an generierte Ressourcen übergeben werden sollen, z. B. an die automatisch generierte Build-Rolle.  
*Typ*: Boolesch  
*Required*: No  
*Standardwert*: `False`  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

 `Resources`   <a name="sam-microvmimage-resources"></a>
Eine Liste von [Resources-Objekten](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-microvmimage-resources.html), die die Ressourcenanforderungen für die MicroVM spezifizieren.  
*Typ*: Liste  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[Resources](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-resources)` Eigenschaft einer `AWS::Lambda::MicrovmImage` Ressource übergeben. 

 `Tags`   <a name="sam-microvmimage-tags"></a>
Eine Zuordnung von Schlüssel-Wert-Paaren, die die Tags angibt, die diesem MicroVM-Image hinzugefügt wurden.  
*Typ: Karte*  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft ähnelt der `[Tags](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-tags)` Eigenschaft einer `AWS::Lambda::MicrovmImage` Ressource. Die `Tags` Eigenschaft in AWS SAM besteht aus Schlüssel-Wert-Paaren (wohingegen CloudFormation diese Eigenschaft aus einer Liste von `Tag` Objekten besteht). Fügt diesem MicroVM-Image und den dafür generierten Standardrollen außerdem AWS SAM automatisch ein `lambda:createdBy:SAM` Tag hinzu. 

## Rückgabewerte
<a name="sam-resource-microvmimage-return-values"></a>

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

Wenn die logische ID dieser Ressource für die `Ref` intrinsische Funktion bereitgestellt wird, gibt sie den ARN des MicroVM-Images zurück.

*Weitere Informationen zur Verwendung der `Ref` Funktion finden Sie [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)im AWS CloudFormation Benutzerhandbuch.*

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

`Fn::GetAtt` gibt einen Wert für ein angegebenes Attribut dieses Typs zurück. Im Folgenden sehen Sie die verfügbaren Attribute und Beispielrückgabewerte.

Weitere Informationen zur Verwendung `Fn::GetAtt` finden Sie [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)im *AWS CloudFormation Benutzerhandbuch*.

`CreatedAt`  <a name="sam-microvmimage-getatt-createdat"></a>
Der Zeitstempel, als die MicroVM-Image-Version erstellt wurde.

`ImageArn`  <a name="sam-microvmimage-getatt-imagearn"></a>
Der ARN des MicroVM-Images.

`LatestActiveImageVersion`  <a name="sam-microvmimage-getatt-latestactiveimageversion"></a>
Die neueste aktive Version des MicroVM-Images.

`LatestFailedImageVersion`  <a name="sam-microvmimage-getatt-latestfailedimageversion"></a>
Die letzte fehlgeschlagene Version des MicroVM-Images, falls vorhanden.

`State`  <a name="sam-microvmimage-getatt-state"></a>
Der aktuelle Status des MicroVM-Images.

`UpdatedAt`  <a name="sam-microvmimage-getatt-updatedat"></a>
Der Zeitstempel, zu dem die MicroVM-Image-Version zuletzt aktualisiert wurde.

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

### Minimales MicroVM-Image
<a name="sam-resource-microvmimage-example-minimal"></a>

Im folgenden Beispiel wird ein MicroVM-Image erstellt, das nur die erforderlichen Eigenschaften enthält. AWS SAM generiert automatisch eine Build-Rolle.

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

### Vollständige MicroVM-Image-Konfiguration
<a name="sam-resource-microvmimage-example-full"></a>

Im folgenden Beispiel wird ein MicroVM-Image erstellt, bei dem alle verfügbaren Eigenschaften konfiguriert sind.

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