# 查询模板列表
#### 功能介绍
查询模板列表。
#### URI
- URI格式
  ```
  GET /v1/{project_id}/screens/templates
  ```
  
- 参数说明
  表1URI参数说明 
  | 参数         | 是否必选 | 参数类型   | 描述                                                                              |
  |:---|:---|:---|:---|
  | project_id | 是    | String | 项目编号，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-dlv/dlv_02_0501.html)。 |
     
  
 
#### 请求消息
参数说明：如[表2]所示。
 表2请求参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                |
|:---|:---|:---|:---|
| workspaceId | 是    | String | 工作空间ID，长度为32个字符，获取方法请参见[获取workspaceId](https://support.huaweicloud.com/api-dlv/dlv_02_0605.html)。 |
   
#### 响应消息
参数说明：如[表3]所示。
 表3响应参数 
| 参数          | 参数类型    | 描述                                 |
|:---|:---|:---|
| id          | String  | 模板ID                               |
| name        | String  | 模板名称                               |
| description | String  | 模板的描述信息                            |
| thumbnail   | String  | 模板缩略图的存储地址                         |
| priority    | Integer | 模板优先级，即模板在控制台中的位置，从左到右，第一位为0。      |
| size        | String  | 模板的屏幕大小                            |
| createDate  | Long    | 模板创建时间                             |
| updateDate  | Long    | 模板更新时间                             |
| status      | Integer | 模板状态：0-created，1- deleted，2-shared |
| locale      | String  | 语言标识。                              |
| permission  | Boolean | 是否具有该模板的访问权限。true：有权限。false：无权限。   |
   
#### 示例
- 请求示例
  ```
  GET https://{dlv_endpoint}/v1/{project_id}/screens/templates
  {请求消息头}
  {
      "workspaceId": "86ce107974ce4f93b618acb232863027"
  }
  ```
  
  
- 成功响应示例
  ```
  [
      {
          "id": "32546212564",
          "name": "blank_template",
          "description": "在空白画布上尽情施展您的创意吧！",
          "thumbnail": "",
          "priority": 0,
          "size": "尺寸自定",
          "createDate": 1533176653819,
          "updateDate": 1533176653819,
          "status": 0,
          "locale": en-us,
          "permission": true
      }
  ]
  ```
  
  
- 失败响应示例
  ```
  {
      "errors": [
          {
              "error_code": "1004",
              "error_msg": "The operation with the resource entity occur some error."
          }
      ]
  }
  ```
  
 
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-dlv/dlv_02_0603.html)。