
# 查询发布包列表 - ListFactoryReleasePackages
#### 功能介绍
用于查询发布包的列表信息。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/DataArtsStudio/doc?api=ListFactoryReleasePackages)中调试该接口，支持自动认证鉴权。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dataartsstudio/abcd.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
- URI格式 POST /v2/{project_id}/factory/release-packages
  

- 参数说明
  表1URI参数说明 
  | 参数名        | 是否必选 | 参数类型   | 说明                                                                                                    |
  |:---|:---|:---|:---|
  | project_id | 是    | String | 项目编号，获取方法请参见[项目ID和账号ID](https://support.huaweicloud.com/api-dataartsstudio/projectid_accountid.html)。 |
     
  
 
#### 请求参数
表2请求Header参数 
| 参数名           | 是否必选 | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| workspace     | 否    | String | 工作空间id。获取方法请参见[实例ID和工作空间ID](https://support.huaweicloud.com/api-dataartsstudio/dataartsstudio_02_0350.html)。 - 如果不设置该参数，默认查询default工作空间下的数据。  - 如果需要查询其他工作空间的数据，需要带上该消息头。 说明： - 多个DataArts Studio实例需要指定工作空间。  - 当工作空间里面没有default工作空间时，工作空间为必填参数，否则会报错。      |
| X-Auth-Token  | 否    | String | 使用Token认证时该字段必选，用户Token的长度要求如下： 最小长度：**0** 最大长度：**4096**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Content-Type  | 否    | String | 有Body体的情况下必选，无Body体的情况下则无需填写和校验。 示例：Content-Type: application/json;charset=UTF-8                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Authorization | 否    | String | 使用AK/SK进行认证时该字段必选。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Host          | 否    | String | 使用AK/SK进行认证时该字段必选。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   
表3Body参数说明 
| 参数名                     | 是否必选 | 参数类型            | 说明                                                                                                                                                                                               |
|:---|:---|:---|:---|
| key_word                | 否    | String          | 包名package_name关键字。                                                                                                                                                                               |
| apply_user_name         | 否    | String          | 申请人名称。                                                                                                                                                                                           |
| deploy_user_name        | 否    | String          | 发布人名称。                                                                                                                                                                                           |
| apply_begin_time        | 否    | Long            | 申请开始时间，13位时间戳。                                                                                                                                                                                   |
| apply_end_time          | 否    | Long            | 申请结束时间，13位时间戳。                                                                                                                                                                                   |
| deploy_begin_time       | 否    | String          | 发布开始时间，13位时间戳。                                                                                                                                                                                   |
| deploy_end_time         | 否    | String          | 发布结束时间，13位时间戳。                                                                                                                                                                                   |
| apply_user_name_filter  | 否    | List\<String\>  | 申请人名称集合，根据该字段筛选，如果选择了apply_user_name，则该名称必须包含在集合内。                                                                                                                                               |
| deploy_user_name_filter | 否    | List\<String\>  | 发布人名称集合，根据该字段筛选，如果选择了deploy_user_name，则该名称必须包含在集合内。                                                                                                                                              |
| deploy_status_filter    | 否    | List\<Integer\> | 发布状态集合。 1：待审批 2：成功 3：失败 5：发布中 |
| sorted_direction        | 否    | String          | 排序方向，默认是desc。                                                                                                                                                                                    |
| order_column            | 否    | String          | 排序字段，默认是apply_timestamp。                                                                                                                                                                         |
| limit                   | 否    | Integer         | 分页返回结果，默认是10。                                                                                                                                                                                    |
| offset                  | 否    | Integer         | 分页的起始页，默认值为0，取值范围大于等于0。                                                                                                                                                                          |
   
#### 响应参数
表4参数说明 
| 参数名   | 是否必选 | 参数类型            | 说明                                                         |
|:---|:---|:---|:---|
| data  | 是    | array\[object\] | 发布包信息，参考[表5]。 |
| total | 是    | Integer         | 发布包个数。                                                     |
   
 表5发布包信息的参数说明 
| 参数名               | 是否必选 | 参数类型            | 说明                                                                                                                                                                                          |
|:---|:---|:---|:---|
| apply_timestamp   | 否    | Long            | 申请时间，13位时间戳。                                                                                                                                                                                |
| apply_user_id     | 否    | String          | 申请人id。                                                                                                                                                                                      |
| apply_user_name   | 否    | String          | 申请人名称。                                                                                                                                                                                      |
| delete_flag       | 否    | integer         | 是否删除。 0：没有删除 1：删除                                                                                       |
| deploy_status     | 否    | integer         | 发布状态。 1：待审批 2：成功 3：失败 5：发布中 |
| deploy_timestamp  | 否    | Long            | 发布时间，13位时间戳。                                                                                                                                                                                |
| deploy_user_id    | 否    | String          | 发布人id。                                                                                                                                                                                      |
| deploy_user_name  | 否    | String          | 发布人名称。                                                                                                                                                                                      |
| package_approvers | 否    | array\[object\] | 发布包审批信息，参考[表6]。                                                                                                                               |
| package_id        | 否    | String          | 发布包id。                                                                                                                                                                                      |
| package_name      | 否    | String          | 发布包名称。                                                                                                                                                                                      |
| project_id        | 否    | String          | 项目ID和空间信息，以 项目ID-workspace-空间ID 拼接。                                                                                                                                                         |
| workspace_id      | 否    | String          | 发布包所在空间ID。                                                                                                                                                                                  |
   
 表6发布包审批信息的参数说明 
| 参数名       | 是否必选 | 参数类型   | 说明        |
|:---|:---|:---|:---|
| user_id   | 否    | String | 发布包审批人id。 |
| user_name | 否    | String | 发布包审批人名称。 |
   
#### 请求示例
```
POST /v2/62099355b894428e8916573ae635f1f9/factory/release-packages
{
"key_word": "",
"apply_user_name": "",
"deploy_user_name": "",
        "apply_begin_time": 1699113600999,
"apply_end_time": 1700323199999,
"deploy_begin_time": "",
"deploy_end_time": "",
"apply_user_name_filter": [],
"deploy_user_name_filter": [],
"deploy_status_filter": [],
"sorted_direction": "desc",
"order_column": "apply_timestamp",
"limit": 10,
"offset": 0
}
```
#### 响应示例
- 成功响应 HTTP状态码 200
  ```
  {
      "data": [
          {
              "apply_timestamp": 1700288912934,
              "apply_user_id": "7b71e498e75d44048c9a22dd3c54f978",
              "apply_user_name": "ei_dlf_l00341563",
              "delete_flag": 0,
              "deploy_status": 3,
              "deploy_timestamp": 1700289155129,
              "deploy_user_id": "7b71e498e75d44048c9a22dd3c54f978",
              "deploy_user_name": "ei_dlf_l00341563",
              "package_approvers": [
                  {
                      "user_id": "7b71e498e75d44048c9a22dd3c54f978",
                      "user_name": "ei_dlf_l00341563"
                  }
              ],
              "package_id": "4",
              "package_name": "ads_supplier_inventory_info__ads_supplier_inventory_info_20231118143537",
              "project_id": "62099355b894428e8916573ae635f1f9-workspace-45be704b28cb4f25a39221169fd3e27e",
              "workspace_id": "45be704b28cb4f25a39221169fd3e27e"
          },
          {
              "apply_timestamp": 1700288777664,
              "apply_user_id": "7b71e498e75d44048c9a22dd3c54f978",
              "apply_user_name": "ei_dlf_l00341563",
              "delete_flag": 0,
              "deploy_status": 2,
              "deploy_timestamp": 1700289161361,
              "deploy_user_id": "7b71e498e75d44048c9a22dd3c54f978",
              "deploy_user_name": "ei_dlf_l00341563",
              "package_approvers": [
                  {
                      "user_id": "7b71e498e75d44048c9a22dd3c54f978",
                      "user_name": "ei_dlf_l00341563"
                  }
              ],
              "package_id": "3",
              "package_name": "aa_20231118143318",
              "project_id": "62099355b894428e8916573ae635f1f9-workspace-45be704b28cb4f25a39221169fd3e27e",
              "workspace_id": "45be704b28cb4f25a39221169fd3e27e"
          }
      ],
      "total": 2
  }
  ```
  
- 失败响应 HTTP状态码 400
  ```
  {
      "error_code": "DLF.3051",
      "error_msg": "The request parameter is invalid.  "
  }
  ```
  
 
