UpdateFunctionUrlConfig - AWS Lambda
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

UpdateFunctionUrlConfig

Met à jour la configuration d’une URL de fonction Lambda.

Syntaxe de la demande

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"
}

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

FunctionName

Nom de la fonction Lambda.

Formats de nom

  • Nom de fonction – my-function.

  • ARN de fonction – arn:aws:lambda:us-west-2:123456789012:function:my-function.

  • ARN partiel – 123456789012:function:my-function.

Contrainte de longueur qui s’applique uniquement à l’ARN complet. Si vous spécifiez uniquement le nom de la fonction, ce dernier est limité à 64 caractères.

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 140.

Modèle : (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-_]+))?

Obligatoire : oui

Qualifier

Le nom de l’alias.

Contraintes de longueur : longueur minimum de 1. Longueur maximum de 128.

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

Corps de la demande

Cette demande accepte les données suivantes au format JSON.

AuthType

Le type d’authentification que votre URL de fonction utilise. Définissez sa valeur sur AWS_IAM si vous voulez limiter l’accès aux utilisateurs authentifiés uniquement. Définissez la valeur sur NONE, si vous souhaitez contourner l’authentification IAM pour créer un point de terminaison public. Pour plus d’informations, consultez Modèle de sécurité et d’authentification pour les URL de fonctions Lambda.

Type : chaîne

Valeurs valides : NONE | AWS_IAM

Obligatoire : non

Cors

Les paramètres du partage de ressources cross-origin (CORS) pour l’URL de votre fonction.

Type : objet Cors

Obligatoire : non

InvokeMode

Utilisez l’une des options suivantes :

  • BUFFERED : il s’agit de l’option par défaut. Lambda invoque votre fonction en utilisant l’opération d’API Invoke. Les résultats de l’invocation sont disponibles lorsque la charge utile est complète. La taille de la charge utile maximale est de 6 Mo.

  • RESPONSE_STREAM : votre fonction diffuse les résultats de la charge utile au fur et à mesure qu’ils sont disponibles. Lambda invoque votre fonction en utilisant l’opération d’API InvokeWithResponseStream. La taille maximale de la charge utile de réponse est de 20 Mo, mais vous pouvez demander une augmentation du quota.

Type : chaîne

Valeurs valides : BUFFERED | RESPONSE_STREAM

Obligatoire : non

Syntaxe de la réponse

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"
}

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

AuthType

Le type d’authentification que votre URL de fonction utilise. Définissez sa valeur sur AWS_IAM si vous voulez limiter l’accès aux utilisateurs authentifiés uniquement. Définissez la valeur sur NONE, si vous souhaitez contourner l’authentification IAM pour créer un point de terminaison public. Pour plus d’informations, consultez Modèle de sécurité et d’authentification pour les URL de fonctions Lambda.

Type : chaîne

Valeurs valides : NONE | AWS_IAM

Cors

Les paramètres du partage de ressources cross-origin (CORS) pour l’URL de votre fonction.

Type : objet Cors

CreationTime

Date de création de l’URL de la fonction, au format ISO-8601 (AAAA-MM-JJHhh:mm:ss.sTZD).

Type : chaîne

FunctionArn

Amazon Resource Name (ARN) de votre fonction.

Type : chaîne

Modèle : 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

Le point de terminaison de l’URL HTTP pour votre fonction.

Type : chaîne

Contraintes de longueur : longueur minimum de 40. Longueur maximum de 100.

InvokeMode

Utilisez l’une des options suivantes :

  • BUFFERED : il s’agit de l’option par défaut. Lambda invoque votre fonction en utilisant l’opération d’API Invoke. Les résultats de l’invocation sont disponibles lorsque la charge utile est complète. La taille de la charge utile maximale est de 6 Mo.

  • RESPONSE_STREAM : votre fonction diffuse les résultats de la charge utile au fur et à mesure qu’ils sont disponibles. Lambda invoque votre fonction en utilisant l’opération d’API InvokeWithResponseStream. La taille maximale de la charge utile de réponse est de 20 Mo, mais vous pouvez demander une augmentation du quota.

Type : chaîne

Valeurs valides : BUFFERED | RESPONSE_STREAM

LastModifiedTime

Date de la dernière mise à jour de la configuration de l’URL de la fonction, au format ISO-8601 (AAAA-MM-JJHhh:mm:ss.sTZD).

Type : chaîne

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

InvalidParameterValueException

L’un des paramètres dans la demande n’est pas valide.

Code d’état HTTP : 400

ResourceConflictException

La ressource existe déjà ou une autre opération est en cours.

Code d’état HTTP : 409

ResourceNotFoundException

La ressource spécifiée dans la demande n’existe pas.

Code d’état HTTP : 404

ServiceException

Le service AWS Lambda a rencontré une erreur interne.

Code d’état HTTP : 500

TooManyRequestsException

La limite de débit de demande a été dépassée. Pour plus d’informations, consultez Quotas Lambda.

Code d’état HTTP : 429

consultez aussi

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :