Azure / azure-sdk-for-net

This repository is for active development of the Azure SDK for .NET. For consumers of the SDK we recommend visiting our public developer docs at https://learn.microsoft.com/dotnet/azure/ or our versioned developer docs at https://azure.github.io/azure-sdk-for-net.
MIT License
5.48k stars 4.81k forks source link

Contradicting info with UploadAsync. #43137

Open tjohnson1010 opened 7 months ago

tjohnson1010 commented 7 months ago

Type of issue

Other (describe below)

Description

[Enter feedback here] Many of the methods allow you to overwrite the blob, but state they will error if the blob exists, then immediately describe what the method will do if it exists. Example: The UploadAsync(BinaryData) operation creates a new block blob or throws an exception if the blob already exists. Updating an existing block blob overwrites any existing metadata on the blob.

It does error when a string is passed, but not BinaryData or stream.

FYI: for String variant, the error returned is very confusing and wasn't clear this is not supported.

Page URL

https://learn.microsoft.com/en-us/dotnet/api/azure.storage.blobs.blobclient.uploadasync?view=azure-dotnet#azure-storage-blobs-blobclient-uploadasync(system-string)

Content source URL

https://github.com/Azure/azure-docs-sdk-dotnet/blob/master/xml/Azure.Storage.Blobs/BlobClient.xml

Document Version Independent Id

236218cc-38cb-0067-5cbf-1d36f63bbddf

Article author

@azure-sdk

Metadata

github-actions[bot] commented 7 months ago

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @xgithubtriage.