Oracle Cloud Infrastructure - Dokumentation

Benutzerdefinierte Konfigurationsparameter zum Übergeben an Funktionen angeben

Erfahren Sie, wie Sie benutzerdefinierte Konfigurationsparameter angeben, die an ausgeführte Funktionen mit OCI Functions übergeben werden sollen.

Voraussetzungen und weitere Informationen finden Sie unter Benutzerdefinierte Konfigurationsparameter an Funktionen übergeben.

    1. Wählen Sie auf der Listenseite Anwendungen die Anwendung mit Funktionen aus, an die Sie benutzerdefinierte Konfigurationsparameter übergeben möchten. Wenn Sie Hilfe beim Suchen der Listenseite oder der Anwendung benötigen, finden Sie weitere Informationen unter Anwendungen auflisten.
    2. Führen Sie einen der folgenden Schritte aus:

      • Um einen oder mehrere benutzerdefinierte Konfigurationsparameter an jede Funktion in der Anwendung zu übergeben, wählen Sie Konfiguration aus, um die Seite Konfiguration für die Anwendung anzuzeigen.

      • Um einen oder mehrere benutzerdefinierte Konfigurationsparameter an eine bestimmte Funktion zu übergeben, wählen Sie die Registerkarte Funktionen, wählen den Namen der Funktion aus, und wählen Sie Konfiguration aus, um die Seite Konfiguration für die Funktion anzuzeigen.

    3. Wählen Sie auf der Seite Konfiguration die Option Konfiguration verwalten aus, und wählen Sie Konfiguration hinzufügen aus, um die folgenden Details für den ersten benutzerdefinierten Konfigurationsparameter anzugeben:

      • Schlüssel: Der Name des benutzerdefinierten Konfigurationsparameters. Der Name darf nur alphanumerische Zeichen sowie Unterstriche enthalten und darf nicht mit einer Zahl beginnen. Beispiel: username
      • Wert: Ein Wert für den benutzerdefinierten Konfigurationsparameter. Der Wert darf nur ausdruckbare Unicode-Zeichen enthalten. Beispiel: jdoe
    4. (Optional) Wählen Sie Konfiguration hinzufügen aus, um bei Bedarf andere benutzerdefinierte Konfigurationsparameter einzugeben.

    5. Wählen Sie Änderungen speichern aus, um den neuen benutzerdefinierten Konfigurationsparameter zu speichern.

      OCI Functions kombiniert die Schlüssel/Wert-Paare für alle benutzerdefinierten Konfigurationsparameter (anwendungsweit und funktionsspezifisch) in der Anwendung in einem einzelnen, seriell codierten Konfigurationsobjekt mit einer maximal zulässigen Größe von 4 Kb. Sie können den neuen benutzerdefinierten Konfigurationsparameter nicht speichern, wenn die Größe des serialisierten Konfigurationsobjekts 4 KB überschreitet.

  • Tipp

    Gelegentlich werden neue Versionen der Fn-Projekt-CLI veröffentlicht. Wir empfehlen Ihnen, regelmäßig zu überprüfen, ob die neueste Version installiert ist. Weitere Informationen finden Sie in Schritte zum Upgrade der Fn-Projekt-CLI.

    So geben Sie benutzerdefinierte Konfigurationsparameter an, die mit der Fn-Projekt-CLI an Funktionen übergeben werden sollen:

    1. Melden Sie sich als Funktionsentwickler bei Ihrer Entwicklungsumgebung an, und öffnen Sie ein Terminalfenster.

    2. Um mindestens einen benutzerdefinierten Konfigurationsparameter anzugeben, der an jede Funktion in einer vorhandenen Anwendung übergeben werden soll, geben Sie Folgendes ein:

      fn config app <app-name> <key> <value>

      Hierbei gilt:

      • <app-name> ist der Name der Anwendung, die die Funktionen enthält, an die Sie den benutzerdefinierten Konfigurationsparameter übergeben möchten.
      • <key> ist der Name des benutzerdefinierten Konfigurationsparameters. Der Name darf nur alphanumerische Zeichen sowie Unterstriche enthalten und darf nicht mit einer Zahl beginnen.
      • <value> ist der Wert, der dem benutzerdefinierten Konfigurationsparameter zugewiesen werden soll. Der Wert darf nur ausdruckbare Unicode-Zeichen enthalten.

      Beispiel:

      fn config app acmeapp username jdoe

      Folgendes ist zu beachten:

      • Sie können auch benutzerdefinierte Konfigurationsparameter für die gesamte Anwendung definieren, wenn Sie eine neue Anwendung mit dem Befehl fn create app erstellen.
      • OCI Functions kombiniert die Schlüssel/Wert-Paare für alle benutzerdefinierten Konfigurationsparameter (anwendungsweit und funktionsspezifisch) in der Anwendung in einem einzelnen, seriell codierten Konfigurationsobjekt mit einer maximal zulässigen Größe von 4 KB.

    3. Um einen oder mehrere benutzerdefinierte Konfigurationsparameter anzugeben, die an eine bestimmte Funktion übergeben werden sollen, geben Sie Folgendes ein:

      fn config function <app-name> <function-name> <key> <value>

      Hierbei gilt:

      • <app-name> ist der Name der Anwendung mit der Funktion, an die Sie den benutzerdefinierten Konfigurationsparameter übergeben möchten.
      • <function-name> ist der Name der Funktion, an die der benutzerdefinierte Konfigurationsparameter übergeben werden soll.
      • <key> ist der Name des benutzerdefinierten Konfigurationsparameters. Der Name darf nur alphanumerische Zeichen sowie Unterstriche enthalten und darf nicht mit einer Zahl beginnen.
      • <value> ist der Wert, der dem benutzerdefinierten Konfigurationsparameter zugewiesen werden soll. Der Wert darf nur ausdruckbare Unicode-Zeichen enthalten.

      Beispiel:

      fn config function acmeapp acme-func username jdoe

      Folgendes ist zu beachten:

      • Sie können auch funktionsspezifische benutzerdefinierte Konfigurationsparameter definieren, wenn Sie eine neue Funktion mit dem Befehl fn create function erstellen.
      • OCI Functions kombiniert die Schlüssel/Wert-Paare für alle benutzerdefinierten Konfigurationsparameter (anwendungsweit und funktionsspezifisch) in der Anwendung in einem einzelnen, seriell codierten Konfigurationsobjekt mit einer maximal zulässigen Größe von 4 KB.

  • Führen Sie die folgenden API-Vorgänge aus, um benutzerdefinierte Konfigurationsparameter zu definieren: