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à.

# sam package
<a name="sam-cli-command-reference-sam-package"></a>

La AWS Serverless Application Model Command Line Interface (AWS SAM CLI) impacchetta un' AWS SAM applicazione.

Questo comando crea un `.zip` file con il codice e le dipendenze e carica il file su Amazon Simple Storage Service (Amazon S3). AWS SAM abilita la crittografia per tutti i file archiviati in Amazon S3. Quindi restituisce una copia del AWS SAM modello, sostituendo i riferimenti agli artefatti locali con la posizione Amazon S3 in cui il comando ha caricato gli artefatti.

Per impostazione predefinita, quando si utilizza questo comando, si AWS SAMCLI presuppone che la directory di lavoro corrente sia la directory principale del progetto. Il AWS SAMCLI primo tenta di individuare un file modello creato utilizzando il [sam build](sam-cli-command-reference-sam-build.md) comando, situato nella `.aws-sam` sottocartella e denominato. `template.yaml` Successivamente, AWS SAMCLI tenta di individuare un file modello denominato `template.yaml` o `template.yml` nella directory di lavoro corrente. Se si specifica l'`--template`opzione, il comportamento predefinito AWS SAMCLI dell'opzione viene sovrascritto e includerà solo il AWS SAM modello e le risorse locali a cui punta.

**Nota**  
[sam deploy](sam-cli-command-reference-sam-deploy.md)ora esegue implicitamente la funzionalità di. `sam package` È possibile utilizzare il [sam deploy](sam-cli-command-reference-sam-deploy.md) comando direttamente per impacchettare e distribuire l'applicazione.

## Utilizzo
<a name="sam-cli-command-reference-sam-package-usage"></a>

```
$ sam package <arguments> <options>
```

## Arguments (Argomenti)
<a name="sam-cli-command-reference-sam-package-args"></a>

**Resource ID (ID risorsa)**  <a name="sam-cli-command-reference-sam-package-args-resource-id"></a>
L'ID della funzione Lambda da impacchettare.  
Questo argomento è facoltativo. Se l'applicazione contiene una singola funzione Lambda, la AWS SAM CLI la impacchetterà. Se l'applicazione contiene più funzioni, fornisci l'ID della funzione per impacchettare una singola funzione.  
*Valori validi*: l'ID logico o l'ARN della risorsa.

## Opzioni
<a name="sam-cli-command-reference-sam-package-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-package-options-config-env"></a>
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-package-options-config-file"></a>
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è «samconfig.toml» nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-package-options-debug"></a>
Attiva la registrazione di debug per stampare il messaggio di debug generato dai timestamp e visualizzarli. AWS SAMCLI

`--force-upload`  <a name="sam-cli-command-reference-sam-package-options-force-upload"></a>
Sostituisci i file esistenti nel bucket Amazon S3. Specificate questo flag per caricare gli artefatti anche se corrispondono agli artefatti esistenti nel bucket Amazon S3.

`--help`  <a name="sam-cli-command-reference-sam-package-options-help"></a>
Mostra questo messaggio ed esce.

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-package-options-image-repository"></a>
L'URI del repository Amazon Elastic Container Registry (Amazon ECR) in cui questo comando carica l'immagine della funzione. Obbligatorio per le funzioni dichiarate con il `Image` tipo di pacchetto.

`--kms-key-id TEXT`  <a name="sam-cli-command-reference-sam-package-options-kms-key-id"></a>
L'ID di una chiave AWS Key Management Service (AWS KMS) utilizzata per crittografare gli artefatti che sono a riposo nel bucket Amazon S3. Se questa opzione non è specificata, AWS SAM utilizza le chiavi di crittografia gestite da Amazon S3.

`--metadata`  <a name="sam-cli-command-reference-sam-package-options-metadata"></a>
(Facoltativo) Una mappa di metadati da allegare a tutti gli artefatti a cui si fa riferimento nel modello.

`--no-progressbar`  <a name="sam-cli-command-reference-sam-package-options-no-progressbar"></a>
Non visualizzare una barra di avanzamento durante il caricamento di artefatti su Amazon S3.

`--output-template-file PATH`  <a name="sam-cli-command-reference-sam-package-options-output-template-file"></a>
Il percorso del file in cui il comando scrive il modello confezionato. Se non specificate un percorso, il comando scrive il modello nello standard output.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-package-options-profile"></a>
Il profilo specifico del file delle credenziali che ottiene le AWS credenziali.

`--region TEXT`  <a name="sam-cli-command-reference-sam-package-options-region"></a>
La AWS regione in cui effettuare la distribuzione. Ad esempio, us-east-1.

`--resolve-s3`  <a name="sam-cli-command-reference-sam-package-options-resolve-s3"></a>
Crea automaticamente un bucket Amazon S3 da utilizzare per il packaging. Se specifichi entrambe le `--resolve-s3` opzioni `--s3-bucket` e, si verificherà un errore.

`--s3-bucket TEXT`  <a name="sam-cli-command-reference-sam-package-options-s3-bucket"></a>
Il nome del bucket Amazon S3 in cui questo comando carica il tuo artefatto. Se il tuo artefatto è più grande di 51.200 byte, è richiesta l'opzione o l'opzione. `--s3-bucket` `--resolve-s3` Se si specificano entrambe le `--resolve-s3` opzioni `--s3-bucket` e, si verificherà un errore.

`--s3-prefix TEXT`  <a name="sam-cli-command-reference-sam-package-options-s3-prefix"></a>
Prefisso aggiunto al nome degli artefatti che vengono caricati nel bucket Amazon S3. Il nome del prefisso è un nome di percorso (nome della cartella) per il bucket Amazon S3. Questo vale solo per le funzioni dichiarate con `Zip` il tipo di pacchetto.

`--save-params`  <a name="sam-cli-command-reference-sam-package-options-save-params"></a>
Salva i parametri forniti dalla riga di comando nel file AWS SAM di configurazione.

`--signing-profiles LIST`  <a name="sam-cli-command-reference-sam-package-options-signing-profiles"></a>
(Facoltativo) L'elenco dei profili di firma con cui firmare i pacchetti di distribuzione. Questo parametro accetta un elenco di coppie chiave-valore, in cui la chiave è il nome della funzione o del livello da firmare e il valore è il profilo di firma, con un proprietario del profilo opzionale delimitato da. `:` Ad esempio, `FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner`.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-package-options-template-file"></a>
Il percorso e il nome del file in cui si trova il AWS SAM modello.  
Se si specifica questa opzione, AWS SAM impacchetta solo il modello e le risorse locali a cui punta.

`--use-json`  <a name="sam-cli-command-reference-sam-package-options-use-json"></a>
Esporta JSON per il CloudFormation modello. Per impostazione predefinita, viene utilizzato YAML.

## Esempio
<a name="sam-cli-command-reference-sam-package-examples"></a>

L'esempio seguente crea e impacchetta artefatti per una funzione e applicazioni Lambda. CodeDeploy Gli artefatti vengono caricati in un bucket Amazon S3. L'output del comando è un nuovo file denominato `package.yml`.

```
$ sam package \
  --template-file template.yml \
  --output-template-file package.yml \
  --s3-bucket amzn-s3-demo-bucket
```