Funktionen aufrufen

So rufen Sie eine in OCI Functions bereitgestellte Funktion mit der Fn-Projekt-CLI auf:

1. Melden Sie sich als Funktionsentwickler bei Ihrer Entwicklungsumgebung an.

2. Geben Sie in einem Terminalfenster Folgendes ein:

   fn invoke <app-name> <function-name>

   Hierbei gilt:

   • <app-name> ist der Name der Anwendung, die die aufzurufende Funktion enthält.
   • <function-name> ist der Name der aufzurufenden Funktion.

   Beispiel:

   fn invoke helloworld-app helloworld-func

   Ausgabe:

   Hello World !

   Tipp
   
   

   Wenn Sie Argumente und Werte an eine Funktion übergeben möchten, stellen Sie dem Befehl fn invoke das Präfix echo -n '<argument>=<value>'| voran.

   Wenn die Funktion das Argument und den Wert als JSON erwartet, verwenden Sie ein gültiges JSON-Format. Beispiel:

   echo -n '{"name":"John"}' | fn invoke helloworld-app helloworld-func

   Ausgabe:

   Hello John !

Wenn Sie die Oracle Cloud Infrastructure-CLI installiert haben, können Sie API-Anforderungen zum Aufrufen von Funktionen verwenden. Die Oracle Cloud Infrastructure-CLI vereinfacht außerdem die Oracle Cloud Infrastructure-Authentifizierung. Informationen zur Verwendung der Oracle Cloud Infrastructure-CLI finden Sie unter Befehlszeilenschnittstelle (CLI).

Bei diesen Anweisungen wird Folgendes vorausgesetzt:

• Sie haben die Oracle Cloud Infrastructure-CLI bereits installiert und konfiguriert.
• Sie möchten eine Funktion als Funktionsentwickler aufrufen, der für Ihre Entwicklungsumgebung konfiguriert ist.

So rufen Sie eine Funktion mit der Oracle Cloud Infrastructure-CLI auf:

1. Melden Sie sich als Funktionsentwickler bei Ihrer Entwicklungsumgebung an.

2. Geben Sie in einem Terminalfenster Folgendes ein:

   oci fn function invoke --function-id <function-ocid> --file "<output-filepath>" --body "<request-parameters>"

   Hierbei gilt:

   • <function-ocid> ist die OCID der Funktion, die aufgerufen werden soll. Um die OCID einer Funktion zu ermitteln, verwenden Sie den Befehl fn inspect, um den Wert der Eigenschaft id der Funktion anzuzeigen (siehe Funktionen auflisten).
   • <output-filepath> ist der Pfad und der Name einer Datei, in die die Antwort geschrieben werden soll. Um die Antwort in "stdout" zu schreiben, geben Sie --file "-" an.
   • <request-parameters> sind optionale Argumente und Werte, die an die Funktion übergeben werden. Wenn die Funktion Argumente und Werte als JSON erwartet, verwenden Sie ein gültiges JSON-Format. Beispiel: --body '{"name":"John"}'. Beachten Sie, dass Sie --body "" in die Anforderung aufnehmen müssen, selbst wenn keine zu übergebenden Anforderungsparameter vorhanden sind.

   Beispiel:

   • oci fn function invoke --function-id ocid1.fnfunc.oc1.phx.aaaa____uxoa --file "-" --body ""

     Ausgabe:

     Hello World !

   • oci fn function invoke --function-id ocid1.fnfunc.oc1.phx.aaaa____uxoa --file "-" --body '{"name":"John"}'

     Ausgabe:

     Hello John !

Wenn Sie ein Programm schreiben, um eine Funktion in einer Sprache aufzurufen, für die ein Oracle Cloud Infrastructure-SDK vorhanden ist, wird empfohlen, dass Sie dieses SDK verwenden, um API-Anforderungen zum Aufrufen der Funktion zu senden. Das SDK vereinfacht außerdem die Oracle Cloud Infrastructure-Authentifizierung.

Wenn Sie eine Funktion mit einem SDK aufrufen, geben Sie nicht den gesamten Aufrufendpunkt an, den Sie bei Verwendung des Oracle Cloud Infrastructure-CLI-Befehls raw-request angeben (siehe Aufrufendpunkt einer Funktion abrufen). Geben Sie stattdessen nur den ersten Teil des Aufrufendpunkts der Funktion an. Beispiel: Wenn Sie ein SDK verwenden, geben Sie den Aufrufendpunkt der Funktion nicht als https://fht7ns4mn2q.us-phoenix-1.functions.oci.oraclecloud.com/20181201/functions/ocid1.fnfunc.oc1.phx.aaaa____uxoa/actions/invoke an. Geben Sie stattdessen den Aufrufendpunkt der Funktion als https://fht7ns4mn2q.us-phoenix-1.functions.oci.oraclecloud.com an.

Informationen zur Verwendung der API und zu Signieranforderungen finden Sie unter REST-API-Dokumentation und Sicherheitszugangsdaten. Informationen zu SDKs finden Sie unter SDKs und die CLI.

Mit dem API-Vorgang InvokeFunction können Sie Funktionen aufrufen.

Wenn Sie eine Funktion mit dem Oracle Cloud Infrastructure-CLI-Befehl raw-request aufrufen, müssen Sie den Aufrufendpunkt der Funktion angeben.

So rufen Sie den Aufrufendpunkt einer Funktion ab:

1. Melden Sie sich als Funktionsentwickler bei Ihrer Entwicklungsumgebung an.

2. Geben Sie in einem Terminalfenster Folgendes ein:

   fn inspect function <app-name> <function-name>

   Hierbei gilt:

   • <app-name> ist der Name der Anwendung mit der Funktion, für die Sie den Aufrufendpunkt abrufen möchten.
   • <function-name> ist der Name der Funktion, für die Sie den Aufrufendpunkt abrufen möchten.

   Beispiel:

   fn inspect function helloworld-app helloworld-func

   Ausgabe:

   {
      "annotations": {
   		"fnproject.io/fn/invokeEndpoint": "https://fht7ns4mn2q.us-phoenix-1.functions.oci.oraclecloud.com/20181201/functions/ocid1.fnfunc.oc1.phx.aaaa____uxoa/actions/invoke",
   
   ...
   }

   Der Aufrufendpunkt der Funktion ist der Wert von "fnproject.io/fn/invokeEndpoint". Beispiel: "https://fht7ns4mn2q.us-phoenix-1.functions.oci.oraclecloud.com/20181201/functions/ocid1.fnfunc.oc1.phx.aaaa____uxoa/actions/invoke" (aus Gründen der Lesbarkeit abgekürzt).

Wenn Sie die Oracle Cloud Infrastructure-CLI installiert haben, können Sie API-Anforderungen zum Aufrufen von Funktionen verwenden. Die CLI vereinfacht außerdem die Oracle Cloud Infrastructure-Authentifizierung. Weitere Informationen zur Verwendung der Oracle Cloud Infrastructure-CLI finden Sie unter Befehlszeilenschnittstelle (CLI).

Bei diesen Anweisungen wird Folgendes vorausgesetzt:

• Sie haben die Oracle Cloud Infrastructure-CLI bereits installiert und konfiguriert.
• Sie möchten eine Funktion als Funktionsentwickler aufrufen, der für Ihre Entwicklungsumgebung konfiguriert ist.

So rufen Sie eine in OCI Functions bereitgestellte Funktion auf, indem Sie mit dem Oracle Cloud Infrastructure-CLI-Befehl raw-request eine signierte Anforderung an den Aufrufendpunkt der Funktion senden:

1. Melden Sie sich als Funktionsentwickler bei Ihrer Entwicklungsumgebung an.

2. Rufen Sie den Aufrufendpunkt der Funktion ab (siehe Aufrufendpunkt einer Funktion abrufen).

   Beispiel: "fnproject.io/fn/invokeEndpoint": "https://fht7ns4mn2q.us-phoenix-1.functions.oci.oraclecloud.com/20181201/functions/ocid1.fnfunc.oc1.phx.aaaa____uxoa/actions/invoke" (aus Gründen der Lesbarkeit abgekürzt).

3. Verwenden Sie den Oracle Cloud Infrastructure-CLI-Befehl raw-request, um die Funktion aufzurufen. Senden Sie dazu eine signierte POST-Anforderung an den Aufrufendpunkt der Funktion, indem Sie Folgendes eingeben:

   oci raw-request --http-method POST --target-uri <invoke-endpoint> --request-body "<request-parameters>"

   Hierbei gilt:

   • <invoke-endpoint> ist der Endpunkt, den Sie im vorherigen Schritt abgerufen haben.
   • <request-parameters> sind optionale Argumente und Werte, die an die Funktion übergeben werden. Wenn die Funktion Argumente und Werte als JSON erwartet, verwenden Sie ein gültiges JSON-Format. Beachten Sie, dass Sie --request-body "" in die Anforderung aufnehmen müssen, selbst wenn keine zu übergebenden Anforderungsparameter vorhanden sind.

   Beispiel:

   • oci raw-request --http-method POST --target-uri https://fht7ns4mn2q.us-phoenix-1.functions.oci.oraclecloud.com/20181201/functions/ocid1.fnfunc.oc1.phx.aaaa____uxoa/actions/invoke --request-body ""

     Ausgabe:

     Hello World !

   • oci raw-request --http-method POST --target-uri https://fht7ns4mn2q.us-phoenix-1.functions.oci.oraclecloud.com/20181201/functions/ocid1.fnfunc.oc1.phx.aaaa____uxoa/actions/invoke --request-body '{"name":"John"}'

     Ausgabe:

     Hello John !

4. Wenn eine Passphrase angegeben wurde, um den API-Signaturschlüssel zu verschlüsseln, geben Sie sie bei entsprechender Aufforderung ein.

Rufen Sie eine Funktion mit {\b Detached} als Aufruftyp auf, wenn:

• Sie möchten eine Funktion aufrufen, deren Ausführung lange dauert.
• Sie möchten, dass die Funktion asynchron ausgeführt wird, sodass die Kontrolle unmittelbar nach dem Aufruf der Funktion an den Aufrufer zurückgegeben wird, ohne auf die Ergebnisse des Aufrufs zu warten.
• Sie möchten Ziele angeben, an die Ergebnisse erfolgreicher und nicht erfolgreicher Aufrufe gesendet werden sollen.

Durch den getrennten Aufruf können Workloads mit langer Ausführungszeit (wie große ETL-Aufgaben, AI/ML-Jobs und Integrationen) beendet werden, ohne durch den synchronen Aufruf-Timeout eingeschränkt zu werden.

oci fn function create --application-id <ocid> --display-name "fn_longer_demo" --image <image> --memory-in-mbs 256 \
  --detached-mode-timeout-in-seconds 1800 \
  --success-destination file://success-dest.json \
  --failure-destination file://failure-dest.json

Hierbei gilt:

• success-dest.json enthält die folgende JSON-Zeichenfolge:

  {"kind": "STREAM", "streamId": "ocid1.stream.oc1...."}

• failure-dest.json enthält die folgende JSON-Zeichenfolge:

  {"kind": "QUEUE", "queueId": "ocid1.queue.oc1....", "channelId": "failure1234"}

Die Attribute, die für verschiedene Zielservices angegeben werden sollen, finden Sie in der API-Dokumentation unter SuccessDestinationDetails und FailureDestinationDetails.

{
  "id": "01K1Q6K12C1BT01KRZJ000HKB9",
  "version": "1.0",
  "data": {
    "compartmentId": "ocid1.compartment.oc1..aaaaaaaa______jf4a",
    "functionId": "...",
    "applicationId": "...",
    "request": {
      "opcRequestId": "...",
      "fnCallId": "..."
    },
    "response": {
      "status": "200",
      "errorCode": null,
      "errorMessage": null,
      "timestamp": "2025-08-03T05:31:21.392988237Z"
    }
  }
}

{
    "id": "01J6BS40ZC000000000000H7Z0",
    "version": "1.0",
    "data":
    {
        "compartmentId": "ocid1.compartment.oc1..aaaaaaaa______jf4a",
        "functionId": "...",
        "applicationId": "...",
        "request": {
            "opcRequestId": "...",
            "fnCallId": "..."
        },
        "response": {
            "status": "502",
            "errorCode": "FunctionInvokeExecutionFailed",
            "errorMessage": "function failed",
            "timestamp": "2024-08-11T21:47:41.264Z"
        }
    }
}