Iot Hub Resource - Create Event Hub Consumer Group

Usługa:: IoT Hub

Wersja interfejsu API:: 2026-11-01

Dodaj grupę odbiorców do punktu końcowego zgodnego z centrum zdarzeń w centrum IoT.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/eventHubEndpoints/{eventHubEndpointName}/ConsumerGroups/{name}?api-version=2026-11-01

Parametry identyfikatora URI

Nazwisko	W	Wymagane	Typ	Opis
eventHubEndpointName	path	True	string	Nazwa EventHubEndpoint
name	path	True	string	Nazwa grupy odbiorców do pobrania.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
resourceName	path	True	string	Nazwa centrum IoT.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwisko	Wymagane	Typ	Opis
properties	True	EventHubConsumerGroupName	Nazwa grupy odbiorców usługi EventHub.

Odpowiedzi

Nazwisko	Typ	Opis
200 OK	EventHubConsumerGroupInfo	Aktualizacja zasobu 'EventHubConsumerGroupInfo' zakończyła się sukcesem
Other Status Codes	ErrorDetails	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwisko	Opis
user_impersonation	podszywaj się pod konto użytkownika

Przykłady

IotHubResource_CreateEventHubConsumerGroup

Przykładowe żądanie

HTTP

PUT https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub/eventHubEndpoints/events/ConsumerGroups/test?api-version=2026-11-01

{
  "properties": {
    "name": "test"
  }
}

Przykładowa odpowiedź

Kod stanu:: 200

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

Definicje

Nazwisko	Opis
createdByType	Typ tożsamości, która utworzyła zasób.
ErrorDetails	Szczegóły błędu.
EventHubConsumerGroupBodyDescription	Grupa odbiorców usługi EventHub.
EventHubConsumerGroupInfo	Właściwości obiektu EventHubConsumerGroupInfo.
EventHubConsumerGroupName	Nazwa grupy odbiorców usługi EventHub.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

ErrorDetails

Objekt

Szczegóły błędu.

Nazwisko	Typ	Opis
code	string	Kod błędu.
details	string	Szczegóły błędu.
httpStatusCode	string	Kod statusu HTTP.
message	string	Komunikat o błędzie.

EventHubConsumerGroupBodyDescription

Objekt

Grupa odbiorców usługi EventHub.

Nazwisko	Typ	Opis
properties	EventHubConsumerGroupName	Nazwa grupy odbiorców usługi EventHub.

EventHubConsumerGroupInfo

Objekt

Właściwości obiektu EventHubConsumerGroupInfo.

Nazwisko	Typ	Opis
etag	string	Znacznik etag.
id	string (arm-id)	W pełni określony identyfikator zasobu dla tego zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nazwa zasobu
properties		Tagi.
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

EventHubConsumerGroupName

Objekt

Nazwa grupy odbiorców usługi EventHub.

Nazwisko	Typ	Opis
name	string	Nazwa grupy odbiorców usługi EventHub

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwisko	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.