[Storage] blob, fileshare, and queue README and samples clean-up (Azure#29002)

* Blob samples + readme

* File-share readme

* Queue readme & samples

Author: vincenttran-msft

sdk/storage/azure-storage-blob/README.md

@@ -219,7 +219,7 @@ Create a container from where you can upload or download blobs.
 ```python
 from azure.storage.blob import ContainerClient
 
-container_client = ContainerClient.from_connection_string(conn_str="<connection_string>", container_name="my_container")
+container_client = ContainerClient.from_connection_string(conn_str="<connection_string>", container_name="mycontainer")
 
 container_client.create_container()
 ```
@@ -229,7 +229,7 @@ Use the async client to upload a blob
 ```python
 from azure.storage.blob.aio import ContainerClient
 
-container_client = ContainerClient.from_connection_string(conn_str="<connection_string>", container_name="my_container")
+container_client = ContainerClient.from_connection_string(conn_str="<connection_string>", container_name="mycontainer")
 
 await container_client.create_container()
 ```
@@ -240,7 +240,7 @@ Upload a blob to your container
 ```python
 from azure.storage.blob import BlobClient
 
-blob = BlobClient.from_connection_string(conn_str="<connection_string>", container_name="my_container", blob_name="my_blob")
+blob = BlobClient.from_connection_string(conn_str="<connection_string>", container_name="mycontainer", blob_name="my_blob")
 
 with open("./SampleSource.txt", "rb") as data:
     blob.upload_blob(data)
@@ -251,7 +251,7 @@ Use the async client to upload a blob
 ```python
 from azure.storage.blob.aio import BlobClient
 
-blob = BlobClient.from_connection_string(conn_str="<connection_string>", container_name="my_container", blob_name="my_blob")
+blob = BlobClient.from_connection_string(conn_str="<connection_string>", container_name="mycontainer", blob_name="my_blob")
 
 with open("./SampleSource.txt", "rb") as data:
     await blob.upload_blob(data)
@@ -263,7 +263,7 @@ Download a blob from your container
 ```python
 from azure.storage.blob import BlobClient
 
-blob = BlobClient.from_connection_string(conn_str="my_connection_string", container_name="my_container", blob_name="my_blob")
+blob = BlobClient.from_connection_string(conn_str="<connection_string>", container_name="mycontainer", blob_name="my_blob")
 
 with open("./BlockDestination.txt", "wb") as my_blob:
     blob_data = blob.download_blob()
@@ -275,7 +275,7 @@ Download a blob asynchronously
 ```python
 from azure.storage.blob.aio import BlobClient
 
-blob = BlobClient.from_connection_string(conn_str="my_connection_string", container_name="my_container", blob_name="my_blob")
+blob = BlobClient.from_connection_string(conn_str="<connection_string>", container_name="mycontainer", blob_name="my_blob")
 
 with open("./BlockDestination.txt", "wb") as my_blob:
     stream = await blob.download_blob()
@@ -289,7 +289,7 @@ List the blobs in your container
 ```python
 from azure.storage.blob import ContainerClient
 
-container = ContainerClient.from_connection_string(conn_str="my_connection_string", container_name="my_container")
+container = ContainerClient.from_connection_string(conn_str="<connection_string>", container_name="mycontainer")
 
 blob_list = container.list_blobs()
 for blob in blob_list:
@@ -301,7 +301,7 @@ List the blobs asynchronously
 ```python
 from azure.storage.blob.aio import ContainerClient
 
-container = ContainerClient.from_connection_string(conn_str="my_connection_string", container_name="my_container")
+container = ContainerClient.from_connection_string(conn_str="<connection_string>", container_name="mycontainer")
 
 blob_list = []
 async for blob in container.list_blobs():

sdk/storage/azure-storage-blob/samples/blob_samples_authentication_async.py

@@ -133,7 +133,7 @@ async def auth_default_azure_credential(self):
         # [END create_blob_service_client_oauth_default_credential]
 
         # Get account information for the Blob Service
-        account_info = blob_service_client.get_service_properties()
+        account_info = await blob_service_client.get_service_properties()
 
 async def main():
     sample = AuthSamplesAsync()

sdk/storage/azure-storage-file-share/README.md

@@ -172,7 +172,7 @@ Create a file share to store your files
 ```python
 from azure.storage.fileshare import ShareClient
 
-share = ShareClient.from_connection_string(conn_str="<connection_string>", share_name="my_share")
+share = ShareClient.from_connection_string(conn_str="<connection_string>", share_name="myshare")
 share.create_share()
 ```
 
@@ -181,7 +181,7 @@ Use the async client to create a file share
 ```python
 from azure.storage.fileshare.aio import ShareClient
 
-share = ShareClient.from_connection_string(conn_str="<connection_string>", share_name="my_share")
+share = ShareClient.from_connection_string(conn_str="<connection_string>", share_name="myshare")
 await share.create_share()
 ```
 
@@ -191,7 +191,7 @@ Upload a file to the share
 ```python
 from azure.storage.fileshare import ShareFileClient
 
-file_client = ShareFileClient.from_connection_string(conn_str="<connection_string>", share_name="my_share", file_path="my_file")
+file_client = ShareFileClient.from_connection_string(conn_str="<connection_string>", share_name="myshare", file_path="my_file")
 
 with open("./SampleSource.txt", "rb") as source_file:
     file_client.upload_file(source_file)
@@ -202,7 +202,7 @@ Upload a file asynchronously
 ```python
 from azure.storage.fileshare.aio import ShareFileClient
 
-file_client = ShareFileClient.from_connection_string(conn_str="<connection_string>", share_name="my_share", file_path="my_file")
+file_client = ShareFileClient.from_connection_string(conn_str="<connection_string>", share_name="myshare", file_path="my_file")
 
 with open("./SampleSource.txt", "rb") as source_file:
     await file_client.upload_file(source_file)
@@ -214,7 +214,7 @@ Download a file from the share
 ```python
 from azure.storage.fileshare import ShareFileClient
 
-file_client = ShareFileClient.from_connection_string(conn_str="<connection_string>", share_name="my_share", file_path="my_file")
+file_client = ShareFileClient.from_connection_string(conn_str="<connection_string>", share_name="myshare", file_path="my_file")
 
 with open("DEST_FILE", "wb") as file_handle:
     data = file_client.download_file()
@@ -226,7 +226,7 @@ Download a file asynchronously
 ```python
 from azure.storage.fileshare.aio import ShareFileClient
 
-file_client = ShareFileClient.from_connection_string(conn_str="<connection_string>", share_name="my_share", file_path="my_file")
+file_client = ShareFileClient.from_connection_string(conn_str="<connection_string>", share_name="myshare", file_path="my_file")
 
 with open("DEST_FILE", "wb") as file_handle:
     data = await file_client.download_file()
@@ -239,7 +239,7 @@ List all directories and files under a parent directory
 ```python
 from azure.storage.fileshare import ShareDirectoryClient
 
-parent_dir = ShareDirectoryClient.from_connection_string(conn_str="<connection_string>", share_name="my_share", directory_path="parent_dir")
+parent_dir = ShareDirectoryClient.from_connection_string(conn_str="<connection_string>", share_name="myshare", directory_path="parent_dir")
 
 my_list = list(parent_dir.list_directories_and_files())
 print(my_list)
@@ -250,7 +250,7 @@ List contents of a directory asynchronously
 ```python
 from azure.storage.fileshare.aio import ShareDirectoryClient
 
-parent_dir = ShareDirectoryClient.from_connection_string(conn_str="<connection_string>", share_name="my_share", directory_path="parent_dir")
+parent_dir = ShareDirectoryClient.from_connection_string(conn_str="<connection_string>", share_name="myshare", directory_path="parent_dir")
 
 my_files = []
 async for item in parent_dir.list_directories_and_files():

sdk/storage/azure-storage-queue/README.md

@@ -194,15 +194,15 @@ Create a queue in your storage account
 ```python
 from azure.storage.queue import QueueClient
 
-queue = QueueClient.from_connection_string(conn_str="<connection_string>", queue_name="my_queue")
+queue = QueueClient.from_connection_string(conn_str="<connection_string>", queue_name="myqueue")
 queue.create_queue()
 ```
 
 Use the async client to create a queue
 ```python
 from azure.storage.queue.aio import QueueClient
 
-queue = QueueClient.from_connection_string(conn_str="<connection_string>", queue_name="my_queue")
+queue = QueueClient.from_connection_string(conn_str="<connection_string>", queue_name="myqueue")
 await queue.create_queue()
 ```
 
@@ -212,7 +212,7 @@ Send messages to your queue
 ```python
 from azure.storage.queue import QueueClient
 
-queue = QueueClient.from_connection_string(conn_str="<connection_string>", queue_name="my_queue")
+queue = QueueClient.from_connection_string(conn_str="<connection_string>", queue_name="myqueue")
 queue.send_message("I'm using queues!")
 queue.send_message("This is my second message")
 ```
@@ -223,7 +223,7 @@ Send messages asynchronously
 import asyncio
 from azure.storage.queue.aio import QueueClient
 
-queue = QueueClient.from_connection_string(conn_str="<connection_string>", queue_name="my_queue")
+queue = QueueClient.from_connection_string(conn_str="<connection_string>", queue_name="myqueue")
 await asyncio.gather(
     queue.send_message("I'm using queues!"),
     queue.send_message("This is my second message")
@@ -236,7 +236,7 @@ Receive and process messages from your queue
 ```python
 from azure.storage.queue import QueueClient
 
-queue = QueueClient.from_connection_string(conn_str="<connection_string>", queue_name="my_queue")
+queue = QueueClient.from_connection_string(conn_str="<connection_string>", queue_name="myqueue")
 response = queue.receive_messages()
 
 for message in response:
@@ -253,7 +253,7 @@ Receive and process messages in batches
 ```python
 from azure.storage.queue import QueueClient
 
-queue = QueueClient.from_connection_string(conn_str="<connection_string>", queue_name="my_queue")
+queue = QueueClient.from_connection_string(conn_str="<connection_string>", queue_name="myqueue")
 response = queue.receive_messages(messages_per_page=10)
 
 for message_batch in response.by_page():
@@ -267,7 +267,7 @@ Receive and process messages asynchronously
 ```python
 from azure.storage.queue.aio import QueueClient
 
-queue = QueueClient.from_connection_string(conn_str="<connection_string>", queue_name="my_queue")
+queue = QueueClient.from_connection_string(conn_str="<connection_string>", queue_name="myqueue")
 response = queue.receive_messages()
 
 async for message in response:

sdk/storage/azure-storage-queue/samples/queue_samples_message_async.py

@@ -152,7 +152,7 @@ async def send_and_receive_messages_async(self):
     async def receive_one_message_from_queue(self):
         # Instantiate a queue client
         from azure.storage.queue.aio import QueueClient
-        queue = QueueClient.from_connection_string(self.connection_string, "myqueue3")
+        queue = QueueClient.from_connection_string(self.connection_string, "myqueue4")
 
         # Create the queue
         async with queue:
@@ -182,7 +182,7 @@ async def receive_one_message_from_queue(self):
     async def delete_and_clear_messages_async(self):
         # Instantiate a queue client
         from azure.storage.queue.aio import QueueClient
-        queue = QueueClient.from_connection_string(self.connection_string, "myqueue4")
+        queue = QueueClient.from_connection_string(self.connection_string, "myqueue5")
 
         # Create the queue
         async with queue:
@@ -218,7 +218,7 @@ async def delete_and_clear_messages_async(self):
     async def peek_messages_async(self):
         # Instantiate a queue client
         from azure.storage.queue.aio import QueueClient
-        queue = QueueClient.from_connection_string(self.connection_string, "myqueue5")
+        queue = QueueClient.from_connection_string(self.connection_string, "myqueue6")
 
         # Create the queue
         async with queue:
@@ -253,7 +253,7 @@ async def peek_messages_async(self):
     async def update_message_async(self):
         # Instantiate a queue client
         from azure.storage.queue.aio import QueueClient
-        queue = QueueClient.from_connection_string(self.connection_string, "myqueue6")
+        queue = QueueClient.from_connection_string(self.connection_string, "myqueue7")
 
         # Create the queue
         async with queue:
@@ -283,7 +283,7 @@ async def update_message_async(self):
     async def receive_messages_with_max_messages(self):
         # Instantiate a queue client
         from azure.storage.queue.aio import QueueClient
-        queue = QueueClient.from_connection_string(self.connection_string, "myqueue7")
+        queue = QueueClient.from_connection_string(self.connection_string, "myqueue8")
 
         # Create the queue
         async with queue: