55 为了方便您理解SDK中的一些概念和参数的含义,使用SDK前建议您先查看[ OpenAPI使用入门] ( http://www.jdcloud.com/help/detail/355/isCatalog/0 ) 。要了解每个API的具体参数和含义,请参考程序注释或参考OpenAPI&SDK下具体产品线的API文档。
66
77# 环境准备 #
8- 1 . 京东云Java SDK适用于jdk7及以上版本。
9- 2 . 在开始调用京东云open API之前,需提前在京东云用户中心账户管理下的[AccessKey管理页面](https://uc.jdcloud.com/accesskey/index)申请accesskey和secretKey密钥对(简称AK/SK)。AK/SK信息请妥善保管,如果遗失可能会造成非法用户使用此信息操作您在云上的资源,给你造成数据和财产损失。
8+ 1 . 京东云Java SDK适用于jdk7及以上版本。
9+ 2 . 在开始调用京东云open API之前,需提前在京东云用户中心账户管理下的[ AccessKey管理页面] ( https://uc.jdcloud.com/accesskey/index ) 申请accesskey和secretKey密钥对(简称AK/SK)。AK/SK信息请妥善保管,如果遗失可能会造成非法用户使用此信息操作您在云上的资源,给你造成数据和财产损失。
1010
1111# SDK使用方法 #
1212如果您使用Apache Maven来管理Java项目,只需在项目的pom.xml文件加入相应的依赖项即可,如下所示:
1313
14- <dependency>
15- <groupId>com.jdcloud.sdk</groupId>
16- <artifactId>core</artifactId>
17- <version>1.0.0</version>
18- </dependency>
19- <!-- 对应产品线的SDK -->
20- <dependency>
21- <groupId>com.jdcloud.sdk</groupId>
22- <artifactId>vm</artifactId>
23- <version>0.6.1</version>
24- </dependency>
14+ ``` xml
15+ <dependency >
16+ <groupId >com.jdcloud.sdk</groupId >
17+ <artifactId >core</artifactId >
18+ <version >1.0.0</version >
19+ </dependency >
20+ <!-- 对应产品线的SDK -->
21+ <dependency >
22+ <groupId >com.jdcloud.sdk</groupId >
23+ <artifactId >vm</artifactId >
24+ <version >0.6.1</version >
25+ </dependency >
26+ ```
2527
2628您还可以下载sdk源代码自行使用。
2729
@@ -32,46 +34,46 @@ SDK使用中的任何问题,欢迎您在Issues页面交流。
3234# 调用SDK #
3335Java SDK的调用主要分为4步:
3436
35- 1 . 设置accessKey和secretKey
36-
37- 2 . 创建Client
38-
39- 3 . 设置请求参数
40-
41- 4 . 执行请求得到响应
37+ 1 . 设置accessKey和secretKey
38+ 2 . 创建Client
39+ 3 . 设置请求参数
40+ 4 . 执行请求得到响应
4241
4342以下是查询单个云主机实例详情的调用示例
44- import com.jdcloud.sdk.auth.CredentialsProvider;
45- import com.jdcloud.sdk.auth.StaticCredentialsProvider;
46- import com.jdcloud.sdk.http.HttpRequestConfig;
47- import com.jdcloud.sdk.http.Protocol;
48- import com.jdcloud.sdk.service.vm.client.VmClient;
49- import com.jdcloud.sdk.service.vm.model.* ;
50-
51- public class VmClientExample {
52-
53- public static void main(String[ ] args) {
54- //1. 设置accessKey和secretKey
55- String accessKeyId = "{accessKey}";
56- String secretAccessKey = "{secretKey}";
57- CredentialsProvider credentialsProvider = new StaticCredentialsProvider(accessKeyId, secretAccessKey);
58-
59- //2. 创建XXXClient
60- VmClient vmClient = VmClient.builder()
61- .credentialsProvider(credentialsProvider)
62- .httpRequestConfig(new HttpRequestConfig.Builder().protocol(Protocol.HTTPS).build()) //默认为HTTPS
63- .build();
64-
65- //3. 设置请求参数
66- DescribeInstanceRequest request = new DescribeInstanceRequest();
67- request.regionId("cn-north-1");
68- request.instanceId("i-c0se9uju");
69-
70- //4. 执行请求
71- DescribeInstanceResponse response = vmClient.describeInstance(request);
72-
73- //5. 处理响应
74- System.out.println(new Gson().toJson(response));
75-
76- }
77- }
43+
44+ ``` java
45+ import com.jdcloud.sdk.auth.CredentialsProvider ;
46+ import com.jdcloud.sdk.auth.StaticCredentialsProvider ;
47+ import com.jdcloud.sdk.http.HttpRequestConfig ;
48+ import com.jdcloud.sdk.http.Protocol ;
49+ import com.jdcloud.sdk.service.vm.client.VmClient ;
50+ import com.jdcloud.sdk.service.vm.model.* ;
51+
52+ public class VmClientExample {
53+
54+ public static void main (String [] args ) {
55+ // 1. 设置accessKey和secretKey
56+ String accessKeyId = " {accessKey}" ;
57+ String secretAccessKey = " {secretKey}" ;
58+ CredentialsProvider credentialsProvider = new StaticCredentialsProvider (accessKeyId, secretAccessKey);
59+
60+ // 2. 创建XXXClient
61+ VmClient vmClient = VmClient . builder()
62+ .credentialsProvider(credentialsProvider)
63+ .httpRequestConfig(new HttpRequestConfig .Builder (). protocol(Protocol . HTTPS ). build()) // 默认为HTTPS
64+ .build();
65+
66+ // 3. 设置请求参数
67+ DescribeInstanceRequest request = new DescribeInstanceRequest ();
68+ request. regionId(" cn-north-1" );
69+ request. instanceId(" i-c0se9uju" );
70+
71+ // 4. 执行请求
72+ DescribeInstanceResponse response = vmClient. describeInstance(request);
73+
74+ // 5. 处理响应
75+ System . out. println(new Gson (). toJson(response));
76+
77+ }
78+ }
79+ ```
0 commit comments