SDK 手册

目前阿里云官方提供4 种语言的 SDK 版本，分别为 Java、Python、PHP、C#，具体每个版本的下载安装和使用方法如下：

• Java
• Python
• PHP
• C#

1. 在阿里云官网 创建并管理你的 Access Key。
2. 
   通过 maven 安装 SDK。添加 maven 库：[backcolor=transparent] [backcolor=transparent]<repositories>
3. [backcolor=transparent]         [backcolor=transparent]<repository>
4. [backcolor=transparent]             [backcolor=transparent]<id>[backcolor=transparent]sonatype-nexus-staging[backcolor=transparent]</id>
5. [backcolor=transparent]             [backcolor=transparent]<name>[backcolor=transparent]Sonatype Nexus Staging[backcolor=transparent]</name>
6. [backcolor=transparent]             [backcolor=transparent]<url>[backcolor=transparent]https://oss.sonatype.org/service/local/staging/deploy/maven2/[backcolor=transparent]</url>
7. [backcolor=transparent]             [backcolor=transparent]<releases>
8. [backcolor=transparent]                 [backcolor=transparent]<enabled>[backcolor=transparent]true[backcolor=transparent]</enabled>
9. [backcolor=transparent]             [backcolor=transparent]</releases>
10. [backcolor=transparent]             [backcolor=transparent]<snapshots>
11. [backcolor=transparent]                 [backcolor=transparent]<enabled>[backcolor=transparent]true[backcolor=transparent]</enabled>
12. [backcolor=transparent]             [backcolor=transparent]</snapshots>
13. [backcolor=transparent]         [backcolor=transparent]</repository>
14. [backcolor=transparent] [backcolor=transparent]</repositories>

1. [backcolor=transparent] [backcolor=transparent]<dependency>
2. [backcolor=transparent]     [backcolor=transparent]<groupId>[backcolor=transparent]com.aliyun[backcolor=transparent]</groupId>
3. [backcolor=transparent]     [backcolor=transparent]<artifactId>[backcolor=transparent]aliyun-java-sdk-domain[backcolor=transparent]</artifactId>
4. [backcolor=transparent]         [backcolor=transparent]<version>[backcolor=transparent]2.0.3[backcolor=transparent]</version>
5. [backcolor=transparent] [backcolor=transparent]</dependency>
6. [backcolor=transparent] [backcolor=transparent]<dependency>
7. [backcolor=transparent]     [backcolor=transparent]<groupId>[backcolor=transparent]com.aliyun[backcolor=transparent]</groupId>
8. [backcolor=transparent]     [backcolor=transparent]<artifactId>[backcolor=transparent]aliyun-java-sdk-core[backcolor=transparent]</artifactId>
9. [backcolor=transparent]         [backcolor=transparent]<version>[backcolor=transparent]2.4.4[backcolor=transparent]</version>
10. [backcolor=transparent] [backcolor=transparent]</dependency>

1. [backcolor=transparent]  [backcolor=transparent]import[backcolor=transparent] com[backcolor=transparent].[backcolor=transparent]aliyuncs[backcolor=transparent].[backcolor=transparent]domain[backcolor=transparent].[backcolor=transparent]model[backcolor=transparent].[backcolor=transparent]v20160511[backcolor=transparent].[backcolor=transparent]CreateOrderRequest[backcolor=transparent];
2. [backcolor=transparent]  [backcolor=transparent]import[backcolor=transparent] com[backcolor=transparent].[backcolor=transparent]aliyuncs[backcolor=transparent].[backcolor=transparent]domain[backcolor=transparent].[backcolor=transparent]model[backcolor=transparent].[backcolor=transparent]v20160511[backcolor=transparent].[backcolor=transparent]CreateOrderResponse[backcolor=transparent];
3. [backcolor=transparent]  [backcolor=transparent]import[backcolor=transparent] com[backcolor=transparent].[backcolor=transparent]aliyuncs[backcolor=transparent].[backcolor=transparent]IAcsClient[backcolor=transparent];
4. [backcolor=transparent]  [backcolor=transparent]import[backcolor=transparent] com[backcolor=transparent].[backcolor=transparent]aliyuncs[backcolor=transparent].[backcolor=transparent]profile[backcolor=transparent].[backcolor=transparent]IClientProfile[backcolor=transparent];
5. [backcolor=transparent]  [backcolor=transparent]import[backcolor=transparent] com[backcolor=transparent].[backcolor=transparent]aliyuncs[backcolor=transparent].[backcolor=transparent]DefaultAcsClient[backcolor=transparent];[backcolor=transparent]
7. [backcolor=transparent]  [backcolor=transparent]public[backcolor=transparent] [backcolor=transparent]class[backcolor=transparent] [backcolor=transparent]CreateOrderDemo[backcolor=transparent] [backcolor=transparent]{
9. [backcolor=transparent]     [backcolor=transparent]private[backcolor=transparent] [backcolor=transparent]static[backcolor=transparent] [backcolor=transparent]IAcsClient[backcolor=transparent] client [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]null[backcolor=transparent];
11. [backcolor=transparent]     [backcolor=transparent]//初始化client
12. [backcolor=transparent]     [backcolor=transparent]static[backcolor=transparent] [backcolor=transparent]{
13. [backcolor=transparent]         [backcolor=transparent]String[backcolor=transparent] regionId [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]"cn-hangzhou"[backcolor=transparent];[backcolor=transparent] [backcolor=transparent]//必填固定值，必须为“cn-hanghou”
14. [backcolor=transparent]         [backcolor=transparent]String[backcolor=transparent] accessKeyId [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]""[backcolor=transparent];[backcolor=transparent] [backcolor=transparent]// your accessKey
15. [backcolor=transparent]         [backcolor=transparent]String[backcolor=transparent] accessKeySecret [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]""[backcolor=transparent];[backcolor=transparent]// your accessSecret
16. [backcolor=transparent]         [backcolor=transparent]IClientProfile[backcolor=transparent] profile [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]DefaultProfile[backcolor=transparent].[backcolor=transparent]getProfile[backcolor=transparent]([backcolor=transparent]regionId[backcolor=transparent],[backcolor=transparent] accessKeyId[backcolor=transparent],[backcolor=transparent] accessKeySecret[backcolor=transparent]);
17. [backcolor=transparent]         [backcolor=transparent]// 若报Can not find endpoint to access异常，请添加以下此行代码
18. [backcolor=transparent]             [backcolor=transparent]// DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", "Domain", "domain.aliyuncs.com");  
19. [backcolor=transparent]         client [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]new[backcolor=transparent] [backcolor=transparent]DefaultAcsClient[backcolor=transparent]([backcolor=transparent]profile[backcolor=transparent]);
20. [backcolor=transparent]     [backcolor=transparent]}
22. [backcolor=transparent]     [backcolor=transparent]public[backcolor=transparent] [backcolor=transparent]static[backcolor=transparent] [backcolor=transparent]void[backcolor=transparent] main[backcolor=transparent]([backcolor=transparent]String[backcolor=transparent][][backcolor=transparent] args[backcolor=transparent])[backcolor=transparent] [backcolor=transparent]{
23. [backcolor=transparent]         [backcolor=transparent]//初始化请求
24. [backcolor=transparent]         [backcolor=transparent]CreateOrderRequest[backcolor=transparent] request [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]new[backcolor=transparent] [backcolor=transparent]CreateOrderRequest[backcolor=transparent]();
25. [backcolor=transparent]         [backcolor=transparent]// CreateOrderRequest.setProtocol(ProtocolType.HTTPS); //指定访问协议
26. [backcolor=transparent]         [backcolor=transparent]// CreateOrderRequest.setAcceptFormat(FormatType.JSON); //指定api返回格式
27. [backcolor=transparent]         [backcolor=transparent]// CreateOrderRequest.setMethod(MethodType.POST); //指定请求方法
28. [backcolor=transparent]         [backcolor=transparent]// CreateOrderRequest.setRegionId("cn-hangzhou");//指定要访问的Region,仅对当前请求生效，不改变client的默认设置。
29. [backcolor=transparent]         [backcolor=transparent]ArrayList[backcolor=transparent]<[backcolor=transparent]SubOrderParam[backcolor=transparent]>[backcolor=transparent] subOrderList [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]new[backcolor=transparent] [backcolor=transparent]ArrayList[backcolor=transparent]<[backcolor=transparent]SubOrderParam[backcolor=transparent]>();
30. [backcolor=transparent]         [backcolor=transparent]SubOrderParam[backcolor=transparent] subOrderParam [backcolor=transparent]=[backcolor=transparent] [backcolor=transparent]new[backcolor=transparent] [backcolor=transparent]SubOrderParam[backcolor=transparent]();
31. [backcolor=transparent]         subOrderParam[backcolor=transparent].[backcolor=transparent]setRelatedName[backcolor=transparent]([backcolor=transparent]"ab.com"[backcolor=transparent]);
32. [backcolor=transparent]         subOrderParam[backcolor=transparent].[backcolor=transparent]setDomainTemplateID[backcolor=transparent]([backcolor=transparent]"0000000"[backcolor=transparent]);
33. [backcolor=transparent]         subOrderParam[backcolor=transparent].[backcolor=transparent]setAction[backcolor=transparent]([backcolor=transparent]"activate"[backcolor=transparent]);
34. [backcolor=transparent]         subOrderParam[backcolor=transparent].[backcolor=transparent]setPeriod[backcolor=transparent]([backcolor=transparent]12[backcolor=transparent]);
35. [backcolor=transparent]         subOrderList[backcolor=transparent].[backcolor=transparent]add[backcolor=transparent]([backcolor=transparent]subOrderParam[backcolor=transparent]);
36. [backcolor=transparent]         request[backcolor=transparent].[backcolor=transparent]setSubOrderParams[backcolor=transparent]([backcolor=transparent]subOrderList[backcolor=transparent]);
38. [backcolor=transparent]         [backcolor=transparent]//发起api调用并解析结果
39. [backcolor=transparent]         [backcolor=transparent]try[backcolor=transparent] [backcolor=transparent]{
40. [backcolor=transparent]             [backcolor=transparent]//IAcsClient提供了两种类型的调用结果返回, 一种方式是通过调用doAction方法获取取得原始的api 调用结果, 即返回HttpResponse类型的结果. 示例代码如下：
41. [backcolor=transparent]             [backcolor=transparent]//HttpResponse httpResponse = client.doAction(describeCdnServiceRequest);
42. [backcolor=transparent]             [backcolor=transparent]//System.out.println(httpResponse.getUrl());
43. [backcolor=transparent]             [backcolor=transparent]//System.out.println(new String(httpResponse.getContent()));
45. [backcolor=transparent]             [backcolor=transparent]//另一种方式, 通过调用 getAcsResponse 方法, 获取反序列化后的对象, 示例代码如下:
46. [backcolor=transparent]             [backcolor=transparent]CreateOrderResponse[backcolor=transparent] response [backcolor=transparent]=[backcolor=transparent] client[backcolor=transparent].[backcolor=transparent]getAcsResponse[backcolor=transparent]([backcolor=transparent]request[backcolor=transparent]);
47. [backcolor=transparent]             [backcolor=transparent]System[backcolor=transparent].[backcolor=transparent]out[backcolor=transparent].[backcolor=transparent]println[backcolor=transparent]([backcolor=transparent]response[backcolor=transparent].[backcolor=transparent]getOrderID[backcolor=transparent]）
49. [backcolor=transparent]         [backcolor=transparent]}[backcolor=transparent] [backcolor=transparent]catch[backcolor=transparent] [backcolor=transparent]([backcolor=transparent]ServerException[backcolor=transparent] e[backcolor=transparent])[backcolor=transparent] [backcolor=transparent]{
50. [backcolor=transparent]             e[backcolor=transparent].[backcolor=transparent]printStackTrace[backcolor=transparent]();
51. [backcolor=transparent]         [backcolor=transparent]}[backcolor=transparent] [backcolor=transparent]catch[backcolor=transparent] [backcolor=transparent]([backcolor=transparent]ClientException[backcolor=transparent] e[backcolor=transparent])[backcolor=transparent] [backcolor=transparent]{
52. [backcolor=transparent]             e[backcolor=transparent].[backcolor=transparent]printStackTrace[backcolor=transparent]();
53. [backcolor=transparent]         [backcolor=transparent]}
54. [backcolor=transparent]     [backcolor=transparent]}
55. [backcolor=transparent] [backcolor=transparent]}