全部產品
Search
文件中心

:擷取鏡像列表

更新時間:Jul 06, 2024

介面

listImages

參數

參數 類型 是否必選 說明
type String 重載方法中有這個參數, type= ListImagesRequest.SYSTEM 則返回系統提供的鏡像列表。
marker String 本頁起始資源標識符。預設為空白字串。
maxItemCount int 返回條數,最大取值200,預設200

傳回值

成功後返回一個 ListImagesResponse 執行個體, 可以通過這個執行個體的 getItems 方法,拿到 List<Image> 對象;請參閱 Image 類的描述,瞭解 Image 對象的屬性。

屬性 類型 說明
id String 鏡像ID
name String 鏡像名稱
ownerId long 所有者ID
description String 簡短描述
type String 類型,”System” 或則 “Self”
ecsImageId String ECS鏡像ID
creationTime Date 建立時間
platform String 作業系統, Image.LINUX 或者 Image.WINDOWS

如果失敗,拋出異常:ClientException

例子

Java 源碼:

import com.aliyuncs.batchcompute.main.v20151111.*;
import com.aliyuncs.batchcompute.model.v20151111.*;
import com.aliyuncs.batchcompute.pojo.v20151111.*;
import com.aliyuncs.exceptions.ClientException;

import java.util.List;

public class ListImages {
    static String ACCESS_KEY_ID = "xxx";  //這裡填寫您的 AccessKeyId
    static String ACCESS_KEY_SECRET = "xxx"; //這裡填寫您的 AccessKeySecret
    static String REGION_ID = "cn-xxx";   //這裡填寫 region

    public static void main(String[] args) {
        BatchCompute client = new BatchComputeClient(REGION_ID, ACCESS_KEY_ID, ACCESS_KEY_SECRET);
        try{
            ListImagesResponse response = client.listImages();
            //成功
            List<Image> list = response.getItems();

            for (int i = 0; i < list.size(); i++){
                Image image = list.get(i);
                String Id = image.getId();
                String name = image.getName();
                String plat = image.getPlatform();

                System.out.println("{");
                System.out.println("\tId: " + Id);
                System.out.println("\tName: " + name);
                System.out.println("\tPlat: " + plat);
                System.out.println("},");
            }
        }catch(ClientException e){
            e.printStackTrace();
            //失敗
        }
    }
}

執行結果

{
  {
    Id: img-6ki7te6grlhbv42kn8a002
    Name: mili
    Plat: Windows
  },
  {
    Id: img-6ki7te6grlhbv42kn8a003
    Name: bc-stg-windows-1
    Plat: Windows
  },
  {
    Id: img-6kie8e832lnov8gg50k00b
    Name: JavaSdkImage
    Plat: Linux
  }
}