获取制品Manifest信息 - ShowInstanceArtifactManifest_制品版本管理_API_API参考（企业版）

功能介绍

获取制品的Manifest信息

接口约束

此接口只在注册表实例版本26.6.0及以上的版本才支持

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。

如果使用身份策略授权，需具备如下身份策略权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
swr:repository:getArtifactManifest	Read	repository *	g:ResourceTag/<tag-key> g:EnterpriseProjectId	-	-

URI

GET /v2/{project_id}/instances/{instance_id}/namespaces/{namespace_name}/repositories/{repository_name}/artifacts/{reference}/manifest

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID
instance_id	是	String	注册表实例ID
namespace_name	是	String	命名空间名称
repository_name	是	String	制品仓库名称, 如果您的镜像名称repository_name参数中有/，请先把 / 替换成 %2F 再进行请求。注意：使用curl命令请求，需要把 / 替换成 %252F(即 %2F 的 % 被编码为 %25)再次请求。
reference	是	String	制品摘要

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
-	String

状态码：400

表4 响应Body参数
参数	参数类型	描述
error_code	String	错误码
error_msg	String	错误信息
encoded_authorization_message	String	加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

状态码：401

表5 响应Body参数
参数	参数类型	描述
error_code	String	错误码
error_msg	String	错误信息
encoded_authorization_message	String	加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

状态码：403

表6 响应Body参数
参数	参数类型	描述
error_code	String	错误码
error_msg	String	错误信息
encoded_authorization_message	String	加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

状态码：404

表7 响应Body参数
参数	参数类型	描述
error_code	String	错误码
error_msg	String	错误信息
encoded_authorization_message	String	加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

状态码：500

表8 响应Body参数
参数	参数类型	描述
error_code	String	错误码
error_msg	String	错误信息
encoded_authorization_message	String	加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

请求示例

GET https://{endpoint}/v2/{project_id}/instances/{instance_id}/namespaces/{namespace_name}/repositories/{repository_name}/artifacts/{reference}/manifest

响应示例

状态码：200

查询制品Manifest信息成功

{
  "schemaVersion" : 2,
  "mediaType" : "application/vnd.docker.distribution.manifest.v2+json",
  "config" : {
    "mediaType" : "application/vnd.docker.container.image.v1+json",
    "size" : 1216,
    "digest" : "sha256:172acc6b1fe2930754a9f9d94703a7d571a1eb38cf54f93f47a5a47383baab20"
  },
  "layers" : [ {
    "mediaType" : "application/vnd.docker.image.rootfs.diff.tar.gzip",
    "size" : 96,
    "digest" : "sha256:da9a91b252b0ddcdb64ac42b23b8c1ae6ef3f020987988ebc882d9ec98144df0"
  } ]
}

状态码

状态码	描述
200	查询制品Manifest信息成功
400	错误的请求
401	鉴权失败
403	禁止访问
404	未找到资源
500	内部错误

错误码

请参见错误码。

获取制品Manifest信息 - ShowInstanceArtifactManifest