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

GetFunctionConfiguration

Restituisce le impostazioni specifiche della versione di funzione Lambda o versione. L'output include solo opzioni che possono variare tra le versioni di una funzione. Per modificare queste impostazioni, utilizza UpdateFunctionConfiguration.

Per ottenere tutti i dettagli di una funzione, incluse le impostazioni a livello di funzione, utilizza GetFunction.

Sintassi della richiesta


GET /2015-03-31/functions/FunctionName/configuration?Qualifier=Qualifier HTTP/1.1

Parametri della richiesta URI

La richiesta utilizza i seguenti parametri URI.

FunctionName

Il nome, la versione o l'alias della funzione Lambda.

Formati di nome

Nome della funzione: my-function (solo nome), my-function:v1 (con alias).
ARN funzione: arn:aws:lambda:us-west-2:123456789012:function:my-function.
ARN parziale: 123456789012:function:my-function.

Puoi aggiungere un numero di versione o un alias a qualsiasi formato. 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.

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-_]+))?

Campo obbligatorio: sì

Qualifier

Specifica una versione o un alias per ottenere dettagli su una versione pubblicata della funzione.

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

Modello: (|[a-zA-Z0-9$_-]+)

Corpo della richiesta

La richiesta non ha un corpo della richiesta.

Sintassi della risposta


HTTP/1.1 200
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 200.

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

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

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

InvalidParameterValueException

Uno dei parametri della richiesta non è valido.

Codice di stato HTTP: 400

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

GetFunctionConcurrency

GetFunctionEventInvokeConfig