Azure FileShares 클라이언트 라이브러리 for JavaScript - 버전 1.0.0-beta.1

이 패키지에는 FileShares 클라이언트용 동형 SDK가 포함되어 있으며(Node.js와 브라우저 모두에서 실행Azure 있습니다.

Azure File Shares Resource Provider API.

키 링크:

시작하기

현재 지원되는 환경

자세한 내용은 저희 support 정책을 참조하세요.

사전 요구 사항

@azure/arm-fileshares 패키지 설치

npm로 JavaScript용 Azure FileShares 클라이언트 라이브러리를 설치하세요:

npm install @azure/arm-fileshares

FileSharesClient를 만들고 인증하기

Azure FileSharing API에 접근하기 위해 클라이언트 객체를 생성하려면 Azure FileShares 리소스의 endpoint와 credential가 필요합니다. Azure FileShares 클라이언트는 Azure Active Directory 자격 증명을 사용해 인증할 수 있습니다. Azure FileShares 리소스의 엔드포인트는 Azure Portal에서 찾을 수 있습니다.

@azure/identity 라이브러리의 자격 증명이나 기존 AAD 토큰을 사용해 Azure Active Directory으로 인증할 수 있습니다.

아래에 표시된 DefaultAzureCredential 제공자 또는 Azure SDK에 포함된 다른 자격 증명 제공자를 사용하려면 @azure/identity 패키지를 설치해 주세요:

npm install @azure/identity

또한 새 AAD 애플리케이션을 등록하고 적절한 역할을 서비스 주체에게 할당하여 FileShares Azure 접근 권한을 부여해야 합니다(참고: "Owner" 같은 역할은 필요한 권한을 부여하지 않습니다).

Azure AD 애플리케이션 만드는 방법에 대한 자세한 내용은 this guide를 참고하세요.

Node.js 및 노드와 유사한 환경을 사용하여 DefaultAzureCredential 클래스를 사용하여 클라이언트를 인증할 수 있습니다.

import { FileSharesClient } from "@azure/arm-fileshares";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new FileSharesClient(new DefaultAzureCredential(), subscriptionId);

브라우저 환경에서는 InteractiveBrowserCredential 패키지의 @azure/identity를 사용해 인증하세요.

import { InteractiveBrowserCredential } from "@azure/identity";
import { FileSharesClient } from "@azure/arm-fileshares";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new FileSharesClient(credential, subscriptionId);

JavaScript 번들

브라우저에서 이 클라이언트 라이브러리를 사용하려면 먼저 번들러를 사용해야 합니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 번들링 설명서를 참조하세요.

주요 개념

FileShares클라이언트

FileSharesClient는 Azure FileShares 클라이언트 라이브러리를 사용하는 개발자들의 주요 인터페이스입니다. 이 클라이언트 객체의 메서드를 탐색하여 Azure FileShares 서비스의 다양한 기능을 이해해 보세요.

예시

파일 공유 받기

import { FileSharesClient } from "@azure/arm-fileshares";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new FileSharesClient(new DefaultAzureCredential(), subscriptionId);
const result = await client.fileShares.get("myResourceGroup", "myFileShare");
console.log(result);

구독별 목록 파일 공유

import { FileSharesClient } from "@azure/arm-fileshares";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new FileSharesClient(new DefaultAzureCredential(), subscriptionId);
const shares = [];
for await (const item of client.fileShares.listBySubscription()) {
  shares.push(item);
}
console.log(shares);

파일 공유 생성 또는 업데이트

import { FileSharesClient } from "@azure/arm-fileshares";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new FileSharesClient(new DefaultAzureCredential(), subscriptionId);
const result = await client.fileShares.createOrUpdate("myResourceGroup", "myFileShare", {
  properties: {
    mountName: "myfileshare",
    mediaTier: "SSD",
    redundancy: "Local",
    protocol: "NFS",
    provisionedStorageGiB: 8,
  },
  location: "westus",
});
console.log(result);

Troubleshooting

Logging

로깅을 사용하도록 설정하면 오류에 대한 유용한 정보를 파악하는 데 도움이 될 수 있습니다. HTTP 요청 및 응답 로그를 보려면 환경 변수AZURE_LOG_LEVEL를 info .로 설정합니다. 또는 setLogLevel@azure/logger 호출하여 런타임에 로깅을 사용하도록 설정할 수 있습니다.

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

로그를 사용하도록 설정하는 방법에 대한 자세한 지침은 @azure/로거 패키지 문서를 참조하세요.

다음 단계

이 라이브러리 사용 방법에 대한 자세한 예시는 samples 디렉토리를 참고해 주세요.

Contributing

이 라이브러리에 기여하려면 기여 가이드 를 참조하여 코드를 빌드하고 테스트하는 방법에 대해 자세히 알아보세요.

  • JavaScript용 Microsoft Azure SDK
  • Last updated on