BlobContainerClient.CreateIfNotExists Método

Definição

Namespace:

Azure.Storage.Blobs

Assembly:

Azure.Storage.Blobs.dll

Pacote:

Azure.Storage.Blobs v12.19.1

Origem:

BlobContainerClient.cs

A operação CreateIfNotExists(PublicAccessType, IDictionary<String,String>, BlobContainerEncryptionScopeOptions, CancellationToken) cria um novo contêiner sob a conta especificada. Se o contêiner com o mesmo nome já existir, ele não será alterado.

Para obter mais informações, consulte Criar Contêiner.

public virtual Azure.Response<Azure.Storage.Blobs.Models.BlobContainerInfo> CreateIfNotExists (Azure.Storage.Blobs.Models.PublicAccessType publicAccessType = Azure.Storage.Blobs.Models.PublicAccessType.None, System.Collections.Generic.IDictionary<string,string> metadata = default, Azure.Storage.Blobs.Models.BlobContainerEncryptionScopeOptions encryptionScopeOptions = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateIfNotExists : Azure.Storage.Blobs.Models.PublicAccessType * System.Collections.Generic.IDictionary<string, string> * Azure.Storage.Blobs.Models.BlobContainerEncryptionScopeOptions * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Blobs.Models.BlobContainerInfo>
override this.CreateIfNotExists : Azure.Storage.Blobs.Models.PublicAccessType * System.Collections.Generic.IDictionary<string, string> * Azure.Storage.Blobs.Models.BlobContainerEncryptionScopeOptions * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Blobs.Models.BlobContainerInfo>

Public Overridable Function CreateIfNotExists (Optional publicAccessType As PublicAccessType = Azure.Storage.Blobs.Models.PublicAccessType.None, Optional metadata As IDictionary(Of String, String) = Nothing, Optional encryptionScopeOptions As BlobContainerEncryptionScopeOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Response(Of BlobContainerInfo)

Parâmetros

publicAccessType

PublicAccessType

Opcionalmente, especifica se os dados no contêiner podem ser acessados publicamente e o nível de acesso. BlobContainer especifica o acesso de leitura público completo para dados de contêiner e blob. Os clientes podem enumerar os blobs no contêiner por meio de uma solicitação anônima, mas não podem enumerar os contêineres em uma conta de armazenamento. Blob especifica o acesso de leitura público para blobs. Os dados do blob nesse contêiner podem ser lidos por meio de solicitação anônima, mas os dados do contêiner não estão disponíveis. Os clientes não podem enumerar os blobs no contêiner por meio de uma solicitação anônima. None especifica que os dados do contêiner são privados para o proprietário da conta.

metadata

IDictionary<String,String>

Metadados personalizados opcionais a serem definidos para esse contêiner.

encryptionScopeOptions

BlobContainerEncryptionScopeOptions

Opções de escopo de criptografia opcionais a serem definidas para esse contêiner.

cancellationToken

CancellationToken

Opcional CancellationToken para propagar notificações de que a operação deve ser cancelada.

Retornos

Response<BlobContainerInfo>

Se o contêiner ainda não existir, um Response<T> que descreve o contêiner recém-criado. Se o contêiner já existir, null.

Comentários

Um RequestFailedException será gerado se ocorrer uma falha.