sam remote invoke - AWS Serverless Application Model
UtilizzoArgomentiOpzioni

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 remote invoke

Questa pagina fornisce informazioni di riferimento per l'interfaccia a riga di AWS Serverless Application Model comando (AWS SAM CLI) sam remote invoke comando.

Il sam remote invoke comando richiama le risorse supportate in. Cloud AWS

Utilizzo

$ sam remote invoke <arguments> <options>

Argomenti

ID risorsa

L'ID della risorsa supportata da richiamare.

Questo argomento accetta i seguenti valori:

  • Amazon Resource Name (ARN): il nome ARN della risorsa.

    Suggerimento

    sam list stack-outputs --stack-name <stack-name>Utilizzalo per ottenere ARN le tue risorse.

  • ID logico: l'ID logico della risorsa. È inoltre necessario fornire il nome AWS CloudFormation dello stack utilizzando l'--stack-nameopzione.

  • ID fisico: l'ID fisico della risorsa. Questo ID viene creato quando si distribuisce una risorsa utilizzando AWS CloudFormation.

    Suggerimento

    sam list resources --stack-name <stack-name>Utilizzalo per ottenere l'ID fisico delle tue risorse.

Quando fornisci un ID ARN o un ID fisico:

Se fornisci un ID ARN o un ID fisico, non fornire un nome di pila. Quando il nome dello stack viene fornito utilizzando l'--stack-nameopzione o quando il nome dello stack è definito nel file di configurazione, AWS SAM CLI elaborerà automaticamente l'ID della risorsa come valore ID logico dallo AWS CloudFormation stack.

Quando non fornisci un ID di risorsa:

Se non fornisci un ID di risorsa, ma fornisci un nome di stack con l'--stack-nameopzione, AWS SAM CLI tenterà di richiamare automaticamente una risorsa nello AWS CloudFormation stack utilizzando la seguente logica:

  1. La AWS SAM CLI identificherà i tipi di risorse nell'ordine seguente e passerà alla fase successiva una volta trovato il tipo di risorsa nello stack:

    1. Lambda

    2. Step Functions

    3. Amazon SQS

    4. Flussi di dati Kinesis

  2. Se il tipo di risorsa ha una sola risorsa nel tuo stack, AWS SAM CLI lo invocherà. Se nello stack sono presenti più risorse del tipo di risorsa, AWS SAM CLI restituirà un errore.

I seguenti sono esempi di cosa AWS SAM CLI farà:

  • Stack che contiene due funzioni Lambda e una coda SQS Amazon: The AWS SAM CLI individuerà il tipo di risorsa Lambda e restituirà un errore poiché lo stack contiene più di una funzione Lambda.

  • Stack che contiene una funzione Lambda e due applicazioni Amazon Kinesis Data Streams: The AWS SAM CLI individuerà la funzione Lambda e la richiamerà poiché lo stack contiene una singola risorsa Lambda.

  • Stack che contiene una singola SQS coda Amazon e due applicazioni Kinesis Data Streams: The AWS SAM CLI individuerà la SQS coda Amazon e la richiamerà poiché lo stack contiene una singola coda Amazon. SQS

Opzioni

--beta-features | --no-beta-features

Consenti o nega le funzionalità beta.

--config-env TEXT

Specificate l'ambiente da utilizzare dal AWS SAM CLI file di configurazione.

Default: default

--config-file FILENAME

Specificate il percorso e il nome del file di configurazione.

Per ulteriori informazioni sui file di configurazione, consulta Configurazione del AWS SAMCLI.

Impostazione predefinita: samconfig.toml nella radice della directory del progetto.

--debug

Attiva la registrazione di debug. Questo stampa i messaggi di debug e i timestamp generati da AWS SAM CLI.

--event, -e TEXT

L'evento da inviare alla risorsa di destinazione.

--event-file FILENAME

Il percorso di un file che contiene l'evento da inviare alla risorsa di destinazione.

--help, -h

Mostra il messaggio di aiuto ed esci.

--output [ text | json ]

Visualizza i risultati della chiamata in un formato di output specifico.

json— I metadati della richiesta e la risposta delle risorse vengono restituiti nella struttura. JSON La risposta contiene l'SDKoutput completo.

text— I metadati della richiesta vengono restituiti nella struttura del testo. La risposta della risorsa viene restituita nel formato di output della risorsa richiamata.

--parameter

aggiuntiviBoto3parametri che è possibile passare alla risorsa richiamata.

Flusso di dati Amazon Kinesis

I seguenti parametri aggiuntivi possono essere utilizzati per inserire un record nel flusso di dati Kinesis:

  • ExplicitHashKey='string'

  • PartitionKey='string'

  • SequenceNumberForOrdering='string'

  • StreamARN='string'

Per una descrizione di ogni parametro, vedi Kinesis.client.put_RECORD.

AWS Lambda

I seguenti parametri aggiuntivi possono essere utilizzati per richiamare una risorsa Lambda e ricevere una risposta bufferizzata:

  • ClientContext='base64-encoded string'

  • InvocationType='[ DryRun | Event | RequestResponse ]'

  • LogType='[ None | Tail ]'

  • Qualifier='string'

I seguenti parametri aggiuntivi possono essere utilizzati per richiamare una risorsa Lambda con streaming di risposte:

  • ClientContext='base64-encoded string'

  • InvocationType='[ DryRun | RequestResponse ]'

  • LogType='[ None | Tail ]'

  • Qualifier='string'

Per una descrizione di ogni parametro, consulta quanto segue:

Servizio Amazon Simple Queue (AmazonSQS)

I seguenti parametri aggiuntivi possono essere utilizzati per inviare un messaggio a una SQS coda Amazon:

  • DelaySeconds=integer

  • MessageAttributes='json string'

  • MessageDeduplicationId='string'

  • MessageGroupId='string'

  • MessageSystemAttributes='json string'

Per una descrizione di ogni parametro, consulta SQS.client.send_message.

AWS Step Functions

I seguenti parametri aggiuntivi possono essere utilizzati per avviare l'esecuzione di una macchina a stati:

  • name='string'

  • traceHeader='string'

Per una descrizione di ogni parametro, vedete SFN.client.start_execution.

--profile TEXT

Il profilo specifico del file di credenziali per ottenere le credenziali. AWS

--region TEXT

La Regione AWS risorsa. Ad esempio us-east-1.

--stack-name TEXT

Il nome dello AWS CloudFormation stack a cui appartiene la risorsa.

--test-event-name NAME

Il nome dell'evento di test condivisibile da passare alla funzione Lambda.

Nota

Questa opzione supporta solo le funzioni Lambda.