[Storage] Fix metadata typehint in file-share (#35505)

Author: vincenttran-msft

sdk/storage/azure-storage-file-share/azure/storage/fileshare/_directory_client.py

@@ -348,8 +348,9 @@ def create_directory(self, **kwargs):
                 This parameter was introduced in API version '2021-06-08'.
 
         :paramtype file_change_time: str or ~datetime.datetime
-        :keyword dict[str, str] metadata:
+        :keyword metadata:
             Name-value pairs associated with the directory as metadata.
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword int timeout:
             Sets the server-side timeout for the operation in seconds. For more details see
             https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations.
@@ -858,8 +859,9 @@ def create_subdirectory(
 
         :param str directory_name:
             The name of the subdirectory.
-        :keyword dict[str, str] metadata:
+        :keyword metadata:
             Name-value pairs associated with the subdirectory as metadata.
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword int timeout:
             Sets the server-side timeout for the operation in seconds. For more details see
             https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations.
@@ -932,8 +934,9 @@ def upload_file(
         :type data: Union[bytes, str, Iterable[AnyStr], IO[AnyStr]]
         :param int length:
             Length of the file in bytes. Specify its maximum size, up to 1 TiB.
-        :keyword dict[str, str] metadata:
+        :keyword metadata:
             Name-value pairs associated with the file as metadata.
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword ~azure.storage.fileshare.ContentSettings content_settings:
             ContentSettings object used to set file properties. Used to set content type, encoding,
             language, disposition, md5, and cache control.

sdk/storage/azure-storage-file-share/azure/storage/fileshare/_file_client.py

@@ -435,8 +435,9 @@ def create_file(  # type: ignore
         :keyword ~azure.storage.fileshare.ContentSettings content_settings:
             ContentSettings object used to set file properties. Used to set content type, encoding,
             language, disposition, md5, and cache control.
-        :keyword dict[str, str] metadata:
+        :keyword metadata:
             Name-value pairs associated with the file as metadata.
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword lease:
             Required if the file has an active lease. Value can be a ShareLeaseClient object
             or the lease ID as a string.
@@ -547,8 +548,9 @@ def upload_file(
                 This parameter was introduced in API version '2021-06-08'.
 
         :paramtype file_change_time: str or ~datetime.datetime
-        :keyword dict[str, str] metadata:
+        :keyword metadata:
             Name-value pairs associated with the file as metadata.
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword ~azure.storage.fileshare.ContentSettings content_settings:
             ContentSettings object used to set file properties. Used to set content type, encoding,
             language, disposition, md5, and cache control.
@@ -718,7 +720,7 @@ def start_copy_from_url(self, source_url, **kwargs):
 
         :keyword metadata:
             Name-value pairs associated with the file as metadata.
-        :paramtype metadata: dict[str, str]
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword lease:
             Required if the file has an active lease. Value can be a ShareLeaseClient object
             or the lease ID as a string.

sdk/storage/azure-storage-file-share/azure/storage/fileshare/_share_client.py

@@ -351,7 +351,7 @@ def create_share(self, **kwargs):
 
         :keyword metadata:
             Name-value pairs associated with the share as metadata.
-        :paramtype metadata: dict[str, str]
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword int quota:
             The quota to be allotted.
         :keyword access_tier:
@@ -431,7 +431,7 @@ def create_snapshot( # type: ignore
 
         :keyword metadata:
             Name-value pairs associated with the share as metadata.
-        :paramtype metadata: dict[str, str]
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword int timeout:
             Sets the server-side timeout for the operation in seconds. For more details see
             https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations.
@@ -682,7 +682,7 @@ def set_share_metadata(self, metadata, **kwargs):
 
         :param metadata:
             Name-value pairs associated with the share as metadata.
-        :type metadata: dict[str, Any]
+        :type metadata: dict[str, str]
         :keyword int timeout:
             Sets the server-side timeout for the operation in seconds. For more details see
             https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations.
@@ -982,7 +982,7 @@ def create_directory(self, directory_name, **kwargs):
             The name of the directory.
         :keyword metadata:
             Name-value pairs associated with the directory as metadata.
-        :paramtype metadata: dict[str, str]
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword int timeout:
             Sets the server-side timeout for the operation in seconds. For more details see
             https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations.

sdk/storage/azure-storage-file-share/azure/storage/fileshare/_share_service_client.py

@@ -344,9 +344,10 @@ def create_share(
         which to interact with the newly created share.
 
         :param str share_name: The name of the share to create.
-        :keyword dict[str, str] metadata:
+        :keyword metadata:
             A dict with name_value pairs to associate with the
             share as metadata. Example:{'Category':'test'}
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword int quota:
             Quota in bytes.
         :keyword int timeout:

sdk/storage/azure-storage-file-share/azure/storage/fileshare/aio/_directory_client_async.py

@@ -221,8 +221,9 @@ async def create_directory(self, **kwargs):
                 This parameter was introduced in API version '2021-06-08'.
 
         :paramtype file_change_time: str or ~datetime.datetime
-        :keyword dict[str, str] metadata:
+        :keyword metadata:
             Name-value pairs associated with the directory as metadata.
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword int timeout:
             Sets the server-side timeout for the operation in seconds. For more details see
             https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations.
@@ -731,8 +732,9 @@ async def create_subdirectory(
 
         :param str directory_name:
             The name of the subdirectory.
-        :keyword dict[str, str] metadata:
+        :keyword metadata:
             Name-value pairs associated with the subdirectory as metadata.
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword int timeout:
             Sets the server-side timeout for the operation in seconds. For more details see
             https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations.
@@ -805,8 +807,9 @@ async def upload_file(
         :type data: Union[bytes, str, Iterable[AnyStr], AsyncIterable[AnyStr], IO[AnyStr]]
         :param int length:
             Length of the file in bytes. Specify its maximum size, up to 1 TiB.
-        :keyword dict[str, str] metadata:
+        :keyword metadata:
             Name-value pairs associated with the file as metadata.
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword ~azure.storage.fileshare.ContentSettings content_settings:
             ContentSettings object used to set file properties. Used to set content type, encoding,
             language, disposition, md5, and cache control.

sdk/storage/azure-storage-file-share/azure/storage/fileshare/aio/_file_client_async.py

@@ -291,8 +291,9 @@ async def create_file(  # type: ignore
         :keyword ~azure.storage.fileshare.ContentSettings content_settings:
             ContentSettings object used to set file properties. Used to set content type, encoding,
             language, disposition, md5, and cache control.
-        :keyword dict[str, str] metadata:
+        :keyword metadata:
             Name-value pairs associated with the file as metadata.
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword lease:
             Required if the file has an active lease. Value can be a ShareLeaseClient object
             or the lease ID as a string.
@@ -404,8 +405,9 @@ async def upload_file(
                 This parameter was introduced in API version '2021-06-08'.
 
         :paramtype file_change_time: str or ~datetime.datetime
-        :keyword dict[str, str] metadata:
+        :keyword metadata:
             Name-value pairs associated with the file as metadata.
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword ~azure.storage.fileshare.ContentSettings content_settings:
             ContentSettings object used to set file properties. Used to set content type, encoding,
             language, disposition, md5, and cache control.
@@ -578,7 +580,7 @@ async def start_copy_from_url(self, source_url, **kwargs):
 
         :keyword metadata:
             Name-value pairs associated with the file as metadata.
-        :paramtype metadata: dict[str, str]
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword lease:
             Required if the file has an active lease. Value can be a ShareLeaseClient object
             or the lease ID as a string.

sdk/storage/azure-storage-file-share/azure/storage/fileshare/aio/_share_client_async.py

@@ -209,7 +209,7 @@ async def create_share(self, **kwargs):
 
         :keyword metadata:
             Name-value pairs associated with the share as metadata.
-        :paramtype metadata: dict[str, str]
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword int quota:
             The quota to be allotted.
         :keyword access_tier:
@@ -289,7 +289,7 @@ async def create_snapshot( # type: ignore
 
         :keyword metadata:
             Name-value pairs associated with the share as metadata.
-        :paramtype metadata: dict[str, str]
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword int timeout:
             Sets the server-side timeout for the operation in seconds. For more details see
             https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations.
@@ -539,7 +539,7 @@ async def set_share_metadata(self, metadata, **kwargs):
 
         :param metadata:
             Name-value pairs associated with the share as metadata.
-        :type metadata: dict[str, Any]
+        :type metadata: dict[str, str]
         :keyword int timeout:
             Sets the server-side timeout for the operation in seconds. For more details see
             https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations.
@@ -826,8 +826,9 @@ async def create_directory(self, directory_name, **kwargs):
 
         :param str directory_name:
             The name of the directory.
-        :keyword dict[str, str] metadata:
+        :keyword metadata:
             Name-value pairs associated with the directory as metadata.
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword int timeout:
             Sets the server-side timeout for the operation in seconds. For more details see
             https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations.

sdk/storage/azure-storage-file-share/azure/storage/fileshare/aio/_share_service_client_async.py

@@ -283,9 +283,10 @@ async def create_share(
         which to interact with the newly created share.
 
         :param str share_name: The name of the share to create.
-        :keyword dict[str, str] metadata:
+        :keyword metadata:
             A dict with name_value pairs to associate with the
             share as metadata. Example:{'Category':'test'}
+        :paramtype metadata: Optional[dict[str, str]]
         :keyword int quota:
             Quota in bytes.
         :keyword int timeout: