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 start-api
Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model sottocomando Command Line Interface (AWS SAMCLI). sam local start-api
-
Per un'introduzione a AWS SAMCLI, vedereChe cos'è il? AWS SAMCLI.
-
Per la documentazione sull'uso del AWS SAMCLI
sam local start-api
sottocomando, vedereUso di sam local start-api.
Il sam local start-api
sottocomando esegue le AWS Lambda funzioni localmente per eseguirle tramite un host di server HTTP locale.
Utilizzo
$
sam local start-api
<options>
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 durante il debug locale.
--container-host
TEXT
-
Host del contenitore Lambda emulato localmente. Il valore predefinito è
localhost
. Se vuoi eseguirlo AWS SAMCLI in un contenitore Docker su macOS, puoi specificare.host.docker.internal
Se desideri eseguire il contenitore su un host diverso da quello AWS SAMCLI, puoi 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 il messaggio di debug generato dai timestamp e visualizzarli. AWS SAMCLI
--debug-args
TEXT
-
Argomenti aggiuntivi da passare al debugger.
--debug-function
-
Facoltativo. Specifica la funzione Lambda a cui applicare le opzioni di debug quando viene specificato.
--warm-containers
Questo parametro si applica a--debug-port
,--debugger-path
e.--debug-args
--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 host di un debugger che verrà 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 file JSON che contiene i valori per le variabili di ambiente della funzione Lambda.
--force-image-build
-
Specifica se AWS SAM CLI deve ricostruire l'immagine usata per richiamare funzioni con livelli.
--help
-
Mostra questo messaggio ed esce.
--hook-name
TEXT
-
Il nome dell'hook utilizzato per estendere le AWS SAMCLI funzionalità.
Valori accettati:
terraform
. --host
TEXT
-
Il nome host o l'indirizzo IP locale a cui collegarsi (impostazione predefinita: '127.0.0.1').
--invoke-image
TEXT
-
L'URI dell'immagine del contenitore che desideri utilizzare per le funzioni Lambda. Per impostazione predefinita, AWS SAM estrae l'immagine del contenitore da Amazon ECR Public. Usa questa opzione per estrarre l'immagine da un'altra posizione.
Puoi specificare questa opzione più volte. Ogni istanza di questa opzione può accettare una stringa o una coppia chiave-valore. Se specificate una stringa, è l'URI dell'immagine del contenitore da utilizzare per tutte le funzioni dell'applicazione. Ad esempio,
sam local start-api --invoke-image public.ecr.aws/sam/emu-python3.8
. Se specificate una coppia chiave-valore, la chiave è il nome della risorsa e il valore è l'URI dell'immagine del contenitore da utilizzare per quella risorsa. Ad esempiosam local start-api --invoke-image public.ecr.aws/sam/emu-python3.8 --invoke-image Function1=amazon/aws-sam-cli-emulation-image-python3.8
. Con le coppie chiave-valore, è possibile specificare immagini di contenitori diverse per risorse diverse. --layer-cache-basedir
DIRECTORY
-
Specifica la posizione basedir in cui vengono scaricati i layer utilizzati dal modello.
--log-file, -l
TEXT
-
Il file di registro a cui inviare i log di runtime.
--parameter-overrides
-
Facoltativo. Una stringa che contiene le sostituzioni AWS CloudFormation dei parametri codificate come coppie chiave-valore. Usa lo stesso formato del AWS CLI—ad esempio, '=, ParameterKey = =KeyPairName, =t1.micro'. ParameterValue MyKey ParameterKey InstanceType ParameterValue
--port, -p
INTEGER
-
Il numero di porta locale su cui ascoltare (impostazione predefinita: '3000').
--profile
TEXT
-
Il profilo specifico del file delle credenziali che ottiene le AWS credenziali.
--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. Da utilizzare con l'
--hook-name
opzione. --skip-pull-image
-
Specifica se la CLI deve ignorare l'estrazione dell'ultima immagine Docker per il runtime Lambda.
--ssl-cert-file
PATH
-
Percorso del file del certificato SSL (impostazione predefinita: Nessuno). Quando si utilizza questa opzione, è necessario utilizzare anche l'
--ssl-key-file
opzione. --ssl-key-file
PATH
-
Percorso del file della chiave SSL (impostazione predefinita: Nessuno). Quando si utilizza questa opzione, è necessario utilizzare anche l'
--ssl-cert-file
opzione. --static-dir, -s
TEXT
-
Tutti i file di risorse statici (ad esempio, CSS/ JavaScript /HTML) che si trovano in questa directory vengono presentati in.
/
--template, -t
PATH
-
Il AWS SAM file modello.
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 del file del Terraform piano locale quando si utilizza AWS SAMCLI withTerraform Cloud. Questa opzione richiede che
--hook-name
sia impostata suterraform
. --warm-containers
[EAGER | LAZY]
-
Facoltativo. Specifica come AWS SAMCLI gestisce i contenitori per ogni funzione.
Sono disponibili due opzioni:
EAGER
: I contenitori per tutte le funzioni vengono caricati all'avvio e persistono tra le chiamate.LAZY
: I contenitori vengono caricati solo quando ogni funzione viene richiamata per la prima volta. Questi contenitori persistono per chiamate aggiuntive.