华为云用户手册

样式 尺寸位置 图表尺寸：设置图表的宽和高。单位为px。 图表位置：设置图表在画布中的位置。单位为px。 图1 尺寸位置-高级地球 添加子组件 高级地球的子组件包括地球飞线、地球热力点。 地球飞线 以动态飞线的形式连接地球中的两个地理位置，飞线的样式、位置的经纬值参考以下步骤进行配置。 单击“添加子组件”，添加地球飞线。 图2 添加地球飞线-高级地球 单击“地球飞线”，进入地球飞线的配置页面。 在“样式”页签，配置飞线的高度、速度、粗细和颜色。 图3 配置地球飞线样式-高级地球 在“数据”页签，配置飞线的起点和终点的经纬度。 数据格式：from为飞线的起点，to为飞线的终点。 自动更新请求：勾选自动更新请求，并设置更新间隔后，动态数据将根据间隔时间自动轮询。 地球热力点 以热力点的形式表现地球中的某些地理位置的数据信息，热力点的样式、经纬度参考以下步骤进行配置。 单击“添加子组件”，添加地球热力点。 图4 添加地球热力点-高级地球 单击“地球热力点”，进入地球热力点的配置页面。 在“样式”页签，配置热力点的高度和颜色。 图5 配置地球热力点样式-高级地球 在“数据”页签，配置热力点的经纬度和大小。 数据格式：lon为热力点的经度；lat为热力点的纬度；value为热力点的值；type为热力点的类型。 自动更新请求：勾选自动更新请求，并设置更新间隔后，动态数据将根据间隔时间自动轮询。 全局样式 球体类型：单击下拉选择，设置球体类型。可设置为粒子、行政区、卫星。 x轴：输入数值或拖动设置地球的x轴。 y轴：输入数值或拖动设置地球的y轴。 z轴：输入数值或拖动设置地球的z轴。 自转速度：输入数值或拖动设置地球的自转速度。值越大，自传速度越快。 灯光 显示/隐藏灯光：单击“灯光”右侧的勾选框，表示显示灯光，表示隐藏灯光。 强度：输入数值或拖动设置灯光的强弱。数值越大，灯光越强。 颜色：单击颜色编辑器设置灯光的颜色。 背光 显示/隐藏背光：单击“背光”右侧的勾选框，表示显示背光，表示隐藏背光。 大小：背光大小类似于球体向周围发光的辐射范围。输入数值或拖动可以调节数值大小。数值越大，辐射范围越大。 z轴：指球体后边的发光源。输入数值或拖动可以调节数值大小，值越小，光影越大；值越大，光影越小。 颜色：单击颜色编辑器设置背光的颜色。 飞线 显示/隐藏飞线：单击“飞线”右侧的勾选框，表示显示飞线，表示隐藏飞线。 高度：输入数值或拖动设置飞线的高度。数值越大，飞线的高度越高。 速度：输入数值或拖动设置飞线的速度。数值越大，飞线的运行速度越快。 粗细：输入数值或拖动设置飞线的粗细。数值越大，飞线越粗。 颜色：单击颜色编辑器设置飞线的颜色。

样式 尺寸位置 图表尺寸：设置图表的宽和高。单位为px。 图表位置：设置图表在画布中的位置。单位为px。 添加子组件 地图的子组件包括地图飞线、地图散点、柱状层。 地图飞线 以动态飞线的形式连接地图中的两个地理位置，飞线的样式、位置的经纬值参考以下步骤进行配置。 单击“添加子组件”，添加地图飞线。 单击“地图飞线”，进入地图飞线的配置页面。 在“样式”页签，配置飞线的飞行速率、飞线粗细、飞线长度和颜色。 图1 配置地图飞线样式-3D中国地图 在“数据”页签，配置飞线的起点和终点的经纬度。 数据格式：from为飞线的起点，to为飞线的终点。 自动更新请求：勾选自动更新请求，并设置更新间隔后，动态数据将根据间隔时间自动轮询。 地图散点 以散点的形式表现地图中的某些地理位置的数据信息，散点的样式、经纬度参考以下步骤进行配置。 单击“添加子组件”，添加地图散点。 单击“地图散点”，进入地图散点的配置页面。 在“样式”页签，配置散点的散点大小、样式、颜色、透明度和选中样式的颜色，提示信息的颜色、字号、字体粗细。 图2 配置地图散点样式-3D中国地图 在“数据”页签，配置散点的经纬度和大小。 数据格式：lon为散点的经度；lat为散点的纬度；value为散点的值，与样式中散点大小一起决定散点的大小，value值越大，散点越大。 自动更新请求：勾选自动更新请求，并设置更新间隔后，动态数据将根据间隔时间自动轮询。 柱状层 以3D柱状的形式表现地图中的某些地理位置的数据信息，柱状层的样式、经纬度参考以下步骤进行配置。 单击“添加子组件”，添加柱状层。 单击“柱状层”，进入柱状层的配置页面。 在“样式”页签，配置柱状层的柱子粗细、柱子的最小高度值、柱子的颜色和颜色透明度。 图3 配置柱状层样式-3D中国地图 在“数据”页签，配置柱子的经纬度和高度。 数据格式：lon为柱子的经度；lat为柱子的纬度；value为柱子的值，value值越大，柱子越高。 自动更新请求：勾选自动更新请求，并设置更新间隔后，动态数据将根据间隔时间自动轮询 全局样式 地图中心：设置地图中心在图层中的位置。 地球旋转：设置地图的缩放距离、水平旋转角度、垂直旋转角度。 地图颜色：设置地图中区域块的填充色。 边线选项：设置地图中区域边线的颜色和宽度。

柱状层 柱状层是以3D柱状的形式表现地图中的某些地理位置的数据信息。 图9 3D世界地图(2019) - 柱状层 样式 高度：柱子的高度。单位px。 颜色：柱子的颜色。 数据 图10 柱状层 - 数据 字段映射：地图散点的数据格式包含以下2个字段，请配置lon和lat字段映射到数据源中的字段名称，如果配置为空，则表示字段名称和所映射的数据源中的字段名称相同。 lat：柱子的纬度。 lon：柱子的经度。 数据源的数据格式为JSON格式，示例如下： [ { "lat": 6, "lon": 159 }, { "lat": 30, "lon": 99 } ] 数据源类型：选择图表的数据源。系统提供了多种数据源供用户选择，您需要先添加数据源，具体操作请参见数据连接概述。 自动更新请求：勾选自动更新请求，并设置更新间隔后，数据将根据间隔时间自动轮询。 查看数据响应结果：单击“查看数据响应结果”，显示选择的数据源的数据信息。 交互 关于组件是否支持交互功能及交互的使用方法，请参考设置组件事件交互。

地图飞线 地图飞线是以动态飞线的形式连接地图中的两个地理位置。 图5 3D世界地图(2019) - 地图飞线 样式 虚线：虚线的样式。 高度：飞线轨迹弯曲的高度。当高度为1时，飞线近似直线。 速度：飞线飞行的速率。 粗细：耀斑的粗细。 颜色：飞线的颜色。 数据 图6 地图飞线 - 数据 字段映射：地图飞线的数据格式包含以下2个字段，请配置以下2个字段映射到数据源中的字段名称，如果配置为空，则表示字段名称和所映射的数据源中的字段名称相同。 from：飞线起点位置的经度和纬度，经纬度之间以逗号分隔。 to：飞线终点位置的经度和纬度，经纬度之间以逗号分隔。 数据源的数据格式为JSON格式，示例如下： [ { "from": "116.85059,31.69078", "to": "118.69629,36.20882" }, { "from": "120.89355,37.09024", "to": "116.93848,31.61597" } ] 数据源类型：选择图表的数据源。系统提供了多种数据源供用户选择，您需要先添加数据源，具体操作请参见数据连接概述。 自动更新请求：勾选自动更新请求，并设置更新间隔后，数据将根据间隔时间自动轮询。 查看数据响应结果：单击“查看数据响应结果”，显示选择的数据源的数据信息。 交互 关于组件是否支持交互功能及交互的使用方法，请参考设置组件事件交互。

地图散点 地图散点是以散点的形式表现地图中的某些地理位置的数据信息。 图7 3D世界地图(2019) - 地图散点 样式 大小：散点的大小。 颜色：散点的颜色。 数据 图8 地图散点 - 数据 字段映射：地图散点的数据格式包含以下3个字段，请配置lon和lat字段映射到数据源中的字段名称，如果配置为空，则表示字段名称和所映射的数据源中的字段名称相同。 lat：散点的纬度。 lon：散点的经度。 value：散点的值，与样式中的“大小”一起决定散点的大小，value值越大，散点越大。 数据源的数据格式为JSON格式，示例如下： [ { "lat": 62.103883, "lon": -106.523438, "value": 51 }, { "lat": 50.064192, "lon": -74.179688, "value": 94 } ] 数据源类型：选择图表的数据源。系统提供了多种数据源供用户选择，您需要先添加数据源，具体操作请参见数据连接概述。 自动更新请求：勾选自动更新请求，并设置更新间隔后，数据将根据间隔时间自动轮询。 查看数据响应结果：单击“查看数据响应结果”，显示选择的数据源的数据信息。 交互 关于组件是否支持交互功能及交互的使用方法，请参考设置组件事件交互。

样式 尺寸位置 图表尺寸：图表的宽和高。单位均为px。 图表位置：图表在画布中的位置。单位均为px。 全局样式 地图中心：设置地图中心在图层中的位置。 地球旋转：设置地图的缩放距离、水平旋转角度、垂直旋转角度。 地图颜色：设置地图中区域块的填充色。 边线选项：设置地图中区域边线的颜色和宽度。 图2 边线选项 - 3D世界地图(2019) 添加子组件 在3D世界地图(2019)中可添加的子组件有：地图飞线、地图散点、柱状层。 地图子组件的相关操作如下： 添加子组件 在“样式”配置栏，单击“添加子组件”按钮，然后在弹出菜单中选择一个子组件，即可将该子组件添加到地图组件中。子组件添加完成后，在“添加子组件”按钮下方会显示所添加的子组件名称，例如“地图飞线”。 图3 添加子组件 编辑子组件 单击子组件名称就可以编辑子组件。 删除子组件 单击子组件名称后面的按钮，可以删除该子组件。

样式 尺寸位置 图表尺寸：设置图表的宽和高。单位为px。 图表位置：设置图表在画布中的位置。单位为px。 添加子组件 地球的子组件包括地球飞线、地球热力点。 地球飞线 以动态飞线的形式连接地球中的两个地理位置，飞线的样式、位置的经纬值参考以下步骤进行配置。 单击“添加子组件”，添加地球飞线。 图2 添加地球飞线-地球 单击“地球飞线”，进入地球飞线的配置页面。 在“样式”页签，配置飞线的高度、速度、粗细和颜色。 图3 配置地球飞线样式-地球 在“数据”页签，配置飞线的起点和终点的经纬度。 数据格式：from为飞线的起点，to为飞线的终点。 自动更新请求：勾选自动更新请求，并设置更新间隔后，动态数据将根据间隔时间自动轮询。 地球热力点 以热力点的形式表现地球中的某些地理位置的数据信息，热力点的样式、经纬度参考以下步骤进行配置。 单击“添加子组件”，添加地球热力点。 图4 添加地球热力点-地球 单击“地球热力点”，进入地球热力点的配置页面。 在“样式”页签，配置热力点的高度和颜色。 图5 配置地球热力点样式-地球 在“数据”页签，配置热力点的经纬度和大小。 数据格式：lon为热力点的经度；lat为热力点的纬度；value为热力点的值；type为热力点的类型。 自动更新请求：勾选自动更新请求，并设置更新间隔后，动态数据将根据间隔时间自动轮询。 全局样式 相机：通过拖动设置相机的x轴，y轴，z轴。 自转速度：通过拖动设置地球的自转速度。 图6 全局样式-地球 飞线 显示/隐藏飞线：单击“飞线”右侧的勾选框，表示显示飞线，表示隐藏飞线。 高度：输入数值或拖动设置飞线的高度。 速度：输入数值或拖动设置飞线的速度。 粗细：输入数值或拖动设置飞线的粗细。 颜色：单击颜色编辑器设置飞线的颜色。 图7 飞线-地球

地图散点 地图散点是以散点的形式表现地图中的某些地理位置的数据信息。 样式 大小：散点的大小。 颜色：散点的颜色。 数据 图4 地图散点-数据 字段映射：地图散点的数据格式包含以下3个字段，请配置lon和lat字段映射到数据源中的字段名称，如果配置为空，则表示字段名称和所映射的数据源中的字段名称相同。 lon：散点的经度。 lat：散点的纬度。 value：散点的值，与样式中的“大小”一起决定散点的大小，value值越大，散点越大。 数据源的数据格式为JSON格式，示例如下： [ { "lat": 62.103883, "lon": -106.523438, "value": 51 }, { "lat": 50.064192, "lon": -74.179688, "value": 94 } ] 数据源类型：选择图表的数据源。系统提供了多种数据源供用户选择，您需要先添加数据源，具体操作请参见数据连接概述。 自动更新请求：勾选自动更新请求，并设置更新间隔后，数据将根据间隔时间自动轮询。 查看数据响应结果：单击“查看数据响应结果”，显示选择的数据源的数据信息。 交互 关于组件是否支持交互功能及交互的使用方法，请参考设置组件事件交互。

柱状层 柱状层是以3D柱状的形式表现地图中的某些地理位置的数据信息。 样式 高度：柱子的高度。单位px。 颜色：柱子的颜色。 数据 图5 柱状层-数据 字段映射：地图散点的数据格式包含以下2个字段，请配置lon和lat字段映射到数据源中的字段名称，如果配置为空，则表示字段名称和所映射的数据源中的字段名称相同。 lon：柱子的经度。 lat：柱子的纬度。 数据源的数据格式为JSON格式，示例如下： [ { "lat": 31.8998, "lon": 102.2212 }, { "lat": 28.6542, "lon": 120.079 } ] 数据源类型：选择图表的数据源。系统提供了多种数据源供用户选择，您需要先添加数据源，具体操作请参见数据连接概述。 自动更新请求：勾选自动更新请求，并设置更新间隔后，数据将根据间隔时间自动轮询。 查看数据响应结果：单击“查看数据响应结果”，显示选择的数据源的数据信息。 交互 关于组件是否支持交互功能及交互的使用方法，请参考设置组件事件交互。

样式 尺寸位置 图表尺寸：图表的宽和高。单位均为px。 图表位置：图表在画布中的位置。单位均为px。 全局样式 地图中心：设置地图中心在图层中的位置。 地球旋转：设置地图的缩放距离、水平旋转角度、垂直旋转角度。 地图颜色：设置地图中区域块的填充色。 边线选项：设置地图中区域边线的颜色和宽度。 添加子组件 在3D中国地图(2019)中可添加的子组件有：地图飞线、地图散点、柱状层。 地图子组件的相关操作如下： 添加子组件 在“样式”配置栏，单击“添加子组件”按钮，然后在弹出菜单中选择一个子组件，即可将该子组件添加到地图组件中。子组件添加完成后，在“添加子组件”按钮下方会显示所添加的子组件名称，例如“地图飞线”。 图1 添加子组件 编辑子组件 单击子组件名称就可以编辑子组件。 删除子组件 单击子组件名称后面的按钮，可以删除该子组件。

地图飞线 地图飞线是以动态飞线的形式连接地图中的两个地理位置。 样式 虚线：虚线的样式。 高度：飞线轨迹弯曲的高度。当高度为1时，飞线近似直线。 速度：飞线飞行的速率。 粗细：耀斑的粗细。单位px。 颜色：飞线的颜色。 数据 图3 地图飞线-数据 字段映射：地图飞线的数据格式包含以下2个字段，请配置以下2个字段映射到数据源中的字段名称，如果配置为空，则表示字段名称和所映射的数据源中的字段名称相同。 from：飞线起点位置的经度和纬度，经纬度之间以逗号分隔。 to：飞线终点位置的经度和纬度，经纬度之间以逗号分隔。 数据源的数据格式为JSON格式，示例如下： [ { "from": "116.85059,31.69078", "to": "118.69629,36.20882" }, { "from": "120.89355,37.09024", "to": "116.93848,31.61597" } ] 数据源类型：选择图表的数据源。系统提供了多种数据源供用户选择，您需要先添加数据源，具体操作请参见数据连接概述。 自动更新请求：勾选自动更新请求，并设置更新间隔后，数据将根据间隔时间自动轮询。 查看数据响应结果：单击“查看数据响应结果”，显示选择的数据源的数据信息。 交互 关于组件是否支持交互功能及交互的使用方法，请参考设置组件事件交互。

发布大屏 登录 DLV 控制台。 在“我的大屏”页面，找到需要发布的大屏，将鼠标移至该大屏图标之上，界面上将显示大屏的管理按钮，单击发布按钮。 图1 发布大屏 您也可以在大屏开发页面右上方，单击发布按钮发布大屏。 图2 大屏发布 在弹出的“发布”页面，配置发布参数。 图3 配置发布参数 发布状态 开启发布按钮（如图3所示），让其他用户也能访问该大屏。当大屏开启发布状态后，其他用户想要访问大屏时，不需要登录到DLV系统中，只要打开浏览器并在地址栏中输入“分享”参数中的链接就可以访问大屏了。 版本管理 设置用户通过分享链接访问大屏时，允许查看的大屏版本。 实时更新发布：当大屏内容有修改时，用户可以即时查看到最新的大屏内容。系统默认选项，不支持删除。 历史快照：将当前的大屏内容作为一个版本进行存档，存档后大屏内容的修改不会同步到该历史快照中。当某一个历史快照设置为“分享中”时，用户可以查看该版本的大屏内容。 分享密钥 设置大屏的分享方式。 公开分享：不设置密码访问和Token验证时，即为公开分享，用户通过分享链接直接访问大屏。DLV基础版只支持公开分享方式，不支持其他分享方式。 密码访问：在“设置访问密码”选项卡开启密码访问，开启后按钮显示为，然后在输入框中设置发布密码。设置密码成功后，用户在浏览器中通过分享链接访问大屏时，需要输入该密码才能访问。 您也可以开启“验证有效期”，开启后，当用户登录验证成功后，在所设置的有效期内访问大屏无需再次验证，超过时间需要重新验证。关闭后，每次访问都需要通过验证。 图4 输入发布密码 Token访问：在“设置Token验证”选项卡开启Token验证访问。 系统会随机生成验证码，您需要记录下这个Token。您也可以开启“验证有效期”，开启后，使用该Token访问大屏验证成功后，在所设置的有效期内无需再次验证，超过时间需要重新验证。关闭后，每次访问都需要通过验证。 图5 设置Token验证 在这个时候，如果您尝试直接打开您所分享的页面，您会收到一个认证失败提示。表示您的访问被拒绝了。 如果您想要打开您所分享的页面，需要完成如下几个步骤： 为了防止重放攻击，请确保您的服务器时间为东8区标准时间，DLV只会提供1分钟的误差，如果时间误差超过1分钟将会验证失败。 发布大屏，记录分享的大屏编码（分享链接中share后面的一串字符串）。 将大屏编码和当前时间（毫秒）连起来，并用 |（竖线）分隔开。 使用 token 通过 HMAC-SHA256 base64 对3.b中的字符串进行加密。 将时间和加密后的签名分别命名为dlv_time，dlv_signature。 将它们依次放入分享链接的querystring中。 示例如下： Java: package com.test; import java.security.*; import javax.crypto.*; import javax.crypto.spec.SecretKeySpec; import org.apache.commons.codec.binary.Base64; import java.net.URLEncoder; public class ShareWithTokenTest { public static void main(String[] args) throws Exception { System.out.println(getShareUrlWithToken("********722467a9477b5b*******", "*******r1tyy1C7Jenni3p*********")); } public static String getShareUrlWithToken(String shareID, String token){ long time = System.currentTimeMillis(); String data = shareID + "|" + time; String signature = HMA CS HA256(data.getBytes(), token.getBytes()); String url = "https://console.huaweicloud.com/dlv/vision/share/?id="+shareID +"&dlv_time="+time+"&dlv_signature="+ signature+"&locale=zh-cn®ion=cn-north-4"; return url; } //采用HmacSHA256进行签名 public static String HMACSHA256(byte[] data, byte[] key) { try { SecretKeySpec signingKey = new SecretKeySpec(key, "HmacSHA256"); Mac mac = Mac.getInstance("HmacSHA256"); mac.init(signingKey); return URLEncoder.encode(Base64.encodeBase64String(mac.doFinal(data))); } catch (NoSuchAlgorithmException e) { e.printStackTrace(); } catch (InvalidKeyException e) { e.printStackTrace(); } return null; } } 上述代码中的以下参数，请根据实际情况进行替换： System.out.println(getShareUrlWithToken("*****3b44722********5b888211bca", "******er1tyy1C7J*******JxeIlPz8P")中的*******4722467a9477*******11bca为分享链接中share后的参数，*****er1tyy1C7******pzJxe***8P为分享密钥中的参数。 String url = "https://console.huaweicloud.com/dlv/vision/share/?id="+shareID +"&dlv_time="+time+"&dlv_signature="+ signature+"&locale=zh-cn®ion=cn-north-4"中的locale=zh-cn为语言标识，英文为en-us；region=cn-north-4为服务所在区域，cn-north-4为华北-北京四，您也可以在华北-北京一和华南-广州区域中分享大屏。

修订记录 发布日期 修改说明 2023-09-18 第十九次正式发布。 新增如下章节： 设置组件数据中关于字段对应组件的颜色设置。 2023-08-07 第十八次正式发布。 新增如下章节： 修改大屏名称 2023-06-02 第十七次正式发布。 下线组件指南地图章节。 2021-06-01 第十六次正式发布。 增加如下章节： 管理VPC连接 2020-07-08 第十五次正式发布。 修改如下章节： 成员管理 发布大屏 组合大屏 在第三方系统中集成大屏 2020-04-30 第十四次正式发布。 增加如下章节： 上传自定义组件 2020-03-10 第十三次正式发布。 增加如下章节： 设置组件链接交互实现下钻功能 设置URL参数交互 修改如下章节： 创建用户并授权使用DLV 2020-01-19 第十二次正式发布。 增加如下章节： 注册账号并实名认证 购买DLV套餐包 （可选）创建工作空间 创建用户并授权使用DLV 工作空间管理 成员管理 导入导出大屏 在第三方系统中集成大屏 组合大屏 修改如下章节： 创建大屏 新建数据连接 添加组件 2019-12-05 第十一次正式发布。 修改如下章节： 编辑大屏：页面设置增加贴合开关和灵敏度设置。 线状图：新增交互功能。 柱状图：新增交互功能，在“数据”中新增堆叠配置。 柱图类型组件，在“数据”中新增堆叠配置： 水平柱状图 WT柱图 WT水平柱图 折线柱图 双轴折线柱图 WT折线柱图 WT双轴折线柱图 气泡图：新增交互功能。Y轴增加轴类型配置，支持数据value字段映射气泡大小。 2019-10-11 第十次正式发布。 修改如下章节： 编辑大屏：支持辅助线和组件坐标辅助线。 拷贝组件：支持使用快捷键Ctrl + C、Ctrl + V 进行复制、粘贴组件。 数字翻牌器：数字翻牌器支持千分位相关配置、趋势自定义图标、始终动画、小数位配置。 轮播列表柱状图：支持值标签配置、流光配置。 2019-08-30 第九次正式发布。 增加如下章节： 环形柱图 双轴折线柱图 双轴线状图 WT双轴折线柱图 WT双轴线状图 修改如下章节： 新建CSV文件数据连接：增加CSV文件格式说明。 2019-07-11 第八次正式发布。 修改如下章节： 新建API数据连接：支持由DLV的后台服务器代理转发请求。 地理搜索：增加初始化设置启用开关。 2019-06-18 第七次正式发布。 支持WT类图标组件，新增散点图类 CSV数据源增加“文件来源”，支持本地文件和OBS文件两种方式，修改新建CSV文件数据连接。 2019-05-22 第六次正式发布。 修改如下章节: 新建MySQL数据连接中补充使用示例 设置组件事件交互中补充使用示例 2019-04-20 第五次正式发布。 增加如下章节： 查找数据连接 锁定组件 隐藏组件 重命名组件 地理搜索 修改如下章节： 新建数据连接 拷贝组件 删除组件 2019-03-25 第四次正式发布。 修改如下章节： 组件指南 2019-03-05 第三次正式发布。 增加如下章节： 搜索大屏 新建Oracle数据连接 新建MySQL数据连接 新建PostgreSQL数据连接 新建SQL Server数据连接 2019-02-21 第二次正式发布。 修改如下章节： 发布大屏 2018-12-22 第一次正式发布。

用于集成到第三方系统的大屏URL 在第三方系统中集成DLV大屏时，大屏的URL地址要携带应用的AppKey和密钥。DLV大屏和组合大屏均可以集成到第三方系统中。以下以大屏为例，介绍如何生成集成到第三方系统的大屏URL。 参考发布大屏章节发布大屏，发布时需开启Token验证方式，并获取大屏链接，链接格式如下： https://console.huaweicloud.com/dlv/vision/share/?id=*******c5c6343cab********fdfcb4&locale=zh-cn®ion=cn-north-4 用于第三方系统中嵌入使用的大屏链接地址，需要在原始的大屏链接中追加几个参数，嵌入链接地址格式如下所示： https://console.huaweicloud.com/dlv/vision/share/?id=a33b74ac5c6343cab47ae3386efdfcb4&dlv_time={当前的系统时间}&app_id={开放管理页面中的应用AppKey}&dlv_signature={签名}&locale=zh-cn®ion=cn-north-4 id：即share id，在发布大屏时，获取大屏分享链接中share后面的id参数，如图3中红框所示。 图3 获取shareId dlv_time：当前的系统时间，可在应用程序代码中调用系统函数进行获取。 long time = System.currentTimeMillis(); app_id：在开放管理页面中，获取应用的AppKey，获取方法请参见查看应用的AppKey和密钥。 dlv_signature：签名。必须通过代码生成，生成签名的步骤如下： 使用应用的密钥通过HMACSHA256加密算法生成签名。 String data = shareID + "|" + time + "|" + appId; String signature = HMACSHA256(data.getBytes(), token.getBytes()); 将参数id（即变量shareID ）、dlv_time（即变量time）和app_id（即变量appId）连接起来并用竖线（|）分隔，作为生成签名的data。 在开放管理页面中，获取应用的密钥，在应用程序代码中定义为变量token。 有关获取AppKey和密钥的详细内容，请参见查看应用的AppKey和密钥。 locale：语言标识。zh-cn表示中文，en-us表示英文。 region：区域。根据大屏所在的区域进行替换。 如果您需要在第三方系统中集成组合大屏，则请参考发布组合大屏进行发布，发布时需开启Token验证方式，然后获取组合大屏链接。在组合大屏链接中增加•dlv_time：当前的系统时间，可在应用程序...和•app_id：在开放管理页面中，获取应用的Ap...参数，就可以生成用于嵌入第三方系统的组合大屏链接地址。

示例一：将amount值转换成整型 将amount值转换成整型。 insert into temp select cast(amount as INT) from source_stream; 表1 类型转换函数示例 示例 说明 示例 cast(v1 as string) 将v1转换为字符串类型，v1可以是数值类型，TIMESTAMP/DATE/TIME。 表T1: | content (INT) | | ------------- | | 5 | 语句： SELECT cast(content as varchar) FROM T1; 结果： "5" cast (v1 as int) 将v1转换为int, v1可以是数值类型或字符类。 表T1: | content (STRING) | | ------------- | | "5" | 语句： SELECT cast(content as int) FROM T1; 结果： 5 cast(v1 as timestamp) 将v1转换为timestamp类型，v1可以是字符串或DATE/TIME。 表T1: | content (STRING) | | ------------- | | "2018-01-01 00:00:01" | 语句： SELECT cast(content as timestamp) FROM T1; 结果： 1514736001000 cast(v1 as date) 将v1转换为date类型， v1可以是字符串或者TIMESTAMP。 表T1: | content (TIMESTAMP) | | ------------- | | 1514736001000 | 语句： SELECT cast(content as date) FROM T1; 结果： "2018-01-01" Flink作业不支持使用CAST将“BIGINT”转换为“TIMESTAMP”，可以使用to_timestamp进行转换。

请求消息 表2 请求参数 参数 是否必选 参数类型 描述 auto_terminate_time 是 String 云服务器定时删除时间。 按照ISO8601标准表示，并使用UTC +0时间，格式为yyyy-MM-ddTHH:mm:ssZ。 如果秒（ss）取值不是 00，则自动取为当前分钟（mm）开始时。 最短定时删除时间为当前时间半小时之后。 最长定时删除时间不能超过当前时间三年。 如果参数auto_terminate_time为空字符串，表示不设置定时删除或取消定时删除。 示例：2020-09-25T12:05:00Z

请求示例 设置云服务器的定时删除时间为“2020-09-25T12:05:00Z”。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/actions/update-auto-terminate-time { "auto_terminate_time": "2020-09-25T12:05:00Z", } 取消云服务器的定时删除。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/actions/update-auto-terminate-time { "auto_terminate_time": "", }

基本概念 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用用户进行日常管理工作。 用户 由账号在 IAM 中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和IAM用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 详情请参见区域和可用区。 可用区（AZ，Availability Zone） 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中创建资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中的资源，使得资源的权限控制更加精确。 图1 项目隔离模型 同样在我的凭证下，您可以查看项目ID。 企业项目 企业项目是项目的升级版，针对企业不同项目间的资源进行分组和管理，是逻辑隔离。企业项目中可以包含多个区域的资源，且项目中的资源可以迁入迁出。 关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理用户指南》。 父主题： 使用前必读

请求示例 查询CAS2.0接口验证票据，参数分别配置应用回调地址https://example.com及认证登录接口获取的认证票据ST-eYlKs8FrLCltwRwfm8AiwCxmQ8gAL...，使用JSON响应格式获取用户属性信息。 GET https://{domain_name}/api/v1/cas/serviceValidate?service=https://example.com&ticket=ST-eYlKs8FrLCltwRwfm8AiwCxmQ8gAL...&format=JSON

URI GET /api/v1/cas/serviceValidate 表1 Query参数 参数 是否必选 参数类型 描述 service 是 String 应用接受票据的地址，必须与应用CAS配置中的应用回调URL一致。 ticket 是 String 票据，认证登录获取的Service Ticket。 format 否 String 响应用户信息的格式，可选择XML和JSON。 缺省值：XML

API概览 应用身份管理 服务为您提供管理类、用户类和应用集成相关接口。 表1 OneAccess 接口说明 接口分类 接口类型 接口说明 管理类接口 访问认证 包括获取访问凭据。 用户管理 包括创建、修改、删除用户以及为用户授权、查询用户信息等。 组织管理 包括创建、修改、删除组织以及查询组织等。 应用机构管理 包括更新、删除、新增应用机构以及查询应用机构等。 应用帐号管理 包括更新、禁用、启用、删除、新增应用帐号以及查询应用帐号等。 应用侧角色管理 包括更新、删除、新增应用侧角色和应用侧角色成员以及查询应用侧角色、角色成员等。 用户类接口 系统接口 包括获取服务器时间、获取公钥。 注册接口 包括使用手机号和短信验证码注册。 验证码 包括获取图形验证码、校验图形验证码、获取国际区号、发送短信验证码等。 登录登出 包括用户密码登录、手机短信验证码登录、微信登录、支付宝登录、退出登录等。 社交帐号 包括社交帐号登录绑定手机号、社交帐号注册并绑定手机号、获取用户已绑定的社交帐号列表、社交帐号解绑等。 密码管理 包括跳过强制修改密码、密码过期强制修改密码、查询是否设置个人密码、通过手机号找回密码等。 二次认证 包括通过state_Token获取手机号和手机号短信验证码二次认证。 个人信息管理 包括查询个人信息、修改个人信息和修改个人手机号。 SSO 包括通过session_token获取sso_ticket、通过sso_ticket获取用户信息和刷新session_token。 id_token管理 包括通过session_token生成id_token。 应用集成接口 基于CAS的应用认证集成 包括基于CAS协议进行应用认证集成的接口，如认证登录、验证票据、注销登录等。 基于SAML2.0的应用认证集成 包括基于SAML2.0协议进行应用认证集成的接口，如获取IdP元数据等。 基于OAuth2.0的应用认证集成 包括基于OAuth2.0协议进行应用认证集成的接口，如认证登录获取授权码、获取AccessToken、获取用户信息等。 基于OIDC的应用认证集成 包括基于OIDC协议进行应用认证集成的接口，如隐式授权、认证登录获取授权码等。 统一退出 包括全局退出接口，用于注销会话退出登录应用。

请求示例 查询CAS3.0接口验证票据，参数分别配置应用回调地址https://example.com及认证登录接口获取的认证票据ST-eYlKs8FrLCltwRwfm8AiwCxmQ8gAL...，使用JSON响应格式获取用户属性信息。 GET https://{domain_name}/api/v1/cas/p3/serviceValidate?service=https://example.com&ticket=ST-eYlKs8FrLCltwRwfm8AiwCxmQ8gAL...&format=JSON

URI GET /api/v1/cas/p3/serviceValidate 表1 Query参数 参数 是否必选 参数类型 描述 service 是 String 应用接受票据的地址，必须与应用CAS配置中的应用回调URL一致。 ticket 是 String 票据，认证登录获取的Service Ticket。 format 否 String 响应用户信息的格式，可选择XML和JSON。 缺省值：XML

请求消息体（可选） 该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取Access Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中domain_name为用户访问域名，*******为认证登录后回调获取的授权码，ClientId为注册应用后分配的接口认证凭证ID，ClientSecret为注册应用后分配的接口认证凭证密钥，https://example.com为注册应用时填写的回调地址。 POST https://abcdefg.huaweioneaccess.com/api/v1/oauth2/token Content-Type: application/json code=******& client_id=ClientId& client_secret=ClientSecret& redirect_uri=https://example.com& grant_type=authorization_code 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息体中“access_token”就是需要获取的Access Token。有了Token之后，您就可以使用Token认证调用其他API。

请求URI OneAccess请求URI由如下部分组成。 {URI-scheme} :// {domain_name} / {resource-path} ? {query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URI中的参数说明 参数 描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 domain_name 使用OneAccess服务API需要使用用户访问域名，获取方法请参见获取用户访问域名。 resource-path 资源路径，也即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“api/v1/oauth2/token”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。 例如您需要获取用户访问域名为“abcdefg.huaweioneaccess.com”的实例Access Token，则需使用用户访问域名“abcdefg.huaweioneaccess.com”，并在获取Access Token的URI部分找到resource-path（ /api/v1/oauth2/token），拼接起来如下所示。 https://abcdefg.huaweioneaccess.com/api/v1/oauth2/token 图1 URI示意图 为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而domain_name在同一个实例也相同，所以简洁起见将这两部分省略。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务您正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候，PATCH可能会去创建一个新的资源。 在获取Access的URI部分，您可以看到其请求方法为“POST”，则其请求为： POST https://abcdefg.huaweioneaccess.com/api/v1/oauth2/token

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Content-Type 消息体的类型（格式）。默认取值为“application/json”，有其他取值时会在具体接口中专门说明。 是 application/json Accept 接受响应类型。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。 否 application/json Content-Length 请求body长度，单位为Byte。 否 3495 对于获取Access Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 POST https://abcdefg.huaweioneaccess.com/api/v1/oauth2/token Content-Type: application/json

请求URI OneAccess请求URI由如下部分组成。 {URI-scheme} :// {domain_name} / {resource-path} ? {query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URI中的参数说明 参数 描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 domain_name 使用OneAccess服务API需要使用用户访问域名，获取方法请参见获取用户访问域名。 resource-path 资源路径，也即API访问路径。从具体API的URI模块获取，例如“获取访问凭证”API的resource-path为“/api/v2/tenant/token”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。 例如您需要获取用户访问域名为“abcdefg.huaweioneaccess.com”的实例Access Token，则需使用用户访问域名“abcdefg.huaweioneaccess.com”，并在获取访问凭据的URI部分找到resource-path（/api/v2/tenant/token），拼接起来如下所示。 https://abcdefg.huaweioneaccess.com/api/v2/tenant/token 图1 URI示意图 为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而domain_name在同一个实例也相同，所以简洁起见将这两部分省略。

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Content-Type 消息体的类型（格式）。默认取值为“application/json”，有其他取值时会在具体接口中专门说明。 是 application/json Accept 接受响应类型。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。 否 application/json Content-Length 请求body长度，单位为Byte。 否 3495 Authorization 认证凭据。如获取用户信息接口，值为Bearer {access_token}。 否 Bearer {access_token} 对于获取访问凭据接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 POST https://{domain_name}/api/v2/tenant/token Content-Type: application/x-www-form-urlencoded

请求消息体（可选） 该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取访问凭据接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中ClientId为注册应用后分配的接口认证凭证ID，ClientSecret为注册应用后分配的接口认证凭证密钥。 POST https://{domain_name}/api/v2/tenant/token Content-Type: application/x-www-form-urlencoded client_id=ClientId& client_secret=ClientSecret& grant_type=client_credentials 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取访问凭据接口，返回的响应消息体中“access_token”就是需要获取的Access Token。有了Token之后，您就可以使用Token认证调用其他API。