blob_service_client.hpp

// Copyright (c) Microsoft Corporation.
// Licensed under the MIT License.
 
#pragma once
 
#include "azure/storage/blobs/blob_container_client.hpp"
 
#include <azure/core/credentials/credentials.hpp>
#include <azure/storage/common/storage_credential.hpp>
 
#include <memory>
#include <string>
 
namespace Azure { namespace Storage { namespace Blobs {
 
  class BlobServiceBatch;
 
  class BlobServiceClient final {
  public:
    static BlobServiceClient CreateFromConnectionString(
        const std::string& connectionString,
        const BlobClientOptions& options = BlobClientOptions());
 
    explicit BlobServiceClient(
        const std::string& serviceUrl,
        std::shared_ptr<StorageSharedKeyCredential> credential,
        const BlobClientOptions& options = BlobClientOptions());
 
    explicit BlobServiceClient(
        const std::string& serviceUrl,
        std::shared_ptr<Core::Credentials::TokenCredential> credential,
        const BlobClientOptions& options = BlobClientOptions());
 
    explicit BlobServiceClient(
        const std::string& serviceUrl,
        const BlobClientOptions& options = BlobClientOptions());
 
    BlobContainerClient GetBlobContainerClient(const std::string& blobContainerName) const;
 
    std::string GetUrl() const { return m_serviceUrl.GetAbsoluteUrl(); }
 
    ListBlobContainersPagedResponse ListBlobContainers(
        const ListBlobContainersOptions& options = ListBlobContainersOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    Azure::Response<Models::UserDelegationKey> GetUserDelegationKey(
        const Azure::DateTime& expiresOn,
        const GetUserDelegationKeyOptions& options = GetUserDelegationKeyOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    Azure::Response<Models::SetServicePropertiesResult> SetProperties(
        Models::BlobServiceProperties properties,
        const SetServicePropertiesOptions& options = SetServicePropertiesOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    Azure::Response<Models::BlobServiceProperties> GetProperties(
        const GetServicePropertiesOptions& options = GetServicePropertiesOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    Azure::Response<Models::AccountInfo> GetAccountInfo(
        const GetAccountInfoOptions& options = GetAccountInfoOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    Azure::Response<Models::ServiceStatistics> GetStatistics(
        const GetBlobServiceStatisticsOptions& options = GetBlobServiceStatisticsOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    FindBlobsByTagsPagedResponse FindBlobsByTags(
        const std::string& tagFilterSqlExpression,
        const FindBlobsByTagsOptions& options = FindBlobsByTagsOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    Azure::Response<BlobContainerClient> CreateBlobContainer(
        const std::string& blobContainerName,
        const CreateBlobContainerOptions& options = CreateBlobContainerOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    Azure::Response<Models::DeleteBlobContainerResult> DeleteBlobContainer(
        const std::string& blobContainerName,
        const DeleteBlobContainerOptions& options = DeleteBlobContainerOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    Azure::Response<BlobContainerClient> UndeleteBlobContainer(
        const std::string& deletedBlobContainerName,
        const std::string& deletedBlobContainerVersion,
        const UndeleteBlobContainerOptions& options = UndeleteBlobContainerOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    Azure::Response<BlobContainerClient> RenameBlobContainer(
        const std::string& sourceBlobContainerName,
        const std::string& destinationBlobContainerName,
        const RenameBlobContainerOptions& options = RenameBlobContainerOptions(),
        const Azure::Core::Context& context = Azure::Core::Context()) const;
 
    BlobServiceBatch CreateBatch() const;
 
    Response<Models::SubmitBlobBatchResult> SubmitBatch(
        const BlobServiceBatch& batch,
        const SubmitBlobBatchOptions& options = SubmitBlobBatchOptions(),
        const Core::Context& context = Core::Context()) const;
 
  private:
    Azure::Core::Url m_serviceUrl;
    std::shared_ptr<Azure::Core::Http::_internal::HttpPipeline> m_pipeline;
    Azure::Nullable<EncryptionKey> m_customerProvidedKey;
    Azure::Nullable<std::string> m_encryptionScope;
 
    std::shared_ptr<Azure::Core::Http::_internal::HttpPipeline> m_batchRequestPipeline;
    std::shared_ptr<Azure::Core::Http::_internal::HttpPipeline> m_batchSubrequestPipeline;
 
    friend class BlobServiceBatch;
  };
}}} // namespace Azure::Storage::Blobs