Partilhar via


CloudBlobContainer Classe

  • java.lang.Object
    • com.microsoft.azure.storage.blob.CloudBlobContainer

public class CloudBlobContainer

Representa um contêiner no serviço Blob do Microsoft Azure.

Diretórios de retenção de contêineres, que são encapsulados como objetos CloudBlobDirectory, e diretórios contêm blobs de blocos e blobs de páginas. Os diretórios também podem conter subdiretórios.

Resumo do campo

Modificador e tipo Campo e descrição
HashMap<String, String> metadata

Representa os metadados do contêiner.

Resumo do Construtor

Construtor Description
CloudBlobContainer(final StorageUri storageUri)

Cria uma instância da classe usando o URI especificado. O URI do blob deve incluir um token SAS, a menos que o acesso anônimo seja usado.

CloudBlobContainer(final StorageUri storageUri, final StorageCredentials credentials)

Cria uma instância da classe usando o StorageUri e as credenciais especificados.

CloudBlobContainer(final String containerName, final CloudBlobClient client)

Cria uma instância da classe usando o nome e o cliente especificados.

CloudBlobContainer(final URI uri)

Cria uma instância da classe usando o URI especificado. O URI do blob deve incluir um token SAS, a menos que o acesso anônimo seja usado.

CloudBlobContainer(final URI uri, final StorageCredentials credentials)

Cria uma instância da classe usando o URI e as credenciais especificados.

Resumo do método

Modificador e tipo Método e descrição
final String acquireLease()

Adquire uma nova concessão infinita no contêiner.

final String acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId)

Adquire uma nova concessão no contêiner com o tempo de concessão especificado e a ID de concessão proposta.

final String acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Adquire uma nova concessão no contêiner com o tempo de concessão especificado, a ID de concessão proposta, as opções de solicitação e o contexto de operação.

final long breakLease(final Integer breakPeriodInSeconds)

Interrompe a concessão e garante que outro cliente não possa adquirir uma nova concessão até que o período de concessão atual expire.

final long breakLease(final Integer breakPeriodInSeconds, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Interrompe a concessão existente, usando as opções de solicitação especificadas e o contexto de operação, e garante que outro cliente não possa adquirir uma nova concessão até que o período de concessão atual expire.

final String changeLease(final String proposedLeaseId, final AccessCondition accessCondition)

Altera a ID de concessão existente para a ID de concessão proposta.

final String changeLease(final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Altera a ID de concessão existente para a ID de concessão proposta com as condições de acesso, as opções de solicitação e o contexto de operação especificados.

void create()

Cria o contêiner.

void create(BlobContainerPublicAccessType accessType, BlobRequestOptions options, OperationContext opContext)

Cria o contêiner usando as opções especificadas e o contexto de operação.

void create(BlobRequestOptions options, OperationContext opContext)

Cria o contêiner usando as opções especificadas e o contexto de operação.

boolean createIfNotExists()

Cria o contêiner se ele não existir.

boolean createIfNotExists(BlobContainerPublicAccessType accessType, BlobRequestOptions options, OperationContext opContext)

Cria o contêiner se ele não existir, usando as opções de solicitação especificadas e o contexto de operação.

boolean createIfNotExists(BlobRequestOptions options, OperationContext opContext)

Cria o contêiner se ele não existir, usando as opções de solicitação especificadas e o contexto de operação.

void delete()

Exclui o contêiner.

void delete(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Exclui o contêiner usando as opções de solicitação especificadas e o contexto de operação.

boolean deleteIfExists()

Exclui o contêiner se ele existir.

boolean deleteIfExists(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Exclui o contêiner se ele existir usando as opções de solicitação e o contexto de operação especificados.

AccountInformation downloadAccountInfo()

Obtém informações relacionadas à conta de armazenamento na qual esse contêiner reside.

AccountInformation downloadAccountInfo(BlobRequestOptions options, OperationContext opContext)

Obtém informações relacionadas à conta de armazenamento na qual esse contêiner reside.

StorageRequest<ServiceClient, CloudBlobContainer, AccountInformation> downloadAccountInformationImpl(final RequestOptions options)
void downloadAttributes()

Baixa os atributos do contêiner, que consistem em metadados e propriedades.

void downloadAttributes(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Baixa os atributos do contêiner, que consistem em metadados e propriedades, usando as opções de solicitação e o contexto de operação especificados.

BlobContainerPermissions downloadPermissions()

Baixa as configurações de permissão para o contêiner.

BlobContainerPermissions downloadPermissions(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Baixa as configurações de permissões para o contêiner usando as opções de solicitação e o contexto de operação especificados.

boolean exists()

Retorna um valor que indica se o contêiner existe.

boolean exists(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Retorna um valor que indica se o contêiner existe, usando as opções de solicitação e o contexto de operação especificados.

String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier)

Retorna uma assinatura de acesso compartilhado para o contêiner. Observe que isso não contém o "?".

String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols)

Retorna uma assinatura de acesso compartilhado para o contêiner. Observe que isso não contém o "?".

CloudAppendBlob getAppendBlobReference(final String blobName)

Retorna uma referência a um CloudAppendBlob objeto que representa um blob de acréscimo nesse contêiner.

CloudAppendBlob getAppendBlobReference(final String blobName, final String snapshotID)

Retorna uma referência a um CloudAppendBlob objeto que representa um blob de acréscimo no contêiner, usando a ID de instantâneo especificada.

final CloudBlob getBlobReferenceFromServer(final String blobName)

Obtém uma referência a um blob neste contêiner. O blob já deve existir no serviço.

Ao contrário dos outros métodos get*Reference, esse método faz uma solicitação de serviço para recuperar os metadados e as propriedades do blob. O blob retornado pode ser usado diretamente como um CloudBlob ou convertido usando instanceof ou getProperties().getBlobType() para determinar seu subtipo.

final CloudBlob getBlobReferenceFromServer(final String blobName, final String snapshotID, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Obtém uma referência a um blob neste contêiner. O blob já deve existir no serviço.

Ao contrário dos outros métodos get*Reference, esse método faz uma solicitação de serviço para recuperar os metadados e as propriedades do blob. O blob retornado pode ser usado diretamente como um CloudBlob ou convertido usando instanceof ou getProperties().getBlobType() para determinar seu subtipo.

CloudBlockBlob getBlockBlobReference(final String blobName)

Retorna uma referência a um CloudBlockBlob objeto que representa um blob de blocos neste contêiner.

CloudBlockBlob getBlockBlobReference(final String blobName, final String snapshotID)

Retorna uma referência a um CloudBlockBlob objeto que representa um blob de blocos neste contêiner, usando a ID de instantâneo especificada.

CloudBlobDirectory getDirectoryReference(String directoryName)

Retorna uma referência a um CloudBlobDirectory objeto que representa um diretório de blob virtual dentro desse contêiner.

HashMap<String, String> getMetadata()

Retorna os metadados do contêiner. Esse valor é inicializado com os metadados da fila por uma chamada para downloadAttributes()e é definido na fila com uma chamada para uploadMetadata().

String getName()

Retorna o nome do contêiner.

CloudPageBlob getPageBlobReference(final String blobName)

Retorna uma referência a um CloudPageBlob objeto que representa um blob de páginas neste contêiner.

CloudPageBlob getPageBlobReference(final String blobName, final String snapshotID)

Retorna uma referência a um CloudPageBlob objeto que representa um blob de páginas no contêiner, usando a ID de instantâneo especificada.

BlobContainerProperties getProperties()

Retorna as propriedades do contêiner.

CloudBlobClient getServiceClient()

Retorna o cliente do serviço Blob associado a esse contêiner.

StorageUri getStorageUri()

Retorna a lista de URIs para todos os locais.

URI getUri()

Retorna o URI desse contêiner.

Iterable<ListBlobItem> listBlobs()

Retorna uma coleção enumerável de itens de blob para o contêiner.

Iterable<ListBlobItem> listBlobs(final String prefix)

Retorna uma coleção enumerável de itens de blob para o contêiner cujos nomes começam com o prefixo especificado.

Iterable<ListBlobItem> listBlobs(final String prefix, final boolean useFlatBlobListing)

Retorna uma coleção enumerável de itens de blob para o contêiner cujos nomes começam com o prefixo especificado usando a opção simples ou hierárquica especificada.

Iterable<ListBlobItem> listBlobs(final String prefix, final boolean useFlatBlobListing, final EnumSet<BlobListingDetails> listingDetails, BlobRequestOptions options, OperationContext opContext)

Retorna uma coleção enumerável de itens de blob para o contêiner cujos nomes começam com o prefixo especificado, usando a opção simples ou hierárquica especificada, listando opções de detalhes, opções de solicitação e contexto de operação.

ResultSegment<ListBlobItem> listBlobsSegmented()

Retorna um segmento de resultado de uma coleção enumerável de itens de blob no contêiner.

ResultSegment<ListBlobItem> listBlobsSegmented(final String prefix)

Retorna um segmento de resultado que contém uma coleção de itens de blob cujos nomes começam com o prefixo especificado.

ResultSegment<ListBlobItem> listBlobsSegmented(final String prefix, final boolean useFlatBlobListing, final EnumSet<BlobListingDetails> listingDetails, final Integer maxResults, final ResultContinuation continuationToken, BlobRequestOptions options, OperationContext opContext)

Retorna um segmento de resultado que contém uma coleção de itens de blob cujos nomes começam com o prefixo especificado, usando a opção simples ou hierárquica especificada, listando opções de detalhes, opções de solicitação e contexto de operação.

Iterable<CloudBlobContainer> listContainers()

Retorna uma coleção enumerável de contêineres para o cliente de serviço associado a esse contêiner.

Iterable<CloudBlobContainer> listContainers(final String prefix)

Retorna uma coleção enumerável de contêineres cujos nomes começam com o prefixo especificado para o cliente de serviço associado a esse contêiner.

Iterable<CloudBlobContainer> listContainers(final String prefix, final ContainerListingDetails detailsIncluded, final BlobRequestOptions options, final OperationContext opContext)

Retorna uma coleção enumerável de contêineres cujos nomes começam com o prefixo especificado para o cliente de serviço associado a esse contêiner, usando a configuração de detalhes especificada, as opções de solicitação e o contexto de operação.

ResultSegment<CloudBlobContainer> listContainersSegmented()

Retorna um segmento de resultado de uma coleção enumerável de contêineres para o cliente de serviço associado a esse contêiner.

ResultSegment<CloudBlobContainer> listContainersSegmented(final String prefix)

Retorna um segmento de resultado de uma coleção enumerável de contêineres cujos nomes começam com o prefixo especificado para o cliente de serviço associado a esse contêiner.

ResultSegment<CloudBlobContainer> listContainersSegmented(final String prefix, final ContainerListingDetails detailsIncluded, final Integer maxResults, final ResultContinuation continuationToken, final BlobRequestOptions options, final OperationContext opContext)

Retorna um segmento de resultado que contém uma coleção de contêineres cujos nomes começam com o prefixo especificado para o cliente de serviço associado a esse contêiner, usando as opções de detalhes de listagem especificadas, opções de solicitação e contexto de operação.

final void releaseLease(final AccessCondition accessCondition)

Libera a concessão no contêiner.

final void releaseLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Libera a concessão no contêiner usando as condições de acesso, as opções de solicitação e o contexto de operação especificados.

final void renewLease(final AccessCondition accessCondition)

Renova uma concessão existente com as condições de acesso especificadas.

final void renewLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Renova uma concessão existente com as condições de acesso, as opções de solicitação e o contexto de operação especificados.

void setMetadata(final HashMap<String, String> metadata)

Define a coleção de metadados de pares nome-valor a ser definida no contêiner com uma uploadMetadata() chamada. Essa coleção substituirá todos os metadados de contêiner existentes. Se isso estiver definido como uma coleção vazia, os metadados do contêiner serão limpos em uma uploadMetadata() chamada.

void setProperties(final BlobContainerProperties properties)

Define as propriedades do contêiner.

void setStorageUri(final StorageUri storageUri)

Define a lista de URIs para todos os locais.

void uploadMetadata()

Carrega os metadados do contêiner.

void uploadMetadata(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Carrega os metadados do contêiner usando as opções de solicitação especificadas e o contexto de operação.

void uploadPermissions(final BlobContainerPermissions permissions)

Carrega as permissões do contêiner.

void uploadPermissions(final BlobContainerPermissions permissions, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Carrega as permissões do contêiner usando as opções de solicitação especificadas e o contexto de operação.

Detalhes do campo

metadata

protected HashMap metadata= new HashMap()

Representa os metadados do contêiner.

Detalhes do construtor

CloudBlobContainer

public CloudBlobContainer(final StorageUri storageUri)

Cria uma instância da classe usando o URI especificado. O URI do blob deve incluir um token SAS, a menos que o acesso anônimo seja usado.

Parameters:

storageUri - Um StorageUri objeto que representa o URI do contêiner.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

CloudBlobContainer

public CloudBlobContainer(final StorageUri storageUri, final StorageCredentials credentials)

Cria uma instância da classe usando o StorageUri e as credenciais especificados.

Parameters:

storageUri - Um StorageUri objeto que representa o StorageUri absoluto do contêiner.
credentials - Um StorageCredentials objeto usado para autenticar o acesso.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

CloudBlobContainer

protected CloudBlobContainer(final String containerName, final CloudBlobClient client)

Cria uma instância da classe usando o nome e o cliente especificados.

Parameters:

containerName - Um String que representa o nome do contêiner, que deve aderir às regras de nomenclatura de contêiner. O nome do contêiner não deve incluir nenhum caractere separador de caminho (/). Os nomes de contêiner devem estar em minúsculas, entre 3 e 63 caracteres e devem começar com uma letra ou número. Os nomes de contêiner podem conter apenas letras, números e o caractere traço (-).
client - Um CloudBlobClient objeto que representa o cliente de serviço associado e que especifica o ponto de extremidade para o serviço Blob. *

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.
URISyntaxException - Se o URI do recurso construído com base no containerName for inválido.

CloudBlobContainer

public CloudBlobContainer(final URI uri)

Cria uma instância da classe usando o URI especificado. O URI do blob deve incluir um token SAS, a menos que o acesso anônimo seja usado.

Parameters:

uri - Um java.net.URI objeto que representa o URI do contêiner.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

CloudBlobContainer

public CloudBlobContainer(final URI uri, final StorageCredentials credentials)

Cria uma instância da classe usando o URI e as credenciais especificados.

Parameters:

uri - Um java.net.URI objeto que representa o URI absoluto do contêiner.
credentials - Um StorageCredentials objeto usado para autenticar o acesso.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

Detalhes do método

acquireLease

public final String acquireLease()

Adquire uma nova concessão infinita no contêiner.

Returns:

Um String que representa a ID de concessão.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

acquireLease

public final String acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId)

Adquire uma nova concessão no contêiner com o tempo de concessão especificado e a ID de concessão proposta.

Parameters:

leaseTimeInSeconds - Um Integer que especifica o período de tempo para o qual adquirir a concessão, em segundos. Se for nulo, uma concessão infinita será adquirida. Se não for nulo, o valor deverá ser maior que zero.
proposedLeaseId - Um String valor que representa a ID de concessão proposta para a nova concessão ou nula se nenhuma ID de concessão for proposta.

Returns:

Um String que representa a ID de concessão.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

acquireLease

public final String acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Adquire uma nova concessão no contêiner com o tempo de concessão especificado, a ID de concessão proposta, as opções de solicitação e o contexto de operação.

Parameters:

leaseTimeInSeconds - Um Integer que especifica o período de tempo para o qual adquirir a concessão, em segundos. Se for nulo, uma concessão infinita será adquirida. Se não for nulo, o valor deverá ser maior que zero.
proposedLeaseId - Um String valor que representa a ID de concessão proposta para a nova concessão ou nula se nenhuma ID de concessão for proposta.
accessCondition - Um objeto AccessCondition que representa a condição de acesso do contêiner.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado (CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. O contexto é usado para acompanhar solicitações para o serviço de armazenamento e para fornecer informações adicionais de runtime sobre a operação.

Returns:

Um String que representa a ID de concessão.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

breakLease

public final long breakLease(final Integer breakPeriodInSeconds)

Interrompe a concessão e garante que outro cliente não possa adquirir uma nova concessão até que o período de concessão atual expire.

Parameters:

breakPeriodInSeconds - Um Integer que especifica o tempo de espera, em segundos, até que a concessão atual seja interrompida. Se null, o ponto de interrupção é o restante da concessão atual ou zero para concessão infinita.

Returns:

O tempo, em segundos, restante no período de concessão.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

breakLease

public final long breakLease(final Integer breakPeriodInSeconds, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Interrompe a concessão existente, usando as opções de solicitação especificadas e o contexto de operação, e garante que outro cliente não possa adquirir uma nova concessão até que o período de concessão atual expire.

Parameters:

breakPeriodInSeconds - Um Integer que especifica o tempo de espera, em segundos, até que a concessão atual seja interrompida. Se null, o ponto de interrupção é o restante da concessão atual ou zero para concessão infinita.
accessCondition - Um objeto AccessCondition que representa as condições de acesso para o blob.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado (CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. O contexto é usado para acompanhar solicitações para o serviço de armazenamento e para fornecer informações adicionais de runtime sobre a operação.

Returns:

O tempo, em segundos, restante no período de concessão.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

changeLease

public final String changeLease(final String proposedLeaseId, final AccessCondition accessCondition)

Altera a ID de concessão existente para a ID de concessão proposta.

Parameters:

proposedLeaseId - Um String valor que representa a ID de concessão proposta para a nova concessão ou nula se nenhuma ID de concessão for proposta.
accessCondition - Um objeto AccessCondition que representa as condições de acesso para o blob. A ID de concessão é necessária para ser definida com uma condição de acesso.

Returns:

Um String que representa a nova ID de concessão.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

changeLease

public final String changeLease(final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Altera a ID de concessão existente para a ID de concessão proposta com as condições de acesso, as opções de solicitação e o contexto de operação especificados.

Parameters:

proposedLeaseId - Um String que representa a ID de concessão proposta para a nova concessão. Isso não pode ser nulo.
accessCondition - Um objeto AccessCondition que representa as condições de acesso para o blob. A ID de concessão é necessária para ser definida com uma condição de acesso.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado (CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. O contexto é usado para acompanhar solicitações para o serviço de armazenamento e para fornecer informações adicionais de runtime sobre a operação.

Returns:

Um String que representa a nova ID de concessão.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

create

public void create()

Cria o contêiner.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

create

public void create(BlobContainerPublicAccessType accessType, BlobRequestOptions options, OperationContext opContext)

Cria o contêiner usando as opções especificadas e o contexto de operação.

Parameters:

accessType - Um BlobContainerPublicAccessType objeto que especifica se os dados no contêiner podem ser acessados publicamente e qual nível de acesso deve ser permitido.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

create

public void create(BlobRequestOptions options, OperationContext opContext)

Cria o contêiner usando as opções especificadas e o contexto de operação.

Parameters:

options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

createIfNotExists

public boolean createIfNotExists()

Cria o contêiner se ele não existir.

Returns:

true se o contêiner ainda não existia e foi criado; caso contrário, false.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

createIfNotExists

public boolean createIfNotExists(BlobContainerPublicAccessType accessType, BlobRequestOptions options, OperationContext opContext)

Cria o contêiner se ele não existir, usando as opções de solicitação especificadas e o contexto de operação.

Parameters:

accessType - Um BlobContainerPublicAccessType objeto que especifica se os dados no contêiner podem ser acessados publicamente e qual nível de acesso deve ser permitido.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado (CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

true se o contêiner ainda não existia e foi criado; caso contrário, false.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

createIfNotExists

public boolean createIfNotExists(BlobRequestOptions options, OperationContext opContext)

Cria o contêiner se ele não existir, usando as opções de solicitação especificadas e o contexto de operação.

Parameters:

options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado (CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

true se o contêiner ainda não existia e foi criado; caso contrário, false.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

delete

public void delete()

Exclui o contêiner.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

delete

public void delete(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Exclui o contêiner usando as opções de solicitação especificadas e o contexto de operação.

Parameters:

accessCondition - Um objeto AccessCondition que representa a condição de acesso do contêiner.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

deleteIfExists

public boolean deleteIfExists()

Exclui o contêiner se ele existir.

Returns:

true se o contêiner ainda não existia e foi criado; caso contrário, false.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

deleteIfExists

public boolean deleteIfExists(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Exclui o contêiner se ele existir usando as opções de solicitação e o contexto de operação especificados.

Parameters:

accessCondition - Um objeto AccessCondition que representa a condição de acesso do contêiner.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

true se o contêiner existia e foi excluído; caso contrário, false.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

downloadAccountInfo

public AccountInformation downloadAccountInfo()

Obtém informações relacionadas à conta de armazenamento na qual esse contêiner reside.

Returns:

Um AccountInformation objeto para a conta de armazenamento fornecida.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

downloadAccountInfo

public AccountInformation downloadAccountInfo(BlobRequestOptions options, OperationContext opContext)

Obtém informações relacionadas à conta de armazenamento na qual esse contêiner reside.

Parameters:

options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

Um AccountInformation objeto para a conta de armazenamento fornecida.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

downloadAccountInformationImpl

protected StorageRequest downloadAccountInformationImpl(final RequestOptions options)

Parameters:

options

downloadAttributes

public void downloadAttributes()

Baixa os atributos do contêiner, que consistem em metadados e propriedades.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

downloadAttributes

public void downloadAttributes(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Baixa os atributos do contêiner, que consistem em metadados e propriedades, usando as opções de solicitação e o contexto de operação especificados.

Parameters:

accessCondition - Um objeto AccessCondition que representa a condição de acesso do contêiner.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

downloadPermissions

public BlobContainerPermissions downloadPermissions()

Baixa as configurações de permissão para o contêiner.

Returns:

Um BlobContainerPermissions objeto que representa as permissões do contêiner.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

downloadPermissions

public BlobContainerPermissions downloadPermissions(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Baixa as configurações de permissões para o contêiner usando as opções de solicitação e o contexto de operação especificados.

Parameters:

accessCondition - Um objeto AccessCondition que representa a condição de acesso do contêiner.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

Um BlobContainerPermissions objeto que representa as permissões do contêiner.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

exists

public boolean exists()

Retorna um valor que indica se o contêiner existe.

Returns:

true se o contêiner existir, caso contrário false, .

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

exists

public boolean exists(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Retorna um valor que indica se o contêiner existe, usando as opções de solicitação e o contexto de operação especificados.

Parameters:

accessCondition - Um objeto AccessCondition que representa a condição de acesso do contêiner.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

true se o contêiner existir, caso contrário false, .

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

generateSharedAccessSignature

public String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier)

Retorna uma assinatura de acesso compartilhado para o contêiner. Observe que isso não contém o "?".

Parameters:

policy - Um SharedAccessBlobPolicy objeto que representa a política de acesso para a assinatura de acesso compartilhado.
groupPolicyIdentifier - Um String que representa a política de acesso no nível do contêiner.

Returns:

Um String que representa uma assinatura de acesso compartilhado para o contêiner.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.
InvalidKeyException - Se a chave for inválida.

generateSharedAccessSignature

public String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols)

Retorna uma assinatura de acesso compartilhado para o contêiner. Observe que isso não contém o "?".

Parameters:

policy - Um SharedAccessBlobPolicy objeto que representa a política de acesso para a assinatura de acesso compartilhado.
groupPolicyIdentifier - Um String que representa a política de acesso no nível do contêiner.
ipRange - Um IPRange objeto que contém o intervalo de endereços IP permitidos.
protocols - Um SharedAccessProtocols que representa os protocolos de Internet permitidos.

Returns:

Um String que representa uma assinatura de acesso compartilhado para o contêiner.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.
InvalidKeyException - Se a chave for inválida.

getAppendBlobReference

public CloudAppendBlob getAppendBlobReference(final String blobName)

Retorna uma referência a um CloudAppendBlob objeto que representa um blob de acréscimo nesse contêiner.

Parameters:

blobName - Um String que representa o nome do blob.

Returns:

Um CloudAppendBlob objeto que representa uma referência ao blob de acréscimo especificado.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.
URISyntaxException - Se o URI do recurso for inválido.

getAppendBlobReference

public CloudAppendBlob getAppendBlobReference(final String blobName, final String snapshotID)

Retorna uma referência a um CloudAppendBlob objeto que representa um blob de acréscimo no contêiner, usando a ID de instantâneo especificada.

Parameters:

blobName - Um String que representa o nome do blob.
snapshotID - Um String que representa a ID de instantâneo do blob.

Returns:

Um CloudAppendBlob objeto que representa uma referência ao blob de acréscimo especificado.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.
URISyntaxException - Se o URI do recurso for inválido.

getBlobReferenceFromServer

public final CloudBlob getBlobReferenceFromServer(final String blobName)

Obtém uma referência a um blob neste contêiner. O blob já deve existir no serviço.

Ao contrário dos outros métodos get*Reference, esse método faz uma solicitação de serviço para recuperar os metadados e as propriedades do blob. O blob retornado pode ser usado diretamente como um CloudBlob ou convertido usando instanceof ou getProperties().getBlobType() para determinar seu subtipo.

Parameters:

blobName - Um String que representa o nome do blob.

Returns:

Um CloudBlob objeto que representa uma referência ao blob especificado.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.
URISyntaxException - Se o URI do recurso for inválido.

getBlobReferenceFromServer

public final CloudBlob getBlobReferenceFromServer(final String blobName, final String snapshotID, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Obtém uma referência a um blob neste contêiner. O blob já deve existir no serviço.

Ao contrário dos outros métodos get*Reference, esse método faz uma solicitação de serviço para recuperar os metadados e as propriedades do blob. O blob retornado pode ser usado diretamente como um CloudBlob ou convertido usando instanceof ou getProperties().getBlobType() para determinar seu subtipo.

Parameters:

blobName - Um String que representa o nome do blob.
snapshotID - Um String que representa a ID de instantâneo do blob.
accessCondition - Um objeto AccessCondition que representa as condições de acesso para o blob.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

Um CloudBlob objeto que representa uma referência ao blob especificado.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.
URISyntaxException - Se o URI do recurso for inválido.

getBlockBlobReference

public CloudBlockBlob getBlockBlobReference(final String blobName)

Retorna uma referência a um CloudBlockBlob objeto que representa um blob de blocos neste contêiner.

Parameters:

blobName - Um String que representa o nome do blob.

Returns:

Um CloudBlockBlob objeto que representa uma referência ao blob de bloco especificado.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.
URISyntaxException - Se o URI do recurso for inválido.

getBlockBlobReference

public CloudBlockBlob getBlockBlobReference(final String blobName, final String snapshotID)

Retorna uma referência a um CloudBlockBlob objeto que representa um blob de blocos neste contêiner, usando a ID de instantâneo especificada.

Parameters:

blobName - Um String que representa o nome do blob.
snapshotID - Um String que representa a ID de instantâneo do blob.

Returns:

Um CloudBlockBlob objeto que representa uma referência ao blob de bloco especificado.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.
URISyntaxException - Se o URI do recurso for inválido.

getDirectoryReference

public CloudBlobDirectory getDirectoryReference(String directoryName)

Retorna uma referência a um CloudBlobDirectory objeto que representa um diretório de blob virtual dentro desse contêiner.

Parameters:

directoryName - Um String que representa o nome do diretório de blob virtual. Se o diretório raiz (o diretório que representa o próprio contêiner) for desejado, use uma cadeia de caracteres vazia.

Returns:

Um CloudBlobDirectory que representa um diretório de blob virtual dentro desse contêiner.

Throws:

URISyntaxException - Se o URI do recurso for inválido.

getMetadata

public HashMap getMetadata()

Retorna os metadados do contêiner. Esse valor é inicializado com os metadados da fila por uma chamada para downloadAttributes()e é definido na fila com uma chamada para uploadMetadata().

Returns:

Um java.util.HashMap objeto que representa os metadados do contêiner.

getName

public String getName()

Retorna o nome do contêiner.

Returns:

Um String que representa o nome do contêiner.

getPageBlobReference

public CloudPageBlob getPageBlobReference(final String blobName)

Retorna uma referência a um CloudPageBlob objeto que representa um blob de páginas neste contêiner.

Parameters:

blobName - Um String que representa o nome do blob.

Returns:

Um CloudPageBlob objeto que representa uma referência ao blob de página especificado.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.
URISyntaxException - Se o URI do recurso for inválido.

getPageBlobReference

public CloudPageBlob getPageBlobReference(final String blobName, final String snapshotID)

Retorna uma referência a um CloudPageBlob objeto que representa um blob de páginas no contêiner, usando a ID de instantâneo especificada.

Parameters:

blobName - Um String que representa o nome do blob.
snapshotID - Um String que representa a ID de instantâneo do blob.

Returns:

Um CloudPageBlob objeto que representa uma referência ao blob de página especificado.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.
URISyntaxException - Se o URI do recurso for inválido.

getProperties

public BlobContainerProperties getProperties()

Retorna as propriedades do contêiner.

Returns:

Um BlobContainerProperties objeto que representa as propriedades do contêiner.

getServiceClient

public CloudBlobClient getServiceClient()

Retorna o cliente do serviço Blob associado a esse contêiner.

Returns:

Um CloudBlobClient objeto que representa o cliente de serviço associado a esse contêiner.

getStorageUri

public StorageUri getStorageUri()

Retorna a lista de URIs para todos os locais.

Returns:

Um StorageUri objeto que representa a lista de URIs para todos os locais..

getUri

public URI getUri()

Retorna o URI desse contêiner.

Returns:

O URI absoluto para o contêiner.

listBlobs

public Iterable listBlobs()

Retorna uma coleção enumerável de itens de blob para o contêiner.

Returns:

Uma coleção enumerável de ListBlobItem objetos recuperados de forma preguiçosa que representa os itens neste contêiner.

listBlobs

public Iterable listBlobs(final String prefix)

Retorna uma coleção enumerável de itens de blob para o contêiner cujos nomes começam com o prefixo especificado.

Parameters:

prefix - Um String que representa o prefixo de nome de blob. Esse valor deve ser precedido pelo nome do contêiner ou pelo caminho absoluto para o contêiner.

Returns:

Uma coleção enumerável de ListBlobItem objetos recuperados de forma preguiçosa que representa os itens cujos nomes começam com o prefixo especificado neste contêiner.

listBlobs

public Iterable listBlobs(final String prefix, final boolean useFlatBlobListing)

Retorna uma coleção enumerável de itens de blob para o contêiner cujos nomes começam com o prefixo especificado usando a opção simples ou hierárquica especificada.

Parameters:

prefix - Um String que representa o prefixo de nome de blob. Esse valor deve ser precedido pelo nome do contêiner ou pelo caminho absoluto para o contêiner.
useFlatBlobListing -

true para indicar que a lista retornada será simples; false para indicar que a lista retornada será hierárquica.

Returns:

Uma coleção enumerável de ListBlobItem objetos recuperados de forma preguiçosa que representa os itens cujos nomes começam com o prefixo especificado neste contêiner.

listBlobs

public Iterable listBlobs(final String prefix, final boolean useFlatBlobListing, final EnumSet listingDetails, BlobRequestOptions options, OperationContext opContext)

Retorna uma coleção enumerável de itens de blob para o contêiner cujos nomes começam com o prefixo especificado, usando a opção simples ou hierárquica especificada, listando opções de detalhes, opções de solicitação e contexto de operação.

Parameters:

prefix - Um String que representa o prefixo de nome de blob. Esse valor deve ser precedido pelo nome do contêiner ou pelo caminho absoluto para o contêiner.
useFlatBlobListing -

true para indicar que a lista retornada será simples; false para indicar que a lista retornada será hierárquica.

listingDetails - Um java.util.EnumSet objeto que contém BlobListingDetails valores que indicam se instantâneos, blobs excluídos temporariamente, metadados e/ou blocos não confirmados são retornados. Os blocos confirmados sempre são retornados.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

Uma coleção enumerável de ListBlobItem objetos recuperados de forma preguiçosa que representa os itens cujos nomes começam com o prefixo especificado neste contêiner.

listBlobsSegmented

public ResultSegment listBlobsSegmented()

Retorna um segmento de resultado de uma coleção enumerável de itens de blob no contêiner.

Returns:

Um ResultSegment<T> objeto que contém um segmento da coleção enumerável de ListBlobItem objetos que representam os itens de blob no contêiner.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

listBlobsSegmented

public ResultSegment listBlobsSegmented(final String prefix)

Retorna um segmento de resultado que contém uma coleção de itens de blob cujos nomes começam com o prefixo especificado.

Parameters:

prefix - Um String que representa o prefixo do nome do blob.

Returns:

Um ResultSegment<T> objeto que contém um segmento da coleção enumerável de ListBlobItem objetos que representam os itens de blob cujos nomes começam com o prefixo especificado no contêiner.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

listBlobsSegmented

public ResultSegment listBlobsSegmented(final String prefix, final boolean useFlatBlobListing, final EnumSet listingDetails, final Integer maxResults, final ResultContinuation continuationToken, BlobRequestOptions options, OperationContext opContext)

Retorna um segmento de resultado que contém uma coleção de itens de blob cujos nomes começam com o prefixo especificado, usando a opção simples ou hierárquica especificada, listando opções de detalhes, opções de solicitação e contexto de operação.

Parameters:

prefix - Um String que representa o prefixo do nome do blob.
useFlatBlobListing -

true para indicar que a lista retornada será simples; false para indicar que a lista retornada será hierárquica.

listingDetails - Um java.util.EnumSet objeto que contém BlobListingDetails valores que indicam se instantâneos, blobs excluídos temporariamente, metadados e/ou blocos não confirmados são retornados. Os blocos confirmados sempre são retornados.
maxResults - O número máximo de resultados a serem recuperados. Se null ou maior que 5000, o servidor retornará até 5.000 itens. Deve ser pelo menos 1.
continuationToken - Um ResultContinuation objeto que representa um token de continuação retornado por uma operação de listagem anterior.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado (CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

Um ResultSegment<T> objeto que contém um segmento da coleção enumerável de ListBlobItem objetos que representam os itens de bloco cujos nomes começam com o prefixo especificado no contêiner.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

listContainers

public Iterable listContainers()

Retorna uma coleção enumerável de contêineres para o cliente de serviço associado a esse contêiner.

Returns:

Uma coleção enumerável de CloudBlobContainer objetos recuperados de forma preguiçosa que representam os contêineres para o cliente de serviço associado a esse contêiner.

listContainers

public Iterable listContainers(final String prefix)

Retorna uma coleção enumerável de contêineres cujos nomes começam com o prefixo especificado para o cliente de serviço associado a esse contêiner.

Parameters:

prefix - Um String que representa o prefixo do nome do contêiner.

Returns:

Uma coleção enumerável de CloudBlobContainer objetos recuperados lentamente que representam os contêineres cujos nomes começam com o prefixo especificado para o cliente de serviço associado a esse contêiner.

listContainers

public Iterable listContainers(final String prefix, final ContainerListingDetails detailsIncluded, final BlobRequestOptions options, final OperationContext opContext)

Retorna uma coleção enumerável de contêineres cujos nomes começam com o prefixo especificado para o cliente de serviço associado a esse contêiner, usando a configuração de detalhes especificada, as opções de solicitação e o contexto de operação.

Parameters:

prefix - Um String que representa o prefixo do nome do contêiner.
detailsIncluded - Um ContainerListingDetails valor que indica se os metadados de contêiner serão retornados.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

Uma coleção enumerável de CloudBlobContainer objetos recuperados de forma preguiçosa que representa os contêineres para o cliente de serviço associado a esse contêiner.

listContainersSegmented

public ResultSegment listContainersSegmented()

Retorna um segmento de resultado de uma coleção enumerável de contêineres para o cliente de serviço associado a esse contêiner.

Returns:

Um ResultSegment<T> objeto que contém um segmento da coleção enumerável de CloudBlobContainer objetos que representam os contêineres para o cliente de serviço associado a esse contêiner.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

listContainersSegmented

public ResultSegment listContainersSegmented(final String prefix)

Retorna um segmento de resultado de uma coleção enumerável de contêineres cujos nomes começam com o prefixo especificado para o cliente de serviço associado a esse contêiner.

Parameters:

prefix - Um String que representa o prefixo de nome de blob.

Returns:

Um ResultSegment<T> objeto que contém um segmento da coleção enumerável de CloudBlobContainer objetos que representam os contêineres cujos nomes começam com o prefixo especificado para o cliente de serviço associado a esse contêiner.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

listContainersSegmented

public ResultSegment listContainersSegmented(final String prefix, final ContainerListingDetails detailsIncluded, final Integer maxResults, final ResultContinuation continuationToken, final BlobRequestOptions options, final OperationContext opContext)

Retorna um segmento de resultado que contém uma coleção de contêineres cujos nomes começam com o prefixo especificado para o cliente de serviço associado a esse contêiner, usando as opções de detalhes de listagem especificadas, opções de solicitação e contexto de operação.

Parameters:

prefix - Um String que representa o prefixo do nome do contêiner.
detailsIncluded - Um ContainerListingDetails objeto que indica se os metadados estão incluídos.
maxResults - O número máximo de resultados a serem recuperados. Se null ou maior que 5000, o servidor retornará até 5.000 itens. Deve ser pelo menos 1.
continuationToken - Um ResultContinuation objeto que representa um token de continuação retornado por uma operação de listagem anterior.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

Um ResultSegment<T> objeto que contém um segmento da coleção enumerável de CloudBlobContainer objetos que representam os contêineres cujos nomes começam com o prefixo especificado para o cliente de serviço associado a esse contêiner.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

releaseLease

public final void releaseLease(final AccessCondition accessCondition)

Libera a concessão no contêiner.

Parameters:

accessCondition - Um objeto AccessCondition que representa as condições de acesso para o blob. A ID de concessão é necessária para ser definida com uma condição de acesso.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

releaseLease

public final void releaseLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Libera a concessão no contêiner usando as condições de acesso, as opções de solicitação e o contexto de operação especificados.

Parameters:

accessCondition - Um objeto AccessCondition que representa as condições de acesso para o blob. A ID de concessão é necessária para ser definida com uma condição de acesso.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado (CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. O contexto é usado para acompanhar solicitações para o serviço de armazenamento e para fornecer informações adicionais de runtime sobre a operação.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

renewLease

public final void renewLease(final AccessCondition accessCondition)

Renova uma concessão existente com as condições de acesso especificadas.

Parameters:

accessCondition - Um objeto AccessCondition que representa a condição de acesso do contêiner. A ID de concessão é necessária para ser definida com uma condição de acesso.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

renewLease

public final void renewLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Renova uma concessão existente com as condições de acesso, as opções de solicitação e o contexto de operação especificados.

Parameters:

accessCondition - Um objeto AccessCondition que representa as condições de acesso para o blob. A ID de concessão é necessária para ser definida com uma condição de acesso.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado (CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. O contexto é usado para acompanhar solicitações para o serviço de armazenamento e para fornecer informações adicionais de runtime sobre a operação.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

setMetadata

public void setMetadata(final HashMap metadata)

Define a coleção de metadados de pares nome-valor a ser definida no contêiner com uma uploadMetadata() chamada. Essa coleção substituirá todos os metadados de contêiner existentes. Se isso estiver definido como uma coleção vazia, os metadados do contêiner serão limpos em uma uploadMetadata() chamada.

Parameters:

metadata - Um java.util.HashMap objeto que representa os metadados atribuídos ao contêiner.

setProperties

protected void setProperties(final BlobContainerProperties properties)

Define as propriedades do contêiner.

Parameters:

properties - Um BlobContainerProperties objeto que representa as propriedades que estão sendo atribuídas ao contêiner.

setStorageUri

protected void setStorageUri(final StorageUri storageUri)

Define a lista de URIs para todos os locais.

Parameters:

storageUri - Um StorageUri objeto que representa a lista de URIs para todos os locais.

uploadMetadata

public void uploadMetadata()

Carrega os metadados do contêiner.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

uploadMetadata

public void uploadMetadata(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Carrega os metadados do contêiner usando as opções de solicitação especificadas e o contexto de operação.

Parameters:

accessCondition - Um objeto AccessCondition que representa a condição de acesso do contêiner.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

uploadPermissions

public void uploadPermissions(final BlobContainerPermissions permissions)

Carrega as permissões do contêiner.

Parameters:

permissions - Um BlobContainerPermissions objeto que representa as permissões para carregar.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

uploadPermissions

public void uploadPermissions(final BlobContainerPermissions permissions, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Carrega as permissões do contêiner usando as opções de solicitação especificadas e o contexto de operação.

Parameters:

permissions - Um BlobContainerPermissions objeto que representa as permissões para carregar.
accessCondition - Um objeto AccessCondition que representa a condição de acesso do contêiner.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

Aplica-se a