.NET을 사용하여 Blob 임대 만들기 및 관리

이 문서에서는 .NET용 Azure Storage 클라이언트 라이브러리를 사용하여 Blob 임대를 만들고 관리하는 방법을 보여 줍니다. 클라이언트 라이브러리를 사용하여 Blob 임대를 획득, 갱신, 해제 및 중단할 수 있습니다.

필수 조건

• Azure 구독 - 체험 구독 만들기
• Azure Storage 계정 - 스토리지 계정 만들기
• 운영 체제에 맞는 최신 .NET SDK. 런타임이 아니라 SDK가 있어야 합니다.

환경 설정

기존 프로젝트가 없는 경우, 이 섹션에서는 .NET용 Azure Blob Storage 클라이언트 라이브러리를 사용해서 작동하도록 프로젝트를 설정하는 방법을 보여 줍니다. 이 단계에는 패키지 설치, using 지시문 추가 및 권한이 있는 클라이언트 개체 만들기가 포함됩니다. 자세한 내용은 Azure Blob Storage 및 .NET 시작을 참조하세요.

패키지 설치

프로젝트 디렉터리에서 dotnet add package 명령을 사용하여 Azure Blob Storage 및 Azure ID 클라이언트 라이브러리용 패키지를 설치합니다. Azure 서비스에 암호 없이 연결하려면 Azure.Identity 패키지가 필요합니다.

dotnet add package Azure.Storage.Blobs
dotnet add package Azure.Identity

using 지시문 추가

코드 파일 맨 위에 다음과 같이 using 지시문을 추가합니다.

using Azure.Identity;
using Azure.Storage.Blobs;
using Azure.Storage.Blobs.Models;
using Azure.Storage.Blobs.Specialized;

이 게시물의 일부 코드 예제에는 using 지시문이 추가로 필요할 수 있습니다.

클라이언트 개체 만들기

Blob Storage에 앱을 연결하려면 BlobServiceClient의 인스턴스를 만듭니다. 다음 예에서는 권한 부여를 위해 DefaultAzureCredential을 사용하여 클라이언트 개체를 만드는 방법을 설명합니다.

public BlobServiceClient GetBlobServiceClient(string accountName)
{
    BlobServiceClient client = new(
        new Uri($"https://{accountName}.blob.core.windows.net"),
        new DefaultAzureCredential());

    return client;
}

.NET 앱에서 종속성 주입을 위한 서비스 클라이언트를 등록할 수 있습니다.

특정 컨테이너 또는 Blob을 위한 클라이언트 개체도 만들 수 있습니다. 클라이언트 개체 만들기 및 관리에 대한 자세한 내용은 데이터 리소스와 상호 작용하는 클라이언트 개체 만들기 및 관리를 참조하세요.

권한 부여

권한 부여 메커니즘에는 Blob 임대 작업을 수행하는 데 필요한 권한이 있어야 합니다. Microsoft Entra ID로 권한을 부여하려면(권장) Azure RBAC 기본 제공 역할 Storage Blob 데이터 기여자 이상이 필요합니다. 자세한 내용은 Blob 임대(REST API)에 대한 권한 부여 지침을 참조하세요.

Blob 임대 정보

임대는 쓰기 및 삭제 작업을 위해 blob에 대한 잠금을 만들고 관리합니다. 잠금 기간은 15~60초 또는 무한할 수 있습니다. Blob을 임대하면 해당 Blob에 대한 배타적인 쓰기 및 삭제 액세스 권한이 제공됩니다. 활성 임대 상태로 Blob에 쓰기를 수행하려면 클라이언트의 쓰기 요청에 활성 임대 ID가 포함되어야 합니다.

임대 상태와 임대에 대해 지정된 작업을 수행할 수 있는 경우에 대해 자세히 알아보려면 임대 상태 및 작업을 참조하세요.

컨테이너 삭제를 포함하는 모든 컨테이너 작업은 임대가 활성화된 Blob을 포함하는 컨테이너에서 허용됩니다. 따라서 컨테이너 내의 blob에 활성 임대가 포함되어 있더라도 컨테이너를 삭제할 수 있습니다. 컨테이너 삭제 권한을 제어하려면 컨테이너 임대 작업을 사용하세요.

임대 작업은 BlobLeaseClient 클래스에 의해 처리되는데, 이것은 Blob 및 컨테이너에 대한 모든 임대 작업을 포함하는 클라이언트를 제공합니다. 클라이언트 라이브러리를 사용하는 컨테이너 임대에 대한 자세한 내용은 .NET을 사용하여 컨테이너 임대 만들기 및 관리를 참조하세요.

임대 취득

Blob 임대를 획득하면 코드가 Blob에서 작동하는 데 사용할 수 있는 임대 ID를 얻습니다. Blob에 이미 활성 임대가 있는 경우 활성 임대 ID를 사용하여 새 임대만 요청할 수 있습니다. 그러나 새 임대 기간을 지정할 수 있습니다.

임대를 획득하려면 BlobLeaseClient 클래스의 인스턴스를 만든 후, 다음 메서드 중 하나를 사용합니다.

• 획득
• AcquireAsync

다음 예제에서는 Blob에 대한 30초 임대를 획득합니다.

public static async Task<BlobLeaseClient> AcquireBlobLeaseAsync(
    BlobClient blobClient)
{
    // Get a BlobLeaseClient object to work with a blob lease
    BlobLeaseClient leaseClient = blobClient.GetBlobLeaseClient();

    Response<BlobLease> response = 
        await leaseClient.AcquireAsync(duration: TimeSpan.FromSeconds(30));

    // Use response.Value to get information about the blob lease

    return leaseClient;
}

임대 갱신

요청에 지정된 임대 ID가 Blob과 연결된 임대 ID와 일치하는 경우 Blob 임대를 갱신할 수 있습니다. 임대가 만료되었더라도 Blob이 수정되지 않았거나 임대 만료 후 다시 임대되지 않았다면 임대를 갱신할 수 있습니다. 임대를 갱신하면 임대 기간이 재설정됩니다.

임대를 갱신하려면 BlobLeaseClient 인스턴스에 다음 메서드 중 하나를 사용합니다.

• 갱신
• RenewAsync

다음 예제에서는 Blob에 대한 임대를 갱신합니다.

public static async Task RenewBlobLeaseAsync(
    BlobClient blobClient,
    string leaseID)
{
    // Get a BlobLeaseClient object to work with a blob lease
    BlobLeaseClient leaseClient = blobClient.GetBlobLeaseClient(leaseID);

    await leaseClient.RenewAsync();
}

임대 해제

요청에 지정된 임대 ID가 Blob과 연결된 임대 ID와 일치하는 경우 Blob 임대를 해제할 수 있습니다. 임대를 해제하면 해제가 완료되는 즉시 다른 클라이언트가 해당 Blob에 대한 임대를 획득할 수 있습니다.

BlobLeaseClient 인스턴스에 다음 메서드 중 하나를 사용하여 임대를 해제할 수 있습니다.

• 엔지니어링
• ReleaseAsync

다음 예제에서는 Blob의 임대를 해제합니다.

public static async Task ReleaseBlobLeaseAsync(
    BlobClient blobClient,
    string leaseID)
{
    // Get a BlobLeaseClient object to work with a blob lease
    BlobLeaseClient leaseClient = blobClient.GetBlobLeaseClient(leaseID);

    await leaseClient.ReleaseAsync();
}

임대 중단

Blob에 활성 임대가 있는 경우 Blob 임대를 중단할 수 있습니다. 권한이 부여된 요청으로 임대를 중단할 수 있으며 요청 시 일치하는 임대 ID를 지정할 필요가 없습니다. 임대가 중단된 후에는 임대를 갱신할 수 없으며 임대를 위반하면 원래 임대가 만료되거나 해제될 때까지 일정 기간 동안 새 임대를 취득할 수 없습니다.

BlobLeaseClient 인스턴스에 다음 메서드 중 하나를 사용하여 임대를 중단할 수 있습니다.

• 휴식 시간
• BreakAsync

다음 예제에서는 Blob에 대한 임대를 중단합니다.

public static async Task BreakBlobLeaseAsync(
    BlobClient blobClient)
{
    // Get a BlobLeaseClient object to work with a blob lease
    BlobLeaseClient leaseClient = blobClient.GetBlobLeaseClient();

    await leaseClient.BreakAsync();
}

임대 상태 및 작업

다음 다이어그램은 5가지 임대 상태와 임대 상태를 변경하는 명령 또는 이벤트를 보여 줍니다.

다음 표에서는 5개의 임대 상태를 나열하고, 각각에 대해 간략하게 설명하며, 지정된 상태에서 허용되는 임대 작업을 나열합니다. 이러한 임대 작업은 다이어그램에 표시된 대로 상태 전환을 유발합니다.

임대가 만료된 후에는 blob이 수정되거나 다시 임대될 때까지 Blob service에서 임대 ID가 유지 관리됩니다. 클라이언트는 만료된 임대 ID를 사용하여 임대를 갱신하거나 해제하려고 시도할 수 있습니다. 이 작업이 성공하면 클라이언트는 임대 ID가 마지막으로 유효한 이래로 Blob이 변경되지 않았음을 알게 됩니다. 요청이 실패하면 클라이언트는 해당 임대의 마지막 유효 상태 이후에 blob이 수정되었거나 다시 임대되었음을 알게 됩니다. 이 경우에는 클라이언트가 Blob에 대해 새로운 임대를 획득해야 합니다.

임대가 명시적으로 해제되지 않고 만료될 경우, 클라이언트가 Blob에서 새로운 임대를 획득하려면 먼저 최대 1분까지 기다려야 할 수 있습니다. 하지만 blob이 수정되지 않은 경우에는 클라이언트가 해당 임대 ID를 사용해서 임대를 즉시 갱신할 수 있습니다.

스냅샷은 읽기 전용이기 때문에 blob 스냅샷에 대해서는 임대 권한을 부여할 수 없습니다. 스냅샷에 대해 임대를 요청하면 상태 코드 400 (Bad Request)이 표시됩니다.

리소스

.NET용 Azure Blob Storage 클라이언트 라이브러리를 사용하여 Blob 임대를 관리하는 방법에 대한 자세한 내용은 다음 리소스를 참조하세요.

코드 샘플

• 이 문서의 코드 샘플 보기(GitHub)

REST API 작업

.NET용 Azure SDK에는 Azure REST API를 기반으로 빌드되는 라이브러리가 포함되어 있으므로 익숙한 .NET 패러다임을 통해 REST API 작업과 상호 작용할 수 있습니다. Blob 임대를 관리하기 위한 클라이언트 라이브러리 메서드는 다음 REST API 작업을 사용합니다.

• Blob 임대

클라이언트 라이브러리 리소스

• 클라이언트 라이브러리 참조 설명서
• 클라이언트 라이브러리 소스 코드
• 패키지(NuGet)

참고 항목

• Blob Storage에서 동시성 관리

관련 콘텐츠

• 이 문서는 .NET용 Blob Storage 개발자 가이드의 일부입니다. 자세한 내용은 .NET 앱 빌드에서 개발자 가이드 문서 전체 목록을 참조하세요.