# 查询指定链码版本信息
#### 功能介绍
查询指定链码版本信息
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/BCS/doc?api=ListChaincodeVersion)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
GET /v2/agent/apis/chaincode/versions
表1Query参数 
| 参数             | 是否必选 | 参数类型   | 描述                              |
|:---|:---|:---|:---|
| chaincode_name | 是    | String | 链代码名称，以小写字母开头，支持小写字母和数字，长度6-25位 |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数       | 参数类型                                                                                    | 描述     |
|:---|:---|:---|
| versions | Array of [ChaincodeVersion] objects | 链码版本信息 |
   
 表4ChaincodeVersion 
| 参数                        | 参数类型                                                                    | 描述                               |
|:---|:---|:---|
| version                   | String                                                                  | 链码版本                             |
| hash_code                 | String                                                                  | 链码版本哈希值                          |
| description               | String                                                                  | 链码版本描述                           |
| install_time              | String                                                                  | 链码版本安装时间                         |
| update_time               | String                                                                  | 链码版本更新时间                         |
| instantiate_status        | Boolean                                                                 | 链码版本实例化状态                        |
| security_check_status     | Integer                                                                 | 链代码安全检查状态（0：不存在，1：运行中，2：完成，3：失败） |
| uninstantiated_peer_infos | Array of [PeerInfo] objects | 未实例化的peer信息                      |
   
 表5PeerInfo 
| 参数        | 参数类型             | 描述           |
|:---|:---|:---|
| org_name  | String           | 组织名称         |
| org_id    | String           | 组织id         |
| peer_name | String           | 节点名称         |
| peer_id   | String           | 节点id         |
| status    | String           | 节点状态         |
| channels  | Array of strings | 未实例化的peer信息  |
| url       | String           | Peer节点的url信息 |
| peer      | String           | Peer节点的内部域名  |
   
**状态码： 400**
表6响应Body参数 
| 参数            | 参数类型   | 描述   |
|:---|:---|:---|
| error_code    | String | 错误码  |
| error_message | String | 错误描述 |
| error_msg     | String | 错误描述 |
   
#### 请求示例
```
GET https://192.168.0.90:30603/v2/agent/apis/chaincode/versions?chaincode_name=chaincode
```
#### 响应示例
**状态码： 200**
Success
```
{
  "versions" : [ {
    "version" : "1.0",
    "hash_code" : "1473b4807fe9f970d1ba56192e41d39c7d621d07d80e603cf75ed3982b81034d",
    "description" : "",
    "install_time" : "2021-01-11T11:27:12.093454567+08:00",
    "update_time" : "2021-01-11T11:27:12.093454789+08:00",
    "instantiate_status" : false,
    "uninstantiated_peer_infos" : [ {
      "org_name" : "organization",
      "org_id" : "57e7914450b098771f5106acaf02be8a61894fae",
      "peer_name" : "peer-0",
      "peer_id" : "peer-57e7914450b098771f5106acaf02be8a61894fae-0.peer-57e7914450b098771f5106acaf02be8a61894fae.default.svc.cluster.local"
    }, {
      "org_name" : "organization",
      "org_id" : "57e7914450b098771f5106acaf02be8a61894fae",
      "peer_name" : "peer-1",
      "peer_id" : "peer-57e7914450b098771f5106acaf02be8a61894fae-1.peer-57e7914450b098771f5106acaf02be8a61894fae.default.svc.cluster.local"
    } ],
    "security_check_status" : 2
  } ]
}
```
**状态码： 400**
Bad Request
```
{
  "error_code" : "BCS.4000013",
  "error_message" : "request body is too large"
}
```
#### 状态码
| 状态码 | 描述          |
|:---|:---|
| 200 | Success     |
| 400 | Bad Request |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/devg-bcs/ErrorCode.html)。