page_blob_client.hpp

// Copyright (c) Microsoft Corporation. All rights reserved.
// SPDX-License-Identifier: MIT
 
#pragma once
 
#include <cstdint>
#include <memory>
#include <string>
 
#include "azure/storage/blobs/blob_client.hpp"
 
namespace Azure { namespace Storage { namespace Blobs {
 
  class PageBlobClient final : public BlobClient {
  public:
    static PageBlobClient CreateFromConnectionString(
        const std::string& connectionString,
        const std::string& blobContainerName,
        const std::string& blobName,
        const BlobClientOptions& options = BlobClientOptions());
 
    explicit PageBlobClient(
        const std::string& blobUrl,
        std::shared_ptr<StorageSharedKeyCredential> credential,
        const BlobClientOptions& options = BlobClientOptions());
 
    explicit PageBlobClient(
        const std::string& blobUrl,
        std::shared_ptr<Core::Credentials::TokenCredential> credential,
        const BlobClientOptions& options = BlobClientOptions());
 
    explicit PageBlobClient(
        const std::string& blobUrl,
        const BlobClientOptions& options = BlobClientOptions());
 
    PageBlobClient WithSnapshot(const std::string& snapshot) const;
 
    PageBlobClient WithVersionId(const std::string& versionId) const;
 
    Azure::Response<Models::CreatePageBlobResult> Create(
        int64_t blobSize,
        const CreatePageBlobOptions& options = CreatePageBlobOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    Azure::Response<Models::CreatePageBlobResult> CreateIfNotExists(
        int64_t blobContentLength,
        const CreatePageBlobOptions& options = CreatePageBlobOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    Azure::Response<Models::UploadPagesResult> UploadPages(
        int64_t offset,
        Azure::Core::IO::BodyStream& content,
        const UploadPagesOptions& options = UploadPagesOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    Azure::Response<Models::UploadPagesFromUriResult> UploadPagesFromUri(
        int64_t destinationOffset,
        std::string sourceUri,
        Azure::Core::Http::HttpRange sourceRange,
        const UploadPagesFromUriOptions& options = UploadPagesFromUriOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    Azure::Response<Models::ClearPagesResult> ClearPages(
        Azure::Core::Http::HttpRange range,
        const ClearPagesOptions& options = ClearPagesOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    Azure::Response<Models::ResizePageBlobResult> Resize(
        int64_t blobSize,
        const ResizePageBlobOptions& options = ResizePageBlobOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    GetPageRangesPagedResponse GetPageRanges(
        const GetPageRangesOptions& options = GetPageRangesOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    GetPageRangesDiffPagedResponse GetPageRangesDiff(
        const std::string& previousSnapshot,
        const GetPageRangesOptions& options = GetPageRangesOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    GetPageRangesDiffPagedResponse GetManagedDiskPageRangesDiff(
        const std::string& previousSnapshotUrl,
        const GetPageRangesOptions& options = GetPageRangesOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    StartBlobCopyOperation StartCopyIncremental(
        const std::string& sourceUri,
        const StartBlobCopyIncrementalOptions& options = StartBlobCopyIncrementalOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
  private:
    explicit PageBlobClient(BlobClient blobClient);
 
    friend class BlobClient;
  };
 
}}} // namespace Azure::Storage::Blobs