添加Open API数据源 - DataV数据可视化

本文为您介绍在DataV中添加Open API数据源的方法，以及相关参数配置说明。Open API是阿里云提供的云产品开放接口的调用方式，使用Open API可以方便地调用各云产品提供的API接口，轻松实现控制及查询等功能。在DataV中，最常见的场景是使用Open API调用其他的云产品的API，获取数据并展示出来。

前提条件

已准备好待添加的Open API数据源。

添加Open API数据源操作步骤

登录DataV控制台。
在我的数据页签中选择数据源管理，单击添加数据。
从类型列表中，选择Open API。

填写Open API相关信息。


参数	说明
名称	数据源的显示名称，您可以自由命名。
EndPoint	Open API的服务地址，需要您从云产品的API文档处获取。例如ECS的Open API服务地址为`ecs.aliyuncs.com`，云监控杭州region的Open API服务地址为`metrics.cn-hangzhou.aliyuncs.com`。
APIVersion	云产品的API版本，您可以从云产品的API文档获取，如云监控的API版本为`2017-03-01`。
AppKey	可以调用Open API的账号的AccessKey ID。
AppSecret	可以调用Open API的账号的AccessKey Secret。

信息填写完成后，单击确定，完成数据源的添加。

新添加的数据源会自动显示在数据源列表中。

使用Open API数据源操作步骤

登录DataV控制台。
在我的可视化页面中，将鼠标移动至需要编辑的可视化应用上，单击编辑。
在画布编辑页面，单击画布中的某一组件。

如果画布中还没有组件，请先添加组件，详情请参见添加资产。
在画布右侧的组件配置面板中选择数据，并单击配置数据源。
在设置数据源面板中，选择数据源类型为Open API。
在选择已有数据源列表中选择配置完成的Open API数据源。
在下方请求方式下拉列表中选择一种请求方式，可选择GET和POST两种。
填写接口名称。

在编辑框中填写需要调用的接口名称，即API调用中的Action参数。取值来自云产品提供的API列表，比如云监控的DescribeMetricList。
可选：填写返回结果路径。
取Open API返回结果的一部分作为返回结果路径。
例如Open API返回：
```
{
    "data": [
        {
            "x": 1,
            "y": 2
        },
        {
            "x": 2,
            "y": 4
        }
    ]
}
```
如果返回结果路径中填写data，则数据响应结果为：
```
[
    {
        "x": 1,
        "y": 2
    },
    {
        "x": 2,
        "y": 4
    }
]
```
说明这个转换可以在过滤器中进行，此处可以留空不填。
在下方的编辑框中输入查询参数。
- 查询参数为Open API的接口参数，以JSON对象的形式填写。
- 参数名参考云产品API的入参说明。
- 回调ID在JSON对象的value中填写。
以云监控的DescribeMetricList API为例，查询参数如下所示。
```
{
  "MetricName": "cpu_idle",
  "Namespace": "acs_ecs_dashboard",
  "Dimensions": [
    {
      "instanceId": "i-j6c0kyh2qh7fi0r4k351"
    }
  ],
  "StartTime": "2021-01-27 14:00:00",
  "EndTime": "2021-01-27 15:00:00",
  "Period": "60"
}
```
单击选中下方对象转数组，可自动将返回的对象转换成数值。
例如：
```
// 原数据
{
  "name": "..."
}
 => 
//转换后数据
[{
  "name": "..."
}]
```
说明此配置项不常使用，建议您使用过滤器进行数据格式转换。
单击预览数据源返回结果，查看数据返回结果。