PutRuntimeManagementConfig - AWS Lambda

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

PutRuntimeManagementConfig

Imposta la configurazione di gestione di un runtime per la versione di una funzione. Per ulteriori informazioni, consulta Aggiornamenti del runtime.

Sintassi della richiesta

PUT /2021-07-20/functions/FunctionName/runtime-management-config?Qualifier=Qualifier HTTP/1.1 Content-type: application/json { "RuntimeVersionArn": "string", "UpdateRuntimeOn": "string" }

Parametri della richiesta URI

La richiesta utilizza i seguenti parametri URI.

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.

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ì

Qualifier

Specifica una versione della funzione. Può essere $LATEST o un numero di versione pubblicato. Se non viene specificato alcun valore, viene restituita la configurazione per la versione $LATEST.

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

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

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

RuntimeVersionArn

L'ARN della versione di runtime che desideri sia utilizzata dalla funzione.

Nota

Questo valore è necessario solo se si utilizza la modalità di aggiornamento manuale del runtime.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 26. La lunghezza massima è 2048 caratteri.

Modello: ^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$

Campo obbligatorio: no

UpdateRuntimeOn

Specifica la modalità di aggiornamento del runtime.

  • Auto (default) (Automatico [impostazione predefinita]): aggiorna automaticamente alla versione di runtime più recente e sicura utilizzando un rollout della versione runtime in due fasi. Questa è la scelta migliore per la maggior parte dei clienti che possono essere certi di beneficiare sempre degli aggiornamenti di runtime.

  • Function update (Aggiornamento delle funzioni): Lambda aggiorna il runtime della funzione alla versione più recente e sicura quando si aggiorna la funzione. Questo approccio sincronizza gli aggiornamenti del runtime con le implementazioni delle funzioni, consentendo all'utente di controllare quando vengono applicati gli aggiornamenti di runtime e di rilevare e mitigare tempestivamente le rare incompatibilità degli aggiornamenti in fase di runtime. Quando si utilizza questa impostazione, è necessario aggiornare regolarmente le funzioni per mantenerne l'autonomia up-to-date.

  • Manual (Manuale): si specifica una versione di runtime nella configurazione della funzione. La funzione utilizzerà questa versione di runtime a tempo indeterminato. Nel raro caso in cui una nuova versione di runtime non sia compatibile con una funzione esistente, ciò consente di ripristinare la funzione a una versione di runtime precedente. Per ulteriori informazioni, consulta Rollback di una versione di runtime.

Tipo: stringa

Valori validi: Auto | Manual | FunctionUpdate

Campo obbligatorio: sì

Sintassi della risposta

HTTP/1.1 200 Content-type: application/json { "FunctionArn": "string", "RuntimeVersionArn": "string", "UpdateRuntimeOn": "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.

FunctionArn

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

RuntimeVersionArn

L'ARN del runtime per cui la funzione è configurata per l'utilizzo. Se la modalità di aggiornamento del runtime è manuale, viene restituito l'ARN, altrimenti viene restituito null.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 26. La lunghezza massima è 2048 caratteri.

Modello: ^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$

UpdateRuntimeOn

La modalità di aggiornamento del runtime.

Tipo: stringa

Valori validi: Auto | Manual | FunctionUpdate

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

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: