Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

 Crea un'immagine AWS Lambda MicroVM da un elemento di codice archiviato in Amazon S3. Un'immagine MicroVM è un'Firecrackeristantanea creata a partire da un codice applicativo, che consente l'avvio in meno di un secondo per Dockerfile le istanze MicroVM. 

**Nota**  
Quando esegui la distribuzione su, trasforma le tue risorse in risorse. AWS CloudFormation AWS SAM AWS SAM CloudFormation Per ulteriori informazioni, consulta [Generato CloudFormation risorse per AWS SAM](sam-specification-generated-resources.md). 

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

Per dichiarare questa entità nel tuo modello AWS Serverless Application Model (AWS SAM), usa la seguente sintassi.

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

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

 `AdditionalOsCapabilities`   <a name="sam-microvmimage-additionaloscapabilities"></a>
Funzionalità del sistema operativo aggiuntive da concedere all'ambiente di runtime MicroVM. Se non si specifica un valore, il servizio non concede funzionalità aggiuntive del sistema operativo.  
*Valori validi*: `ALL`  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[AdditionalOsCapabilities](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-additionaloscapabilities)` proprietà di una `AWS::Lambda::MicrovmImage` risorsa. 

 `BaseImageArn`   <a name="sam-microvmimage-baseimagearn"></a>
L'ARN dell'immagine MicroVM di base da cui creare.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[BaseImageArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-baseimagearn)` proprietà di una risorsa. `AWS::Lambda::MicrovmImage` 

 `BaseImageVersion`   <a name="sam-microvmimage-baseimageversion"></a>
La versione dell'immagine MicroVM di base da utilizzare.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[BaseImageVersion](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-baseimageversion)` proprietà di una `AWS::Lambda::MicrovmImage` risorsa. 

 `BuildRoleArn`   <a name="sam-microvmimage-buildrolearn"></a>
L'ARN del ruolo IAM che il servizio di compilazione MicroVM assume per scaricare l'elemento di codice da Amazon S3 e scrivere i log di build.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è simile alla proprietà di una risorsa. `[BuildRoleArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-buildrolearn)` `AWS::Lambda::MicrovmImage` È obbligatorio in CloudFormation ma non in AWS SAM. Se non specifichi un ruolo, ne AWS SAM crea uno con un ID logico di`{{<resource-logical-id>}}BuildRole`. Se l'elemento del codice è crittografato con una chiave gestita dal cliente AWS KMS, è necessario fornire al proprio ruolo l'autorizzazione appropriata`kms:Decrypt`. 

 `CodeUri`   <a name="sam-microvmimage-codeuri"></a>
L'URI Amazon S3 dell'elemento zip contenente il codice e dell'Dockerfileapplicazione.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene trasformata nella `[CodeArtifact](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-codeartifact)` proprietà di una risorsa. `AWS::Lambda::MicrovmImage` AWS SAM avvolge l'URI nella struttura. `CodeArtifact.Uri` 

 `CpuConfigurations`   <a name="sam-microvmimage-cpuconfigurations"></a>
Un elenco di [CpuConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-microvmimage-cpuconfiguration.html)oggetti che specificano le architetture CPU supportate per la microVM. Se non si specifica un valore, il servizio utilizza l'architettura CPU predefinita.  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[CpuConfigurations](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-cpuconfigurations)` proprietà di una `AWS::Lambda::MicrovmImage` risorsa. 

 `Description`   <a name="sam-microvmimage-description"></a>
Una descrizione dell'immagine MicroVM.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Description](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-description)` proprietà di una `AWS::Lambda::MicrovmImage` risorsa. 

 `EgressNetworkConnectors`   <a name="sam-microvmimage-egressnetworkconnectors"></a>
L'elenco degli ARN dei connettori di rete in uscita disponibili per la microVM in fase di esecuzione.  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[EgressNetworkConnectors](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-egressnetworkconnectors)` proprietà di una risorsa. `AWS::Lambda::MicrovmImage` 

 `EnvironmentVariables`   <a name="sam-microvmimage-environmentvariables"></a>
Variabili di ambiente impostate nell'ambiente di runtime MicroVM.  
*Tipo: Mappa*  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è simile alla `[EnvironmentVariables](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-environmentvariables)` proprietà di una `AWS::Lambda::MicrovmImage` risorsa. In AWS SAM, specificare come mappa (ad esempio,`KEY: value`). AWS SAM converte nel formato CloudFormation `[{Key: KEY, Value: value}]` array. 

 `Hooks`   <a name="sam-microvmimage-hooks"></a>
configurazione Lifecycle Hook per immagini MicroVMS e MicroVM.  
*Tipo*[:](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-microvmimage-hooks.html) ganci  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Hooks](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-hooks)` proprietà di una `AWS::Lambda::MicrovmImage` risorsa. 

 `Logging`   <a name="sam-microvmimage-logging"></a>
Configurazione per l'output di registrazione MicroVM. Specificane esattamente uno: `CloudWatch` per abilitare CloudWatch la registrazione o `Disabled` per disattivarla.  
*Type*: [Logging](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-microvmimage-logging.html)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Logging](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-logging)` proprietà di una `AWS::Lambda::MicrovmImage` risorsa. 

 `Name`   <a name="sam-microvmimage-name"></a>
Il nome dell'immagine MicroVM.  
▬*Tipo:* stringa  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-name)` proprietà di una `AWS::Lambda::MicrovmImage` risorsa. 

 `PropagateTags`   <a name="sam-microvmimage-propagatetags"></a>
Speciifica se passare i tag dalla `Tags` proprietà alle risorse generate, ad esempio il ruolo di compilazione generato automaticamente.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*Default*: `False`  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `Resources`   <a name="sam-microvmimage-resources"></a>
Un elenco di oggetti [Resources](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-microvmimage-resources.html) che specificano i requisiti di risorse per la MicroVM.  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Resources](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-resources)` proprietà di una `AWS::Lambda::MicrovmImage` risorsa. 

 `Tags`   <a name="sam-microvmimage-tags"></a>
Una mappa di coppie chiave-valore che specifica i tag aggiunti a questa immagine MicroVM.  
*Tipo: Mappa*  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è simile alla `[Tags](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html#cfn-lambda-microvmimage-tags)` proprietà di una `AWS::Lambda::MicrovmImage` risorsa. La `Tags` proprietà in AWS SAM è costituita da coppie chiave-valore (mentre in CloudFormation questa proprietà è costituita da un elenco di `Tag` oggetti). Inoltre, aggiunge AWS SAM automaticamente un `lambda:createdBy:SAM` tag a questa immagine MicroVM e ai ruoli predefiniti generati per essa. 

## Valori restituiti
<a name="sam-resource-microvmimage-return-values"></a>

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

Quando l'ID logico di questa risorsa viene fornito alla funzione `Ref` intrinseca, restituisce l'ARN dell'immagine MicroVM.

*Per ulteriori informazioni sull'uso della `Ref` funzione, vedere [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)la Guida per l'utente.AWS CloudFormation *

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

`Fn::GetAtt` restituisce un valore per un attributo specificato di questo tipo. Di seguito sono riportati gli attributi disponibili e i valori restituiti di esempio.

Per ulteriori informazioni sull'utilizzo`Fn::GetAtt`, consulta [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)la *Guida per l'AWS CloudFormation utente*.

`CreatedAt`  <a name="sam-microvmimage-getatt-createdat"></a>
Il timestamp in cui è stata creata la versione dell'immagine MicroVM.

`ImageArn`  <a name="sam-microvmimage-getatt-imagearn"></a>
L'ARN dell'immagine MicroVM.

`LatestActiveImageVersion`  <a name="sam-microvmimage-getatt-latestactiveimageversion"></a>
L'ultima versione attiva dell'immagine MicroVM.

`LatestFailedImageVersion`  <a name="sam-microvmimage-getatt-latestfailedimageversion"></a>
L'ultima versione non riuscita dell'immagine MicroVM, se presente.

`State`  <a name="sam-microvmimage-getatt-state"></a>
Lo stato attuale dell'immagine MicroVM.

`UpdatedAt`  <a name="sam-microvmimage-getatt-updatedat"></a>
Il timestamp dell'ultimo aggiornamento della versione dell'immagine MicroVM.

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

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

L'esempio seguente crea un'immagine MicroVM con solo le proprietà richieste. AWS SAM genera automaticamente un ruolo di compilazione.

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

### Configurazione completa dell'immagine MicroVM
<a name="sam-resource-microvmimage-example-full"></a>

L'esempio seguente crea un'immagine MicroVM con tutte le proprietà disponibili configurate.

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