# 查询大屏详细信息
#### 功能介绍
获取某一个大屏的详细信息。
#### URI
- URI格式
  ```
  GET /v1/{project_id}/screens/{screen_id}?workspaceId={}
  ```
  
- 参数说明
  表1URI参数说明 
  | 参数          | 是否必选 | 参数类型   | 描述                                                                                               |
  |:---|:---|:---|:---|
  | project_id  | 是    | String | 项目编号，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-dlv/dlv_02_0501.html)。                  |
  | screen_id   | 是    | String | 大屏ID，获取方法请参见[查询大屏列表](https://support.huaweicloud.com/api-dlv/dlv_02_0525.html)。                  |
  | workspaceId | 是    | String | 工作空间ID，长度为32个字符，获取方法请参见[获取workspaceId](https://support.huaweicloud.com/api-dlv/dlv_02_0605.html) |
     
  
 
#### 响应消息
参数说明：如[表2]所示。
 表2响应参数 
| 参数          | 参数类型                                            | 描述                                 |
|:---|:---|:---|
| id          | String                                          | 大屏ID                               |
| name        | String                                          | 大屏名称                               |
| alias       | String                                          | 大屏别名                               |
| description | String                                          | 大屏的描述信息                            |
| status      | Integer                                         | 大屏状态：0-created，1- deleted，2-shared |
| projectId   | String                                          | 项目编号，即project_id                   |
| createUser  | String                                          | 大屏的创建者                             |
| createDate  | Integer                                         | 大屏的创建时间戳                           |
| updateUser  | String                                          | 大屏的更新者                             |
| updateDate  | Integer                                         | 大屏的更新时间戳                           |
| templateId  | String                                          | 基于模板创建大屏的模板ID                      |
| snapshotId  | String                                          | 大屏快照的ID                            |
| share       | String                                          | 大屏分享的UUID标识                        |
| thumbnail   | String                                          | 大屏缩略图的访问地址                         |
| config      | [config] object | 大屏的配置内容                            |
   
 表3config数据结构 
| 参数     | 参数类型                                                         | 描述   |
|:---|:---|:---|
| scenes | Array of [scene] objects   | 场景信息 |
| config | Array of [config] objects | 配置详情 |
   
 表4scene 
| 参数     | 参数类型                                                        | 描述   |
|:---|:---|:---|
| name   | String                                                      | 场景名称 |
| layers | Array of [layer] objects | 分层   |
   
 表5layer 
| 参数   | 参数类型   | 描述     |
|:---|:---|:---|
| id   | String | 分层的ID  |
| name | String | 分层的名称。 |
| coms | Array  | 组件列表   |
   
 表6config 
| 参数              | 参数类型                                                                                                        | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|
| id              | String                                                                                                      | 大屏配置唯一标识                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| screenId        | String                                                                                                      | 大屏ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| grid            | Integer                                                                                                     | 栅格间距，单位为像素                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| backgroundImage | String                                                                                                      | 背景图片OBS链接                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| backgroundColor | String                                                                                                      | 背景颜色                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| width           | Integer                                                                                                     | 屏幕宽度，单位为像素                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| height          | Integer                                                                                                     | 屏幕高度，单位为像素                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| whLinkage       | Integer                                                                                                     | 大屏宽度和高度联动配置状态；0：关闭；1：开启                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| comList         | String                                                                                                      | 组件列表                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| screenshot      | String                                                                                                      | 封面图                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| display         | Integer                                                                                                     | 缩放方式： - 1：按宽度等比缩放铺满  - 2：按高度等比缩放铺满  - 3：等比缩放自适应  - 4：全屏拉铺满   |
| watermarkFlag   | Integer                                                                                                     | 是否有水印                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| rulerLines      | [rulerLines](https://support.huaweicloud.com/api-dlv/dlv_02_0522.html#dlv_02_0522__table18937226595) object | 坐标                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| variables       | [variables](https://support.huaweicloud.com/api-dlv/dlv_02_0522.html#dlv_02_0522__table842515118017) object | 交互信息                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| workspaceId     | String                                                                                                      | 工作空间ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
   
表7rulerLines 
| 参数   | 参数类型    | 描述                     |
|:---|:---|:---|
| h    | String  | 水平标尺线坐标，单位为像素          |
| v    | String  | 垂直标尺线坐标，单位为像素          |
| show | Boolean | 是否显示，true：显示，false：不显示 |
   
表8variables 
| 参数              | 参数类型   | 描述         |
|:---|:---|:---|
| publishersView  | String | 发送组件交互参数列表 |
| subscribersView | String | 接收组件交互参数列表 |
   
#### 示例
查询大屏ID为ff80808167813a360167819d5b640045的详细信息。
- 请求示例
  ```
  GET https://{dlv_endpoint}/v1/{project_id}/screens/ff80808167813a360167819d5b640045?workspaceId={86ce107974ce4f93b618acb232863027}
  ```
  
  
- 成功响应示例
  ```
  {
      "id": "ff80808167813a360167819d5b640045",
      "name": "screen_01",
      "alias": "test_screen_01",
      "description": "for test",
      "status": 2,
      "projectId": "abcdefghijk0123456",
      "createUser": "a1b2c2d3e4f5g6h5j6k6",
      "createDate": 1544067832676,
      "updateUser": null,
      "updateDate": null,
      "templateId": "32546212564",
      "snapshotId": null,
      "share": "f7c9a336e6c74ca5883a60af882d92de",
      "thumbnail": null,
      "config": {
          "scenes": [
              {
                  "name": "场景1",
                  "layers": [
                      {
                          "id": "ff80808167813a360167819d5b640047",
                          "name": "层1",
                          "coms": []
                      }
                  ]
              }
          ],
          "config": {
              "id": "ff80808167813a360167819d5b650048",
              "screenId": "ff80808167813a360167819d5b640045",
              "grid": null,
              "backgroundImage": "",
              "backgroundColor": null,
              "width": 1920,
              "height": 1080,
              "whLinkage": null,
              "comList": "",
              "screenshot": null,
              "display": 1,
              "watermarkFlag": null,
              "rulerLines": null,
              "variables": null
          }
      }
  }
  ```
  
  
- 失败响应示例
  ```
  {
      "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)。