# 修改对讲分组

## 接口描述

修改对讲分组的名称。

> 分组标识（tag）创建后不可修改：tag 是分组级 SIP 域名的组成部分，修改 tag 等于全组域名变更，因此本接口只允许修改名称。

## 请求说明
| 接口ID | 协议 | 方法 | PATH |
| --- | --- | --- | --- |
| 98 | HTTPS | PUT | /openapi/v1/voip/groups/:id |

### PATH参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| id | int | 是 | 需要修改的分组ID，可通过[遍历对讲分组](/voip/遍历对讲分组.md)获取 |

### URL参数
| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| accesskey_id | string | 是 | 参见[签名认证](/签名认证.md) |
| expires | int | 是 | 参见[签名认证](/签名认证.md) |
| signature | string | 是 | 参见[签名认证](/签名认证.md) |

### HTTP请求头
| 名称 | 必填 | 说明 |
| --- | --- | --- |
| Content-Type | 是 | `application/json` |

### 请求参数

请求参数以Json格式放置于Body中，如下：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| name | string | 否 | 分组名称，长度 1-64 字符；Body 中不含 name 时不做任何修改，直接返回成功 |

### 请求示例

```
PUT https://open.vzicloud.com/openapi/v1/voip/groups/12?accesskey_id=8d9EsDAD2115Q5PM8tuP6g1IdAglkayp&expires=1619022787&signature=G29eTBjMm0gZF7cpXNLX7Hrn0yM%3D HTTP/1.1
Host: open.vzicloud.com
Content-Type: application/json

{ "name": "小区A一期" }
```

## 返回说明

成功，则响应的HTTP状态码为200  
失败，则响应的HTTP状态码为非200，具体参考[错误码](/错误码.md)