7分钟

任务 3 调用腾讯云服务器API

任务目的

学会使用腾讯云产品API(以云服务器查询实例列表为例)。

根据之前准备好的云服务器实例(为确保有数据,需准备至少一台服务器),演示如何调用API查询实例列表并对结果进行验证。

任务步骤

1.调用API查询所有云服务器实例

  • 点击状态栏左上方【腾讯云图标】按钮,回到腾讯云官网。
回到腾讯云主页
  • 点击状态栏【支持】,选择【API中心】进入API中心。
API中心
  • 点击【云服务器】,选择【实例相关接口】,选择【查看实例列表】,在右方可以查看调用API的详情说明。
查询实例列表
  • 点击【API 3.0 Explorer】以使用在线调试API工具。
在线API工具
  • 进入API 3.0 Explorer界面(如下图所示),需要填写相应输入参数(详情可以参考右侧栏上方的【参数说明】),本例中需要填入【SecretId】、【SecretKey】以及【Region】。
填入参数
  • 参数选择上可以勾选【只看必填参数】,Region选择创建服务器时的地区,本例中使用【华南地区(广州)】;
    • 个人密钥在API密钥管理中可以找到(如下所示):
    • 点击状态栏右侧【您的子用户】,点击【访问管理】跳转至访问管理页面。(建议使用右键在新标签页中打开,便于复制)
访问管理
  • 点击左侧菜单栏【访问密钥】-【API密钥管理】,复制当前账号的【SecretId】和【SecretKey】,然后填入之前的API 3.0 Explorer界面。
个人密钥

2.两种调用方式

方式一:使用在线调用的方式。

  • 点击【在线调用】,点击【发送请求】即可看到服务器实例列表。
在线调用
  • 数据示意图如下,区域、实例Id、实例名、IP地址均可以看到与之前控制台页面一致。
在线调用结果

方式二:使用SDK中Node.js方式(详情可以点击【NODEJS SDK使用说明】)。

  • 点击【Node.js】,复制下方所有代码。
Node.js方式调用
  • 新建一个js文件(本实验js文件路径为 D:\test\APITest\CVMdemo\CVMdemo.js),将代码粘贴到其中。
js文件
  • 代码内容如下,由于本实验是在CVMdemo.js文件当前目录初始化node项目,注意将复制代码中的require中的内容改为如下地址:
js代码
  • 运行windows控制台,切换到当前路径,初始化Node项目。
#初始化Node项目
 npm init -y
  • 初始化成功效果如图所示:
初始化项目
  • 继续在此CMD工具中,安装运行所需依赖并执行CVMdemo.js文件。
#安装依赖
npm install tencentcloud-sdk-nodejs --save
#执行js文件
node ./CVMdemo.js
  • 使用Node.js调用腾讯云服务器查询所有实例API,查询有结果返还,且返还结果参数与云服务器控制台实例列表一致,即表明API接口调用成功。
实验验证