Elastic Compute Service:Create a preemptible instance

In the ECS console

1. Log on to the ECS console, go to the instance buy page, and then click the Custom Launch tab.

2. Follow on-screen instructions to configure ECS resource settings based on your business requirements.

   Take note of the following parameters. For information about other parameters, see Create an instance on the Custom Launch tab.

   • Billing Method: Select Preemptible Instance.

   • Instance Usage Duration:

     • 1 Hour: Specify a 1-hour protection period for the preemptible instance. The instance is not automatically released within 1 hour after instance creation. When the protection period ends, the system checks the inventory and market price of the instance type in real time and determines whether to release the instance.

     • None: No protection period is specified for the preemptible instance. Preemptible instances that do not have a protection period are more cost-effective than preemptible instances that have a protection period.

   • Highest Price per Instance:

     • Use Automatic Bid: The market price at the time of purchase is used as the bid price.

     • Set Maximum Price: Specify the maximum price that you are willing to pay for the instance type.

   • Instance Interruption Mode: Specify how to handle the preemptible instance and related resources if interruption and reclamation are triggered.

     • Release: The preemptible instance and the following resources are released: computing resources (vCPUs, GPUs, and memory), static public IP address (public IP address that is automatically assigned to the instance), public bandwidth, and cloud disks (system disk and data disks).

     • Stop in Economical Mode: The preemptible instance is stopped in economical mode. The system reclaims and no longer bills the computing resources (vCPUs, GPUs, and memory), static public IP address, and public bandwidth associated with the static public IP address of the instance. The system continues billing other resources of the preemptible instance, such as the cloud disks (system disk and data disks), elastic IP addresses (if any), and snapshots.

       Note

       A preemptible instance that is stopped in economical mode may fail to restart due to insufficient resources or market price fluctuations.

Use ECS SDK for Java

import com.aliyun.ecs20140526.Client;
import com.aliyun.teaopenapi.models.Config;

public class Sample {
    private static Client createClient() throws Exception {
        Config config = new Config()
                // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is configured. 
                .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is configured. 
                .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))
                // Specify an endpoint. For information about endpoints, go to https://api.alibabacloud.com/product/Ecs.
                .setEndpoint("ecs.cn-hangzhou.aliyuncs.com");
        return new Client(config);
    }
}

// Create a request object.
RunInstancesRequest request = new RunInstancesRequest()
    // Specify the region ID.
    .setRegionId("cn-hangzhou")
    // Set the billing method to pay-as-you-go.
    .setInstanceChargeType("PostPaid")
    // Set the bidding mode to automatic bidding.
    .setSpotStrategy("SpotAsPriceGo")
    // Set the instance usage duration to 1 hour, which ensures that the instance is not released within 1 hour after the instance is created.
    .setSpotDuration(1)
    // Specify the instance type.
    .setInstanceType("instanceType")
    // Specify the image ID.
    .setImageId("imageId")
    // Specify the ID of the security group.
    .setSecurityGroupId("securityGroupId")
    // Specify the vSwitch ID.
    .setVSwitchId("vSwitchId");

// Specify the runtime parameters.
RuntimeOptions runtime = new RuntimeOptions();
// Call the DescribeInstances operation.
RunInstancesResponse response = client.runInstancessWithOptions(request, runtime);
System.out.println(response.body.toMap());

import com.aliyun.ecs20140526.Client;
import com.aliyun.ecs20140526.models.RunInstancesRequest;
import com.aliyun.ecs20140526.models.RunInstancesResponse;
import com.aliyun.ecs20140526.models.RunInstancesResponseBody;
import com.aliyun.tea.TeaException;
import com.aliyun.tea.TeaUnretryableException;
import com.aliyun.teaopenapi.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;
import com.alibaba.fastjson.JSONArray;

import java.util.Arrays;

public class Sample {
    private static Client createClient() throws Exception {
        Config config = new Config()
                // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is configured. 
                .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is configured. 
                .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))
                // Specify an endpoint. For information about endpoints, go to https://api.alibaba.com/product/Ecs.
                .setEndpoint("ecs.cn-hangzhou.aliyuncs.com");
        return new Client(config);
    }

    public static void main(String[] args) {
        try {
            Client client = Sample.createClient();
            // Create a request object.
            RunInstancesRequest request = new RunInstancesRequest()
                    // Specify the region ID.
                    .setRegionId("cn-hangzhou")
                    // Set the billing method to pay-as-you-go.
                    .setInstanceChargeType("PostPaid")
                    // Set the bidding mode to automatic bidding.
                    .setSpotStrategy("SpotAsPriceGo")
                    // Set the instance usage duration to 1 hour, which ensures that the instance is not released within 1 hour after the instance is created.
                    .setSpotDuration(1)
                    // Specify the instance type.
                    .setInstanceType("instanceType")
                    // Specify the image ID.
                    .setImageId("imageId")
                    // Specify the ID of the security group.
                    .setSecurityGroupId("securityGroupId")
                    // Specify the vSwitch ID.
                    .setVSwitchId("vSwitchId");;
            // Specify the runtime parameters.
            RuntimeOptions runtime = new RuntimeOptions();
            // Call the RunInstances operation.
            RunInstancesResponse response = client.runInstancesWithOptions(request, runtime);
            System.out.println(response.body.toMap());
        } catch (TeaUnretryableException ue) {
            // Handle exceptions with caution in actual business scenarios and do not ignore exceptions in your project. In this example, exceptions are provided only for reference. 
            ue.printStackTrace();
            // Obtain the error message.
            System.out.println(ue.getMessage());
            // Obtain the request message and query the request information when an error occurs.
            System.out.println(ue.getLastRequest());
        } catch (TeaException e) {
            // Handle exceptions with caution in actual business scenarios and do not ignore exceptions in your project. In this example, exceptions are provided only for reference. 
            e.printStackTrace();
            // Obtain the error code.
            System.out.println(e.getCode());
            // Obtain the error message that contains the request ID.
            System.out.println(e.getMessage());
            // Obtain the detailed error information that is returned by the server.
            System.out.println(e.getData());
        } catch (Exception e) {
            // Handle exceptions with caution in actual business scenarios and do not ignore exceptions in your project. In this example, exceptions are provided only for reference. 
            e.printStackTrace();
        }
    }
}

Use Terraform

Procedure

1. Open your browser and enter https://shell.alibabacloud.com in the address bar to access Cloud Shell.

   For information about how to use Cloud Shell, see Use Cloud Shell.

2. Create and access a project directory named terraform in which Terraform resources are stored.

   mkdir terraform
   cd terraform

3. Create a configuration file named main.tf in the preceding directory and add the following content to the file:

   main.tf

   provider "alicloud" {
     region = var.region
   }
   
   # The ID of the region in which you want to create the preemptible instance.
   variable "region" {
     type    = string
     default = "cn-beijing"
   }
   
   # The name of the VPC in which you want to create the preemptible instance.
   variable "vpc_name" {
     type    = string
     default = "tf_test_fofo"
   }
   
   # The CIDR block of the VPC.
   variable "vpc_cidr_block" {
     type    = string
     default = "172.16.0.0/12"
   }
   
   # The CIDR block of the vSwitch to which you want to connect the preemptible instance.
   variable "vswitch_cidr_block" {
     type    = string
     default = "172.16.0.0/21"
   }
   
   # The ID of the zone in which you want to create the preemptible instance.
   variable "availability_zone" {
     type    = string
     default = "cn-beijing-b"
   }
   
   # The name of the security group to which you want to add the preemptible instance.
   variable "security_group_name" {
     type    = string
     default = "default"
   }
   
   # The instance type of the preemptible instance.
   variable "instance_type" {
     type    = string
     default = "ecs.n2.small"
   }
   
   # The category of the system disk.
   variable "system_disk_category" {
     type    = string
     default = "cloud_efficiency"
   }
   
   # The operating system of the image that you want to use to create the preemptible instance.
   variable "image_id" {
     type    = string
     default = "ubuntu_140405_64_40G_cloudinit_20161115.vhd"
   }
   
   # The name of the preemptible instance.
   variable "instance_name" {
     type    = string
     default = "test_fofo"
   }
   
   # The public bandwidth of the preemptible instance.
   variable "internet_max_bandwidth_out" {
     type    = number
     default = 10
   }
   
   # The billing method of the preemptible instance.
   variable "instance_charge_type" {
     type    = string
     default = "PostPaid"
   }
   
   # The bidding policy of the preemptible instance.
   variable "spot_strategy" {
     type    = string
     default = "SpotAsPriceGo"
   }
   
   # The protection period of the preemptible instance.
   variable "spot_duration" {
     type    = number
     default = 0
   }
   
   # The port range of the inbound security group rule.
   variable "port_range" {
     type    = string
     default = "1/65535"
   }
   
   # The priority of the inbound security group rule.
   variable "priority" {
     type    = number
     default = 1
   }
   
   # The CIDR block of the inbound security group rule.
   variable "cidr_ip" {
     type    = string
     default = "0.0.0.0/0"
   }
   
   resource "alicloud_vpc" "vpc" {
     vpc_name       = var.vpc_name
     cidr_block = var.vpc_cidr_block
   }
   
   resource "alicloud_vswitch" "vsw" {
     vpc_id            = alicloud_vpc.vpc.id
     cidr_block        = var.vswitch_cidr_block
     zone_id = var.availability_zone
   }
   
   resource "alicloud_security_group" "default" {
     security_group_name   = var.security_group_name
     vpc_id = alicloud_vpc.vpc.id
   }
   
   resource "alicloud_instance" "instance" {
     availability_zone          = var.availability_zone
     security_groups = [alicloud_security_group.default.id]
     instance_type              = var.instance_type
     system_disk_category       = var.system_disk_category
     image_id                   = var.image_id
     instance_name              = var.instance_name
     vswitch_id                 = alicloud_vswitch.vsw.id
     internet_max_bandwidth_out = var.internet_max_bandwidth_out
     instance_charge_type       = var.instance_charge_type
     spot_strategy              = var.spot_strategy
     spot_duration              = var.spot_duration
   }
   
   resource "alicloud_security_group_rule" "allow_all_tcp" {
     type              = "ingress"
     ip_protocol       = "tcp"
     nic_type          = "intranet"
     policy            = "accept"
     port_range        = var.port_range
     priority          = var.priority
     security_group_id = alicloud_security_group.default.id
     cidr_ip           = var.cidr_ip
   }

4. Run the terraform init command to initialize the configurations.

   

5. Run the terraform apply command. During the execution, follow on-screen instructions to enter yes and press the Enter key. Wait until the command is complete. If the following command output is returned, the preemptible instance is created.

   

6. Run the terraform show command to query the details of resources created by Terraform.

   

terraform destroy