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 local invoke
Questa pagina fornisce informazioni di riferimento per l'interfaccia a riga di AWS Serverless Application Model comando (AWS SAM CLI) sam local invoke
sottocomando.
-
Per un'introduzione al AWS SAM CLI, vedi Che cos'è il AWS SAM CLI?
-
Per la documentazione sull'utilizzo di AWS SAM CLI
sam local invoke
sottocomando, vedereIntroduzione ai test con sam local invoke.
Il sam local invoke
sottocomando avvia una chiamata una tantum di una funzione localmente. AWS Lambda
Utilizzo
$
sam local invoke
<arguments>
<options>
Nota
Se hai più di una funzione definita nel tuo AWS SAM modello, fornisci l'ID logico della funzione che desideri richiamare.
Argomenti
- ID risorsa
-
L'ID della funzione Lambda da richiamare.
Questo argomento è facoltativo. Se l'applicazione contiene una sola funzione Lambda, la AWS SAM CLI invocherà. Se l'applicazione contiene più funzioni, fornisci l'ID della funzione da richiamare.
Valori validi: l'ID logico o la risorsa della risorsaARN.
Opzioni
--add-host
LIST
-
Passa un nome host alla mappatura dell'indirizzo IP al file host del contenitore Docker. Questo parametro può essere passato più volte.
Esempio:
--add-host
example.com:127.0.0.1
--beta-features | --no-beta-features
-
Consenti o nega le funzionalità beta.
--config-env
TEXT
-
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.
--config-file
PATH
-
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. --container-env-vars
-
(Facoltativo) Passa le variabili di ambiente al contenitore di immagini della funzione Lambda durante il debug locale.
--container-host
TEXT
-
Host del contenitore Lambda emulato localmente. Il valore predefinito è
localhost
. Se vuoi correre AWS SAM CLI in un contenitore Docker su macOS, puoi specificare.host.docker.internal
Se desideri eseguire il contenitore su un host diverso da AWS SAM CLI, è possibile specificare l'indirizzo IP dell'host remoto. --container-host-interface
TEXT
-
L'indirizzo IP dell'interfaccia di rete host a cui devono collegarsi le porte del contenitore. Il valore predefinito è
127.0.0.1
. Si usa0.0.0.0
per collegarsi a tutte le interfacce. --debug
-
Attiva la registrazione di debug per stampare i messaggi di debug che AWS SAM CLI genera e visualizza i timestamp.
--debug-args
TEXT
-
Argomenti aggiuntivi da passare al debugger.
--debug-port, -d
TEXT
-
Quando specificato, avvia il contenitore di funzioni Lambda in modalità debug ed espone questa porta sull'host locale.
--debugger-path
TEXT
-
Il percorso dell'host di un debugger montato nel contenitore Lambda.
--docker-network
TEXT
-
Il nome o l'ID di una rete Docker esistente a cui i contenitori Lambda Docker devono connettersi, insieme alla rete bridge predefinita. Se questo non è specificato, i contenitori Lambda si connettono solo alla rete bridge Docker predefinita.
--docker-volume-basedir, -v
TEXT
-
La posizione della directory di base in cui si trova il AWS SAM file. Se Docker è in esecuzione su un computer remoto, è necessario montare il percorso in cui esiste il AWS SAM file sulla macchina Docker e modificare questo valore in modo che corrisponda al computer remoto.
--env-vars, -n
PATH
-
Il JSON file che contiene i valori per le variabili di ambiente della funzione Lambda. Per ulteriori informazioni sui file delle variabili di ambiente, vedereFile di variabili di ambiente.
--event, -e
PATH
-
Il JSON file che contiene i dati degli eventi che vengono passati alla funzione Lambda quando viene richiamata. Se non si specifica questa opzione, non si presume alcun evento. Per inserire JSON da
stdin
, devi inserire il valore '-'. Per informazioni dettagliate sui formati dei messaggi relativi agli eventi di diversi AWS servizi, consulta Lavorare con altri servizi nella Guida per gli AWS Lambda sviluppatori. --force-image-build
-
Specifica se AWS SAM CLI dovrebbe ricostruire l'immagine usata per invocare le funzioni Lambda con livelli.
--help
-
Mostra questo messaggio ed esce.
--hook-name TEXT
-
Il nome dell'hook utilizzato per estendere AWS SAM CLI funzionalità.
Valori accettati:
terraform
. --invoke-image
TEXT
-
L'immagine URI del contenitore che si desidera utilizzare per l'invocazione della funzione locale. Per impostazione predefinita, AWS SAM estrae l'immagine del contenitore da Amazon ECR Public (che è elencata inArchivi di immagini per AWS SAM). Usa questa opzione per estrarre l'immagine da un'altra posizione.
Ad esempio
sam local invoke MyFunction --invoke-image amazon/aws-sam-cli-emulation-image-python3.8
. --layer-cache-basedir
DIRECTORY
-
Specifica la posizione della directory di base in cui vengono scaricati i layer utilizzati dal modello.
--log-file, -l
TEXT
-
Il file di registro a cui inviare i log di runtime.
--no-event
-
Richiama la funzione con un evento vuoto.
--parameter-overrides
-
Una stringa che contiene AWS CloudFormation parametri sovrascritti codificati come coppie chiave-valore. Utilizzate lo stesso formato di (). AWS Command Line Interface AWS CLI La AWS SAM CLI il 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
--profile
TEXT
-
Il profilo specifico del file delle credenziali che ottiene le credenziali. AWS
--region
TEXT
-
La AWS regione in cui effettuare la distribuzione. Ad esempio, us-east-1.
--save-params
-
Salva i parametri forniti dalla riga di comando nel file di AWS SAM configurazione.
--shutdown
-
Emula un evento di spegnimento dopo il completamento dell'invocazione, per testare la gestione delle estensioni del comportamento di spegnimento.
--skip-prepare-infra
-
Salta la fase di preparazione se non sono state apportate modifiche all'infrastruttura. Utilizzare con l'
--hook-name
opzione. --skip-pull-image
-
Per impostazione predefinita, il AWS SAM CLI controlla l'ultimo ambiente di runtime remoto di Lambda e aggiorna automaticamente l'immagine locale per mantenerla sincronizzata.
Specificate questa opzione per saltare la visualizzazione della versione più recente Docker immagine per il tuo ambiente di runtime Lambda.
--template, -t
PATH
-
Il file AWS SAM modello.
Questa opzione non è compatibile con
--hook-name
.Nota
Se si specifica questa opzione, AWS SAM carica solo il modello e le risorse locali a cui punta.
--terraform-plan-file
-
Il percorso relativo o assoluto verso il locale Terraform file di piano quando si utilizza il AWS SAM CLI con Terraform Cloud. Questa opzione richiede che
--hook-name
sia impostata suterraform
.