sam remote invoke

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)sam remote invoke.

• Per un'introduzione a AWS SAMCLI, vedereChe cos'è il? AWS SAMCLI.

• Per la documentazione sull'uso del AWS SAMCLI sam remote invoke comando, vedereIntroduzione ai test nel cloud con sam remote invoke.

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): l'ARN della risorsa.

  Suggerimento

  sam list stack-outputs --stack-name <stack-name>Utilizzalo per ottenere l'ARN delle 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 ARN o un ID fisico:

Se fornisci un ARN o un ID fisico, non fornire un nome dello stack. 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 dello stack. AWS CloudFormation

Quando non fornisci un ID di risorsa:

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

1. AWS SAM CLIIdentificherà 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 nello stack, la AWS SAM CLI richiamerà. Se nello stack sono presenti più risorse dello stesso tipo di risorsa, AWS SAM CLI verrà restituito un errore.

Di seguito sono riportati alcuni esempi di ciò che AWS SAM CLI farà:

• Stack che contiene due funzioni Lambda e una coda Amazon SQS: 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 AWS SAM CLI: individuerà la funzione Lambda e la richiamerà poiché lo stack contiene una singola risorsa Lambda.

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

Opzioni

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

Consenti o nega le funzionalità beta.

--config-env TEXT

Specificate l'ambiente da utilizzare dal file AWS SAMCLI 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 SAMCLI

--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'output SDK 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

Boto3Parametri aggiuntivi 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:

• Lambda con risposta bufferizzata — lambda.client.Invoke

• Lambda con streaming di risposte — lambda.client.invoke_with_response_stream

Amazon Simple Queue Service (Amazon SQS)

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

• 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, vedere 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.