通过SDK使用ECS实例
更新时间：2020-05-14 22:22:57
如果您是一位开发者，可以通过SDK的方式创建ECS实例。本文介绍如何通过Java SDK创建ECS实例。
准备Java SDK环境
在使用Java SDK创建ECS实例前，您需要配置好Java SDK环境，并在Maven项目的pom.xml文件中，添加阿里云核心库aliyun-java-sdk-core、云服务器aliyun-java-sdk-ecs、专有网络aliyun-java-sdk-vpc和fastjson依赖。详情请参见安装Java SDK。
在pom.xml文件中新增专有网络aliyun-java-sdk-vpc依赖，如下所示。
<dependencies>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<version>4.4.3</version>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-ecs</artifactId>
<version>4.17.1</version>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.60</version>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-vpc</artifactId>
<version>3.0.9</version>
</dependency>
</dependencies>获取AccessKey信息
创建AccessKey，具体请参见创建AccessKey。
说明 为避免主账号泄露AccessKey带来的安全风险，建议您创建RAM用户，授予RAM用户云服务器ECS相关的访问权限，再使用RAM用户的AccessKey调用SDK。详情请参见账号访问控制。
创建ECS实例所需资源
在创建ECS实例前，您需要先创建专有网络VPC和安全组。
说明 如果已经存在专有网络VPC和安全组，您也可以获取交换机ID和安全组ID后，直接购买ECS实例。具体请参见购买ECS实例。
购买ECS实例
购买一个包年包月的ECS实例。
| API | 参数 | 示例取值 |
|---|---|---|
| RunInstances | RegionId | 地域：cn-hangzhou |
| ImageId | 镜像：推荐使用Aliyun Linux镜像aliyun_2_1903_x64_20G_alibase_20200324.vhd。 | |
| InstanceType | 实例规格：
|
|
| SecurityGroupId | 安全组ID：使用步骤3返回的结果。
示例：sg-bp1dve08xy2c8y9g**** |
|
| VSwitchId | 交换机ID：使用步骤2返回的结果。
示例：vsw-bp1mihse903i05oxn**** |
|
| InstanceName | 实例名称。
示例：ecs_sdk_demo |
|
| InstanceChargeType | 付费方式：实例按照包年包月的付费方式PrePaid。
说明 您需要确保账号余额能够完成支付。 |
|
| PeriodUnit | 付费周期单位：Month | |
| Period | 付费时长：1 | |
| InternetMaxBandwidthOut | 公网IP带宽：1 | |
| Password | 实例登录密码：<yourPassword>
说明 您需要自定义复杂密码以保护ECS实例的安全。 |
以下代码示例表示创建包年包月的ECS实例。
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;
import com.google.gson.Gson;
import java.util.*;
import com.aliyuncs.ecs.model.v20140526.*;
public class RunInstances {
public static void main(String[] args) {
DefaultProfile profile = DefaultProfile.getProfile("cn-hangzhou", "<accessKeyId>", "<accessSecret>");
IAcsClient client = new DefaultAcsClient(profile);
RunInstancesRequest request = new RunInstancesRequest();
request.setRegionId("cn-hangzhou");
request.setImageId("aliyun_2_1903_x64_20G_alibase_20200324.vhd");
request.setInstanceType("ecs.s6-c1m2.small");
request.setSecurityGroupId("sg-bp1dve08xy2c8y9g****");
request.setVSwitchId("vsw-bp1mihse903i05oxn****");
request.setInstanceName("ecs_sdk_demo");
request.setInternetMaxBandwidthOut(1);
request.setPassword("<yourPassword>");
request.setPeriod(1);
request.setPeriodUnit("Month");
request.setInstanceChargeType("PrePaid");
try {
RunInstancesResponse response = client.getAcsResponse(request);
System.out.println(new Gson().toJson(response));
} catch (ServerException e) {
e.printStackTrace();
} catch (ClientException e) {
System.out.println("ErrCode:" + e.getErrCode());
System.out.println("ErrMsg:" + e.getErrMsg());
System.out.println("RequestId:" + e.getRequestId());
}
}
}返回结果如下所示。
{
"requestId": "9582F9F2-349C-438E-A6A2-3E7B6B56****",
"tradePrice": ****,
"instanceIdSets": ["i-bp1hcv43i3glqxbv****"]
}连接ECS实例
此示例介绍通过Cloud Shell登录Linux实例。如果您安装的是Windows实例，登录方式请参见在本地客户端上连接Windows实例。
- 查询实例公网IP地址。
API 参数 示例取值 DescribeInstances RegionId 地域：cn-hangzhou InstanceIds 实例ID：使用购买ECS实例返回的结果。 示例：'["i-bp1hcv43i3glqxbv****"]'
以下代码示例表示查询实例公网IP。
aliyun ecs DescribeInstances --RegionId cn-hangzhou --InstanceIds '["i-bp1hcv43i3glqxbv****"]'在返回结果中找到以下公网IP信息。
- 通过SSH登录ECS实例。
实例到期释放
包年包月实例到期后，您可以手动释放。如果一直未续费，实例也会自动释放。
发表评论
当前登录：未提供 [登录]