文档首页/ 智能数据洞察 DataArts Insight/ API参考/ 大屏/ 更新大屏
更新时间：2024-10-14 GMT+08:00
查看PDF
分享

更新大屏

功能介绍

更新大屏。

URI

PUT /v1/{project_id}/screens/update

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释： 项目唯一标识ID,获取方法请参考获取项目ID。 约束限制： 不涉及 取值范围： 只能使用中英文字符,字符长度32位。 默认取值： 不涉及

最小长度：0

最大长度：128

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Workspace-Id

是

String

参数解释： 工作空间ID，即控制台的项目ID。 约束限制： 不涉及 取值范围： 只能使用中英文字符,字符长度32位。 默认取值： 不涉及

最小长度：0

最大长度：128

X-Auth-Token

是

String

参数解释： 用户Token。 通过调用IAM服务获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token 认证鉴权 约束限制： 不涉及 取值范围： 非空 默认取值： 不涉及

最小长度：0

最大长度：8192
表3 请求Body参数

参数

是否必选

参数类型

描述

id

是

String

参数解释： 大屏主键。 约束限制： 不涉及 取值范围： 只能使用中英文字符,字符长度32位。 默认取值： 不涉及

最小长度：0

最大长度：128

name

是

String

参数解释： 大屏名称。 约束限制： 不涉及 取值范围： 只允许输入长度为1到32位由数字、中文、英文、空格、下划线（_）或中划线（-）组成的字符，且开头和结尾不能有空格。 默认取值： 不涉及

最小长度：1

最大长度：32

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

id

String

大屏ID。

最小长度：0

最大长度：128

name

String

大屏名称。

最小长度：0

最大长度：32

pages

Array of ScreenPageOpenApiVO objects

大屏Page列表。

数组长度：0 - 100
表5 ScreenPageOpenApiVO

参数

参数类型

描述

id

String

Page ID。

最小长度：0

最大长度：128

name

String

Page名称。

最小长度：0

最大长度：32

nodes

Array of ScreenNodeOpenApiVO objects

Page内组件列表。

数组长度：0 - 1000
表6 ScreenNodeOpenApiVO

参数

参数类型

描述

id

String

组件ID。

最小长度：0

最大长度：128

name

String

组件名称。

最小长度：0

最大长度：32

type

String

组件类型。

最小长度：0

最大长度：32

hidden

Boolean

组件是否隐藏。

target_nodes

Array of target_nodes objects

交互事件关联组件。

数组长度：0 - 100
表7 target_nodes

参数

参数类型

描述

id

String

关联组件ID。

最小长度：0

最大长度：128

field_id

String

关联组件字段ID。

最小长度：0

最大长度：128

请求示例

更新大屏。

https://{endpoint}/v1/{project_id}/screens/update

{
  "id" : "00xxxx3e-45e5-4cc3-847c-dcxxxx42424d",
  "name" : "updateScreen"
}

响应示例

状态码： 200

更新大屏成功。

  • 示例 1 
    {
  "id" : "xx",
  "name" : "空白大屏",
  "pages" : [ {
    "id" : "",
    "name" : "",
    "nodes" : [ ]
  } ],
  "status" : 0
}
  • 示例 2 
    • 
  

 

 

  
状态码

  

   

    
     

      
       
状态码

      
       
描述

     

    
    
     

      
       
200

      
       
更新大屏成功。

     

    
   

  

 

 

  
错误码

  
请参见错误码。

 





 

  

   父主题： 大屏
  

 



    
  


  

  
  
  

    
    

      
相关文档