Devices - Get Component Command History

서비스:: IoT Central

API 버전:: 2022-07-31

구성 요소 명령 기록 가져오기

GET https://{subdomain}.{baseDomain}/api/devices/{deviceId}/components/{componentName}/commands/{commandName}?api-version=2022-07-31

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
baseDomain	path	True	string	모든 Azure IoT Central 서비스 요청에 대한 기본 도메인입니다.
commandName	path	True	string	이 디바이스 명령의 이름입니다.
componentName	path	True	string	디바이스 구성 요소의 이름입니다.
deviceId	path	True	string	디바이스의 고유 ID입니다.
subdomain	path	True	string	애플리케이션 하위 도메인입니다.
api-version	query	True	string	호출되는 API의 버전입니다.

응답

Name	형식	Description
200 OK	DeviceCommandCollection	성공
Other Status Codes	Error	IoT Central 서비스에서 받은 오류 응답입니다. 헤더 x-ms-error-code: string

Name

형식

Description

200 OK

DeviceCommandCollection

성공

Other Status Codes

Error

IoT Central 서비스에서 받은 오류 응답입니다.

헤더

x-ms-error-code: string

보안

azure_auth

Azure Active Directory OAuth2 흐름

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

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Get command history

샘플 요청

HTTP

GET https://appsubdomain.azureiotcentral.com/api/devices/mx1/components/Thermostat_1o/commands/CoolDown?api-version=2022-07-31

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "request": 20,
      "id": "4e17dd2e-7bf2-458d-8466-19bc6fc9b642",
      "response": 58.795679629034694,
      "responseCode": 200
    }
  ]
}

정의

Name	Description
DeviceCommand	디바이스 명령 정의입니다.
DeviceCommandCollection	디바이스 명령 실행의 페이징된 결과입니다.
Error	응답 오류 정의입니다.
ErrorDetails	오류의 세부 정보입니다.

DeviceCommand

Object

디바이스 명령 정의입니다.

Name	형식	Description
connectionTimeout	integer (int32) minimum: 0 maximum: 30	연결이 끊긴 디바이스가 온라인 상태가 될 때까지 대기하는 연결 시간 제한(초)입니다. 기본값은 0초입니다.
id	string	디바이스 명령 실행의 요청 ID입니다.
request		디바이스 명령에 대한 페이로드는 모든 기본 형식 또는 개체를 지원합니다.
response		디바이스 명령 응답의 페이로드는 모든 기본 형식 또는 개체를 지원합니다.
responseCode	integer (int32)	디바이스 명령 응답의 상태 코드입니다.
responseTimeout	integer (int32) minimum: 5 maximum: 30	디바이스에서 명령이 완료될 때까지 대기하는 응답 시간 제한(초)입니다. 기본값은 30초입니다.

DeviceCommandCollection

Object

디바이스 명령 실행의 페이징된 결과입니다.

Name	형식	Description
nextLink	string	디바이스 명령 실행의 다음 페이지를 가져오는 URL입니다.
value	DeviceCommand[]	디바이스 명령 실행의 컬렉션입니다.

Error

Object

응답 오류 정의입니다.

Name	형식	Description
error	ErrorDetails	현재 요청에 대한 오류 세부 정보입니다.

ErrorDetails

Object

오류의 세부 정보입니다.

Name	형식	Description
code	string	오류 코드입니다.
message	string	오류 메시지 세부 정보입니다.
requestId	string	현재 요청에 대한 상관 관계 ID입니다.
time	string (date-time-rfc1123)	오류 요청이 실패한 시간입니다.