阿里云首页 云网管

Java SDK

本文介绍安装云网管Java SDK及使用Java SDK完成常见操作的相关步骤。

前提条件

  • 已开通云网管。更多信息,请参见开通使用云网管

  • 已创建并获取AccessKey。更多信息,请参见访问密钥

  • 已安装Java开发环境。

    • 云网管Java SDK支持J2SE 6.0及以上的Java运行环境,您可以执行java -version命令检查您已安装的Java版本。如果未安装,可以从Java官方网站下载安装包并完成安装。

步骤1:安装Java SDK

您可以通过以下两种方式安装云网管Java SDK:

  • 方式一:在Maven项目中加入依赖项(推荐方式)。

    • 在Maven工程中使用云网管Java SDK,只需在pom.xml中加入相应依赖即可。以0.0.1版本为例,在<dependencies>中加入如下内容:

            <dependency>
                <groupId>com.aliyun</groupId>
                <artifactId>cmn20200825</artifactId>
                <version>0.0.1</version>
            </dependency>
  • 方式二:在Eclipse中导入JAR包。

    • 以0.0.1版本为例,步骤如下:

      1. 下载Java SDK,下载链接请参见Aliyun CMN Java SDK

      2. 将cmn20200825-0.0.1.jar拷贝到您的项目中。

      3. 在Eclipse中选择您的工程,右击选择Properties > Java Build Path > Add JARs。

      4. 选中步骤2中拷贝的JAR文件。

步骤2:创建云网管Client

Client是云网管的Java客户端,用于管理Device,MonitorItem等云网管资源。使用Java SDK发起云网管请求,您需要初始化一个Client实例。

Config authConfig = new Config();
authConfig.accessKeyId = "your_access_id";     //用您的真实阿里云AccessKeyId替代。
authConfig.accessKeySecret = "your_access_key";   //用您的真实阿里云AccessKeySecret替代。
authConfig.endpoint = "region_endpoint"; //在实际使用中,请按照您实际的服务入口和接入方式编写。
authConfig.regionId = "cn-hangzhou"; //在实际使用中,请按照您实际的服务地域编写。
Client authClient = new Client(authConfig);

Java SDK示例

此处以分页获取资源管理下的所有设备列表为例。

//初始化ListDevices的请求类
ListDevicesRequest request = new ListDevicesRequest();
request.setMaxResults(10);  //分页参数,每页获取10行
request.setDeviceFormName("网络设备");  //设备形态名称,在实际使用中,请按照您实际设备形态编写
//使用request实例调用ListDevices接口,且返回参数为对应的Response实例。
ListDevicesResponse response = authClient.listDevices(request);
//其他代码