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

Iot Hub Resource - List Event Hub Consumer Groups

获取 IoT 中心的事件中心兼容设备到云终结点中的使用者组列表。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/eventHubEndpoints/{eventHubEndpointName}/ConsumerGroups?api-version=2023-06-30

URI 参数

名称 必需 类型 说明
eventHubEndpointName
path True

string

与事件中心兼容的终结点的名称。

resourceGroupName
path True

string

包含 IoT 中心的资源组的名称。

resourceName
path True

string

IoT 中心的名称。

subscriptionId
path True

string

订阅标识符。

api-version
query True

string

API 的版本。

响应

名称 类型 说明
200 OK

EventHubConsumerGroupsListResult

这是一个同步操作。 正文包含此 IoT 中心的事件中心兼容终结点中的使用者组的 JSON 序列化列表

Other Status Codes

ErrorDetails

DefaultErrorResponse

安全性

azure_auth

Azure Active Directory OAuth2 流

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名称 说明
user_impersonation 模拟用户帐户

示例

IotHubResource_ListEventHubConsumerGroups

Sample Request

GET https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub/eventHubEndpoints/events/ConsumerGroups?api-version=2023-06-30

Sample Response

{
  "value": [
    {
      "properties": {
        "created": "Thu, 15 Jun 2017 19:20:58 GMT"
      },
      "id": "/subscriptions/cmd-sub-1/resourceGroups/cmd-rg-1/providers/Microsoft.Devices/IotHubs/test-hub-2/eventHubEndpoints/events/ConsumerGroups/%24Default",
      "name": "$Default",
      "type": "Microsoft.Devices/IotHubs/EventHubEndpoints/ConsumerGroups",
      "etag": "AAAAAAFD6M4="
    }
  ]
}

定义

名称 说明
ErrorDetails

错误详细信息。

EventHubConsumerGroupInfo

EventHubConsumerGroupInfo 对象的属性。

EventHubConsumerGroupsListResult

包含下一个链接的事件中心兼容使用者组名称的 JSON 序列化数组。

ErrorDetails

错误详细信息。

名称 类型 说明
code

string

错误代码。

details

string

错误详细信息。

httpStatusCode

string

HTTP 状态代码。

message

string

错误消息。

EventHubConsumerGroupInfo

EventHubConsumerGroupInfo 对象的属性。

名称 类型 说明
etag

string

etag。

id

string

事件中心兼容的使用者组标识符。

name

string

事件中心兼容的使用者组名称。

properties

标记。

type

string

资源类型。

EventHubConsumerGroupsListResult

包含下一个链接的事件中心兼容使用者组名称的 JSON 序列化数组。

名称 类型 说明
nextLink

string

下一个链接。

value

EventHubConsumerGroupInfo[]

使用者组对象列表