ZStack AIOS

获取IAM2项目可用的容器镜像 (GetIAM2ProjectContainerImages)

面向开发者的 API 使用规范、SDK 调用方式和 AIOS 相关接口说明。

API请求

URLs

GET zstack/v1/iam2/project/{projectId}/repository/{repositoryId}/image

Headers

Authorization: OAuth the-session-uuid

Curl示例

curl -H "Content-Type: application/json;charset=UTF-8" \
-H "Authorization: OAuth b86c9016b4f24953a9edefb53ca0678c" \
-X GET http://localhost:8080/zstack/v1/iam2/project/63c40906d58d3dd9bd4ce6d45b5fe941/repository/3a365d41ccc03557ad0192349df2bf07/image?limit=1000&start=0

参数列表


名字	类型	位置	描述	起始版本
projectId	String	url		5.1.8
repositoryId	String	url		5.1.8
limit (可选)	Integer	query		5.1.8
start (可选)	Integer	query		5.1.8
systemTags (可选)	List	query	系统标签	5.1.8
userTags (可选)	List	query	用户标签	5.1.8

API返回

返回示例

{
  "inventories": [
    {
      "name": "image",
      "tagCount": 3,
      "pullCount": 10,
      "createTime": "2026-05-22T10:00:00Z",
      "updateTime": "2026-05-22T10:30:00Z"
    }
  ],
  "total": 1
}


名字	类型	描述	起始版本
inventories	List	容器镜像列表	5.3.28
total	Integer	结果总数	5.3.28
name	String	镜像名称	5.3.28
tagCount	Integer	标签数量	5.3.28
pullCount	Integer	拉取次数	5.3.28
createTime	String	创建时间	5.3.28
updateTime	String	更新时间	5.3.28

SDK示例

Java SDK

GetIAM2ProjectContainerImagesAction action = new GetIAM2ProjectContainerImagesAction();
action.projectId = "63c40906d58d3dd9bd4ce6d45b5fe941";
action.repositoryId = "3a365d41ccc03557ad0192349df2bf07";
action.limit = 1000;
action.start = 0;
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c";
GetIAM2ProjectContainerImagesAction.Result res = action.call();

Python SDK

GetIAM2ProjectContainerImagesAction action = GetIAM2ProjectContainerImagesAction()
action.projectId = "63c40906d58d3dd9bd4ce6d45b5fe941"
action.repositoryId = "3a365d41ccc03557ad0192349df2bf07"
action.limit = 1000
action.start = 0
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c"
GetIAM2ProjectContainerImagesAction.Result res = action.call()