이 패키지에는 Azure Data Protection 클라이언트에 대한 동형 SDK(Node.js 및 브라우저 모두에서 실행됨)가 포함되어 있습니다.
Azure Data Protection 서비스에 대한 API 2.0 사양 열기
키 링크:
- 소스 코드
- NPM(패키지)
- API 참조 설명서
- 견본
시작
현재 지원되는 환경
- Node.js의 LTS 버전
- Safari, Chrome, Edge 및 Firefox의 최신 버전입니다.
자세한 내용은 지원 정책을 참조하세요.
필수 구성 요소
@azure/arm-dataprotection 패키지 설치
다음을 사용하여 npmJavaScript용 Azure Data Protection 클라이언트 라이브러리를 설치합니다.
npm install @azure/arm-dataprotection
생성 및 인증 DataProtectionClient
Azure Data Protection API에 액세스하기 위한 클라이언트 개체를 만들려면 Azure Data Protection 리소스endpoint의 와 credential . Azure Data Protection 클라이언트는 Azure Active Directory 자격 증명을 사용하여 인증할 수 있습니다.
Azure Portal에서 Azure Data Protection 리소스에 대한 엔드포인트를 찾을 수 있습니다.
@azure/ID 라이브러리 또는 기존 AAD 토큰의 자격 증명을 사용하여 Azure Active Directory로 인증할 수 있습니다.
아래에 표시된 DefaultAzureCredential 공급자 또는 Azure SDK와 함께 제공되는 다른 자격 증명 공급자를 사용하려면 패키지를 @azure/identity 설치하세요.
npm install @azure/identity
또한 새 AAD 애플리케이션을 등록하고 서비스 주체에 적절한 역할을 할당하여 Azure Data Protection에 대한 액세스 권한을 부여 해야 합니다(참고: 다음과 "Owner" 같은 역할은 필요한 권한을 부여하지 않음).
Azure AD 애플리케이션을 만드는 방법에 대한 자세한 내용은 이 가이드를 확인하세요.
Node.js 및 Node와 유사한 환경을 사용하여 클래스를 DefaultAzureCredential 사용하여 클라이언트를 인증할 수 있습니다.
import { DataProtectionClient } from "@azure/arm-dataprotection";
import { DefaultAzureCredential } from "@azure/identity";
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new DataProtectionClient(new DefaultAzureCredential(), subscriptionId);
브라우저 환경의 경우 패키지에서 InteractiveBrowserCredential 인증을 @azure/identity 사용합니다.
import { InteractiveBrowserCredential } from "@azure/identity";
import { DataProtectionClient } from "@azure/arm-dataprotection";
const credential = new InteractiveBrowserCredential({
tenantId: "<YOUR_TENANT_ID>",
clientId: "<YOUR_CLIENT_ID>",
});
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new DataProtectionClient(credential, subscriptionId);
JavaScript 번들
브라우저에서 이 클라이언트 라이브러리를 사용하려면 먼저 번들러를 사용해야 합니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 번들링 문서를 참조하십시오.
주요 개념
DataProtectionClient
DataProtectionClient Azure Data Protection 클라이언트 라이브러리를 사용하는 개발자를 위한 기본 인터페이스입니다. 이 클라이언트 개체의 메서드를 탐색하여 액세스할 수 있는 Azure Data Protection 서비스의 다양한 기능을 이해합니다.
문제 해결
로깅
로깅을 사용하도록 설정하면 오류에 대한 유용한 정보를 파악하는 데 도움이 될 수 있습니다. HTTP 요청 및 응답의 로그를 보려면 환경 변수AZURE_LOG_LEVEL를 info 로 설정합니다. 또는 런타임에 다음을 호출 setLogLevel@azure/logger하여 로깅을 활성화할 수 있습니다.
import { setLogLevel } from "@azure/logger";
setLogLevel("info");
로그를 활성화하는 방법에 대한 자세한 지침은 @azure/logger 패키지 문서를 참조하세요.
다음 단계
이 라이브러리를 사용하는 방법에 대한 자세한 예제는 샘플 디렉토리를 살펴보십시오.
기여
이 라이브러리에 기여하려면 기여 가이드 읽어 코드를 빌드하고 테스트하는 방법에 대해 자세히 알아보세요.
관련 프로젝트
- JavaScript용 Microsoft Azure SDK
Azure SDK for JavaScript