你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

DeviceManagementClient.DeleteGroup(String, RequestContext) 方法

定义

命名空间:

Azure.IoT.DeviceUpdate

程序集:

Azure.IoT.DeviceUpdate.dll

包:

Azure.IoT.DeviceUpdate v1.0.0

Source:

DeviceManagementClient.cs

删除设备组。 当启用了设备更新的设备连接到中心并报告其属性时，将自动创建此组。 组、子组和部署不会自动清理，但出于历史记录目的而保留。 如果用户不需要保留组的任何历史记录，并且不再需要该组，则可以调用此方法来删除组。 如果在删除组后再次为此组连接设备，将自动重新创建该设备，但没有历史记录。

public virtual Azure.Response DeleteGroup (string groupId, Azure.RequestContext context = default);

abstract member DeleteGroup : string * Azure.RequestContext -> Azure.Response
override this.DeleteGroup : string * Azure.RequestContext -> Azure.Response

Public Overridable Function DeleteGroup (groupId As String, Optional context As RequestContext = Nothing) As Response

参数

groupId

String

组标识符。

context

RequestContext

请求上下文，它可以基于每个调用替代客户端管道的默认行为。

返回

Response

从服务返回的响应。

例外

ArgumentNullException

groupId 为 null。

ArgumentException

groupId 是一个空字符串，预期为非空。

RequestFailedException

服务返回了不成功状态代码。

示例

此示例演示如何使用所需参数调用 DeleteGroup。

var credential = new DefaultAzureCredential();
var endpoint = new Uri("<https://my-service.azure.com>");
var client = new DeviceManagementClient(endpoint, "<instanceId>", credential);

Response response = client.DeleteGroup("<groupId>");
Console.WriteLine(response.Status);

注解

的 Response Error架构：

{
              error: {
                code: string,
                message: string,
                target: string,
                details: [Error],
                innererror: {
                  code: string,
                  message: string,
                  errorDetail: string,
                  innerError: InnerError
                },
                occurredDateTime: string (ISO 8601 Format)
              }
            }