googleapis
diff --git a/‎gcloud/storage/key.py
Copy file name to clipboardExpand all lines: gcloud/storage/key.py
+8-1Lines changed: 8 additions & 1 deletion b/‎gcloud/storage/key.py
Copy file name to clipboardExpand all lines: gcloud/storage/key.py
+8-1Lines changed: 8 additions & 1 deletion
@@ -134,10 +134,17 @@ def exists(self):
         return self.bucket.get_key(self.name) is not None
 
     def rename(self, new_name):
-        """Renames this key.
+        """Renames this key using copy and delete operations.
 
         Effectively, copies key to the same bucket with a new name, then
         deletes the key.
+        
+        .. warning::
+          This method will first duplicate the data
+          and then delete the old key.
+          This means that with very large objects
+          renaming could be a very (temporarily) costly
+          or a very slow operation.
 
         :type new_name: string
         :param new_name: The new name for this key.