
# 创建短信模板 - CreateTemplate
#### 功能介绍
该接口用于用户创建模板。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/MSGSMS/doc?api=CreateTemplate)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
POST /v2/{project_id}/msgsms/templates
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                      |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID，参考[获取帐号、用户、项目的名称和ID](https://support.huaweicloud.com/api-msgsms/sms_05_0020.html)。 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                       |
|:---|:---|:---|:---|
| Content-Type | 是    | String | 请求体参数类型，该字段必须设置为：application/json                        |
| X-Auth-Token | 是    | String | 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
   
表3请求Body参数 
| 参数                  | 是否必选 | 参数类型                                                                                          | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| app_id              | 是    | String                                                                                        | 应用主键ID，参考[表5 响应SmsAppQueryResp参数](https://support.huaweicloud.com/api-msgsms/sms_05_0022.html#ZH-CN_TOPIC_0000001380032914__table133082032111715)中的ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| brackets            | 否    | String                                                                                        | 中括号类型。支持枚举值： - CN：中文类型【】  - GB：英文类型\[\] 须知： - 默认值为：CN。  - 输入值不在上述枚举值范围内的，也按CN处理。  - 只有地域为国内时，该字段有效。                                                                                                                                                                             |
| region              | 是    | String                                                                                        | 地域。 - cn：国内  - intl：国际                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| send_country        | 否    | Array of Integers                                                                             | 发送国家ID列表，只有地域为国际时，该字段有效。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| sign_id             | 否    | String                                                                                        | 签名主键ID，对应[表5 响应SmsSignatureResp参数](https://support.huaweicloud.com/api-msgsms/sms_05_0028.html#ZH-CN_TOPIC_0000001430073161__table822693813014)中的ID。只有地域为国内，且universal_template参数值不为1时，该字段有效。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| template_content    | 是    | String                                                                                        | 模板内容。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| template_desc       | 否    | String                                                                                        | 模板描述。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| template_name       | 是    | String                                                                                        | 模板名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| template_type       | 是    | String                                                                                        | 模板类型。只有地域为国内，且universal_template参数值不为1时，该字段有效。universal_template参数值为0，则模板类型继承绑定签名的签名类型。支持枚举值： - VERIFY_CODE_TYPE：验证码类。  - PROMOTION_TYPE：推广类。  - NOTIFY_TYPE：通知类。                                                                                                                                                                                                                                                                                                                                                                 |
| universal_template  | 否    | Integer                                                                                       | 是否为通用模板，当传参为1时，sign_id字段无效 - 0：非通用模板  - 1：通用模板                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| variable_attributes | 否    | Array of [SmsTemplateVariableAttrReq] objects | 模板参数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| flow_status         | 否    | String                                                                                        | 流程状态 - Adopted：通过  - Reviewing：审核中  - Reject：拒绝  - Disable：停用  - Pending：待提交  - Adopted_inactive：审核通过-去激活  - SignReviewing：待签名审核   |
   
 表4SmsTemplateVariableAttrReq 
| 参数             | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| variable_desc  | 否    | String  | 变量说明，当变量类型为TEXT时，必填                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| variable_index | 是    | Integer | 变量索引，对应模板内容变量索引                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| variable_type  | 是    | String  | 变量类型 - PHONE：电话号码  - CHARDIGIT：其他号码（如验证码、订单号、密码等）  - DATETIME：日期时间  - MONEY：金额  - TEXT：其他（如名称、帐号、地址等）   |
   
#### 响应参数
表5响应Body参数 
| 参数            | 参数类型   | 描述     |
|:---|:---|:---|
| id            | String | 模板主键ID |
| template_name | String | 模板名称   |
   
#### 请求示例
创建短信模板，请求方式：POST ，请求URL：/v2/{project_id}/msgsms/templates，路径参数：project_id，请求头参数：X-Auth-Token，Content-Type；请求体：app_id，region，template_content，template_type，template_name。
```
POST /v2/845ada5bc7444f1295cd517af0123da1/msgsms/templates 
Host: 100.85.***.***:30300
Content-Type: application/json
X-Auth-Token: ****
Content-Length: 308
 
{
    "app_id": "******9c-1a6b-4ee5-9651-5bca450694b3",
    "brackets": "GB",
    "region": "cn",
    "sign_id": "******10-c3fb-427e-965c-a98ae844c5bd",
    "template_content": "测试",
    "template_name": "auto_test789",
    "template_type": "NOTIFY_TYPE",
    "universal_template": 0
}
```
#### 响应示例
```
{
    "id": "******27-37eb-4229-bee9-0eba4d8a897f",
    "template_name": "auto_test789"
}
```
#### 返回值
| 状态码 | 描述           |
|:---|:---|
| 200 | OK           |
| 201 | Created      |
| 401 | Unauthorized |
| 403 | Forbidden    |
| 404 | Not Found    |
| 500 | System error |
   
