From e8c3c62008ccceff51cf0176bbe6ab629602af2f Mon Sep 17 00:00:00 2001
From: nidhiii-27 <nidhiii@google.com>
Date: Mon, 23 Feb 2026 10:58:53 +0530
Subject: [PATCH] chore: modify documentation to include failure scenario

---
 .../main/java/com/google/cloud/storage/Storage.java    | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/Storage.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/Storage.java
index 12ac95dff7..9c764e8c1e 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/Storage.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/Storage.java
@@ -4045,6 +4045,8 @@ Blob createFrom(
   /**
    * Returns the requested bucket or {@code null} if not found.
    *
+   * <p>Note: A {@link StorageException} is thrown in case of any failure.
+   *
    * <p>Accepts an optional userProject {@link BucketGetOption} option which defines the project id
    * to assign operational costs.
    *
@@ -4067,6 +4069,8 @@ Blob createFrom(
    * Locks bucket retention policy. Requires a local metageneration value in the request. Review
    * example below.
    *
+   * <p>Note: A {@link StorageException} is thrown in case of any failure.
+   *
    * <p>Accepts an optional userProject {@link BucketTargetOption} option which defines the project
    * id to assign operational costs.
    *
@@ -4090,6 +4094,8 @@ Blob createFrom(
   /**
    * Returns the requested blob or {@code null} if not found.
    *
+   * <p>Note: A {@link StorageException} is thrown in case of any failure.
+   *
    * <p>Accepts an optional userProject {@link BlobGetOption} option which defines the project id to
    * assign operational costs.
    *
@@ -4112,6 +4118,8 @@ Blob createFrom(
   /**
    * Returns the requested blob or {@code null} if not found.
    *
+   * <p>Note: A {@link StorageException} is thrown in case of any failure.
+   *
    * <p>Accepts an optional userProject {@link BlobGetOption} option which defines the project id to
    * assign operational costs.
    *
@@ -4149,6 +4157,8 @@ Blob createFrom(
   /**
    * Returns the requested blob or {@code null} if not found.
    *
+   * <p>Note: A {@link StorageException} is thrown in case of any failure.
+   *
    * <p>Example of getting information on a blob.
    *
    * <pre>{@code