Help Center/ API Gateway/ User Guide/ API Policies/ Orchestration Rule Management
Updated on 2024-05-24 GMT+08:00

Orchestration Rule Management

APIG supports API parameter orchestration. You can configure different algorithm rules to map new request parameters and values.

Creating an Orchestration Rule

  1. Go to the APIG console.
  2. Select a dedicated gateway at the top of the navigation pane.
  1. In the navigation pane, choose API Management > API Policies.
  2. Click the Orchestration Rules tab.
  3. Click Create Rule.

    Table 1 Rule configuration

    Parameter

    Description

    Rule Name

    Enter a rule name.

    Orchestration Policy

    Select a policy.

    • list: Listed values are mapped to other values.
    • range: Values in the range are mapped to other values.
    • hash: Request header values are mapped to new ones after hash calculation.
    • hash_range: hash values are generated using the request parameters for range orchestration.
    • none_value: If the request parameter is empty, the mapping value of the none_value policy is returned.
    • default: If request parameters cannot match any orchestration rule, the mapping value of the default policy is returned.
    • head_n: Intercept the first n characters of the string (If n is greater than the length of the string, the complete parameter value is returned.) as a temporary parameter pending orchestration for the next rule.
    • tail_n: Intercept the last n characters of the string (If n is greater than the length of the string, the complete parameter value is returned.) as a temporary parameter pending orchestration for the next rule.

    Preprocessing

    Mandatory when Orchestration Policy is set to list, range, hash, hash_range, head_n, or tail_n.

    Whether the rule is a preprocessing one. A preprocessing rule generates a value as a temporary parameter pending orchestration for the next rule.

    Parameter Name

    Mandatory when Preprocessing is disabled or Orchestration Policy is set to none_value or default.

    Enter the parameter name after orchestration.

    Parameter Type

    Mandatory when Preprocessing is disabled or Orchestration Policy is set to none_value or default.

    Select a parameter type.

    • string
    • number

    Parameter Location

    Mandatory when Preprocessing is disabled or Orchestration Policy is set to none_value or default.

    Select a parameter location.

    • header
    • query

    Mapping

    Mandatory when Orchestration Policy is set to list, range, hash_range, none_value, or default.

    Enter the mapping information. You can click Add Mapping to add new mappings.

    • Request Parameter Value Before Orchestration
      • When Orchestration Policy is set to list, enter the request parameter value before orchestration.
      • When Orchestration Policy is set to range or hash_range, enter the start value and end value of the range.
    • Request Parameter Value After Orchestration: Enter the request parameter value after orchestration.

    Length

    Mandatory when Orchestration Policy is set to head_n or tail_n.

    Enter the intercepted length of the string.

  4. Click OK.