介面
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
}
}