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

操作步骤

  1. 登录DataV控制台。
  2. 选择我的数据 > 添加数据。
  3. 单击类型下拉菜单，选择OpenAPI。
  4. 填写OpenAPI相关信息。
    添加Open API数据源
    参数 说明
    名称 数据源的显示名称，您可以自由命名。
    EndPoint OpenAPI的服务地址，需要您从云产品的API文档处获取。例如ECS的OpenAPI服务地址为ecs.aliyuncs.com，云监控杭州region的OpenAPI服务地址为metrics.cn-hangzhou.aliyuncs.com。
    APIVersion 云产品的API版本，您可以从云产品的API文档获取，如云监控的API版本为2017-03-01。
    AppKey 可以调用OpenAPI的账号的AccessKey ID。
    AppSecret 可以调用OpenAPI的账号的AccessKey Secret。
  5. 信息填写完成后，单击确定，完成数据源的添加。

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

使用OpenAPI数据源

  1. 进入DataV控制台，单击我的可视化。
  2. 在我的可视化页面，移动鼠标至您的大屏项目上，单击编辑。
  3. 在大屏编辑页面，单击画布中的某一组件。

    如果画布中还没有组件，请首先添加组件，详情请参见添加组件。

  4. 在画布右侧的组件配置面板中，单击数据 > 配置数据源。
    配置数据源
  5. 在设置数据源页面中，选择数据源类型为OpenAPI。
  6. 单击选择已有数据源下拉列表，选择配置完成的OpenAPI数据源 。
  7. 填写接口名称。

    在编辑框中填写需要调用的接口名称，即API调用中的Action参数。取值来自云产品提供的API列表，比如云监控的QueryMetricList。

  8. 填写返回结果路径。

    取OpenAPI返回结果的一部分作为返回结果路径。

    例如OpenAPI返回： 
    {
    "data": [
        {
            "x": 1,
            "y": 2
        },
        {
            "x": 2,
            "y": 4
        }
    ]
}
    如果返回结果路径中填写data，则数据响应结果为： 
    [
    {
        "x": 1,
        "y": 2
    },
    {
        "x": 2,
        "y": 4
    }
]
    说明 这个转换可以在过滤器中进行，此处可以留空不填。
  9. 在下方的编辑框中输入查询参数。
    • 查询参数为OpenAPI的接口参数，以JSON对象的形式填写。
    • 参数名参考云产品API的入参说明。
    • 回调id在JSON对象的value中填写。
    以云监控的QueryMetricList API为例，查询参数如下所示。 
    // 使用回调 id: myInstanceId。
            {
              "Period": 600,
              "StartTime": "2018-11-20 11:30:00",
              "EndTime": "2018-11-21 11:30:00",
              "Metric": "cpu_idle",
              "Project": "acs_ecs_dashboard",
              "Dimensions": "{instanceId:':myInstanceId'}"
            }
  10. 单击预览数据源返回结果，查看数据返回结果。