你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
BlobServiceClient.CreateBlobContainerAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
该 CreateBlobContainerAsync(String, PublicAccessType, IDictionary<String,String>, CancellationToken) 操作在指定的帐户下创建新的 Blob 容器。 如果已存在同名的容器,操作将失败。
有关详细信息,请参阅 创建容器。
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.BlobContainerClient>> CreateBlobContainerAsync (string blobContainerName, Azure.Storage.Blobs.Models.PublicAccessType publicAccessType = Azure.Storage.Blobs.Models.PublicAccessType.None, System.Collections.Generic.IDictionary<string,string> metadata = default, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateBlobContainerAsync : string * Azure.Storage.Blobs.Models.PublicAccessType * System.Collections.Generic.IDictionary<string, string> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.BlobContainerClient>>
override this.CreateBlobContainerAsync : string * Azure.Storage.Blobs.Models.PublicAccessType * System.Collections.Generic.IDictionary<string, string> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.BlobContainerClient>>
Public Overridable Function CreateBlobContainerAsync (blobContainerName As String, Optional publicAccessType As PublicAccessType = Azure.Storage.Blobs.Models.PublicAccessType.None, Optional metadata As IDictionary(Of String, String) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of BlobContainerClient))
参数
- blobContainerName
- String
要创建的容器的名称。
- publicAccessType
- PublicAccessType
(可选)指定是否可以公开访问容器中的数据以及访问级别。 BlobContainer 指定容器和 Blob 数据的完全公共读取访问权限。 客户端可以通过匿名请求枚举容器中的 Blob,但无法枚举存储帐户中的容器。 Blob 指定 Blob 的公共读取访问权限。 可以通过匿名请求读取此容器中的 Blob 数据,但容器数据不可用。 客户端无法通过匿名请求枚举容器中的 Blob。 None 指定容器数据对帐户所有者是私有的。
- metadata
- IDictionary<String,String>
要为此容器设置的可选自定义元数据。
- cancellationToken
- CancellationToken
可选 CancellationToken ,用于传播应取消操作的通知。
返回
Response<T>引用新创建的容器的 。
注解
RequestFailedException如果发生故障,将引发 。