# 短信变量须知
变量为每次发送短信时的可修改的部分内容。
 #### 变量规范
变量为每次发送短信时的可修改的部分内容。
|  **变量格式规范**  | - 每个模板中最多包含20个变量。  - 不支持连续变量和模板全变量。  - 变量间包含文字则为不连续变量。   |
|---|---|
| **长度规范**     | 若需扩展变量长度，请在申请短信模板时，详细备注使用场景、扩展原因、指明需要扩展长度的变量和扩展后的期望变量长度。                                                                                                                                                                                                                                                                                                                                        |
| ****内容规范**** | 以下两种变量格式等效，系统按${}解析识别变量，大括号中的序号标识/类型标识只是方便查阅，并无实际作用。需要为各变量设置变量属性，才能让相应变量规范生效。                                                                                                                                                                                                                                                                                                                   |
   
当模板内容中设置了变量时，必须指定变量属性。小数点、字母、汉字、空格以及其他符号均按1个变量长度计算。
| 变量属性            | 变量类型      | 规范                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|
| 电话号码            | PHONE     | 长度限制：4-15个字符。 - 可以传入座机号、95或400、800电话等。  - 仅支持数字、"+"、"-"，且以数字结尾。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 其他号码（如验证码、订单号等） | CHARDIGIT | 长度限制：1-20个字符。 主要用途为验证码、订单号等。 - 不允许出现手机号、QQ号、微信号、URL等联系方式。  - 仅支持大小写字母、数字和下划线组合。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 时间              | DATETIME  | 长度限制：1-20个字符。 需要符合时间的表达方式，格式示例如下： - 日期：yyyyMMdd、yyyy-MM-dd、yyyy/MM/dd、yyyy年mm月dd日。  - 时间：HH:mm:ss、HH:mm、HH点mm分、HH点mm。   如果需要同时指定日期和时间，请在模板中填充两个变量，一个变量传入日期，另一个变量传入时间。 - 短信内容示例： ``` 温馨提醒：2020-01-10 19:00-21:00的会议即将开始，请您准时参加。 ```   - 模板示例： ``` 温馨提醒：${1} ${2}-${3}的会议即将开始，请您准时参加。 ```    |
| 金额              | MONEY     | 长度限制：1-20个字符。 - 仅支持传入能够正常表达金额的数字、小数点或中文，例如壹、贰、叁、肆等。  - 支持传入IP地址，例如：10.1.1.10。   说明： "￥"和"$"等货币符号需要放在模板中，不支持变量传入。                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 其他（如名称、账号、地址等）  | TEXT      | 长度限制：1-20个字符。 - 可以设置为公司/产品/地址/姓名/内容/账号/会员名等。  - 不允许出现QQ号/微信号（公众号）/手机号/网址/座机号等联系方式。如果确有需要，请将联系方式放入模板中。  - 不允许在传入值中携带"."、"。"、" ' "、"\<"、"\>"、"{"或"}"。否则，可能导致模板变量解析异常。  - 不允许在传入值中携带"."，即不支持传入IP地址，如变量取值为IP地址，请申请模板时选择变量属性为"金额"。 须知： 变量取值不能包含单引号和大括号（"{"或"}"）字符，否则会导致模板变量检验失败。                                                                                                           |
   
#### 变量示例
| 变量格式  | 填写示例                                               | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|
| 按序号标识 | ${1}、${2}、...、${20}                                | - 长度限制：1-20个字符。  - 中间数字应代表变量在模板内容中的位置顺序。即${1}表示模板内容中的第一个变量，${2}表示模板内容中的第二个变量，以此类推。   说明： 特殊内容（如网址、手机号等）不允许设置局部变量，如www.${1}.cn、186${2}1234等。 |
| 按类型标识 | ${PHONE}、${CHARDIGIT}、${DATETIME}、${MONEY}、${TEXT} | 中间字符表示变量类型，各变量有默认长度限制，不支持自定义设置。                                                                                                                                                                                                                                                                                                                                                                                                             |
   
如有任何疑问，请联系[华为云智能客服](https://console.huaweicloud.com/smartadvisor/#/)，将有专人为您解答。