# 配置API的参数编排规则
API网关支持对API进行参数编排，根据请求参数取值，配置不同算法规则，映射为新的请求参数和新的参数值。
#### 创建编排规则
1. 进入[API网关控制台](https://console.huaweicloud.com/apig2/#/overview)页面。
2. 根据实际业务在左侧导航栏上方选择实例。

3. 在左侧导航栏选择"API管理 \> API策略"。
4. 单击"编排规则管理"页签。
5. 单击"创建编排规则"，根据下表参数说明，配置编排规则。 
   表1编排规则配置 
   | 参数      | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
   |:---|:---|
   | 规则名称    | 填写编排规则的名称，根据规划自定义。支持英文、数字、下划线，且只能以英文开头，长度为3\~64个字符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   | 编排策略    | 选择编排策略。 - list：列表中的值映射成另外的值。  - range：范围中的值映射成另外的值。  - hash：请求头的值经过哈希计算后直接映射为新的请求头。  - hash_range：先用请求参数生成hash值，再用hash值进行range编排。  - none_value：请求参数为空时将返回none_value策略的编排映射值。  - default：请求参数存在，但是没有编排规则可以匹配上请求参数时，将返回default策略的编排映射值。  - head_n：用于截取字符串前n项（如果n大于字符串长度，会返回完整的原始参数值），生成一个临时参数，后面的编排规则用这个临时参数值进行编排。  - tail_n：用于截取字符串后n项（如果n大于字符串长度，会返回完整的原始参数值），生成一个临时参数，后面的编排规则用这个临时参数值进行编排。   |
   | 是否预处理策略 | **当"编排策略"选择"list"、"range"、"hash"、"hash_range"、"head_n"、"tail_n"时可见。** 配置是否预处理策略。当编排规则为预处理时，将该编排规则生成的参数值作为临时参数，成为下一个编排规则的待编排参数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
   | 参数名称    | **当"是否预处理策略"开关关闭或者"编排策略"选择"none_value"或"default"时需要配置。** 填写编排后的参数名称。支持英文、数字、中划线，且只能以英文开头，长度为1\~128个字符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   | 参数类型    | **当"是否预处理策略"开关关闭或者"编排策略"选择"none_value"或"default"时需要配置。** 选择参数类型。 - string  - number                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   | 参数位置    | **当"是否预处理策略"开关关闭或者"编排策略"选择"none_value"或"default"时需要配置。** 选择参数位置。 - header  - query                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   | 映射信息    | **当"编排策略"选择"list"、"range"、"hash_range"、"none_value"、"default"时需要配置。** 填写参数映射信息。支持英文、数字、下划线、中划线，且只能以英文开头，长度为1\~128个字符。多个参数值用英文逗号分隔，最多支持3000个参数。 单击"新增映射信息"，可添加新的映射信息。 - 编排前的请求参数值 - 当"编排策略"选择"list"，输入编排前的请求参数值。  - 当"编排策略"选择"range"或"hash_range"，输入区间起始值和终止值。    - 编排后的请求参数值：输入编排后的请求参数值。                                                                                                                                                                                                                                                                   |
   | 截取长度    | **当"编排策略"选择"head_n"或"tail_n"时需要配置。** 配置截取字符串的长度，取值范围为1\~100。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
      
   
   
6. 单击"确定"。 
   在编排规则列表中显示已创建的规则，表示创建成功。
   
   
 
#### 相关文档
- 参数编排规则创建完成后，您可以为API关联参数编排规则。具体操作，请参考[通过APIG创建REST API](https://support.huaweicloud.com/usermanual-apig/apig_03_0010.html)章节。
- 如果您希望通过API创建编排规则，请参考[创建编排规则](https://support.huaweicloud.com/api-apig/CreateOrchestration.html)。