Updated on 2024-08-15 GMT+08:00

Using an APIC Trigger

This section describes how to create an APIC trigger and call an API to trigger a function. (This is only available in AP-Singapore.)

For details about the APIC event source, see Supported Event Sources.

Prerequisites

You have created an API group, for example, APIConnect_test. For details, see Creating an API Group.

Creating an APIC Trigger

  1. Log in to the FunctionGraph console, and choose Functions > Function List in the navigation pane.
  2. Click Create Function.
  3. Set the following parameters:

    • Function Name: Enter a function name, for example, apig.
    • Agency: Select Use no agency.
    • Enterprise Project: Select default.
    • For Runtime, select Node.js 10.16.

  4. Click Create Function.
  5. Choose Configuration > Triggers and click Create Trigger.

    Figure 1 Creating a trigger

  6. Configure the trigger information.

    Table 1 Trigger information

    Parameter

    Description

    Trigger Type

    Select API Connect (APIC).

    API Instance

    Select an instance. If no instance is available, click Create Instance.

    API Name

    Enter an API name, for example, API_apic.

    API Group

    An API group is a collection of APIs. You can manage APIs by API group.

    Example: DEFAULT.

    Environment

    An API can be called in different environments, such as production, test, and development environments. APIG supports environment management, which allows you to define different request paths for an API in different environments.

    To ensure that the API can be called, select RELEASE.

    Security Authentication

    There are three authentication modes:

    • App: AppKey and AppSecret authentication. This mode is of high security and is recommended. For details, see App Authentication.
    • IAM: IAM authentication. This mode grants access permissions to IAM users only and is of medium security. For details, see IAM Authentication.
    • None: No authentication. This mode grants access permissions to all users.

    Select None.

    Protocol

    There are two types of protocols:

    • HTTP
    • HTTPS

    Select HTTPS.

    Timeout (ms)

    Enter 5000.

  7. Click OK.

    After the trigger is created, an API named API_apic is generated on the APIG console. You can click the API name in the trigger list to go to the APIG console.

Invoking the Function

  1. Log in to ROMA Connect, find the selected instance (for example, Ac6-instance-NoDelete), and view the public IP address.
  2. Enter the public IP address in the address box of the browser.
  3. After the function is executed, a result is returned.

Viewing the Execution Result

  1. Return to the FunctionGraph console. In the navigation pane, choose Functions > Function List.
  2. Click the name of the nodejs-test function.
  3. On the displayed function details page, click the Logs tab to query the function running logs.
  4. Click View Context in the same row as a log to view log details.