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_IAMse si desidera limitare l'accesso solo a utenti autenticati. Impostare suNONEse 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_IAMCampo 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 APIInvoke. 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 APIInvokeWithResponseStream. La dimensione massima del payload di risposta è di 20 MB, tuttavia è possibile richiedere un aumento della quota.
Tipo: stringa
Valori validi:
BUFFERED | RESPONSE_STREAMCampo 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_IAMse si desidera limitare l'accesso solo a utenti autenticati. Impostare suNONEse 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 APIInvoke. 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 APIInvokeWithResponseStream. 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:
