destroy_group
产品支持情况
产品  | 
是否支持  | 
|---|---|
√  | 
|
√  | 
|
x  | 
|
x  | 
|
√  | 
|
√  | 
|
x  | 
 针对
功能说明
销毁集合通信用户自定义group。
函数原型
1 | def destroy_group(group)  | 
参数说明
参数名  | 
输入/输出  | 
描述  | 
|---|---|---|
group  | 
输入  | 
String类型,最大长度为128字节,含结束符。 group名称,集合通信group的标识。  | 
返回值
无。
约束说明
- 必须在集合通信初始化完成之后调用。
 - 调用该接口的rank必须在当前接口入参group定义的范围内,不在此范围内的rank调用该接口会失败。
 - 相同名称的group,destroy_group和create_group配套使用,必须在create_group完成之后调用。
 - 如果用户传入的group恰好是hccl_world_group(默认group),销毁group失败。
 
调用示例
以下仅为代码片段,不可执行,调用HCCL Python接口进行集合通信操作的完整示例可参见样例代码。
1 2 3 4  | from hccl.manage.api import create_group from hccl.manage.api import destroy_group create_group("myGroup", 4, [0, 1, 2, 3]) destroy_group("myGroup")  | 
父主题: hccl.manage.api