다음을 통해 공유


Iot Hub Resource - List Event Hub Consumer Groups

IoT Hub의 Event Hub 호환 디바이스-클라우드 엔드포인트에서 소비자 그룹 목록을 가져옵니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
eventHubEndpointName
path True

string

Event Hub 호환 엔드포인트의 이름입니다.

resourceGroupName
path True

string

IoT Hub를 포함하는 리소스 그룹의 이름입니다.

resourceName
path True

string

IoT Hub의 이름입니다.

subscriptionId
path True

string

구독 식별자입니다.

api-version
query True

string

API 버전입니다.

응답

Name 형식 Description
200 OK

EventHubConsumerGroupsListResult

동기 작업입니다. 본문에는 이 IoT Hub의 Event Hub 호환 엔드포인트에 있는 소비자 그룹의 JSON 직렬화된 목록이 포함됩니다.

Other Status Codes

ErrorDetails

DefaultErrorResponse

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

IotHubResource_ListEventHubConsumerGroups

샘플 요청

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

샘플 응답

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

정의

Name Description
ErrorDetails

오류 세부 정보입니다.

EventHubConsumerGroupInfo

EventHubConsumerGroupInfo 개체의 속성입니다.

EventHubConsumerGroupsListResult

다음 링크가 있는 Event Hub 호환 소비자 그룹 이름의 JSON 직렬화된 배열입니다.

ErrorDetails

오류 세부 정보입니다.

Name 형식 Description
code

string

오류 코드입니다.

details

string

오류 세부 정보입니다.

httpStatusCode

string

HTTP 상태 코드입니다.

message

string

오류 메시지입니다.

EventHubConsumerGroupInfo

EventHubConsumerGroupInfo 개체의 속성입니다.

Name 형식 Description
etag

string

etag입니다.

id

string

Event Hub 호환 소비자 그룹 식별자입니다.

name

string

Event Hub 호환 소비자 그룹 이름입니다.

properties

태그입니다.

type

string

리소스 종류입니다.

EventHubConsumerGroupsListResult

다음 링크가 있는 Event Hub 호환 소비자 그룹 이름의 JSON 직렬화된 배열입니다.

Name 형식 Description
nextLink

string

다음 링크입니다.

value

EventHubConsumerGroupInfo[]

소비자 그룹 개체 목록