通道:unarchive
命名空间:microsoft.graph
重要
Microsoft Graph /beta
版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
还原存档 的通道。 取消存档可还原用户发送消息和编辑通道的功能。 通道通过存档 API 进行存档 。
取消存档是一种异步操作;异步非存档操作成功完成时,通道是未存档的,此方法响应后可能会发生这种情况。
注意:属于已存档团队的存档频道不能取消存档。 在取消存档频道之前取消存档团队;否则,将发生错误。
此 API 可用于以下国家级云部署。
全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
权限类型 | 最低特权权限 | 更高特权权限 |
---|---|---|
委派(工作或学校帐户) | ChannelSettings.ReadWrite.All | 不可用。 |
委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
应用程序 | ChannelSettings.ReadWrite.All | 不可用。 |
注意:此 API 支持管理员权限。 全局管理员和 Microsoft Teams 服务管理员可以访问自己不是其中成员的团队。
HTTP 请求
POST /teams/{team-id}/channels/{channel-id}/unarchive
POST /groups/{team-id}/team/channels/{channel-id}/unarchive
请求标头
标头 | 值 |
---|---|
Authorization | 持有者 {token}。 必填。 |
请求正文
请勿提供此方法的请求正文。
响应
如果成功启动取消存档,此方法将 202 Accepted
返回响应代码。 响应包含一个 Location
标头,其中包含为处理团队通道的取消存档而创建的 teamsAsyncOperation 的位置。 通过对此位置发出 GET 请求来检查取消存档操作的状态。
示例
示例 1:取消存档通道
以下示例显示了取消存档通道的请求。
请求
POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/unarchive
响应
以下示例显示了相应的响应。
HTTP/1.1 202 Accepted
Location: /teams/{team-id}/operations/{operation-id}
Content-Type: text/plain
Content-Length: 0
示例 2:存档团队时取消存档频道
以下示例显示了在已存档团队中取消存档频道的请求。
请求
POST https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}/unarchive
响应
以下示例显示了 400
错误响应。
http/1.1 400 Bad Request
Content-Type: application/json
Content-Length: 193
{
"error": {
"code": "BadRequest",
"message": "Team has to be active, for channel to be archived or unarchived: {channel-id}",
"innerError": {
"message": "Team has to be active, for channel to be archived or unarchived: {channel-id}",
"code": "Unknown",
"innerError": {},
"date": "2023-12-11T04:26:35",
"request-id": "8f897345980-f6f3-49dd-83a8-a3064eeecdf8",
"client-request-id": "50a0er33-4567-3f6c-01bf-04d144fc8bbe"
}
}
}
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈