Partilhar via


Iot Hub Resource - List Event Hub Consumer Groups

Obtenha uma lista dos grupos de consumidores no ponto final de dispositivo para cloud compatível com o Hub de Eventos num hub IoT.

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

Parâmetros do URI

Name Em Necessário Tipo Description
eventHubEndpointName
path True

string

O nome do ponto final compatível com o Hub de Eventos.

resourceGroupName
path True

string

O nome do grupo de recursos que contém o hub IoT.

resourceName
path True

string

O nome do hub IoT.

subscriptionId
path True

string

O identificador da subscrição.

api-version
query True

string

A versão da API.

Respostas

Name Tipo Description
200 OK

EventHubConsumerGroupsListResult

Esta é uma operação síncrona. O corpo contém uma lista serializada JSON dos grupos de consumidores no ponto final compatível com o Hub de Eventos neste hub IoT

Other Status Codes

ErrorDetails

DefaultErrorResponse

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

IotHubResource_ListEventHubConsumerGroups

Pedido de amostra

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

Resposta da amostra

{
  "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="
    }
  ]
}

Definições

Name Description
ErrorDetails

Detalhes do erro.

EventHubConsumerGroupInfo

As propriedades do objeto EventHubConsumerGroupInfo.

EventHubConsumerGroupsListResult

A matriz serializada JSON de nomes de grupos de consumidores compatíveis com o Hub de Eventos com uma ligação seguinte.

ErrorDetails

Detalhes do erro.

Name Tipo Description
code

string

O código de erro.

details

string

Os detalhes do erro.

httpStatusCode

string

O código de estado HTTP.

message

string

A mensagem de erro.

EventHubConsumerGroupInfo

As propriedades do objeto EventHubConsumerGroupInfo.

Name Tipo Description
etag

string

O etag.

id

string

O identificador do grupo de consumidores compatível com o Hub de Eventos.

name

string

O nome do grupo de consumidores compatível com o Hub de Eventos.

properties

As etiquetas.

type

string

o tipo de recurso.

EventHubConsumerGroupsListResult

A matriz serializada JSON de nomes de grupos de consumidores compatíveis com o Hub de Eventos com uma ligação seguinte.

Name Tipo Description
nextLink

string

A ligação seguinte.

value

EventHubConsumerGroupInfo[]

Lista de objetos de grupos de consumidores