Configuring API Parameter Orchestration Rules

Creating an Orchestration Rule

1. Go to the APIG console.
2. Select a dedicated gateway at the top of the navigation pane.

3. In the navigation pane, choose API Management > API Policies.
4. Click the Orchestration Rules tab.
5. 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.

6. Click OK.