# 获取制品Manifest信息 - ShowInstanceArtifactManifest
#### 功能介绍
获取制品的Manifest信息
#### 接口约束
此接口只在注册表实例版本26.6.0及以上的版本才支持
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-swr2/swr_02_0002.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-swr2/swr_02_0131.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                                | 访问级别 | 资源类型（\*为必须）   | 条件键                                                                                                                                                                                                                                                                                                                 | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | 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 | 内部错误             |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-swr2/ErrorCode.html)。