
# 查询迁移任务组列表 - ListTaskGroup
#### 功能介绍
查询用户账户下的任务组信息
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-oms/oms_api_0006.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-oms/oms_api_8001.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                | 访问级别 | 资源类型（\*为必须）  | 条件键 | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | oms:taskgroup:list | List | taskgroup \* | -   | -  | -      |
     
  
 
#### URI
GET /v2/{project_id}/taskgroups
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                              |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID 最小长度：**1** 最大长度：**1024** |
   
表2Query参数 
| 参数     | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| limit  | 否    | Integer | 查询返回迁移组任务列表当前页面的数量，默认查询10条。 最多返回100条迁移任务信息。 最小值：**1** 最大值：**100** 缺省值：**10**                                                                                                                                                                                                                                                                                                                                                                                 |
| offset | 否    | Integer | 起始的任务序号，默认为0。 取值大于等于0，取值为0时从第一条开始查询。 最小值：**0** 最大值：**2147483647** 缺省值：**0**                                                                                                                                                                                                                                                                                                                                                                                  |
| status | 否    | Integer | 迁移任务组状态（无该参数时代表查询所有状态的任务） 0 -- 等待中 1 -- 执行中/创建中 2 -- 监控任务执行 3 -- 暂停 4 -- 创建任务失败 5 -- 迁移失败 6 -- 迁移完成 7 -- 暂停中 8 -- 等待删除中 9 -- 删除 最小值：**0** 最大值：**9** |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                       |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | IAM 鉴权 Token 最小长度：**1** 最大长度：**16384** |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数         | 参数类型                                                                     | 描述                                                                                                                   |
|:---|:---|:---|
| count      | Long                                                                     | 满足查询条件的任务组总数 最小值：**0** 最大值：**9223372036854775807** |
| taskgroups | Array of [TaskGroupResp] objects | 查询的迁移任务组详情 数组长度：**0 - 100**                                                         |
   
 表5TaskGroupResp 
| 参数                             | 参数类型                                                                               | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|
| group_id                       | String                                                                             | 任务组id 最小长度：**1** 最大长度：**100**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| status                         | Integer                                                                            | 迁移组任务状态。 0 -- 等待中 1 -- 执行中/创建中 2 -- 监控任务执行 3 -- 暂停 4 -- 创建任务失败 5 -- 迁移失败 6 -- 迁移完成 7 -- 暂停中 8 -- 等待删除中 9 -- 删除 最小值：**0** 最大值：**9**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| error_reason                   | [ErrorReasonResp] object                 | 任务组失败原因，非失败状态时该字段为空字符串。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| src_node                       | [TaskGroupSrcNodeResp] object       | 源端信息                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| description                    | String                                                                             | 任务组描述，不能超过255个字符，且不能包含\^\<\>\&"'等特殊字符。 最小长度：**0** 最大长度：**255**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| dst_node                       | [TaskGroupDstNodeResp] object       | 目的端信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| enable_metadata_migration      | Boolean                                                                            | 是否启用元数据迁移，默认否。不启用时，为保证迁移任务正常运行，仍将为您迁移ContentType元数据。 缺省值：**false**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| enable_failed_object_recording | Boolean                                                                            | 是否开启记录失败对象                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| enable_restore                 | Boolean                                                                            | 是否自动解冻归档数据，（由于对象存储解冻需要源端存储等待一定时间，开启自动解冻会对迁移速度有较大影响，建议先完成归档存储数据解冻后再启动迁移）。开启后，如果遇到归档类型数据，会自动解冻再进行迁移；关闭后，如果遇到归档类型的对象直接跳过相应对象，系统默认对象迁移失败并记录相关信息到失败对象列表中。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| task_type                      | String                                                                             | 任务类型，默认为PREFIX。 LIST：对象列表迁移 URL_LIST：URL列表迁移， PREFIX：对象前缀迁移 枚举值： - **LIST**   - **URL_LIST**   - **PREFIX**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| bandwidth_policy               | Array of [BandwidthPolicyDto] objects | 配置流量控制策略。数组中一个元素对应一个时段的最大带宽，最多允许5个时段，且时段不能重叠。 数组长度：**0 - 5**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| smn_config                     | [SmnInfo] object                                 | SMN消息发送配置。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| source_cdn                     | [SourceCdnResp] object                     | 指定是否启用CDN迁移支持，若包含此字段则为支持，否则为不支持，启用CDN迁移支持后，迁移时将从CDN域名获取源端对象。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| migrate_since                  | Long                                                                               | 迁移指定时间（时间戳，毫秒），表示仅迁移在指定时间之后修改的源端待迁移对象。默认为0，表示不设置迁移指定时间。 最小值：**0** 最大值：**9223372036854775807** 缺省值：**0**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| migrate_speed                  | Long                                                                               | 任务组迁移速度（Byte/s） 最小值：**0** 最大值：**9223372036854775807**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| total_time                     | Long                                                                               | 迁移任务组总耗时(毫秒) 最小值：**0** 最大值：**9223372036854775807**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| start_time                     | Long                                                                               | 迁移任务组的启动时间(Unix时间戳，毫秒) 最小值：**0** 最大值：**9223372036854775807**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| total_task_num                 | Long                                                                               | 任务组包含的迁移任务总数 最小值：**0** 最大值：**9223372036854775807**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| create_task_num                | Long                                                                               | 已创建的迁移任务数 最小值：**0** 最大值：**9223372036854775807**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| failed_task_num                | Long                                                                               | 失败的迁移任务数 最小值：**0** 最大值：**9223372036854775807**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| complete_task_num              | Long                                                                               | 已完成的迁移任务数 最小值：**0** 最大值：**9223372036854775807**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| paused_task_num                | Long                                                                               | 暂停的迁移任务数 最小值：**0** 最大值：**9223372036854775807**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| executing_task_num             | Long                                                                               | 正在运行的迁移任务数 最小值：**0** 最大值：**9223372036854775807**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| waiting_task_num               | Long                                                                               | 等待中的迁移任务数 最小值：**0** 最大值：**9223372036854775807**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| total_num                      | Long                                                                               | 迁移任务组包含的对象总数量 最小值：**0** 最大值：**9223372036854775807**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| create_complete_num            | Long                                                                               | 已完成任务创建的对象总数量 最小值：**0** 最大值：**9223372036854775807**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| success_num                    | Long                                                                               | 成功的对象数量 最小值：**0** 最大值：**9223372036854775807**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| fail_num                       | Long                                                                               | 失败的对象数量 最小值：**0** 最大值：**9223372036854775807**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| skip_num                       | Long                                                                               | 忽略的对象数量 最小值：**0** 最大值：**9223372036854775807**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| total_size                     | Long                                                                               | 任务迁移总大小(Byte) 最小值：**0** 最大值：**9223372036854775807**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| create_complete_size           | Long                                                                               | 已创建迁移任务包含的对象总大小(Byte) 最小值：**0** 最大值：**9223372036854775807**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| complete_size                  | Long                                                                               | 已迁移成功的对象总大小(Byte) 最小值：**0** 最大值：**9223372036854775807**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| failed_object_record           | [FailedObjectRecordDto] object     | 失败对象记录                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| object_overwrite_mode          | String                                                                             | 迁移前同名对象覆盖方式，用于迁移前判断源端与目的端有同名对象时，覆盖目的端或跳过迁移。默认SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE。NO_OVERWRITE：不覆盖。迁移前源端对象与目的端对象同名时，不做对比直接跳过迁移。SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE：大小/最后修改时间对比覆盖。默认配置。迁移前源端对象与目的端对象同名时，通过对比源端和目的端对象大小和最后修改时间，判断是否覆盖目的端，需满足源端/目的端对象的加密状态一致。源端与目的端同名对象大小不相同，或目的端对象的最后修改时间晚于源端对象的最后修改时间(源端较新)，覆盖目的端。 CRC64_COMPARISON_OVERWRITE：CRC64对比覆盖。目前仅支持华为/阿里/腾讯。迁移前源端对象与目的端对象同名时，通过对比源端和目的端对象元数据中CRC64值是否相同，判断是否覆盖目的端，需满足源端/目的端对象的加密状态一致。如果源端与目的端对象元数据中不存在CRC64值，则系统会默认使用SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE(大小/最后修改时间对比覆盖)来对比进行覆盖判断。FULL_OVERWRITE：全覆盖。迁移前源端对象与目的端对象同名时，不做对比覆盖目的端。 枚举值： - **NO_OVERWRITE**   - **SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE**   - **CRC64_COMPARISON_OVERWRITE**   - **FULL_OVERWRITE**    |
| dst_storage_policy             | String                                                                             | 目的端存储类型设置，当且仅当目的端为华为云OBS时需要，默认为标准存储 STANDARD：华为云OBS标准存储 IA：华为云OBS低频存储 ARCHIVE：华为云OBS归档存储 DEEP_ARCHIVE：华为云OBS深度归档存储 SRC_STORAGE_MAPPING：保留源端存储类型，将源端存储类型映射为华为云OBS存储类型 缺省值：**STANDARD** 最小长度：**0** 最大长度：**128** 枚举值： - **STANDARD**   - **IA**   - **ARCHIVE**   - **DEEP_ARCHIVE**   - **SRC_STORAGE_MAPPING**                               |
| obs_system                     | String                                                                             | OBS系统类型 BUCKET：一般桶 PFS：并行文件系统 枚举值： - **BUCKET**   - **PFS**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| consistency_check              | String                                                                             | 一致性校验方式，用于迁移前/后校验对象是否一致，所有校验方式需满足源端/目的端对象的加密状态一致，具体校验方式和校验结果可通过对象列表查看。默认size_last_modified。size_last_modified：默认配置。迁移前后，通过对比源端和目的端对象大小+最后修改时间，判断对象是否已存在或迁移后数据是否完整。源端与目的端同名对象大小相同，且目的端对象的最后修改时间不早于源端对象的最后修改时间，则代表该对象已存在/迁移成功。crc64：目前仅支持华为/阿里/腾讯。迁移前后，通过对比源端和目的端对象元数据中CRC64值是否相同，判断对象是否已存在/迁移完成。如果源端与目的端对象元数据中不存在CRC64值，则系统会默认使用大小/最后修改时间校验方式来校验。no_check：目前仅支持HTTP/HTTPS数据源。当源端对象无法通过标准http协议中content-length字段获取数据大小时，默认数据下载成功即迁移成功，不对数据做额外校验，且迁移时源端对象默认覆盖目的端同名对象。当源端对象能正常通过标准http协议中content-length字段获取数据大小时，则采用大小/最后修改时间校验方式来校验。 枚举值： - **size_last_modified**   - **crc64**   - **no_check**                                                                                                                                                                                                                                                                |
| enable_requester_pays          | Boolean                                                                            | 是否开启请求者付款，在启用后，请求者支付请求和数据传输费用。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
   
 表6ErrorReasonResp 
| 参数         | 参数类型   | 描述                                                                                                  |
|:---|:---|:---|
| error_code | String | 迁移失败的错误码。 最小长度：**0** 最大长度：**10**  |
| error_msg  | String | 迁移失败的原因。 最小长度：**0** 最大长度：**1024** |
   
 表7TaskGroupSrcNodeResp 
| 参数         | 参数类型                                                 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|
| bucket     | String                                               | 源端桶的名称。 最小长度：**0** 最大长度：**1024**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| cloud_type | String                                               | 源端云服务提供商。可选值有AWS、AZURE、ALIYUN、TENCENT、HUAWEICLOUD、QINGCLOUD、KINGSOFTCLOUD、BAIDU、QINIU、GOOGLE、URLSOURCE或者UCLOUD。默认值为ALIYUN。 枚举值： - **AWS**   - **AZURE**   - **ALIYUN**   - **TENCENT**   - **HUAWEICLOUD**   - **QINGCLOUD**   - **KINGSOFTCLOUD**   - **BAIDU**   - **QINIU**   - **URLSOURCE**   - **UCLOUD**   - **GOOGLE**    |
| region     | String                                               | 源端桶所处的区域。 最小长度：**0** 最大长度：**100**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| app_id     | String                                               | 腾讯云APPID，当源端为腾讯云时，会返回此参数。 最小长度：**0** 最大长度：**255**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| object_key | Array of strings                                     | 任务组类型为前缀迁移任务时，表示待迁移前缀。 最小长度：**0** 最大长度：**1024** 数组长度：**0 - 500**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| list_file  | [ListFile] object | 列表文件配置，当task_type为list或url_list时，list_file为必选参数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   
 表8ListFile 
| 参数            | 参数类型   | 描述                                                                                                                                                                      |
|:---|:---|:---|
| list_file_key | String | 对象列表文件或URL列表文件对象名。 最小长度：**1** 最大长度：**1024**                                                           |
| obs_bucket    | String | 存放对象列表文件的OBS桶名。 请确保与目的端桶处于同一区域，否则将导致任务创建失败。 最小长度：**0** 最大长度：**1024** |
| list_file_num | String | 存放对象列表文件的数量 最小长度：**0** 最大长度：**65535**                                                                 |
   
 表9TaskGroupDstNodeResp 
| 参数          | 参数类型   | 描述                                                                                                                                       |
|:---|:---|:---|
| bucket      | String | 目的端桶的名称。 最小长度：**0** 最大长度：**1024**                                      |
| region      | String | 目的端桶所处的区域。 最小长度：**0** 最大长度：**100**                                     |
| save_prefix | String | 目的端桶内路径前缀（拼接在对象key前面,组成新的key,拼接后不能超过1024个字符）。 最小长度：**0** 最大长度：**1024** |
   
 表10BandwidthPolicyDto 
| 参数            | 参数类型   | 描述                                                                                                                                                                                         |
|:---|:---|:---|
| end           | String | 流量控制结束时间，格式为"hh:mm"。例如"12:03"表示12时03分。该时间必须晚于 start 参数，且必须在同一天内（不支持跨天）。                                                                                                                    |
| max_bandwidth | Long   | 时段内允许的最大流量带宽，单位Byte/s，取值范围为\>= 1048576Byte/s（相当于1MB/s）且\<=209715200Byte/s（相当于200MB/s）。 最小值：**1048576** 最大值：**209715200** |
| start         | String | 流量控制开始时间，格式为"hh:mm"。例如"12:03"表示12时03分。该时间必须早于 end 参数，且必须在同一天内（不支持跨天）。                                                                                                                      |
   
 表11SmnInfo 
| 参数                   | 参数类型    | 描述                                                                                                                       |
|:---|:---|:---|
| notify_result        | Boolean | 记录迁移任务执行完毕后SMN消息是否发送成功。                                                                                                  |
| notify_error_message | String  | 记录SMN消息发送失败原因的错误码（迁移任务成功时为空）。 最小长度：**0** 最大长度：**1024** |
| topic_name           | String  | SMN Topic的名称（SMN消息发送成功时为空）。 最小长度：**0** 最大长度：**5120**   |
   
 表12SourceCdnResp 
| 参数                  | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|
| domain              | String | 从指定域名获取对象。 最小长度：**0** 最大长度：**1024**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| protocol            | String | 协议类型，支持http和https协议。 枚举值： - **http**   - **https**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| authentication_type | String | 鉴权类型: NONE：公开访问，无安全限制, QINIU_PRIVATE_AUTHENTICATION：七牛自定义URL签名, ALIYUN_OSS_A：阿里云 URL携带签名，简单通用, ALIYUN_OSS_B：阿里云 Header携带签名，用于API调用, ALIYUN_OSS_C：阿里云 STS临时安全令牌，最安全, KSYUN_PRIVATE_AUTHENTICATION：金山云 金山云自定义URL签名, AZURE_SAS_TOKEN：微软Azure 灵活安全的共享访问签名, TENCENT_COS_A:腾讯云 多次有效签名（不推荐）, TENCENT_COS_B:腾讯云 单次有效签名，安全性最高, TENCENT_COS_C:腾讯云 Header携带签名，用于API调用, TENCENT_COS_D:腾讯云 Header携带签名，用于API调用. 枚举值： - **NONE**   - **QINIU_PRIVATE_AUTHENTICATION**   - **ALIYUN_OSS_A**   - **ALIYUN_OSS_B**   - **ALIYUN_OSS_C**   - **KSYUN_PRIVATE_AUTHENTICATION**   - **AZURE_SAS_TOKEN**   - **TENCENT_COS_A**   - **TENCENT_COS_B**   - **TENCENT_COS_C**   - **TENCENT_COS_D**    |
   
 表13FailedObjectRecordDto 
| 参数            | 参数类型    | 描述                                                                                                       |
|:---|:---|:---|
| result        | Boolean | 是否支持失败对象重传。                                                                                              |
| list_file_key | String  | 失败对象列表文件路径。 最小长度：**0** 最大长度：**1024**   |
| error_code    | String  | 失败对象列表上传失败的错误码。 最小长度：**0** 最大长度：**10** |
   
**状态码：400**
表14响应Body参数 
| 参数         | 参数类型   | 描述    |
|:---|:---|:---|
| error_msg  | String | 错误信息。 |
| error_code | String | 错误码。  |
   
**状态码：403**
表15响应Body参数 
| 参数         | 参数类型   | 描述    |
|:---|:---|:---|
| error_msg  | String | 错误信息。 |
| error_code | String | 错误码。  |
   
**状态码：500**
表16响应Body参数 
| 参数         | 参数类型   | 描述    |
|:---|:---|:---|
| error_msg  | String | 错误信息。 |
| error_code | String | 错误码。  |
   
#### 请求示例
查询f4e146cac1de45669c3fed73dc3b9c6f下的10条迁移任务组数据
```
GET https://{endpoint}/v2/f4e146cac1de45669c3fed73dc3b9c6f/taskgroups?offset=0&limit=10
```
#### 响应示例
**状态码：200**
Ok
```
{
  "count" : 353,
  "taskgroups" : [ {
    "group_id" : "9dd98a5e-7ea3-4d80-abff-4c23914313e4",
    "status" : 6,
    "error_reason" : null,
    "src_node" : {
      "bucket" : "api-auto-test",
      "cloud_type" : "TENCENT",
      "region" : "ap-beijing",
      "app_id" : "1254563210",
      "object_key" : [ "test" ],
      "list_file" : null
    },
    "description" : "",
    "dst_node" : {
      "bucket" : "test-l30022277",
      "region" : "cn-north-7",
      "save_prefix" : ""
    },
    "enable_metadata_migration" : false,
    "enable_failed_object_recording" : true,
    "enable_restore" : false,
    "task_type" : "PREFIX",
    "bandwidth_policy" : [ ],
    "smn_config" : null,
    "source_cdn" : null,
    "migrate_since" : 0,
    "migrate_speed" : 0,
    "total_time" : 973657,
    "start_time" : 1663654062461,
    "total_task_num" : null,
    "create_task_num" : null,
    "failed_task_num" : null,
    "complete_task_num" : null,
    "paused_task_num" : null,
    "executing_task_num" : null,
    "waiting_task_num" : null,
    "total_num" : 6,
    "create_complete_num" : null,
    "success_num" : 6,
    "fail_num" : 0,
    "skip_num" : 0,
    "total_size" : 2469022100,
    "create_complete_size" : null,
    "complete_size" : 2469022100,
    "failed_object_record" : {
      "result" : null,
      "list_file_key" : null,
      "error_code" : null
    },
    "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE",
    "consistency_check" : "size_last_modified",
    "enable_requester_pays" : false,
    "dst_storage_policy" : "STANDARD",
    "obs_system" : "BUCKET"
  }, {
    "group_id" : "2597fc69-af30-4411-b59d-b37857b69792",
    "status" : 6,
    "error_reason" : null,
    "src_node" : {
      "bucket" : "test-retry",
      "cloud_type" : "HUAWEICLOUD",
      "region" : "cn-north-7",
      "app_id" : "",
      "object_key" : [ "%21" ],
      "list_file" : null
    },
    "description" : "",
    "dst_node" : {
      "bucket" : "assess-bucket-1",
      "region" : "cn-north-7",
      "save_prefix" : ""
    },
    "enable_metadata_migration" : false,
    "enable_failed_object_recording" : true,
    "enable_restore" : false,
    "task_type" : "PREFIX",
    "bandwidth_policy" : [ ],
    "smn_config" : null,
    "source_cdn" : null,
    "migrate_since" : 0,
    "migrate_speed" : 0,
    "total_time" : 43440,
    "start_time" : 1663340552910,
    "total_task_num" : null,
    "create_task_num" : null,
    "failed_task_num" : null,
    "complete_task_num" : null,
    "paused_task_num" : null,
    "executing_task_num" : null,
    "waiting_task_num" : null,
    "total_num" : 1,
    "create_complete_num" : null,
    "success_num" : 0,
    "fail_num" : 0,
    "skip_num" : 1,
    "total_size" : 1205,
    "create_complete_size" : null,
    "complete_size" : 1205,
    "failed_object_record" : {
      "result" : null,
      "list_file_key" : null,
      "error_code" : null
    },
    "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE",
    "consistency_check" : "size_last_modified",
    "enable_requester_pays" : false,
    "dst_storage_policy" : "STANDARD",
    "obs_system" : "BUCKET"
  }, {
    "group_id" : "d85ed5a8-61a1-492f-a146-2fd092dc37cf",
    "status" : 5,
    "error_reason" : null,
    "src_node" : {
      "bucket" : "assess-bucket-1",
      "cloud_type" : "HUAWEICLOUD",
      "region" : "cn-north-7",
      "app_id" : "",
      "object_key" : [ "" ],
      "list_file" : null
    },
    "description" : "",
    "dst_node" : {
      "bucket" : "assess-bucket-1",
      "region" : "cn-north-7",
      "save_prefix" : ""
    },
    "enable_metadata_migration" : false,
    "enable_failed_object_recording" : true,
    "enable_restore" : false,
    "task_type" : "PREFIX",
    "bandwidth_policy" : [ ],
    "smn_config" : null,
    "source_cdn" : null,
    "migrate_since" : 0,
    "migrate_speed" : 0,
    "total_time" : 4047612,
    "start_time" : 1663070894867,
    "total_task_num" : null,
    "create_task_num" : null,
    "failed_task_num" : null,
    "complete_task_num" : null,
    "paused_task_num" : null,
    "executing_task_num" : null,
    "waiting_task_num" : null,
    "total_num" : 99020,
    "create_complete_num" : null,
    "success_num" : 0,
    "fail_num" : 99020,
    "skip_num" : 0,
    "total_size" : 954329692,
    "create_complete_size" : null,
    "complete_size" : 954329692,
    "failed_object_record" : {
      "result" : true,
      "list_file_key" : "oms/task_group/d85ed5a8-61a1-492f-a146-2fd092dc37cf/failed_object_lists/",
      "error_code" : null
    },
    "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE",
    "consistency_check" : "size_last_modified",
    "enable_requester_pays" : false,
    "dst_storage_policy" : "STANDARD",
    "obs_system" : "BUCKET"
  }, {
    "group_id" : "2a84320a-eddb-4413-9b12-a0251aae0f3e",
    "status" : 6,
    "error_reason" : null,
    "src_node" : {
      "bucket" : "api-test",
      "cloud_type" : "UCLOUD",
      "region" : "cn-bj",
      "app_id" : "",
      "object_key" : [ "test" ],
      "list_file" : null
    },
    "description" : "",
    "dst_node" : {
      "bucket" : "test-l30022277",
      "region" : "cn-north-7",
      "save_prefix" : ""
    },
    "enable_metadata_migration" : false,
    "enable_failed_object_recording" : true,
    "enable_restore" : false,
    "task_type" : "PREFIX",
    "bandwidth_policy" : [ ],
    "smn_config" : null,
    "source_cdn" : null,
    "migrate_since" : 0,
    "migrate_speed" : 0,
    "total_time" : 63228,
    "start_time" : 1662725286648,
    "total_task_num" : null,
    "create_task_num" : null,
    "failed_task_num" : null,
    "complete_task_num" : null,
    "paused_task_num" : null,
    "executing_task_num" : null,
    "waiting_task_num" : null,
    "total_num" : 6,
    "create_complete_num" : null,
    "success_num" : 5,
    "fail_num" : 0,
    "skip_num" : 1,
    "total_size" : 0,
    "create_complete_size" : null,
    "complete_size" : 0,
    "failed_object_record" : {
      "result" : null,
      "list_file_key" : null,
      "error_code" : null
    },
    "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE",
    "consistency_check" : "size_last_modified",
    "enable_requester_pays" : false,
    "dst_storage_policy" : "STANDARD",
    "obs_system" : "BUCKET"
  }, {
    "group_id" : "64bca3b2-6ccc-4ca4-8394-17d3c7bdf871",
    "status" : 6,
    "error_reason" : null,
    "src_node" : {
      "bucket" : "api-auto-test",
      "cloud_type" : "TENCENT",
      "region" : "ap-beijing",
      "app_id" : "1254563210",
      "object_key" : [ "test" ],
      "list_file" : null
    },
    "description" : "",
    "dst_node" : {
      "bucket" : "test-l30022277",
      "region" : "cn-north-7",
      "save_prefix" : ""
    },
    "enable_metadata_migration" : false,
    "enable_failed_object_recording" : true,
    "enable_restore" : false,
    "task_type" : "PREFIX",
    "bandwidth_policy" : [ ],
    "smn_config" : null,
    "source_cdn" : null,
    "migrate_since" : 0,
    "migrate_speed" : 0,
    "total_time" : 553999,
    "start_time" : 1662725057215,
    "total_task_num" : null,
    "create_task_num" : null,
    "failed_task_num" : null,
    "complete_task_num" : null,
    "paused_task_num" : null,
    "executing_task_num" : null,
    "waiting_task_num" : null,
    "total_num" : 6,
    "create_complete_num" : null,
    "success_num" : 6,
    "fail_num" : 0,
    "skip_num" : 0,
    "total_size" : 2469022100,
    "create_complete_size" : null,
    "complete_size" : 2469022100,
    "failed_object_record" : {
      "result" : null,
      "list_file_key" : null,
      "error_code" : null
    },
    "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE",
    "consistency_check" : "size_last_modified",
    "enable_requester_pays" : false,
    "dst_storage_policy" : "STANDARD",
    "obs_system" : "BUCKET"
  }, {
    "group_id" : "4c019e94-9ac1-4cd6-b404-982816b20c2f",
    "status" : 6,
    "error_reason" : null,
    "src_node" : {
      "bucket" : "api-auto-hangzhou",
      "cloud_type" : "ALIYUN",
      "region" : "cn-hangzhou",
      "app_id" : "",
      "object_key" : [ "test" ],
      "list_file" : null
    },
    "description" : "",
    "dst_node" : {
      "bucket" : "test-l30022277",
      "region" : "cn-north-7",
      "save_prefix" : ""
    },
    "enable_metadata_migration" : false,
    "enable_failed_object_recording" : true,
    "enable_restore" : false,
    "task_type" : "PREFIX",
    "bandwidth_policy" : [ ],
    "smn_config" : null,
    "source_cdn" : null,
    "migrate_since" : 0,
    "migrate_speed" : 0,
    "total_time" : 33279,
    "start_time" : 1662723650469,
    "total_task_num" : null,
    "create_task_num" : null,
    "failed_task_num" : null,
    "complete_task_num" : null,
    "paused_task_num" : null,
    "executing_task_num" : null,
    "waiting_task_num" : null,
    "total_num" : 3,
    "create_complete_num" : null,
    "success_num" : 3,
    "fail_num" : 0,
    "skip_num" : 0,
    "total_size" : 31840,
    "create_complete_size" : null,
    "complete_size" : 31840,
    "failed_object_record" : {
      "result" : null,
      "list_file_key" : null,
      "error_code" : null
    },
    "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE",
    "consistency_check" : "size_last_modified",
    "enable_requester_pays" : false,
    "dst_storage_policy" : "STANDARD",
    "obs_system" : "BUCKET"
  }, {
    "group_id" : "5f5dd578-a3a6-4324-ad64-647a38ffb395",
    "status" : 6,
    "error_reason" : null,
    "src_node" : {
      "bucket" : "api-auto-test",
      "cloud_type" : "BAIDU",
      "region" : "bj",
      "app_id" : "",
      "object_key" : [ "test" ],
      "list_file" : null
    },
    "description" : "",
    "dst_node" : {
      "bucket" : "assess-bucket-1",
      "region" : "cn-north-7",
      "save_prefix" : ""
    },
    "enable_metadata_migration" : false,
    "enable_failed_object_recording" : true,
    "enable_restore" : false,
    "task_type" : "PREFIX",
    "bandwidth_policy" : [ ],
    "smn_config" : null,
    "source_cdn" : null,
    "migrate_since" : 0,
    "migrate_speed" : 0,
    "total_time" : 53427,
    "start_time" : 1662722500472,
    "total_task_num" : null,
    "create_task_num" : null,
    "failed_task_num" : null,
    "complete_task_num" : null,
    "paused_task_num" : null,
    "executing_task_num" : null,
    "waiting_task_num" : null,
    "total_num" : 15,
    "create_complete_num" : null,
    "success_num" : 15,
    "fail_num" : 0,
    "skip_num" : 0,
    "total_size" : 94864941,
    "create_complete_size" : null,
    "complete_size" : 94864941,
    "failed_object_record" : {
      "result" : null,
      "list_file_key" : null,
      "error_code" : null
    },
    "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE",
    "consistency_check" : "size_last_modified",
    "enable_requester_pays" : false,
    "dst_storage_policy" : "STANDARD",
    "obs_system" : "BUCKET"
  }, {
    "group_id" : "912e951b-ae19-4f65-bb94-c889601d8a43",
    "status" : 6,
    "error_reason" : null,
    "src_node" : {
      "bucket" : "assess-bucket-1",
      "cloud_type" : "HUAWEICLOUD",
      "region" : "cn-north-7",
      "app_id" : "",
      "object_key" : [ "" ],
      "list_file" : null
    },
    "description" : "",
    "dst_node" : {
      "bucket" : "oms-onebox-lqm",
      "region" : "cn-north-7",
      "save_prefix" : ""
    },
    "enable_metadata_migration" : false,
    "enable_failed_object_recording" : true,
    "enable_restore" : false,
    "task_type" : "PREFIX",
    "bandwidth_policy" : [ ],
    "smn_config" : null,
    "source_cdn" : null,
    "migrate_since" : 0,
    "migrate_speed" : 0,
    "total_time" : 590588,
    "start_time" : 1662640213374,
    "total_task_num" : null,
    "create_task_num" : null,
    "failed_task_num" : null,
    "complete_task_num" : null,
    "paused_task_num" : null,
    "executing_task_num" : null,
    "waiting_task_num" : null,
    "total_num" : 99052,
    "create_complete_num" : null,
    "success_num" : 99052,
    "fail_num" : 0,
    "skip_num" : 0,
    "total_size" : 1847919442,
    "create_complete_size" : null,
    "complete_size" : 1847919442,
    "failed_object_record" : {
      "result" : null,
      "list_file_key" : null,
      "error_code" : null
    },
    "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE",
    "consistency_check" : "size_last_modified",
    "enable_requester_pays" : false,
    "dst_storage_policy" : "STANDARD",
    "obs_system" : "BUCKET"
  }, {
    "group_id" : "398b5845-b180-47a1-a7c9-56f051ed3f34",
    "status" : 5,
    "error_reason" : null,
    "src_node" : {
      "bucket" : "hw-src",
      "cloud_type" : "HUAWEICLOUD",
      "region" : "cn-north-7",
      "app_id" : "",
      "object_key" : [ "gd.jpg" ],
      "list_file" : null
    },
    "description" : "",
    "dst_node" : {
      "bucket" : "zzww",
      "region" : "cn-north-7",
      "save_prefix" : ""
    },
    "enable_metadata_migration" : false,
    "enable_failed_object_recording" : true,
    "enable_restore" : false,
    "task_type" : "PREFIX",
    "bandwidth_policy" : [ ],
    "smn_config" : null,
    "source_cdn" : null,
    "migrate_since" : 0,
    "migrate_speed" : 0,
    "total_time" : 709891300,
    "start_time" : 1662369530210,
    "total_task_num" : null,
    "create_task_num" : null,
    "failed_task_num" : null,
    "complete_task_num" : null,
    "paused_task_num" : null,
    "executing_task_num" : null,
    "waiting_task_num" : null,
    "total_num" : 1,
    "create_complete_num" : null,
    "success_num" : 0,
    "fail_num" : 1,
    "skip_num" : 0,
    "total_size" : 3528,
    "create_complete_size" : null,
    "complete_size" : 0,
    "failed_object_record" : {
      "result" : true,
      "list_file_key" : "oms/task_group/398b5845-b180-47a1-a7c9-56f051ed3f34/failed_object_lists/",
      "error_code" : null
    },
    "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE",
    "consistency_check" : "size_last_modified",
    "enable_requester_pays" : false,
    "dst_storage_policy" : "STANDARD",
    "obs_system" : "BUCKET"
  }, {
    "group_id" : "494cad85-cbe5-4d62-8e70-e4f0e847e39c",
    "status" : 6,
    "error_reason" : null,
    "src_node" : {
      "bucket" : "test-l30022277-src",
      "cloud_type" : "HUAWEICLOUD",
      "region" : "cn-north-7",
      "app_id" : "",
      "object_key" : [ "test" ],
      "list_file" : null
    },
    "description" : "",
    "dst_node" : {
      "bucket" : "test-l30022277",
      "region" : "cn-north-7",
      "save_prefix" : ""
    },
    "enable_metadata_migration" : false,
    "enable_failed_object_recording" : true,
    "enable_restore" : false,
    "task_type" : "PREFIX",
    "bandwidth_policy" : [ ],
    "smn_config" : null,
    "source_cdn" : null,
    "migrate_since" : 0,
    "migrate_speed" : 0,
    "total_time" : 33513,
    "start_time" : 1661928705453,
    "total_task_num" : null,
    "create_task_num" : null,
    "failed_task_num" : null,
    "complete_task_num" : null,
    "paused_task_num" : null,
    "executing_task_num" : null,
    "waiting_task_num" : null,
    "total_num" : 2,
    "create_complete_num" : null,
    "success_num" : 0,
    "fail_num" : 0,
    "skip_num" : 2,
    "total_size" : 155,
    "create_complete_size" : null,
    "complete_size" : 155,
    "failed_object_record" : {
      "result" : null,
      "list_file_key" : null,
      "error_code" : null
    },
    "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE",
    "consistency_check" : "size_last_modified",
    "enable_requester_pays" : false,
    "dst_storage_policy" : "STANDARD",
    "obs_system" : "BUCKET"
  } ]
}
```
#### SDK代码示例
SDK代码示例如下。
- [Java]
  ```
  package com.huaweicloud.sdk.test;
  import com.huaweicloud.sdk.core.auth.ICredential;
  import com.huaweicloud.sdk.core.auth.BasicCredentials;
  import com.huaweicloud.sdk.core.exception.ConnectionException;
  import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
  import com.huaweicloud.sdk.core.exception.ServiceResponseException;
  import com.huaweicloud.sdk.oms.v2.region.OmsRegion;
  import com.huaweicloud.sdk.oms.v2.*;
  import com.huaweicloud.sdk.oms.v2.model.*;
  public class ListTaskGroupSolution {
      public static void main(String[] args) {
          // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
          // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
          String ak = System.getenv("CLOUD_SDK_AK");
          String sk = System.getenv("CLOUD_SDK_SK");
          String projectId = "{project_id}";
          ICredential auth = new BasicCredentials()
                  .withProjectId(projectId)
                  .withAk(ak)
                  .withSk(sk);
          OmsClient client = OmsClient.newBuilder()
                  .withCredential(auth)
                  .withRegion(OmsRegion.valueOf("<YOUR REGION>"))
                  .build();
          ListTaskGroupRequest request = new ListTaskGroupRequest();
          try {
              ListTaskGroupResponse response = client.listTaskGroup(request);
              System.out.println(response.toString());
          } catch (ConnectionException e) {
              e.printStackTrace();
          } catch (RequestTimeoutException e) {
              e.printStackTrace();
          } catch (ServiceResponseException e) {
              e.printStackTrace();
              System.out.println(e.getHttpStatusCode());
              System.out.println(e.getRequestId());
              System.out.println(e.getErrorCode());
              System.out.println(e.getErrorMsg());
          }
      }
  }
  ```
- [Python]
  ```
  # coding: utf-8
  import os
  from huaweicloudsdkcore.auth.credentials import BasicCredentials
  from huaweicloudsdkoms.v2.region.oms_region import OmsRegion
  from huaweicloudsdkcore.exceptions import exceptions
  from huaweicloudsdkoms.v2 import *
  if __name__ == "__main__":
      # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
      # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
      ak = os.environ["CLOUD_SDK_AK"]
      sk = os.environ["CLOUD_SDK_SK"]
      projectId = "{project_id}"
      credentials = BasicCredentials(ak, sk, projectId)
      client = OmsClient.new_builder() \
          .with_credentials(credentials) \
          .with_region(OmsRegion.value_of("<YOUR REGION>")) \
          .build()
      try:
          request = ListTaskGroupRequest()
          response = client.list_task_group(request)
          print(response)
      except exceptions.ClientRequestException as e:
          print(e.status_code)
          print(e.request_id)
          print(e.error_code)
          print(e.error_msg)
  ```
- [Go]
  ```
  package main
  import (
  "fmt"
  "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
      oms "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/oms/v2"
  "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/oms/v2/model"
      region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/oms/v2/region"
  )
  func main() {
      // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
      // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
      ak := os.Getenv("CLOUD_SDK_AK")
      sk := os.Getenv("CLOUD_SDK_SK")
      projectId := "{project_id}"
      auth, err := basic.NewCredentialsBuilder().
          WithAk(ak).
          WithSk(sk).
          WithProjectId(projectId).
          SafeBuild()
      if err != nil {
          fmt.Println(err)
          return
      }
      hcClient, err := oms.OmsClientBuilder().
           WithRegion(region.ValueOf("<YOUR REGION>")).
           WithCredential(auth).
           SafeBuild()
      if err != nil {
          fmt.Println(err)
          return
      }
      client := oms.NewOmsClient(hcClient)
      request := &model.ListTaskGroupRequest{}
  response, err := client.ListTaskGroup(request)
  if err == nil {
          fmt.Printf("%+v\n", response)
      } else {
          fmt.Println(err)
      }
  }
  ```
- [更多]
  更多编程语言的SDK代码示例，请参见[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/OMS/sdk?api=ListTaskGroup)的代码示例页签，可生成自动对应的SDK代码示例。
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 200 | Ok           |
| 400 | Bad Request  |
| 403 | Forbidden    |
| 500 | Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-oms/ErrorCode.html)。
