CreateFunctionUrlConfig - AWS Lambda
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie auch unter:

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

CreateFunctionUrlConfig

Erstellt eine Lambda-Funktions-URL mit den angegebenen Konfigurationsparametern. Eine Funktions-URL ist ein dedizierter HTTP(S)-Endpunkt, mit dem Sie Ihre Funktion aufrufen können.

Anforderungssyntax

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

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

FunctionName

Der Name der Lambda-Funktion.

Name Formate

  • Funktionsname – my-function.

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

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

Die Längenbeschränkung gilt nur für den gesamten ARN. Wenn Sie nur den Funktionsnamen angeben, ist dieser auf 64 Zeichen begrenzt.

Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 140 Zeichen.

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

Erforderlich: Ja

Qualifier

Der Aliasname.

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.

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

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

AuthType

Die Art der Authentifizierung, die Ihre Funktions-URL verwendet. Setzen Sie diese Option auf AWS_IAM, wenn Sie den Zugriff nur auf authentifizierte Benutzer beschränken möchten. Setzen Sie sie auf NONE, wenn Sie die IAM-Authentifizierung umgehen möchten, um einen öffentlichen Endpunkt zu erstellen. Weitere Informationen finden Sie unter Sicherheits- und Authentifizierungsmodell für Lambda-Funktions-URLs.

Typ: Zeichenfolge

Zulässige Werte: NONE | AWS_IAM

Erforderlich: Ja

Cors

Die Cross-Origin Resource Sharing (CORS)-Einstellungen für Ihre Funktions-URL.

Typ: Cors Objekt

Erforderlich: Nein

InvokeMode

Wählen Sie eine der folgenden Optionen aus:

  • BUFFERED – Dies ist die Standardoption. Lambda ruft Ihre Funktion mithilfe der Invoke-API-Operation auf. Die Aufrufergebnisse sind verfügbar, wenn die Nutzlast abgeschlossen ist. Die maximale Nutzlastgröße beträgt 6 MB.

  • RESPONSE_STREAM – Deine Funktion streamt Nutzlast-Ergebnisse, sobald sie verfügbar sind. Lambda ruft Ihre Funktion mithilfe der InvokeWithResponseStream-API-Operation auf. Die maximale Größe der Antwortnutzlast beträgt 20 MB, Sie können jedoch eine Erhöhung des Kontingents beantragen.

Typ: Zeichenfolge

Zulässige Werte: BUFFERED | RESPONSE_STREAM

Erforderlich: Nein

Antwortsyntax

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

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP-201-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

AuthType

Die Art der Authentifizierung, die Ihre Funktions-URL verwendet. Setzen Sie diese Option auf AWS_IAM, wenn Sie den Zugriff nur auf authentifizierte Benutzer beschränken möchten. Setzen Sie sie auf NONE, wenn Sie die IAM-Authentifizierung umgehen möchten, um einen öffentlichen Endpunkt zu erstellen. Weitere Informationen finden Sie unter Sicherheits- und Authentifizierungsmodell für Lambda-Funktions-URLs.

Typ: Zeichenfolge

Zulässige Werte: NONE | AWS_IAM

Cors

Die Cross-Origin Resource Sharing (CORS)-Einstellungen für Ihre Funktions-URL.

Typ: Cors Objekt

CreationTime

Zeitpunkt der Erstellung der Funktions-URL, im ISO-8601-Format (JJJJ-MM-TTThh:ss.sTZD).

Typ: Zeichenfolge

FunctionArn

Der Amazon-Ressourcenname (ARN) der Funktion.

Typ: Zeichenfolge

Pattern: 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

Der HTTP-URL-Endpunkt für Ihre Funktion.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 40. Maximale Länge beträgt 100 Zeichen.

InvokeMode

Wählen Sie eine der folgenden Optionen aus:

  • BUFFERED – Dies ist die Standardoption. Lambda ruft Ihre Funktion mithilfe der Invoke-API-Operation auf. Die Aufrufergebnisse sind verfügbar, wenn die Nutzlast abgeschlossen ist. Die maximale Nutzlastgröße beträgt 6 MB.

  • RESPONSE_STREAM – Deine Funktion streamt Nutzlast-Ergebnisse, sobald sie verfügbar sind. Lambda ruft Ihre Funktion mithilfe der InvokeWithResponseStream-API-Operation auf. Die maximale Größe der Antwortnutzlast beträgt 20 MB, Sie können jedoch eine Erhöhung des Kontingents beantragen.

Typ: Zeichenfolge

Zulässige Werte: BUFFERED | RESPONSE_STREAM

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

InvalidParameterValueException

Einer der Parameter in der Anfrage ist ungültig.

HTTP Status Code: 400

ResourceConflictException

Die Ressource ist bereits vorhanden, oder ein anderer Vorgang ist im Gange.

HTTP-Statuscode: 409

ResourceNotFoundException

Die in der Anforderung angegebene Ressource ist nicht vorhanden.

HTTP Status Code: 404

ServiceException

Beim Service AWS Lambda trat ein interner Fehler auf.

HTTP Status Code: 500

TooManyRequestsException

Der Durchsatz einer Anforderung wurde überschritten. Weitere Informationen finden Sie unter Lambda-Kontingente.

HTTP-Statuscode: 429

Weitere Informationen finden Sie auch unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: