Sintassi della richiesta Parametri della richiesta URI:Corpo della richiesta Sintassi della risposta Elementi di risposta Errori Vedi anche

CreateFunction

Crea una funzione Lambda. Per creare una funzione, sono necessari un pacchetto di implementazione e un ruolo di esecuzione. Il pacchetto di distribuzione è un archivio file .zip o un'immagine del container che contiene il codice funzione. Il ruolo di esecuzione concede l'autorizzazione all'uso della funzioneServizi AWS, ad esempio Amazon CloudWatch Logs per lo streaming dei log e AWS X-Ray per il tracciamento delle richieste.

Imposta il tipo di pacchetto su Image se il pacchetto di implementazione è una immagine del container. Per un'immagine del container, la proprietà del codice deve includere l'URI di un'immagine del container nel registro di Amazon ECR. Non è necessario specificare le proprietà del gestore e del runtime.

Imposta il tipo di pacchetto su Zip, se il pacchetto di implementazione è un archivio di file .zip. Per un archivio di file .zip, la proprietà del codice specifica il percorso del file zip. È inoltre necessario specificare le proprietà del gestore e del runtime. Il codice nel pacchetto di implementazione deve essere compatibile con l'architettura del set di istruzioni di destinazione della funzione (x86-64 o arm64). Se non specifichi l'architettura, allora il valore predefinito è x86-64.

Quando si crea una funzione, Lambda assegna un'istanza della funzione e le sue risorse di supporto. Se la funzione si connette a un VPC, questo processo potrebbe richiedere circa un minuto. Durante questo periodo, non puoi richiamare o modificare la funzione. I campi State, StateReason e StateReasonCode della risposta da GetFunctionConfiguration indicano quando la funzione è pronta per essere richiamata. Per ulteriori informazioni, consulta Stati delle funzioni Lambda.

Una funzione ha una versione non pubblicata e può avere versioni pubblicate e alias. La versione non pubblicata cambia quando si aggiorna il codice e la configurazione della funzione. Una versione pubblicata è uno snapshot del codice della funzione e della configurazione che non può essere modificato. Un alias è una risorsa con nome che viene mappata a una versione e può essere modificata e mappata a una versione diversa. Utilizza il parametro Publish per creare la versione 1 della funzione dalla sua configurazione iniziale.

Gli altri parametri consentono di configurare impostazioni specifiche della versione e a livello di funzione. È possibile modificare le impostazioni specifiche della versione in un secondo momento con UpdateFunctionConfiguration. Le impostazioni a livello di funzione si applicano sia alle versioni non pubblicate che a quelle pubblicate della funzione e includono i tag (TagResource) e limiti di concorrenza per funzione (PutFunctionConcurrency).

È possibile utilizzare la firma del codice se il pacchetto di implementazione è un archivio di file con estensione .zip. Per abilitare la firma del codice per questa funzione, specifica l'ARN della configurazione di una firma del codice. Quando un utente tenta di distribuire un pacchetto di codice con UpdateFunctionCode, Lambda verifica che il pacchetto di codice abbia una firma valida da un'entità di pubblicazione. La configurazione della firma del codice include un set di profili di firma, che definiscono le entità di pubblicazione attendibili per questa funzione.

Se un altro Account AWS o un Servizio AWS richiama la funzione, utilizza AddPermission per concedere l'autorizzazione creando una policy AWS Identity and Access Management (IAM basata sulle risorse. È possibile concedere autorizzazioni a livello di funzione, di versione o di alias.

Per richiamare direttamente la funzione, utilizza Invoke. Per richiamare la funzione in risposta agli eventi in altri Servizi AWS, crea uno strumento di mappatura dell'origine degli eventi (CreateEventSourceMapping) oppure configura un trigger di funzione nell'altro servizio. Per ulteriori informazioni, consultare Richiamo delle funzioni Lambda.

Sintassi della richiesta


POST /2015-03-31/functions HTTP/1.1
Content-type: application/json

{
   "Architectures": [ "string" ],
   "Code": { 
      "ImageUri": "string",
      "S3Bucket": "string",
      "S3Key": "string",
      "S3ObjectVersion": "string",
      "ZipFile": blob
   },
   "CodeSigningConfigArn": "string",
   "DeadLetterConfig": { 
      "TargetArn": "string"
   },
   "Description": "string",
   "Environment": { 
      "Variables": { 
         "string" : "string" 
      }
   },
   "EphemeralStorage": { 
      "Size": number
   },
   "FileSystemConfigs": [ 
      { 
         "Arn": "string",
         "LocalMountPath": "string"
      }
   ],
   "FunctionName": "string",
   "Handler": "string",
   "ImageConfig": { 
      "Command": [ "string" ],
      "EntryPoint": [ "string" ],
      "WorkingDirectory": "string"
   },
   "KMSKeyArn": "string",
   "Layers": [ "string" ],
   "LoggingConfig": { 
      "ApplicationLogLevel": "string",
      "LogFormat": "string",
      "LogGroup": "string",
      "SystemLogLevel": "string"
   },
   "MemorySize": number,
   "PackageType": "string",
   "Publish": boolean,
   "Role": "string",
   "Runtime": "string",
   "SnapStart": { 
      "ApplyOn": "string"
   },
   "Tags": { 
      "string" : "string" 
   },
   "Timeout": number,
   "TracingConfig": { 
      "Mode": "string"
   },
   "VpcConfig": { 
      "Ipv6AllowedForDualStack": boolean,
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ]
   }
}

Parametri della richiesta URI:

La richiesta non utilizza parametri URI.

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

Architectures

L'architettura del set di istruzioni supportata dalla funzione. Inserisci una matrice di stringhe con uno dei valori validi (arm64 o x86_64). Il valore predefinito è x86_64.

Tipo: matrice di stringhe

Membri dell'array: numero minimo di 1 elemento.

Valori validi: x86_64 | arm64

Campo obbligatorio: no

Code

Il codice della funzione.

Tipo: oggetto FunctionCode

Campo obbligatorio: sì

CodeSigningConfigArn

Per abilitare la firma del codice per questa funzione, specifica l'ARN della configurazione di una firma del codice. Una configurazione della firma del codice include un set di profili di firma, che definiscono le entità di pubblicazione attendibili per questa funzione.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 200.

Modello: arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}

Campo obbligatorio: no

DeadLetterConfig

Una configurazione della coda DLQ che specifica la coda o l'argomento cui Lambda invia eventi asincroni quando la loro elaborazione non va a buon fine. Per ulteriori informazioni, consulta Code DLQ.

Tipo: oggetto DeadLetterConfig

Campo obbligatorio: no

Description

Una descrizione della funzione.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.

Campo obbligatorio: no

Environment

Le variabili di ambiente accessibili dal codice della funzione durante l'esecuzione.

Tipo: oggetto Environment

Campo obbligatorio: no

EphemeralStorage

Le dimensioni in MB della directory /tmp della funzione. Il valore predefinito è 512, ma può essere qualsiasi numero intero compreso tra 512 e 10.240 MB. Per ulteriori informazioni, consultare Configurazione dell'archiviazione temporanea (console).

Tipo: oggetto EphemeralStorage

Campo obbligatorio: no

FileSystemConfigs

Impostazioni di connessione per un file system Amazon EFS.

Tipo: matrice di oggetti FileSystemConfig

Membri dell'array: numero massimo di 1 elementi.

Campo obbligatorio: no

FunctionName

Il nome della funzione Lambda.

Formati di nome

Nome della funzione: my-function
ARN funzione: arn:aws:lambda:us-west-2:123456789012:function:my-function.
ARN parziale: 123456789012:function:my-function.

Il vincolo di lunghezza si applica solo all'ARN completo. Se specifichi solo il nome della funzione, questo avrà un limite di lunghezza di 64 caratteri.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 140.

Modello: (arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?

Campo obbligatorio: sì

Handler

Il nome del metodo all'interno del codice richiamato da Lambda per eseguire la funzione. È necessario il gestore se il pacchetto di implementazione è un archivio di file formato zip. Il formato include il nome del file. Può includere anche gli spazi dei nomi e altri qualificatori, a seconda del runtime. Per ulteriori informazioni, consulta Modello di programmazione Lambda.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 128.

Modello: [^\s]+

Campo obbligatorio: no

ImageConfig

Valori di configurazione di immagini di container che prevalgono sui valori del Dockerfile dell'immagine di container.

Tipo: oggetto ImageConfig

Campo obbligatorio: no

KMSKeyArn

L'ARN della chiave gestita dal cliente AWS Key Management Service (AWS KMS) utilizzata per crittografare le variabili di ambiente della funzione. Quando Lambda SnapStart è attivata, Lambda utilizza questa chiave anche per crittografare l'istantanea della funzione. Se implementi la funzione utilizzando un'immagine di container, Lambda utilizza questa chiave anche per crittografare la funzione quando viene implementata. È importante notare che non è la stessa chiave utilizzata per proteggere l'immagine di container in Amazon Elastic Container Registry (Amazon ECR). Se non specifichi una chiave gestita dal cliente, Lambda utilizza una chiave di servizio predefinita.

Tipo: stringa

Modello: (arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()

Campo obbligatorio: no

Layers

Un elenco di livelli di funzioni da aggiungere all'ambiente di esecuzione della funzione. Specificare ciascun livello in base al relativo ARN, inclusa la versione.

Tipo: matrice di stringhe

Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 140.

Modello: arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+

Campo obbligatorio: no

LoggingConfig

Le impostazioni di configurazione di Amazon CloudWatch Logs della funzione.

Tipo: oggetto LoggingConfig

Campo obbligatorio: no

MemorySize

La quantità di memoria disponibile per la funzione in fase di runtime. Se si incrementa la memoria della funzione, aumenta anche la sua allocazione di CPU. Il valore predefinito è 128 MB. Il valore può essere qualsiasi multiplo di 1 MB.

Tipo: integer

Intervallo valido: valore minimo pari a 128. Valore massimo pari a 10240.

Campo obbligatorio: no

PackageType

Il tipo di pacchetto di implementazione. Imposta su Image per l'immagine di container e imposta su Zip per l'archivio di file .zip.

Tipo: stringa

Valori validi: Zip | Image

Campo obbligatorio: no

Publish

Imposta su true per pubblicare la prima versione della funzione durante la creazione.

Tipo: Booleano

Campo obbligatorio: no

Role

L'Amazon Resource Name (ARN) del ruolo di esecuzione della funzione.

Tipo: stringa

Modello: arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

Campo obbligatorio: sì

Runtime

L'identificatore del runtime della funzione. È necessario il runtime se il pacchetto di implementazione è un archivio di file formato zip.

L'elenco seguente include i runtime obsoleti. Per ulteriori informazioni, consulta Policy di deprecazione del runtime.

Tipo: stringa

Campo obbligatorio: no

SnapStart

L'SnapStartimpostazione della funzione.

Tipo: oggetto SnapStart

Campo obbligatorio: no

Tags

Un elenco di tag da applicare alla funzione.

Tipo: mappatura stringa a stringa

Campo obbligatorio: no

Timeout

La quantità di runtime (in secondi) consentita a una funzione da Lambda prima che venga arrestata. Il valore predefinito è 3 secondi. Il valore consentito massimo di TTL è 900 secondi. Per ulteriori informazioni, consulta Ambiente di esecuzione di Lambda.

Tipo: integer

Intervallo valido: valore minimo di 1.

Campo obbligatorio: no

TracingConfig

Imposta Mode su Active per campionare e tracciare un sottoinsieme di richieste in entrata con X-Ray.

Tipo: oggetto TracingConfig

Campo obbligatorio: no

VpcConfig

Per la connettività di rete alle risorse AWS in un VPC, specificare un elenco di gruppi di sicurezza e sottoreti nel VPC. Quando si connette una funzione a un VPC, può accedere alle risorse e a Internet solo tramite tale VPC. Per ulteriori informazioni, consulta Configurazione di una funzione Lambda per accedere alle risorse in un VPC.

Tipo: oggetto VpcConfig

Campo obbligatorio: no

Sintassi della risposta


HTTP/1.1 201
Content-type: application/json

{
   "Architectures": [ "string" ],
   "CodeSha256": "string",
   "CodeSize": number,
   "DeadLetterConfig": { 
      "TargetArn": "string"
   },
   "Description": "string",
   "Environment": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "Variables": { 
         "string" : "string" 
      }
   },
   "EphemeralStorage": { 
      "Size": number
   },
   "FileSystemConfigs": [ 
      { 
         "Arn": "string",
         "LocalMountPath": "string"
      }
   ],
   "FunctionArn": "string",
   "FunctionName": "string",
   "Handler": "string",
   "ImageConfigResponse": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "ImageConfig": { 
         "Command": [ "string" ],
         "EntryPoint": [ "string" ],
         "WorkingDirectory": "string"
      }
   },
   "KMSKeyArn": "string",
   "LastModified": "string",
   "LastUpdateStatus": "string",
   "LastUpdateStatusReason": "string",
   "LastUpdateStatusReasonCode": "string",
   "Layers": [ 
      { 
         "Arn": "string",
         "CodeSize": number,
         "SigningJobArn": "string",
         "SigningProfileVersionArn": "string"
      }
   ],
   "LoggingConfig": { 
      "ApplicationLogLevel": "string",
      "LogFormat": "string",
      "LogGroup": "string",
      "SystemLogLevel": "string"
   },
   "MasterArn": "string",
   "MemorySize": number,
   "PackageType": "string",
   "RevisionId": "string",
   "Role": "string",
   "Runtime": "string",
   "RuntimeVersionConfig": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "RuntimeVersionArn": "string"
   },
   "SigningJobArn": "string",
   "SigningProfileVersionArn": "string",
   "SnapStart": { 
      "ApplyOn": "string",
      "OptimizationStatus": "string"
   },
   "State": "string",
   "StateReason": "string",
   "StateReasonCode": "string",
   "Timeout": number,
   "TracingConfig": { 
      "Mode": "string"
   },
   "Version": "string",
   "VpcConfig": { 
      "Ipv6AllowedForDualStack": boolean,
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ],
      "VpcId": "string"
   }
}

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 201.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

Architectures

L'architettura del set di istruzioni supportata dalla funzione. L'architettura è una matrice di stringhe con uno dei valori validi. Il valore predefinito dell'architettura è x86_64.

Tipo: matrice di stringhe

Membri dell'array: numero minimo di 1 elemento.

Valori validi: x86_64 | arm64

CodeSha256

L'hash SHA256 del pacchetto di implementazione della funzione.

Tipo: stringa

CodeSize

Le dimensioni del pacchetto di implementazione della funzione, in byte.

Tipo: long

DeadLetterConfig

La coda DLQ della funzione.

Tipo: oggetto DeadLetterConfig

Description

La descrizione della funzione.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.

Environment

Le variabili di ambiente della funzione. Omesso dai log AWS CloudTrail.

Tipo: oggetto EnvironmentResponse

EphemeralStorage

Tipo: oggetto EphemeralStorage

FileSystemConfigs

Impostazioni di connessione per un file system Amazon EFS.

Tipo: matrice di oggetti FileSystemConfig

Membri dell'array: numero massimo di 1 elementi.

FunctionArn

L'Amazon Resource Name (ARN) della funzione.

Tipo: stringa

Modello: arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_\.]+(:(\$LATEST|[a-zA-Z0-9-_]+))?

FunctionName

Il nome della funzione.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 170.

Modello: (arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?

Handler

La funzione che Lambda richiama per iniziare a eseguire la funzione.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 128.

Modello: [^\s]+

ImageConfigResponse

I valori di configurazione dell'immagine della funzione.

Tipo: oggetto ImageConfigResponse

KMSKeyArn

La AWS KMS key utilizzata per crittografare le variabili di ambiente della funzione. Quando Lambda SnapStart è attivata, questa chiave viene utilizzata anche per crittografare l'istantanea della funzione. Questa chiave viene restituita solo se è stata configurata una chiave gestita dal cliente.

Tipo: stringa

Modello: (arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()

LastModified

Data e ora in cui la funzione è stata aggiornata l'ultima volta, in formato ISO-8601 (YYYY-MM-DDThh:mm:ss.sTZD).

Tipo: stringa

LastUpdateStatus

Lo stato dell'ultimo aggiornamento eseguito sulla funzione. Questo viene impostato su Successful per la prima volta dopo il completamento della creazione della funzione.

Tipo: stringa

Valori validi: Successful | Failed | InProgress

LastUpdateStatusReason

Il motivo dell'ultimo aggiornamento eseguito sulla funzione.

Tipo: stringa

LastUpdateStatusReasonCode

Il codice motivo dell'ultimo aggiornamento eseguito sulla funzione.

Tipo: stringa

Layers

I livelli della funzione.

Tipo: matrice di oggetti Layer

LoggingConfig

Le impostazioni di configurazione di Amazon CloudWatch Logs della funzione.

Tipo: oggetto LoggingConfig

MasterArn

Per le funzioni Lambda@Edge, l'ARN della funzione principale.

Tipo: stringa

Modello: arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?

MemorySize

La quantità di memoria disponibile per la funzione in fase di runtime.

Tipo: integer

Intervallo valido: valore minimo pari a 128. Valore massimo pari a 10240.

PackageType

Il tipo di pacchetto di implementazione. Impostare su Image per l'immagine container e impostare Zip per l'archivio di file .zip.

Tipo: stringa

Valori validi: Zip | Image

RevisionId

L'ultima revisione aggiornata della funzione o dell'alias.

Tipo: stringa

Role

Il ruolo di esecuzione della funzione.

Tipo: stringa

Modello: arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

Runtime

L'identificatore del runtime della funzione. È necessario il runtime se il pacchetto di implementazione è un archivio di file formato zip.

L'elenco seguente include i runtime obsoleti. Per ulteriori informazioni, consulta Policy di deprecazione del runtime.

Tipo: stringa

RuntimeVersionConfig

L'ARN del runtime e gli eventuali errori che si sono verificati.

Tipo: oggetto RuntimeVersionConfig

SigningJobArn

L'ARN del processo di firma.

Tipo: stringa

Modello: arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)

SigningProfileVersionArn

L'ARN della versione del profilo di firma.

Tipo: stringa

Modello: arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)

SnapStart

ImpostatoApplyOnPublishedVersions per creare un'istantanea dell'ambiente di esecuzione inizializzato quando si pubblica una versione della funzione. Per ulteriori informazioni, consulta Migliorare le prestazioni di avvio con SnapStart Lambda.

Tipo: oggetto SnapStartResponse

State

Lo stato corrente della funzione. Quando lo stato è Inactive, puoi riattivare la funzione richiamandola.

Tipo: stringa

Valori validi: Pending | Active | Inactive | Failed

StateReason

Il motivo dello stato corrente della funzione.

Tipo: stringa

StateReasonCode

Il codice motivo dello stato corrente della funzione. Quando il codice è Creating, non puoi richiamare o modificare la funzione.

Tipo: stringa

Timeout

La quantità di runtime in secondi consentita a una funzione da Lambda prima che venga arrestata.

Tipo: integer

Intervallo valido: valore minimo di 1.

TracingConfig

La configurazione di tracciamento di AWS X-Ray della funzione.

Tipo: oggetto TracingConfigResponse

Version

La versione della funzione Lambda.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 1024 caratteri.

Modello: (\$LATEST|[0-9]+)

VpcConfig

Configurazione di rete della funzione.

Tipo: oggetto VpcConfigResponse

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

CodeSigningConfigNotFoundException

La configurazione di firma del codice specificata non esiste.

Codice di stato HTTP: 404

CodeStorageExceededException

La tua dimensione totale massima del codiceAccount AWS è stata superata. Per ulteriori informazioni, consulta la pagina relativa alle quote di .

Codice di stato HTTP: 400

CodeVerificationFailedException

La firma del codice non è riuscita a eseguire uno o più controlli di convalida per verificare la mancata corrispondenza o la scadenza della firma, e la policy di firma del codice è impostata su ENFORCE. Lambda blocca la distribuzione.

Codice di stato HTTP: 400

InvalidCodeSignatureException

La firma del codice non ha superato il controllo di integrità. Se il controllo di integrità non riesce, Lambda blocca l'implementazione anche se la policy di firma del codice è impostata su WARN.

Codice di stato HTTP: 400

InvalidParameterValueException

Uno dei parametri della richiesta non è valido.

Codice di stato HTTP: 400

ResourceConflictException

La risorsa esiste già o è in corso un'altra operazione.

Codice di stato HTTP: 409

ResourceNotFoundException

La risorsa specificata nella richiesta non esiste.

Codice di stato HTTP: 404

ServiceException

Il servizio AWS Lambda ha riscontrato un errore interno.

Codice di stato HTTP: 500

TooManyRequestsException

È stato superato il limite di throughput della richiesta. Per ulteriori informazioni, consulta la pagina relativa alle quote di .

Codice di stato HTTP: 429

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

CreateEventSourceMapping

CreateFunctionUrlConfig