Image

Updated at：2025-10-20

Create custom image from instance

The code below demonstrates how to create a custom image, with a default limit of 20 images per account. The created images can be used to generate instances.

The operation will only succeed if the instance is in a Running or Stopped state.

Custom images can only be created from system disk snapshots:

                Python
                
            

                import uuid
from baidubce.auth.bce_credentials import BceCredentials
from baidubce.bce_client_configuration import BceClientConfiguration
from baidubce.services.bcc import bcc_client, bcc_model
if __name__ == '__main__':
# Set your AK, SK, and the region to be accessed
    HOST = 'http://bcc.bj.baidubce.com'
    AK = 'ak'
    SK = 'sk'
# Set default configuration
    config = BceClientConfiguration(credentials=BceCredentials(AK, SK),
    endpoint=HOST)
# Create a BCC client
    client = bcc_client.BccClient(config)
    
    client_token = str(uuid.uuid4())
# Name of image created
    image_name = 'instanceImage***'
# ID of instance created
    instance_id = 'i-***'
# Snapshot ID
    snapshot_id = 's-B1Cc6Dho'
    resp = client.create_image_from_instance_id(image_name,
                                         instance_id=instance_id,
                                         client_token=client_token)
    print(resp)
            

Create custom image from snapshot

When creating via a snapshot, the operation can only succeed if the snapshot is in Available status:

                Python
                
            

                import uuid
from baidubce.auth.bce_credentials import BceCredentials
from baidubce.bce_client_configuration import BceClientConfiguration
from baidubce.services.bcc import bcc_client, bcc_model
if __name__ == '__main__':
# Set your AK, SK, and the region to be accessed
    HOST = 'http://bcc.bj.baidubce.com'
    AK = 'ak'
    SK = 'sk'
# Set default configuration
    config = BceClientConfiguration(credentials=BceCredentials(AK, SK),
    endpoint=HOST)
# Create a BCC client
    client = bcc_client.BccClient(config)
    
    client_token = str(uuid.uuid4())
# Name of image created
    image_name = 'instanceImage***'
# ID of instance created
    instance_id = 'i-***'
# Snapshot ID
    snapshot_id = 'm-***'
    resp = client.create_image_from_snapshot_id(image_name,
                                         snapshot_id=snapshot_id,
                                         client_token=client_token)
    print(resp)
            

Query the image list

The following code can be used to query all image information of the user:

The returned image information includes public images, custom images, and service integration images.
It supports filtering queries by imageType. This parameter is not mandatory. If not set, it defaults to All, which means querying all types of images:

                Python
                
            

                    def list_images(self):
 #Specify the type of image to be queried
 #All (all)
 #System (system image/public image)
 #Custom (custom image)
 #Integration (service integration image)
 #Sharing (shared image)
 #GpuBccSystem (GPU-specific public image)
 #GpuBccSystem (GPU-specific custom image)
 #FpgaBccSystem (FPGA-specific public image)
 #FpgaBccCustom (FPGA-specific custom image)
          image_type = 'All'
 # Starting position of the batch list query
          marker = 'your-marker'
 # Maximum number of items included per page
          max_keys = 100
          self.assertEqual(
                type(self.client.list_images(image_type=image_type
                                             marker=marker
                                             max_keys=max_keys)),
                baidubce.bce_response.BceResponse)
            

Query image details

You can query the detailed information of a single image based on the specified image ID with the following code:

                Python
                
            

                    def get_image(self):
 #ID of image to be queried
          image_id='your-choose-image-id'
          self.assertEqual(
                type(self.client.get_image(image_id)),
                baidubce.bce_response.BceResponse)
            

Delete a custom image

The code below is for deleting specified custom images. Only custom images can be deleted; public and service integration images cannot be removed.

Once an image is deleted, it cannot be recovered and cannot be used to create or reset instances again:

                Python
                
            

                    def delete_image(self):
 #ID of image to be deleted
          image_id='your-choose-image-id'
          self.assertEqual(
                type(self.client.delete_image(image_id)),
                baidubce.bce_response.BceResponse)
            

Query available public image based on instance specifications

You can query available public images based on instance specifications with the following code:

                Python
                
            

                    def test_get_available_images_by_spec(self):
        """
        test case for get_available_images_by_spec
        """
        resp = self.client.get_available_images_by_spec(spec='bcc.ic4.c1m1', os_name='Centos')
            

Disk

Initialization

BCC BCC