이 패키지는 DeviceUpdate 클라이언트용 동형형(Node.js 및 브라우저 모두에서 실행됨)Azure 포함되어 있습니다.
IoT Hub용 디바이스 업데이트는 고객이 IoT 기기의 업데이트를 클라우드에 게시하고, 그 업데이트를 자신의 기기에 배포할 수 있게 해주는 Azure Hub 서비스입니다(IoT Hub에서 관리 및 프로비저닝된 장치 그룹에 대한 업데이트를 승인할 수 있습니다). IoT 기기에 최적화된 Windows 업데이트 플랫폼의 입증된 보안성과 신뢰성을 활용합니다. 전 세계적으로 작동하며 언제 어떻게 기기를 업데이트할지 알기에 고객이 비즈니스 목표에 집중하고 Device Update for IoT Hub가 업데이트를 처리하도록 합니다.
키 링크:
시작하기
현재 지원되는 환경
- Node.js의 LTS 버전
- Safari, Chrome, Edge 및 Firefox의 최신 버전입니다.
자세한 내용은 지원 정책 참조하세요.
필수 조건
@azure/iot-device-update 패키지 설치
JavaScript용 npmAzure DeviceUpdate 클라이언트 라이브러리를 설치하세요:
npm install @azure/iot-device-update
DeviceUpdateClient를 만들고 인증하기
Azure DeviceUpdate API에 접근하기 위한 클라이언트 객체를 생성하려면, Azure DeviceUpdate 리소스의 credential와 endpoint . Azure DeviceUpdate 클라이언트는 Azure Active Directory 자격 증명을 사용해 인증할 수 있습니다.
Azure DeviceUpdate 리소스의 엔드포인트는 Azure Portal에서 찾을 수 있습니다.
아래에 표시된 DefaultAzureCredential 공급자 또는 Azure SDK와 함께 제공되는 다른 자격 증명 공급자를 사용하려면 @azure/identity 패키지를 설치하세요.
npm install @azure/identity
또한 새로운 AAD 애플리케이션을 등록하고, 서비스 주체에게 적절한 역할을 할당하여 Azure DeviceUpdate 접근 권한을 부여해야 합니다(참고: 와 "Owner" 같은 역할은 필요한 권한을 부여하지 않습니다).
Azure AD 애플리케이션을 만드는 방법에 대한 자세한 내용은 이 가이드
Node.js 및 노드와 유사한 환경을 사용하여 DefaultAzureCredential 클래스를 사용하여 클라이언트를 인증할 수 있습니다.
import { DeviceUpdateClient } from "@azure/iot-device-update";
import { DefaultAzureCredential } from "@azure/identity";
const client = new DeviceUpdateClient("<endpoint>", new DefaultAzureCredential(), "<instanceId>");
브라우저 환경의 경우 InteractiveBrowserCredential 패키지의 @azure/identity 사용하여 인증합니다.
import { InteractiveBrowserCredential } from "@azure/identity";
import { DeviceUpdateClient } from "@azure/iot-device-update";
const credential = new InteractiveBrowserCredential({
tenantId: "<YOUR_TENANT_ID>",
clientId: "<YOUR_CLIENT_ID>",
});
const client = new DeviceUpdateClient("<endpoint>", credential, "<instanceId>");
JavaScript 번들
브라우저에서 이 클라이언트 라이브러리를 사용하려면 먼저 번들러를 사용해야 합니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 번들링 설명서참조하세요.
주요 개념
DeviceUpdateClient
DeviceUpdateClientAzure DeviceUpdate 클라이언트 라이브러리를 사용하는 개발자들의 주요 인터페이스입니다. 이 클라이언트 객체의 메서드를 탐색하여 접근할 수 있는 Azure DeviceUpdate 서비스의 다양한 기능을 이해해 보세요.
Troubleshooting
로깅 (로그 기록)
로깅을 사용하도록 설정하면 오류에 대한 유용한 정보를 파악하는 데 도움이 될 수 있습니다. HTTP 요청 및 응답 로그를 보려면 AZURE_LOG_LEVEL 환경 변수를 info설정합니다. 또는 setLogLevel@azure/logger 호출하여 런타임에 로깅을 사용하도록 설정할 수 있습니다.
import { setLogLevel } from "@azure/logger";
setLogLevel("info");
로그를 사용하도록 설정하는 방법에 대한 자세한 지침은 @azure/로거 패키지 문서를 참조하세요.
Contributing
이 라이브러리에 기여하려면 기여 가이드 읽어 코드를 빌드하고 테스트하는 방법에 대해 자세히 알아보세요.
관련 프로젝트
Azure SDK for JavaScript