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 sync
<a name="sam-cli-command-reference-sam-sync"></a>

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)`sam sync`.
+ Per un'introduzione a AWS SAMCLI, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Per la documentazione sull'utilizzo di AWS SAMCLI, vedere[AWS SAM CLI](using-sam-cli.md).

Il `sam sync` comando sincronizza le modifiche dell'applicazione locale con. Cloud AWS

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

```
$ sam sync <options>
```

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

`--base-dir, -s DIRECTORY`  <a name="sam-cli-command-reference-sam-sync-options-base-dir"></a>
Risolve i percorsi relativi al codice sorgente della funzione o del livello rispetto a questa directory. Utilizzate questa opzione per modificare il modo in cui vengono risolti i percorsi relativi alle cartelle del codice sorgente. Per impostazione predefinita, i percorsi relativi vengono risolti rispetto alla posizione del AWS SAM modello.  
Oltre alle risorse nell'applicazione root o nello stack che stai creando, questa opzione si applica anche alle applicazioni o agli stack annidati. Inoltre, questa opzione si applica ai seguenti tipi e proprietà di risorse:  
+ Tipo di risorsa: `AWS::Serverless::Function` Proprietà: `CodeUri`
+ Tipo di risorsa: Attributo della `AWS::Serverless::Function` risorsa: `Metadata` Voce: `DockerContext`
+ Tipo di risorsa: `AWS::Serverless::LayerVersion` Proprietà: `ContentUri`
+ Tipo di risorsa: `AWS::Lambda::Function` Proprietà: `Code`
+ Tipo di risorsa: `AWS::Lambda::LayerVersion` Proprietà: `Content`

`--build-image TEXT`  <a name="sam-cli-command-reference-sam-sync-options-build-image"></a>
L'URI per l'[immagine del contenitore](serverless-image-repositories.md#serverless-image-repository-uris) che desideri utilizzare durante la creazione dell'applicazione. Per impostazione predefinita, AWS SAM utilizza l'URI del repository di immagini del contenitore di [Amazon Elastic Container Registry (Amazon ECR) Public](https://docs.aws.amazon.com/AmazonECR/latest/public/what-is-ecr.html). Specificate questa opzione per utilizzare un'immagine diversa.  
È possibile utilizzare questa opzione più volte in un unico comando. Ogni opzione accetta una stringa o una coppia chiave-valore.  
+ **Stringa**: specifica l'URI dell'immagine del contenitore che verranno utilizzate da tutte le risorse dell'applicazione. Di seguito è riportato un esempio:

  ```
  $ sam sync --build-image amazon/aws-sam-cli-build-image-python3.8
  ```
+ **Coppia chiave-valore**: specifica il nome della risorsa come chiave e l'URI dell'immagine del contenitore da utilizzare con quella risorsa come valore. Utilizzate questo formato per specificare un URI di immagine del contenitore diverso per ogni risorsa dell'applicazione. Di seguito è riportato un esempio:

  ```
  $ sam sync --build-image Function1=amazon/aws-sam-cli-build-image-python3.8
  ```
Questa opzione si applica solo se l'`--use-container`opzione è specificata, altrimenti si verificherà un errore.

`--build-in-source | --no-build-in-source`  <a name="sam-cli-command-reference-sam-sync-options-build-in-source"></a>
Fornisce `--build-in-source` la possibilità di creare il progetto direttamente nella cartella dei sorgenti.  
L'`--build-in-source`opzione supporta i seguenti runtime e metodi di compilazione:  
+ **Runtime**: qualsiasi Node.js runtime supportato dall'`sam init --runtime`opzione.
+ **Metodi di compilazione**:`Makefile`,`esbuild`.
L'`--build-in-source`opzione non è compatibile con le seguenti opzioni:  
+ `--use-container `
*Default*: `--no-build-in-source`

`--capabilities LIST`  <a name="sam-cli-command-reference-sam-sync-options-capabilities"></a>
Un elenco di funzionalità specificate per consentire la creazione CloudFormation di determinati stack. Alcuni modelli di stack potrebbero includere risorse che possono influire sulle autorizzazioni del tuo. Account AWS Ad esempio, creando nuovi utenti AWS Identity and Access Management (IAM). Specificate questa opzione per sovrascrivere i valori predefiniti. I valori validi includono quanto segue:  
+ CAPABILITY\$1IAM
+ CAPABILITY\$1NAMED\$1IAM
+ POLITICA DELLE RISORSE IN MATERIA DI CAPACITÀ
+ CAPABILITY\$1AUTO\$1EXPAND
*Predefinito: e* `CAPABILITY_NAMED_IAM` `CAPABILITY_AUTO_EXPAND`

`--code`  <a name="sam-cli-command-reference-sam-sync-options-code"></a>
Per impostazione predefinita, AWS SAM sincronizza tutte le risorse dell'applicazione. Specificate questa opzione per sincronizzare solo le risorse di codice, che includono quanto segue:  
+ `AWS::Serverless::Function`
+ `AWS::Lambda::Function`
+ `AWS::Serverless::LayerVersion`
+ `AWS::Lambda::LayerVersion`
+ `AWS::Serverless::Api`
+ `AWS::ApiGateway::RestApi`
+ `AWS::Serverless::HttpApi`
+ `AWS::ApiGatewayV2::Api`
+ `AWS::Serverless::StateMachine`
+ `AWS::StepFunctions::StateMachine`
Per sincronizzare le risorse di codice, AWS SAM utilizza APIs direttamente il AWS servizio, anziché distribuirlo tramite AWS CloudFormation. Per aggiornare il tuo CloudFormation stack, **sam sync --watch** esegui o. **sam deploy**

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-sync-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-sync-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).

`--dependency-layer | --no-dependency-layer`  <a name="sam-cli-command-reference-sam-sync-options-dependency-layer"></a>
Speciifica se separare le dipendenze delle singole funzioni in un altro livello per accelerare il processo di sincronizzazione.  
*Default*: `--dependency-layer`

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-sync-options-image-repository"></a>
Il nome 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.

`--image-repositories TEXT`  <a name="sam-cli-command-reference-sam-sync-options-image-repositories"></a>
Una mappatura delle funzioni sull'URI del loro repository Amazon ECR. Funzioni di riferimento in base al relativo ID logico. Di seguito è riportato un esempio:  

```
$ sam sync --image-repositories Function1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repo
```
È possibile specificare questa opzione più volte in un unico comando.

`--kms-key-id TEXT`  <a name="sam-cli-command-reference-sam-sync-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 non specifichi questa opzione, AWS SAM utilizza le chiavi di crittografia gestite da Amazon S3.

`--metadata`  <a name="sam-cli-command-reference-sam-sync-options-metadata"></a>
Una mappa di metadati da allegare a tutti gli artefatti a cui fai riferimento nel modello.

`--notification-arns LIST`  <a name="sam-cli-command-reference-sam-sync-options-notification-arns"></a>
Un elenco di ARNs argomenti relativi a Amazon Simple Notification Service (Amazon SNS) associati allo CloudFormation stack.

`--no-use-container`  <a name="ref-sam-cli-sync-options-no-use-container"></a>
Un'opzione che consente di utilizzare il toolkit IDE per impostare il comportamento predefinito.

`--parameter-overrides`  <a name="sam-cli-command-reference-sam-sync-options-parameter-overrides"></a>
Una stringa che contiene le sostituzioni CloudFormation dei parametri codificate come coppie chiave-valore. Utilizzate lo stesso formato di (). AWS Command Line Interface AWS CLI Il AWS SAMCLI formato è costituito da parole chiave e valori esplicite, ogni override è separata da uno spazio. Di seguito, sono riportati due esempi:  
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world`
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana`

`--resource TEXT`  <a name="sam-cli-command-reference-sam-sync-options-resource"></a>
Speciifica il tipo di risorsa da sincronizzare. Per sincronizzare più risorse, è possibile specificare questa opzione più volte. Questa opzione è supportata dall'`--code`opzione. Il valore deve essere una delle risorse elencate sotto`--code`. Ad esempio, `--resource AWS::Serverless::Function --resource AWS::Serverless::LayerVersion`.

`--resource-id TEXT`  <a name="sam-cli-command-reference-sam-sync-options-resource-id"></a>
Speciifica l'ID della risorsa da sincronizzare. Per sincronizzare più risorse, è possibile specificare questa opzione più volte. Questa opzione è supportata dall'`--code`opzione. Ad esempio, `--resource-id Function1 --resource-id Function2`.

`--role-arn TEXT`  <a name="sam-cli-command-reference-sam-sync-options-role-arn"></a>
L'Amazon Resource Name (ARN) di un ruolo IAM che CloudFormation assume quando si applica il changeset.

`--s3-bucket TEXT`  <a name="sam-cli-command-reference-sam-sync-options-s3-bucket"></a>
Il nome del bucket Amazon Simple Storage Service (Amazon S3) in cui questo comando carica il modello. CloudFormation Se il modello è più grande di 51.200 byte, è richiesta l'opzione o l'`--s3-bucket`opzione. `--resolve-s3` Se si specificano entrambe le `--resolve-s3` opzioni `--s3-bucket` e, si verifica un errore.

`--s3-prefix TEXT`  <a name="sam-cli-command-reference-sam-sync-options-s3-prefix"></a>
Il prefisso aggiunto ai nomi degli artefatti 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 il `Zip` tipo di pacchetto.

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

`--skip-deploy-sync | --no-skip-deploy-sync`  <a name="sam-cli-command-reference-sam-sync-options-skip-deploy-sync"></a>
Specifica `--skip-deploy-sync` di saltare la sincronizzazione iniziale dell'infrastruttura se non è richiesta. AWS SAMCLIConfronterà il AWS SAM modello locale con il CloudFormation modello distribuito ed eseguirà una distribuzione solo se viene rilevata una modifica.  
Specifica `--no-skip-deploy-sync` di eseguire una CloudFormation distribuzione ogni volta che `sam sync` viene eseguita.  
Per ulteriori informazioni, consulta [Salta la distribuzione iniziale CloudFormation](using-sam-cli-sync.md#using-sam-cli-sync-options-skip-deploy-sync).  
*Default*: `--skip-deploy-sync`

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-sync-options-stack-name"></a>
Il nome dello CloudFormation stack per l'applicazione.  
Questa opzione è obbligatoria.

`--tags LIST`  <a name="sam-cli-command-reference-sam-sync-options-tags"></a>
Un elenco di tag da associare allo stack creato o aggiornato. CloudFormation propaga inoltre questi tag alle risorse dello stack che li supportano.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-sync-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 distribuisce solo il modello e le risorse locali a cui punta.

`--use-container, -u`  <a name="sam-cli-command-reference-sam-sync-options-use-container"></a>
Se le tue funzioni dipendono da pacchetti che hanno dipendenze compilate in modo nativo, usa questa opzione per creare la tua funzione all'interno di un AWS Lambda contenitore simile a -like. Docker  
Attualmente, questa opzione non è compatibile con. `--dependency-layer` Se usi `--use-container` con`--dependency-layer`, ti AWS SAMCLI informa e continua con`--no-dependency-layer`.

`--watch`  <a name="sam-cli-command-reference-sam-sync-options-watch"></a>
Avvia un processo che controlla le modifiche apportate all'applicazione locale e le sincronizza automaticamente con. Cloud AWS Per impostazione predefinita, quando si specifica questa opzione, AWS SAM sincronizza tutte le risorse dell'applicazione durante l'aggiornamento. Con questa opzione, AWS SAM esegue una CloudFormation distribuzione iniziale. Quindi, AWS SAM utilizza il AWS servizio APIs per aggiornare le risorse del codice. AWS SAM utilizza CloudFormation per aggiornare le risorse dell'infrastruttura quando si aggiorna il AWS SAM modello.

`--watch-exclude TEXT`  <a name="sam-cli-command-reference-sam-sync-options-watch-exclude"></a>
Esclude un file o una cartella dall'osservazione delle modifiche apportate ai file. Per utilizzare questa opzione, è `--watch` necessario fornire anche questa opzione.  
Questa opzione riceve una coppia chiave-valore:  
+ **Chiave**: l'ID logico di una funzione Lambda nell'applicazione.
+ **Valore**: il nome o la cartella del file associato da escludere.
Quando si aggiornano i file o le cartelle specificati con l'`--watch-exclude`opzione, AWS SAM CLI la sincronizzazione non viene avviata. Tuttavia, quando un aggiornamento ad altri file o cartelle avvia una sincronizzazione, tali file o cartelle verranno inclusi in tale sincronizzazione.  
È possibile fornire questa opzione più volte in un unico comando.

## Esempi
<a name="sam-cli-command-reference-sam-sync-examples"></a>

Per esempi sull'utilizzo di questo comando, fare riferimento a[Opzioni per il comando sam sync](using-sam-cli-sync.md#using-sam-cli-sync-options).