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

CreateFunctionUrlConfig

Crea un URL della funzione Lambda con i parametri di configurazione specificati. Un URL di funzione è un endpoint HTTP(S) dedicato che è possibile utilizzare per richiamare la funzione.

Sintassi della richiesta

POST /2021-10-31/functions/FunctionName/url?Qualifier=Qualifier HTTP/1.1 Content-type: application/json { "AuthType": "string", "Cors": { "AllowCredentials": boolean, "AllowHeaders": [ "string" ], "AllowMethods": [ "string" ], "AllowOrigins": [ "string" ], "ExposeHeaders": [ "string" ], "MaxAge": number }, "InvokeMode": "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

Il nome alias.

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

Modello: (^\$LATEST$)|((?!^[0-9]+$)([a-zA-Z0-9-_]+))

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

AuthType

Il tipo di autenticazione utilizzato dall'URL della funzione. Impostare su AWS_IAM se si desidera limitare l'accesso solo a utenti autenticati. Impostare su NONE se si desidera ignorare l'autenticazione IAM per creare un endpoint pubblico. Per ulteriori informazioni, consultare Modello di sicurezza e autenticazione per gli URL della funzione Lambda.

Tipo: stringa

Valori validi: NONE | AWS_IAM

Campo obbligatorio: sì

Cors

Le impostazioni CORS (cross-origin resource sharing) per l'URL della funzione.

Tipo: oggetto Cors

Campo obbligatorio: no

InvokeMode

Utilizzare una delle opzioni seguenti:

  • BUFFERED: questa è l'opzione predefinita. Lambda richiama la funzione utilizzando l'operazione API Invoke. I risultati delle chiamate sono disponibili quando il payload è completo. La dimensione massima del payload è pari a 6 MB.

  • RESPONSE_STREAM: la funzione trasmette in streaming i risultati del payload non appena sono disponibili. Lambda richiama la funzione utilizzando l'operazione API InvokeWithResponseStream. La dimensione massima del payload di risposta è di 20 MB, tuttavia è possibile richiedere un aumento della quota.

Tipo: stringa

Valori validi: BUFFERED | RESPONSE_STREAM

Campo obbligatorio: no

Sintassi della risposta

HTTP/1.1 201 Content-type: application/json { "AuthType": "string", "Cors": { "AllowCredentials": boolean, "AllowHeaders": [ "string" ], "AllowMethods": [ "string" ], "AllowOrigins": [ "string" ], "ExposeHeaders": [ "string" ], "MaxAge": number }, "CreationTime": "string", "FunctionArn": "string", "FunctionUrl": "string", "InvokeMode": "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.

AuthType

Il tipo di autenticazione utilizzato dall'URL della funzione. Impostare su AWS_IAM se si desidera limitare l'accesso solo a utenti autenticati. Impostare su NONE se si desidera ignorare l'autenticazione IAM per creare un endpoint pubblico. Per ulteriori informazioni, consultare Modello di sicurezza e autenticazione per gli URL della funzione Lambda.

Tipo: stringa

Valori validi: NONE | AWS_IAM

Cors

Le impostazioni CORS (cross-origin resource sharing) per l'URL della funzione.

Tipo: oggetto Cors

CreationTime

La data in cui è stato creato l'URL della funzione, in formato ISO-8601 (YYYY-MM-DDThh:mm:ss.sTZD).

Tipo: stringa

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

FunctionUrl

L'endpoint URL HTTP della funzione.

Tipo: stringa

Vincoli di lunghezza: lunghezza minima di 40. Lunghezza massima di 100.

InvokeMode

Utilizzare una delle opzioni seguenti:

  • BUFFERED: questa è l'opzione predefinita. Lambda richiama la funzione utilizzando l'operazione API Invoke. I risultati delle chiamate sono disponibili quando il payload è completo. La dimensione massima del payload è pari a 6 MB.

  • RESPONSE_STREAM: la funzione trasmette in streaming i risultati del payload non appena sono disponibili. Lambda richiama la funzione utilizzando l'operazione API InvokeWithResponseStream. La dimensione massima del payload di risposta è di 20 MB, tuttavia è possibile richiedere un aumento della quota.

Tipo: stringa

Valori validi: BUFFERED | RESPONSE_STREAM

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: