View a markdown version of this page

Esempi di Lambda che utilizzano Tools for V5 PowerShell - AWS Esempi di codice SDK

Sono disponibili altri esempi di AWS SDK nel repository AWS Doc SDK Examples. GitHub

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à.

Esempi di Lambda che utilizzano Tools for V5 PowerShell

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Strumenti per PowerShell V5 con Lambda.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

L’esempio di codice seguente mostra come utilizzare Add-LMResourceTag.

Strumenti per V5 PowerShell

Esempio 1: aggiunge i tre tag (Washington, Oregon e California) e i relativi valori associati alla funzione specificata identificata dal relativo ARN.

Add-LMResourceTag -Resource "arn:aws:lambda:us-west-2:123456789012:function:MyFunction" -Tag @{ "Washington" = "Olympia"; "Oregon" = "Salem"; "California" = "Sacramento" }
  • Per i dettagli sull'API, vedere TagResource in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Get-LMAccountSetting.

Strumenti per V5 PowerShell

Esempio 1: questo esempio viene visualizzato per confrontare il limite dell’account e l’utilizzo dell’account

Get-LMAccountSetting | Select-Object @{Name="TotalCodeSizeLimit";Expression={$_.AccountLimit.TotalCodeSize}}, @{Name="TotalCodeSizeUsed";Expression={$_.AccountUsage.TotalCodeSize}}

Output:

TotalCodeSizeLimit TotalCodeSizeUsed ------------------ ----------------- 80530636800 15078795
  • Per i dettagli sull'API, vedere GetAccountSettings in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Get-LMAlias.

Strumenti per V5 PowerShell

Esempio 1: questo esempio recupera i pesi di configurazione del routing per uno specifico alias della funzione Lambda.

Get-LMAlias -FunctionName "MylambdaFunction123" -Name "newlabel1" -Select RoutingConfig

Output:

AdditionalVersionWeights ------------------------ {[1, 0.6]}
  • Per i dettagli sull'API, vedere GetAlias in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Get-LMFunctionConcurrency.

Strumenti per V5 PowerShell

Esempio 1: questo esempio ottiene la simultaneità riservata per la funzione Lambda

Get-LMFunctionConcurrency -FunctionName "MylambdaFunction123" -Select *

Output:

ReservedConcurrentExecutions ---------------------------- 100

L’esempio di codice seguente mostra come utilizzare Get-LMFunctionConfiguration.

Strumenti per V5 PowerShell

Esempio 1: questo esempio recupera la configurazione specifica della versione di una funzione Lambda.

Get-LMFunctionConfiguration -FunctionName "MylambdaFunction123" -Qualifier "PowershellAlias"

Output:

CodeSha256 : uWOW0R7z+f0VyLuUg7+/D08hkMFsq0SF4seuyUZJ/R8= CodeSize : 1426 DeadLetterConfig : Amazon.Lambda.Model.DeadLetterConfig Description : Verson 3 to test Aliases Environment : Amazon.Lambda.Model.EnvironmentResponse FunctionArn : arn:aws:lambda:us-east-1:123456789012:function:MylambdaFunction123 :PowershellAlias FunctionName : MylambdaFunction123 Handler : lambda_function.launch_instance KMSKeyArn : LastModified : 2019-12-25T09:52:59.872+0000 LastUpdateStatus : Successful LastUpdateStatusReason : LastUpdateStatusReasonCode : Layers : {} MasterArn : MemorySize : 128 RevisionId : 5d7de38b-87f2-4260-8f8a-e87280e10c33 Role : arn:aws:iam::123456789012:role/service-role/lambda Runtime : python3.8 State : Active StateReason : StateReasonCode : Timeout : 600 TracingConfig : Amazon.Lambda.Model.TracingConfigResponse Version : 4 VpcConfig : Amazon.Lambda.Model.VpcConfigDetail

L’esempio di codice seguente mostra come utilizzare Get-LMFunctionList.

Strumenti per V5 PowerShell

Esempio 1: questo esempio mostra tutte le funzioni Lambda con dimensioni di codice ordinate

Get-LMFunctionList | Sort-Object -Property CodeSize | Select-Object FunctionName, RunTime, Timeout, CodeSize

Output:

FunctionName Runtime Timeout CodeSize ------------ ------- ------- -------- test python2.7 3 243 MylambdaFunction123 python3.8 600 659 myfuncpython1 python3.8 303 675
  • Per i dettagli sull'API, vedere ListFunctions in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Get-LMPolicy.

Strumenti per V5 PowerShell

Esempio 1: questo esempio mostra la policy delle funzioni della funzione Lambda

Get-LMPolicy -FunctionName test -Select Policy

Output:

{"Version":"2012-10-17","Id":"default","Statement":[{"Sid":"xxxx","Effect":"Allow","Principal":{"Service":"sns.amazonaws.com"},"Action":"lambda:InvokeFunction","Resource":"arn:aws:lambda:us-east-1:123456789102:function:test"}]}
  • Per i dettagli sull'API, vedere GetPolicy in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Get-LMProvisionedConcurrencyConfig.

Strumenti per V5 PowerShell

Esempio 1: questo esempio ottiene la configurazione di simultaneità fornita per l’alias specificato della funzione Lambda.

C:\>Get-LMProvisionedConcurrencyConfig -FunctionName "MylambdaFunction123" -Qualifier "NewAlias1"

Output:

AllocatedProvisionedConcurrentExecutions : 0 AvailableProvisionedConcurrentExecutions : 0 LastModified : 2020-01-15T03:21:26+0000 RequestedProvisionedConcurrentExecutions : 70 Status : IN_PROGRESS StatusReason :

L’esempio di codice seguente mostra come utilizzare Get-LMProvisionedConcurrencyConfigList.

Strumenti per V5 PowerShell

Esempio 1: questo esempio recupera l’elenco di configurazioni di simultaneità fornita per una funzione Lambda.

Get-LMProvisionedConcurrencyConfigList -FunctionName "MylambdaFunction123"

L’esempio di codice seguente mostra come utilizzare Get-LMResourceTag.

Strumenti per V5 PowerShell

Esempio 1: recupera i tag e i relativi valori attualmente impostati sulla funzione specificata.

Get-LMResourceTag -Resource "arn:aws:lambda:us-west-2:123456789012:function:MyFunction"

Output:

Key Value --- ----- California Sacramento Oregon Salem Washington Olympia
  • Per i dettagli sull'API, vedere ListTags in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Get-LMVersionsByFunction.

Strumenti per V5 PowerShell

Esempio 1: questo esempio restituisce l’elenco di configurazioni specifiche della versione per ogni versione della funzione Lambda.

Get-LMVersionsByFunction -FunctionName "MylambdaFunction123"

Output:

FunctionName Runtime MemorySize Timeout CodeSize LastModified RoleName ------------ ------- ---------- ------- -------- ------------ -------- MylambdaFunction123 python3.8 128 600 659 2020-01-10T03:20:56.390+0000 lambda MylambdaFunction123 python3.8 128 5 1426 2019-12-25T09:19:02.238+0000 lambda MylambdaFunction123 python3.8 128 5 1426 2019-12-25T09:39:36.779+0000 lambda MylambdaFunction123 python3.8 128 600 1426 2019-12-25T09:52:59.872+0000 lambda

L’esempio di codice seguente mostra come utilizzare New-LMAlias.

Strumenti per V5 PowerShell

Esempio 1: questo esempio crea un nuovo alias Lambda per la versione e la configurazione di routing specificate per specificare la percentuale di richieste di invocazione ricevute.

New-LMAlias -FunctionName "MylambdaFunction123" -RoutingConfig_AdditionalVersionWeight @{Name="1";Value="0.6} -Description "Alias for version 4" -FunctionVersion 4 -Name "PowershellAlias"
  • Per i dettagli sull'API, vedere CreateAlias in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Publish-LMFunction.

Strumenti per V5 PowerShell

Esempio 1: questo esempio crea una nuova funzione C# (dotnetcore1.0 runtime) denominata MyFunction in AWS Lambda, fornendo i binari compilati per la funzione da un file zip sul file system locale (possono essere usati percorsi relativi o assoluti). Le funzioni C# Lambda specificano il gestore della funzione utilizzando la designazione AssemblyName::::. Namespace.ClassName MethodName È necessario sostituire in modo appropriato le parti relative al nome dell'assembly (senza il suffisso .dll), al namespace, al nome della classe e al nome del metodo delle specifiche dell'handler. La nuova funzione avrà le variabili di ambiente ’envvar1’ e ’envvar2’ impostate in base ai valori forniti.

Publish-LMFunction -Description "My C# Lambda Function" ` -FunctionName MyFunction ` -ZipFilename .\MyFunctionBinaries.zip ` -Handler "AssemblyName::Namespace.ClassName::MethodName" ` -Role "arn:aws:iam::123456789012:role/LambdaFullExecRole" ` -Runtime dotnetcore1.0 ` -Environment_Variable @{ "envvar1"="value";"envvar2"="value" }

Output:

CodeSha256 : /NgBMd...gq71I= CodeSize : 214784 DeadLetterConfig : Description : My C# Lambda Function Environment : Amazon.Lambda.Model.EnvironmentResponse FunctionArn : arn:aws:lambda:us-west-2:123456789012:function:ToUpper FunctionName : MyFunction Handler : AssemblyName::Namespace.ClassName::MethodName KMSKeyArn : LastModified : 2016-12-29T23:50:14.207+0000 MemorySize : 128 Role : arn:aws:iam::123456789012:role/LambdaFullExecRole Runtime : dotnetcore1.0 Timeout : 3 Version : $LATEST VpcConfig :

Esempio 2: questo esempio è simile a quello precedente, tranne per il fatto che i binari delle funzioni vengono prima caricati in un bucket Amazon S3 (che deve trovarsi nella stessa regione della funzione Lambda prevista) e l’oggetto S3 risultante viene quindi referenziato durante la creazione della funzione.

Write-S3Object -BucketName amzn-s3-demo-bucket -Key MyFunctionBinaries.zip -File .\MyFunctionBinaries.zip Publish-LMFunction -Description "My C# Lambda Function" ` -FunctionName MyFunction ` -BucketName amzn-s3-demo-bucket ` -Key MyFunctionBinaries.zip ` -Handler "AssemblyName::Namespace.ClassName::MethodName" ` -Role "arn:aws:iam::123456789012:role/LambdaFullExecRole" ` -Runtime dotnetcore1.0 ` -Environment_Variable @{ "envvar1"="value";"envvar2"="value" }
  • Per i dettagli sull'API, vedere CreateFunction in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Publish-LMVersion.

Strumenti per V5 PowerShell

Esempio 1: questo esempio crea una versione per lo snapshot esistente del codice funzione Lambda

Publish-LMVersion -FunctionName "MylambdaFunction123" -Description "Publishing Existing Snapshot of function code as a new version through Powershell"
  • Per i dettagli sull'API, vedere PublishVersion in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Remove-LMAlias.

Strumenti per V5 PowerShell

Esempio 1: questo esempio elimina l’alias della funzione Lambda menzionato nel comando.

Remove-LMAlias -FunctionName "MylambdaFunction123" -Name "NewAlias"
  • Per i dettagli sull'API, vedere DeleteAlias in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Remove-LMFunction.

Strumenti per V5 PowerShell

Esempio 1: questo esempio elimina una versione specifica di una funzione Lambda

Remove-LMFunction -FunctionName "MylambdaFunction123" -Qualifier '3'
  • Per i dettagli sull'API, vedere DeleteFunction in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Remove-LMFunctionConcurrency.

Strumenti per V5 PowerShell

Esempio 1: questo esempio rimuove la simultaneità della funzione dalla funzione Lambda.

Remove-LMFunctionConcurrency -FunctionName "MylambdaFunction123"

L’esempio di codice seguente mostra come utilizzare Remove-LMPermission.

Strumenti per V5 PowerShell

Esempio 1: questo esempio rimuove i criteri StatementId di funzione per la funzione Lambda specificata.

$policy = Get-LMPolicy -FunctionName "MylambdaFunction123" -Select Policy | ConvertFrom-Json| Select-Object -ExpandProperty Statement Remove-LMPermission -FunctionName "MylambdaFunction123" -StatementId $policy[0].Sid
  • Per i dettagli sull'API, vedere RemovePermission in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Remove-LMProvisionedConcurrencyConfig.

Strumenti per V5 PowerShell

Esempio 1: questo esempio rimuove la configurazione della simultaneità fornita per un alias specifico.

Remove-LMProvisionedConcurrencyConfig -FunctionName "MylambdaFunction123" -Qualifier "NewAlias1"

L’esempio di codice seguente mostra come utilizzare Remove-LMResourceTag.

Strumenti per V5 PowerShell

Esempio 1: rimuove i tag forniti da una funzione. Il cmdlet richiederà una conferma prima di procedere, a meno che non venga specificato lo switch -Force. Viene effettuata una sola chiamata al servizio per rimuovere i tag.

Remove-LMResourceTag -Resource "arn:aws:lambda:us-west-2:123456789012:function:MyFunction" -TagKey "Washington","Oregon","California"

Esempio 2: rimuove i tag forniti da una funzione. Il cmdlet richiederà una conferma prima di procedere, a meno che non venga specificato lo switch -Force. Una volta effettuata la chiamata al servizio per tag fornito.

"Washington","Oregon","California" | Remove-LMResourceTag -Resource "arn:aws:lambda:us-west-2:123456789012:function:MyFunction"
  • Per i dettagli sull'API, vedere UntagResource in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Update-LMAlias.

Strumenti per V5 PowerShell

Esempio 1: questo esempio aggiorna la configurazione di un alias di funzione Lambda esistente. Aggiorna il RoutingConfiguration valore per spostare il 60% (0,6) del traffico alla versione 1

Update-LMAlias -FunctionName "MylambdaFunction123" -Description " Alias for version 2" -FunctionVersion 2 -Name "newlabel1" -RoutingConfig_AdditionalVersionWeight @{Name="1";Value="0.6}
  • Per i dettagli sull'API, vedere UpdateAlias in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Update-LMFunctionCode.

Strumenti per V5 PowerShell

Esempio 1: aggiorna la funzione denominata MyFunction '' con il nuovo contenuto contenuto nel file zip specificato. Per una funzione Lambda C# .NET Core, il file zip deve contenere l’assembly compilato.

Update-LMFunctionCode -FunctionName MyFunction -ZipFilename .\UpdatedCode.zip

Esempio 2: questo esempio è simile a quello precedente ma utilizza un oggetto Amazon S3 contenente il codice aggiornato per aggiornare la funzione.

Update-LMFunctionCode -FunctionName MyFunction -BucketName amzn-s3-demo-bucket -Key UpdatedCode.zip
  • Per i dettagli sull'API, vedere UpdateFunctionCode in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Update-LMFunctionConfiguration.

Strumenti per V5 PowerShell

Esempio 1: questo esempio aggiorna la configurazione della funzione Lambda esistente

Update-LMFunctionConfiguration -FunctionName "MylambdaFunction123" -Handler "lambda_function.launch_instance" -Timeout 600 -Environment_Variable @{ "envvar1"="value";"envvar2"="value" } -Role arn:aws:iam::123456789101:role/service-role/lambda -DeadLetterConfig_TargetArn arn:aws:sns:us-east-1: 123456789101:MyfirstTopic

L’esempio di codice seguente mostra come utilizzare Write-LMFunctionConcurrency.

Strumenti per V5 PowerShell

Esempio 1: questo esempio applica le impostazioni di simultaneità per l’intera funzione.

Write-LMFunctionConcurrency -FunctionName "MylambdaFunction123" -ReservedConcurrentExecution 100

L’esempio di codice seguente mostra come utilizzare Write-LMProvisionedConcurrencyConfig.

Strumenti per V5 PowerShell

Esempio 1: questo esempio aggiunge una configurazione di simultaneità fornita all’alias di una funzione

Write-LMProvisionedConcurrencyConfig -FunctionName "MylambdaFunction123" -ProvisionedConcurrentExecution 20 -Qualifier "NewAlias1"