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

Creazione e gestione della funzione Lambda URLs

Una funzione URL è un endpoint HTTP (S) dedicato per la funzione Lambda. Puoi creare e configurare una funzione URL tramite la console Lambda o Lambda. API Quando crei una funzioneURL, Lambda genera automaticamente un URL endpoint unico per te. Una volta creata una funzioneURL, il suo URL endpoint non cambia mai. URLGli endpoint della funzione hanno il seguente formato:

https://<url-id>.lambda-url.<region>.on.aws

URLsLe funzioni sono abilitate al dual stack, supportano e. IPv4 IPv6 Dopo aver configurato una funzione URL per la tua funzione, puoi richiamarla tramite il suo endpoint HTTP (S) tramite un browser web, curl, Postman o qualsiasi client. HTTP

La funzione Lambda URLs utilizza politiche basate sulle risorse per la sicurezza e il controllo degli accessi. La funzione supporta URLs anche le opzioni di configurazione di condivisione delle risorse () tra origini diverse. CORS

È possibile applicare la funzione URLs a qualsiasi alias di funzione o alla versione della funzione $LATEST non pubblicata. Non è possibile aggiungere una funzione URL a nessun'altra versione della funzione.

La sezione seguente mostra come creare e gestire una funzione URL utilizzando la console Lambda e il AWS CLI modello AWS CloudFormation

Creazione di una funzione URL (console)

Segui questi passaggi per creare una funzione URL utilizzando la console.

Creazione di una funzione URL (AWS CLI)

Per creare una funzione URL per una funzione Lambda esistente utilizzando AWS Command Line Interface (AWS CLI), esegui il comando seguente:

aws lambda create-function-url-config \
    --function-name my-function \
    --qualifier prod \ // optional
    --auth-type AWS_IAM
    --cors-config {AllowOrigins="https://example.com"} // optional

Ciò aggiunge una funzione URL al prod qualificatore della funzione. my-function Per ulteriori informazioni su questi parametri di configurazione, vedere CreateFunctionUrlConfignel API riferimento.

Aggiungere una funzione URL a un CloudFormation modello

Per aggiungere una AWS::Lambda::Url risorsa al AWS CloudFormation modello, utilizzate la seguente sintassi:

JSON

{
  "Type" : "AWS::Lambda::Url",
  "Properties" : {
      "AuthType" : String,
      "Cors" : Cors,
      "Qualifier" : String,
      "TargetFunctionArn" : String
    }
}

YAML

Type: AWS::Lambda::Url
Properties: 
  AuthType: String
  Cors: 
    Cors
  Qualifier: String
  TargetFunctionArn: String

Parametri

Condivisione di risorse tra origini diverse () CORS

Per definire in che modo origini diverse possono accedere alla tua funzioneURL, usa la condivisione di risorse tra origini diverse () CORS. Ti consigliamo di eseguire la configurazione CORS se intendi chiamare la tua funzione URL da un dominio diverso. Lambda supporta le seguenti CORS intestazioni per la funzione. URLs

Quando si configura CORS una funzione URL utilizzando la console Lambda o il, AWS CLI Lambda aggiunge automaticamente le CORS intestazioni a tutte le risposte tramite la funzione. URL In alternativa, puoi aggiungere manualmente le CORS intestazioni alla risposta della funzione. Se ci sono intestazioni in conflitto, il comportamento previsto dipende dal tipo di richiesta:

In generale, consigliamo di configurare tutte le CORS impostazioni sulla funzioneURL, piuttosto che inviare manualmente le CORS intestazioni nella risposta della funzione.

Funzione di limitazione URLs

Il throttling limita la frequenza con cui la funzione elabora le richieste. Ciò è utile in molte situazioni, ad esempio per impedire alla funzione di sovraccaricare le risorse a valle o per gestire un improvviso aumento delle richieste.

Puoi limitare la frequenza delle richieste che la tua funzione Lambda elabora tramite una funzione configurando la concorrenza riservataURL. La simultaneità riservata limita il numero massimo di richiami simultanei della funzione. La frequenza massima di richieste al secondo della funzione (RPS) è equivalente a 10 volte la concorrenza riservata configurata. Ad esempio, se configuri la funzione con una concorrenza riservata di 100, il massimo RPS è 1.000.

Ogni volta che la concorrenza della funzione supera la concorrenza riservata, la funzione URL restituisce un codice di stato. HTTP 429 Se la funzione riceve una richiesta che supera il RPS massimo di 10 volte in base alla concorrenza riservata configurata, viene visualizzato anche un errore. HTTP 429 Per ulteriori informazioni sulla simultaneità riservata, consulta Configurazione della concorrenza riservata per una funzione.

Funzione di disattivazione URLs

In caso di emergenza, potresti voler rifiutare tutto il traffico verso la tua sede. URL Per disattivare la funzioneURL, imposta la concorrenza riservata su zero. Ciò limita tutte le richieste alla funzioneURL, con conseguenti risposte di stato. HTTP 429 Per riattivare la funzioneURL, elimina la configurazione di concorrenza riservata o imposta la configurazione su un importo maggiore di zero.

Funzione di eliminazione URLs

Quando si elimina una funzioneURL, non è possibile ripristinarla. La creazione di una nuova funzione URL comporterà un URL indirizzo diverso.