Reserved Instance
Updated at:2025-10-20
Create reserved instances
Create specified reserved instances with the following code:
Java
1import com.baidubce.BceClientConfiguration;
2import com.baidubce.Protocol;
3import com.baidubce.auth.DefaultBceCredentials;
4import com.baidubce.services.bcc.BccClient;
5import com.baidubce.services.bcc.BccClientConfiguration;
6import com.baidubce.services.bcc.model.TagModel;
7import com.baidubce.services.bcc.model.reversed.CreateReservedInstanceResponse;
8import com.baidubce.services.bcc.model.reversed.CreateReservedInstancesRequest;
9import lombok.extern.slf4j.Slf4j;
10import java.util.Collections;
11public class ExampleCreateReservedInstance {
12 public static void main(String[] args) {
13 // Set your AK, SK and the endpoint to be accessed
14 String endpoint = "bcc.bj.baidubce.com";
15 String ak = "ak";
16 String sk = "sk";
17 // Set default configuration
18 BceClientConfiguration bccClientConfiguration = new BccClientConfiguration()
19 .withProtocol(Protocol.HTTP)
20 .withCredentials(new DefaultBceCredentials(ak, sk))
21 .withEndpoint(endpoint);
22 // Create a BCC client
23 BccClient bccClient = new BccClient(bccClientConfiguration);
24 CreateReservedInstancesRequest request = new CreateReservedInstancesRequest();
25 request.setReservedInstanceName("bj-test");
26 request.setScope("AZ");
27 request.setZoneName("cn-bj-a");
28 request.setSpec("bcc.c5.c2m8");
29 request.setOfferingType("FullyPrepay");
30 request.setInstanceCount(1);
31 request.setReservedInstanceCount(1);
32 request.setReservedInstanceTime(1);
33 request.setReservedInstanceTimeUnit("month");
34 request.setAutoRenewTimeUnit("month");
35 request.setAutoRenewTime(1);
36 request.setAutoRenew(true);
37 TagModel tagModel = new TagModel();
38 tagModel.setTagKey("testKey");
39 tagModel.setTagValue("testValue");
40 request.setTags(Collections.singletonList(tagModel));
41 CreateReservedInstanceResponse response = bccClient.createReservedInstances(request);
42 }
43}
Modify reserved instances
Modify specified reserved instance attributes with the following code:
Java
1import com.baidubce.BceClientConfiguration;
2import com.baidubce.Protocol;
3import com.baidubce.auth.DefaultBceCredentials;
4import com.baidubce.services.bcc.BccClient;
5import com.baidubce.services.bcc.BccClientConfiguration;
6import com.baidubce.services.bcc.model.reversed.ModifyReservedInstancesResponse;
7import com.baidubce.services.bcc.model.reversed.ModifyReservedInstancesRequest;
8import com.baidubce.services.bcc.model.reversed.ModifyReservedInstancesRequest.ReservedInstance;
9import lombok.extern.slf4j.Slf4j;
10import java.util.Collections;
11public class ExampleModifyReservedInstances {
12 public static void main(String[] args) {
13 // Set your AK, SK and the endpoint to be accessed
14 String endpoint = "bcc.bj.baidubce.com";
15 String ak = "ak";
16 String sk = "sk";
17 // Set default configuration
18 BceClientConfiguration bccClientConfiguration = new BccClientConfiguration()
19 .withProtocol(Protocol.HTTP)
20 .withCredentials(new DefaultBceCredentials(ak, sk))
21 .withEndpoint(endpoint);
22 // Create a BCC client
23 BccClient bccClient = new BccClient(bccClientConfiguration);
24 ModifyReservedInstancesRequest request = new ModifyReservedInstancesRequest();
25 // Modify the name
26 ReservedInstance modifyName = new ReservedInstance();
27 modifyName.setReservedInstanceId("r-qt4ItfUP");
28 modifyName.setReservedInstanceName("update-reserved-instance");
29 request.setReservedInstances(Collections.singletonList(modifyName));
30 ModifyReservedInstancesResponse response = bccClient.modifyReservedInstances(request);
31 }
32}
Tag unbinding
Bind a tag to a specified reserved instance with the following code:
Java
1import com.baidubce.BceClientConfiguration;
2import com.baidubce.Protocol;
3import com.baidubce.auth.DefaultBceCredentials;
4import com.baidubce.services.bcc.BccClient;
5import com.baidubce.services.bcc.BccClientConfiguration;
6import com.baidubce.services.bcc.model.TagModel;
7import com.baidubce.services.bcc.model.reversed.ReservedTagsRequest;
8import java.util.ArrayList;
9import java.util.Arrays;
10import java.util.List;
11public class ExampleBindReservedToTags {
12 public static void main(String[] args) {
13 // Set your AK, SK and the endpoint to be accessed
14 String endpoint = "bcc.bj.baidubce.com";
15 String ak = "ak";
16 String sk = "sk";
17 // Set default configuration
18 BceClientConfiguration bccClientConfiguration = new BccClientConfiguration()
19 .withProtocol(Protocol.HTTP)
20 .withCredentials(new DefaultBceCredentials(ak, sk))
21 .withEndpoint(endpoint);
22 // Create a BCC client
23 BccClient bccClient = new BccClient(bccClientConfiguration);
24 ReservedTagsRequest reservedTagsRequest = new ReservedTagsRequest();
25 // Tag list
26 List<TagModel> changeTags = new ArrayList<TagModel>();
27 TagModel tagModel = new TagModel().withTagKey("Key").withTagValue("Value");
28 changeTags.add(tagModel);
29 reservedTagsRequest.setChangeTags(changeTags);
30 // List of reserved instance IDs, maximum 100
31 reservedTagsRequest.withInstanceIds(Arrays.asList("r-oFpMXKhv", "r-HrztSVk0"));
32 bccClient.bindReservedInstanceToTags(reservedTagsRequest);
33 }
34}
Unbind tags
Unbind the tag from a specified reserved instance with the following code:
Java
1import com.baidubce.BceClientConfiguration;
2import com.baidubce.Protocol;
3import com.baidubce.auth.DefaultBceCredentials;
4import com.baidubce.services.bcc.BccClient;
5import com.baidubce.services.bcc.BccClientConfiguration;
6import com.baidubce.services.bcc.model.TagModel;
7import com.baidubce.services.bcc.model.reversed.ReservedTagsRequest;
8import java.util.ArrayList;
9import java.util.Arrays;
10import java.util.List;
11public class ExampleUnbindReservedFromTags {
12 public static void main(String[] args) {
13 // Set your AK, SK and the endpoint to be accessed
14 String endpoint = "bcc.bj.baidubce.com";
15 String ak = "ak";
16 String sk = "sk";
17 // Set default configuration
18 BceClientConfiguration bccClientConfiguration = new BccClientConfiguration()
19 .withProtocol(Protocol.HTTP)
20 .withCredentials(new DefaultBceCredentials(ak, sk))
21 .withEndpoint(endpoint);
22 // Create a BCC client
23 BccClient bccClient = new BccClient(bccClientConfiguration);
24 ReservedTagsRequest reservedTagsRequest = new ReservedTagsRequest();
25 // Tag list
26 List<TagModel> changeTags = new ArrayList<TagModel>();
27 TagModel tagModel = new TagModel().withTagKey("Key").withTagValue("Value");
28 changeTags.add(tagModel);
29 reservedTagsRequest.setChangeTags(changeTags);
30 // List of reserved instance IDs, maximum 100
31 reservedTagsRequest.withInstanceIds(Arrays.asList("r-oFpMXKhv", "r-HrztSVk0"));
32 bccClient.unbindReservedInstanceFromTags(reservedTagsRequest);
33 }
34}
