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à.
UpdateFunctionUrlConfig
Aggiorna la configurazione per un URL di funzione Lambda.
Sintassi della richiesta
PUT /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 suNONE
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: no
- 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_STREAM
Campo obbligatorio: no
-
Sintassi della risposta
HTTP/1.1 200
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",
"LastModifiedTime": "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.
- 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 suNONE
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 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
-
- LastModifiedTime
-
La data in cui è stata aggiornata l'ultima volta la configurazione dell'URL della funzione, in formato ISO-8601
(YYYY-MM-DDThh:mm:ss.sTZD). Tipo: stringa
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: