获取IAM2项目可用的容器镜像标签 (GetIAM2ProjectContainerImageTags) | 开发手册 | AIOS

API请求

URLs

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

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/6cbb461a8ffc36f5829ed3aab347f1d0/repository/6e5f6080c3f93a9b935ce299787d9aa5/image/ai-worker/tag?limit=1000&start=0

参数列表

名字	类型	位置	描述	起始版本
projectId	String	url		5.1.8
repositoryId	String	url		5.1.8
imageName	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": "latest",
      "size": 1048576,
      "sizeStr": "1 MiB",
      "digest": "sha256:example",
      "createTime": "2026-05-22T10:00:00Z",
      "address": "registry.example.com/project/image:latest",
      "pullCommand": "docker pull registry.example.com/project/image:latest",
      "architectures": "amd64"
    }
  ],
  "total": 1
}

名字	类型	描述	起始版本
inventories	List	镜像标签列表	5.3.28
total	Integer	结果总数	5.3.28
name	String	标签名称	5.3.28
size	Long	镜像大小	5.3.28
sizeStr	String	镜像大小字符串	5.3.28
digest	String	镜像摘要	5.3.28
createTime	String	创建时间	5.3.28
address	String	镜像地址	5.3.28
pullCommand	String	拉取命令	5.3.28
architectures	String	架构信息	5.3.28

SDK示例

Java SDK

GetIAM2ProjectContainerImageTagsAction action = new GetIAM2ProjectContainerImageTagsAction();
action.projectId = "6cbb461a8ffc36f5829ed3aab347f1d0";
action.repositoryId = "6e5f6080c3f93a9b935ce299787d9aa5";
action.imageName = "ai-worker";
action.limit = 1000;
action.start = 0;
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c";
GetIAM2ProjectContainerImageTagsAction.Result res = action.call();

Python SDK

GetIAM2ProjectContainerImageTagsAction action = GetIAM2ProjectContainerImageTagsAction()
action.projectId = "6cbb461a8ffc36f5829ed3aab347f1d0"
action.repositoryId = "6e5f6080c3f93a9b935ce299787d9aa5"
action.imageName = "ai-worker"
action.limit = 1000
action.start = 0
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c"
GetIAM2ProjectContainerImageTagsAction.Result res = action.call()