[Storage] Prepare azure_storage_blob for v0.3.0 release (#2791)

Author: vincenttran-msft

sdk/storage/azure_storage_blob/CHANGELOG.md

@@ -1,14 +1,12 @@
 # Release History
 
-## 0.3.0 (Unreleased)
+## 0.3.0 (2025-07-15)
 
 ### Features Added
 
-### Breaking Changes
-
-### Bugs Fixed
-
-### Other Changes
+* Added lease support (`acquire_lease`, `break_lease`, `change_lease`, `release_lease`, and `renew_lease`) to `BlobContainerClient` and `BlobClient`.
+* Added two new blob client types, `AppendBlobClient` and `PageBlobClient`.
+* Added support for `list_containers` to `BlobServiceClient`.
 
 ## 0.2.0 (2025-06-10)
 
@@ -20,7 +18,7 @@
   * `BlobContainerClient::blob_client()`
   * `BlobClient::block_blob_client()`
 
-* Added support for `list_blobs`, `set_metadata` to `ContainerClient`.
+* Added support for `list_blobs`, `set_metadata` to `BlobContainerClient`.
 * Added support for `set_metadata`, `set_properties`, and `set_tier` to `BlobClient`.
 
 ### Breaking Changes

sdk/storage/azure_storage_blob/src/clients/append_blob_client.rs

@@ -95,7 +95,7 @@ impl AppendBlobClient {
     /// # Arguments
     ///
     /// * `content_length` - Total length of the blob data to be uploaded.
-    /// * `options` - Optional configuration for the request.
+    /// * `options` - Optional configuration for the request. See [`AppendBlobClientCreateOptionsExt`](crate::models::AppendBlobClientCreateOptionsExt) for additional usage helpers.
     pub async fn create(
         &self,
         options: Option<AppendBlobClientCreateOptions<'_>>,
@@ -144,7 +144,7 @@ impl AppendBlobClient {
     ///
     /// # Arguments
     ///
-    /// * `options` - Optional parameters for the request.
+    /// * `options` - Optional configuration for the request.
     pub async fn seal(
         &self,
         options: Option<AppendBlobClientSealOptions<'_>>,

sdk/storage/azure_storage_blob/src/clients/blob_client.rs

@@ -10,7 +10,7 @@ use crate::{
         BlockBlobClientStageBlockResult, BlockBlobClientUploadResult,
     },
     models::{
-        AccessTierOptional, BlobClientAcquireLeaseOptions, BlobClientBreakLeaseOptions,
+        AccessTier, BlobClientAcquireLeaseOptions, BlobClientBreakLeaseOptions,
         BlobClientChangeLeaseOptions, BlobClientDeleteOptions, BlobClientDownloadOptions,
         BlobClientGetPropertiesOptions, BlobClientReleaseLeaseOptions, BlobClientRenewLeaseOptions,
         BlobClientSetMetadataOptions, BlobClientSetPropertiesOptions, BlobClientSetTierOptions,
@@ -230,7 +230,7 @@ impl BlobClient {
     /// * `options` - Optional configuration for the request.
     pub async fn set_tier(
         &self,
-        tier: AccessTierOptional,
+        tier: AccessTier,
         options: Option<BlobClientSetTierOptions<'_>>,
     ) -> Result<Response<(), NoFormat>> {
         self.client.set_tier(tier, options).await

sdk/storage/azure_storage_blob/src/clients/page_blob_client.rs

@@ -96,7 +96,7 @@ impl PageBlobClient {
     ///
     /// * `content_length` - The maximum size for the Page blob, up to 1TB. The page blob size must
     ///   be aligned to a 512-byte boundary.
-    /// * `options` - Optional parameters for the request. See [`PageBlobClientCreateOptionsExt`](crate::models::PageBlobClientCreateOptionsExt) for additional usage helpers.
+    /// * `options` - Optional configuration for the request. See [`PageBlobClientCreateOptionsExt`](crate::models::PageBlobClientCreateOptionsExt) for additional usage helpers.
     pub async fn create(
         &self,
         content_length: u64,
@@ -110,7 +110,7 @@ impl PageBlobClient {
     /// # Arguments
     ///
     /// * `range` - The range of bytes to clear. See [`format_page_range()`](crate::format_page_range) for help with the expected String format.
-    /// * `options` - Optional parameters for the request.
+    /// * `options` - Optional configuration for the request.
     pub async fn clear_page(
         &self,
         range: String,
@@ -126,7 +126,7 @@ impl PageBlobClient {
     ///
     /// * `size` - Size used to resize the blob. Maximum size for a page Blob is up to 1TB. The
     ///   Page blob size must be aligned to a 512-byte boundary.
-    /// * `options` - Optional parameters for the request.
+    /// * `options` - Optional configuration for the request.
     pub async fn resize(
         &self,
         size: u64,
@@ -143,7 +143,7 @@ impl PageBlobClient {
     /// * `content_length` - Number of bytes to use for writing to a section of the blob. The
     ///   content_length specified must be a modulus of 512.
     /// * `range` - The range of the bytes to write. See [`format_page_range()`](crate::format_page_range) for help with the expected String format.
-    /// * `options` - Optional parameters for the request.
+    /// * `options` - Optional configuration for the request.
     pub async fn upload_page(
         &self,
         data: RequestContent<Bytes>,

sdk/storage/azure_storage_blob/src/generated/clients/blob_client.rs

@@ -3,8 +3,9 @@
 
 use crate::models::{AppendBlobClientCreateOptions, PageBlobClientCreateOptions};
 
+/// Provides usage helpers for setting the `PageBlobClientCreateOptions` optional configurations.
 pub trait PageBlobClientCreateOptionsExt {
-    /// Augments the current options bag to only create if the page blob does not already exists.
+    /// Augments the current options bag to only create if the Page blob does not already exist.
     /// # Arguments
     ///
     /// * `self` - The options bag to be modified.
@@ -20,8 +21,9 @@ impl PageBlobClientCreateOptionsExt for PageBlobClientCreateOptions<'_> {
     }
 }
 
+/// Provides usage helpers for setting the `AppendBlobClientCreateOptions` optional configurations.
 pub trait AppendBlobClientCreateOptionsExt {
-    /// Augments the current options bag to only create if the append blob does not already exists.
+    /// Augments the current options bag to only create if the Append blob does not already exist.
     /// # Arguments
     ///
     /// * `self` - The options bag to be modified.

sdk/storage/azure_storage_blob/src/generated/models/enums.rs

@@ -4,32 +4,45 @@
 mod extensions;
 
 pub use crate::generated::models::{
-    AccessTierOptional, AppendBlobClientAppendBlockFromUrlOptions,
-    AppendBlobClientAppendBlockFromUrlResult, AppendBlobClientAppendBlockOptions,
-    AppendBlobClientAppendBlockResult, AppendBlobClientCreateOptions, AppendBlobClientCreateResult,
-    AppendBlobClientSealOptions, AppendBlobClientSealResult, ArchiveStatus,
-    BlobClientAcquireLeaseOptions, BlobClientAcquireLeaseResultHeaders,
-    BlobClientBreakLeaseOptions, BlobClientChangeLeaseOptions, BlobClientChangeLeaseResultHeaders,
-    BlobClientDeleteOptions, BlobClientDownloadOptions, BlobClientDownloadResult,
-    BlobClientDownloadResultHeaders, BlobClientGetPropertiesOptions, BlobClientGetPropertiesResult,
-    BlobClientGetPropertiesResultHeaders, BlobClientReleaseLeaseOptions,
-    BlobClientRenewLeaseOptions, BlobClientSetMetadataOptions, BlobClientSetPropertiesOptions,
-    BlobClientSetTierOptions, BlobContainerClientAcquireLeaseOptions,
+    AccessTier, AppendBlobClientAppendBlockFromUrlOptions,
+    AppendBlobClientAppendBlockFromUrlResult, AppendBlobClientAppendBlockFromUrlResultHeaders,
+    AppendBlobClientAppendBlockOptions, AppendBlobClientAppendBlockResult,
+    AppendBlobClientAppendBlockResultHeaders, AppendBlobClientCreateOptions,
+    AppendBlobClientCreateResult, AppendBlobClientCreateResultHeaders, AppendBlobClientSealOptions,
+    AppendBlobClientSealResult, AppendBlobClientSealResultHeaders, ArchiveStatus,
+    BlobClientAcquireLeaseOptions, BlobClientAcquireLeaseResult,
+    BlobClientAcquireLeaseResultHeaders, BlobClientBreakLeaseOptions, BlobClientBreakLeaseResult,
+    BlobClientBreakLeaseResultHeaders, BlobClientChangeLeaseOptions, BlobClientChangeLeaseResult,
+    BlobClientChangeLeaseResultHeaders, BlobClientDeleteOptions, BlobClientDownloadOptions,
+    BlobClientDownloadResult, BlobClientDownloadResultHeaders, BlobClientGetPropertiesOptions,
+    BlobClientGetPropertiesResult, BlobClientGetPropertiesResultHeaders,
+    BlobClientReleaseLeaseOptions, BlobClientReleaseLeaseResult,
+    BlobClientReleaseLeaseResultHeaders, BlobClientRenewLeaseOptions, BlobClientRenewLeaseResult,
+    BlobClientRenewLeaseResultHeaders, BlobClientSetMetadataOptions,
+    BlobClientSetPropertiesOptions, BlobClientSetTierOptions,
+    BlobContainerClientAcquireLeaseOptions, BlobContainerClientAcquireLeaseResult,
     BlobContainerClientAcquireLeaseResultHeaders, BlobContainerClientBreakLeaseOptions,
-    BlobContainerClientChangeLeaseOptions, BlobContainerClientChangeLeaseResultHeaders,
-    BlobContainerClientCreateOptions, BlobContainerClientDeleteOptions,
-    BlobContainerClientGetPropertiesOptions, BlobContainerClientGetPropertiesResult,
-    BlobContainerClientGetPropertiesResultHeaders, BlobContainerClientListBlobFlatSegmentOptions,
-    BlobContainerClientReleaseLeaseOptions, BlobContainerClientRenewLeaseOptions,
+    BlobContainerClientBreakLeaseResult, BlobContainerClientBreakLeaseResultHeaders,
+    BlobContainerClientChangeLeaseOptions, BlobContainerClientChangeLeaseResult,
+    BlobContainerClientChangeLeaseResultHeaders, BlobContainerClientCreateOptions,
+    BlobContainerClientDeleteOptions, BlobContainerClientGetPropertiesOptions,
+    BlobContainerClientGetPropertiesResult, BlobContainerClientGetPropertiesResultHeaders,
+    BlobContainerClientListBlobFlatSegmentOptions, BlobContainerClientReleaseLeaseOptions,
+    BlobContainerClientReleaseLeaseResult, BlobContainerClientReleaseLeaseResultHeaders,
+    BlobContainerClientRenewLeaseOptions, BlobContainerClientRenewLeaseResult,
     BlobContainerClientSetMetadataOptions, BlobImmutabilityPolicyMode,
     BlobServiceClientGetPropertiesOptions, BlobServiceClientListContainersSegmentOptions, BlobType,
     BlockBlobClientCommitBlockListOptions, BlockBlobClientCommitBlockListResult,
-    BlockBlobClientGetBlockListOptions, BlockBlobClientStageBlockOptions,
-    BlockBlobClientStageBlockResult, BlockBlobClientUploadOptions, BlockBlobClientUploadResult,
-    BlockList, BlockListType, BlockLookupList, CopyStatus, LeaseState, LeaseStatus,
-    ListBlobsFlatSegmentResponse, ListContainersSegmentResponse, PageBlobClientClearPagesOptions,
-    PageBlobClientClearPagesResult, PageBlobClientCreateOptions, PageBlobClientCreateResult,
-    PageBlobClientResizeOptions, PageBlobClientResizeResult, PageBlobClientUploadPagesOptions,
-    PageBlobClientUploadPagesResult, PublicAccessType, RehydratePriority, StorageServiceProperties,
+    BlockBlobClientCommitBlockListResultHeaders, BlockBlobClientGetBlockListOptions,
+    BlockBlobClientStageBlockOptions, BlockBlobClientStageBlockResult,
+    BlockBlobClientStageBlockResultHeaders, BlockBlobClientUploadOptions,
+    BlockBlobClientUploadResult, BlockBlobClientUploadResultHeaders, BlockList, BlockListType,
+    BlockLookupList, CopyStatus, LeaseState, LeaseStatus, ListBlobsFlatSegmentResponse,
+    ListContainersSegmentResponse, PageBlobClientClearPagesOptions, PageBlobClientClearPagesResult,
+    PageBlobClientClearPagesResultHeaders, PageBlobClientCreateOptions, PageBlobClientCreateResult,
+    PageBlobClientCreateResultHeaders, PageBlobClientResizeOptions, PageBlobClientResizeResult,
+    PageBlobClientResizeResultHeaders, PageBlobClientUploadPagesOptions,
+    PageBlobClientUploadPagesResult, PageBlobClientUploadPagesResultHeaders, PublicAccessType,
+    RehydratePriority, StorageServiceProperties,
 };
 pub use extensions::*;

sdk/storage/azure_storage_blob/src/generated/models/method_options.rs

@@ -7,7 +7,7 @@ use azure_core::{
 };
 use azure_core_test::{recorded, TestContext};
 use azure_storage_blob::models::{
-    AccessTierOptional, BlobClientAcquireLeaseResultHeaders, BlobClientChangeLeaseResultHeaders,
+    AccessTier, BlobClientAcquireLeaseResultHeaders, BlobClientChangeLeaseResultHeaders,
     BlobClientDownloadOptions, BlobClientDownloadResultHeaders, BlobClientGetPropertiesOptions,
     BlobClientGetPropertiesResultHeaders, BlobClientSetMetadataOptions,
     BlobClientSetPropertiesOptions, BlobClientSetTierOptions, BlockBlobClientUploadOptions,
@@ -266,15 +266,15 @@ async fn test_set_access_tier(ctx: TestContext) -> Result<(), Box<dyn Error>> {
 
     let original_response = blob_client.get_properties(None).await?;
     let og_access_tier = original_response.access_tier()?;
-    assert_eq!(AccessTierOptional::Hot.to_string(), og_access_tier.unwrap());
+    assert_eq!(AccessTier::Hot.to_string(), og_access_tier.unwrap());
 
     // Set Standard Blob Tier (Cold)
-    blob_client.set_tier(AccessTierOptional::Cold, None).await?;
+    blob_client.set_tier(AccessTier::Cold, None).await?;
     let response = blob_client.get_properties(None).await?;
 
     // Assert
     let access_tier = response.access_tier()?;
-    assert_eq!(AccessTierOptional::Cold.to_string(), access_tier.unwrap());
+    assert_eq!(AccessTier::Cold.to_string(), access_tier.unwrap());
 
     container_client.delete_container(None).await?;
     Ok(())
@@ -371,7 +371,7 @@ async fn test_leased_blob_operations(ctx: TestContext) -> Result<(), Box<dyn Err
         ..Default::default()
     };
     blob_client
-        .set_tier(AccessTierOptional::Cold, Some(set_tier_options))
+        .set_tier(AccessTier::Cold, Some(set_tier_options))
         .await?;
 
     // Assert
@@ -390,7 +390,7 @@ async fn test_leased_blob_operations(ctx: TestContext) -> Result<(), Box<dyn Err
     assert_eq!("spanish".to_string(), content_language.unwrap());
     assert_eq!("inline".to_string(), content_disposition.unwrap());
     assert_eq!(update_metadata, response_metadata);
-    assert_eq!(AccessTierOptional::Cold.to_string(), access_tier.unwrap());
+    assert_eq!(AccessTier::Cold.to_string(), access_tier.unwrap());
 
     // Overwrite Upload
     let data = b"overruled!";