CloudBlobContainer Classe
- java.
lang. Object - com.
microsoft. azure. storage. blob. CloudBlobContainer
- com.
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. |
Account |
downloadAccountInfo()
Obtém informações relacionadas à conta de armazenamento na qual esse contêiner reside. |
Account |
downloadAccountInfo(BlobRequestOptions options, OperationContext opContext)
Obtém informações relacionadas à conta de armazenamento na qual esse contêiner reside. |
Storage |
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. |
Blob |
downloadPermissions()
Baixa as configurações de permissão para o contêiner. |
Blob |
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 "?". |
Cloud |
getAppendBlobReference(final String blobName)
Retorna uma referência a um CloudAppendBlob objeto que representa um blob de acréscimo nesse contêiner. |
Cloud |
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 Cloud |
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 Cloud |
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. |
Cloud |
getBlockBlobReference(final String blobName)
Retorna uma referência a um CloudBlockBlob objeto que representa um blob de blocos neste contêiner. |
Cloud |
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. |
Cloud |
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. |
Cloud |
getPageBlobReference(final String blobName)
Retorna uma referência a um CloudPageBlob objeto que representa um blob de páginas neste contêiner. |
Cloud |
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. |
Blob |
getProperties()
Retorna as propriedades do contêiner. |
Cloud |
getServiceClient()
Retorna o cliente do serviço Blob associado a esse contêiner. |
Storage |
getStorageUri()
Retorna a lista de URIs para todos os locais. |
URI |
getUri()
Retorna o URI desse contêiner. |
Iterable<List |
listBlobs()
Retorna uma coleção enumerável de itens de blob para o contêiner. |
Iterable<List |
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<List |
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<List |
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. |
Result |
listBlobsSegmented()
Retorna um segmento de resultado de uma coleção enumerável de itens de blob no contêiner. |
Result |
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. |
Result |
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<Cloud |
listContainers()
Retorna uma coleção enumerável de contêineres para o cliente de serviço associado a esse contêiner. |
Iterable<Cloud |
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<Cloud |
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. |
Result |
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. |
Result |
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. |
Result |
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
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:
Throws:
CloudBlobContainer
public CloudBlobContainer(final StorageUri storageUri, final StorageCredentials credentials)
Cria uma instância da classe usando o StorageUri e as credenciais especificados.
Parameters:
Throws:
CloudBlobContainer
protected CloudBlobContainer(final String containerName, final CloudBlobClient client)
Cria uma instância da classe usando o nome e o cliente especificados.
Parameters:
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 (-).
Throws:
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:
java.net.URI
objeto que representa o URI do contêiner.
Throws:
CloudBlobContainer
public CloudBlobContainer(final URI uri, final StorageCredentials credentials)
Cria uma instância da classe usando o URI e as credenciais especificados.
Parameters:
java.net.URI
objeto que representa o URI absoluto do contêiner.
Throws:
Detalhes do método
acquireLease
public final String acquireLease()
Adquire uma nova concessão infinita no contêiner.
Returns:
String
que representa a ID de concessão.Throws:
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:
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.
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:
String
que representa a ID de concessão.Throws:
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:
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.
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.
null
usará as opções de solicitação padrão do cliente de serviço associado (CloudBlobClient).
Returns:
String
que representa a ID de concessão.Throws:
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:
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:
Throws:
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:
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.
null
usará as opções de solicitação padrão do cliente de serviço associado (CloudBlobClient).
Returns:
Throws:
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:
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:
String
que representa a nova ID de concessão.Throws:
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:
String
que representa a ID de concessão proposta para a nova concessão. Isso não pode ser nulo.
null
usará as opções de solicitação padrão do cliente de serviço associado (CloudBlobClient).
Returns:
String
que representa a nova ID de concessão.Throws:
create
public void create()
Cria o contêiner.
Throws:
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:
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
Throws:
create
public void create(BlobRequestOptions options, OperationContext opContext)
Cria o contêiner usando as opções especificadas e o contexto de operação.
Parameters:
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
Throws:
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:
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:
null
usará as opções de solicitação padrão do cliente de serviço associado (CloudBlobClient).
Returns:
true
se o contêiner ainda não existia e foi criado; caso contrário, false
.
Throws:
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:
null
usará as opções de solicitação padrão do cliente de serviço associado (CloudBlobClient).
Returns:
true
se o contêiner ainda não existia e foi criado; caso contrário, false
.
Throws:
delete
public void delete()
Exclui o contêiner.
Throws:
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:
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
Throws:
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:
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:
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
Returns:
true
se o contêiner existia e foi excluído; caso contrário, false
.
Throws:
downloadAccountInfo
public AccountInformation downloadAccountInfo()
Obtém informações relacionadas à conta de armazenamento na qual esse contêiner reside.
Returns:
Throws:
downloadAccountInfo
public AccountInformation downloadAccountInfo(BlobRequestOptions options, OperationContext opContext)
Obtém informações relacionadas à conta de armazenamento na qual esse contêiner reside.
Parameters:
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
Returns:
Throws:
downloadAccountInformationImpl
protected StorageRequest
Parameters:
downloadAttributes
public void downloadAttributes()
Baixa os atributos do contêiner, que consistem em metadados e propriedades.
Throws:
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:
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
Throws:
downloadPermissions
public BlobContainerPermissions downloadPermissions()
Baixa as configurações de permissão para o contêiner.
Returns:
Throws:
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:
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
Returns:
Throws:
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:
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:
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
Returns:
true
se o contêiner existir, caso contrário false
, .
Throws:
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:
String
que representa a política de acesso no nível do contêiner.
Returns:
String
que representa uma assinatura de acesso compartilhado para o contêiner.Throws:
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:
String
que representa a política de acesso no nível do contêiner.
Returns:
String
que representa uma assinatura de acesso compartilhado para o contêiner.Throws:
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:
String
que representa o nome do blob.
Returns:
Throws:
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:
String
que representa o nome do blob.
String
que representa a ID de instantâneo do blob.
Returns:
Throws:
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:
String
que representa o nome do blob.
Returns:
Throws:
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:
String
que representa o nome do blob.
String
que representa a ID de instantâneo do blob.
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
Returns:
Throws:
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:
String
que representa o nome do blob.
Returns:
Throws:
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:
String
que representa o nome do blob.
String
que representa a ID de instantâneo do blob.
Returns:
Throws:
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:
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:
Throws:
getMetadata
public HashMap
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:
java.util.HashMap
objeto que representa os metadados do contêiner.getName
public String getName()
Retorna o nome do contêiner.
Returns:
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:
String
que representa o nome do blob.
Returns:
Throws:
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:
String
que representa o nome do blob.
String
que representa a ID de instantâneo do blob.
Returns:
Throws:
getProperties
public BlobContainerProperties getProperties()
Retorna as propriedades do contêiner.
Returns:
getServiceClient
public CloudBlobClient getServiceClient()
Retorna o cliente do serviço Blob associado a esse contêiner.
Returns:
getStorageUri
public StorageUri getStorageUri()
Retorna a lista de URIs para todos os locais.
Returns:
getUri
public URI getUri()
Retorna o URI desse contêiner.
Returns:
listBlobs
public Iterable
Retorna uma coleção enumerável de itens de blob para o contêiner.
Returns:
listBlobs
public Iterable
Retorna uma coleção enumerável de itens de blob para o contêiner cujos nomes começam com o prefixo especificado.
Parameters:
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:
listBlobs
public Iterable
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:
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.
true
para indicar que a lista retornada será simples; false
para indicar que a lista retornada será hierárquica.
Returns:
listBlobs
public Iterable
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:
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.
true
para indicar que a lista retornada será simples; false
para indicar que a lista retornada será hierárquica.
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.
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
Returns:
listBlobsSegmented
public ResultSegment
Retorna um segmento de resultado de uma coleção enumerável de itens de blob no contêiner.
Returns:
Throws:
listBlobsSegmented
public ResultSegment
Retorna um segmento de resultado que contém uma coleção de itens de blob cujos nomes começam com o prefixo especificado.
Parameters:
String
que representa o prefixo do nome do blob.
Returns:
Throws:
listBlobsSegmented
public ResultSegment
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:
String
que representa o prefixo do nome do blob.
true
para indicar que a lista retornada será simples; false
para indicar que a lista retornada será hierárquica.
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.
null
ou maior que 5000, o servidor retornará até 5.000 itens. Deve ser pelo menos 1.
null
usará as opções de solicitação padrão do cliente de serviço associado (CloudBlobClient).
Returns:
Throws:
listContainers
public Iterable
Retorna uma coleção enumerável de contêineres para o cliente de serviço associado a esse contêiner.
Returns:
listContainers
public Iterable
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:
String
que representa o prefixo do nome do contêiner.
Returns:
listContainers
public Iterable
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:
String
que representa o prefixo do nome do contêiner.
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
Returns:
listContainersSegmented
public ResultSegment
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:
Throws:
listContainersSegmented
public ResultSegment
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:
String
que representa o prefixo de nome de blob.
Returns:
Throws:
listContainersSegmented
public ResultSegment
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:
String
que representa o prefixo do nome do contêiner.
null
ou maior que 5000, o servidor retornará até 5.000 itens. Deve ser pelo menos 1.
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
Returns:
Throws:
releaseLease
public final void releaseLease(final AccessCondition accessCondition)
Libera a concessão no contêiner.
Parameters:
Throws:
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:
null
usará as opções de solicitação padrão do cliente de serviço associado (CloudBlobClient).
Throws:
renewLease
public final void renewLease(final AccessCondition accessCondition)
Renova uma concessão existente com as condições de acesso especificadas.
Parameters:
Throws:
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:
null
usará as opções de solicitação padrão do cliente de serviço associado (CloudBlobClient).
Throws:
setMetadata
public void setMetadata(final HashMap
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:
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:
setStorageUri
protected void setStorageUri(final StorageUri storageUri)
Define a lista de URIs para todos os locais.
Parameters:
uploadMetadata
public void uploadMetadata()
Carrega os metadados do contêiner.
Throws:
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:
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
Throws:
uploadPermissions
public void uploadPermissions(final BlobContainerPermissions permissions)
Carrega as permissões do contêiner.
Parameters:
Throws:
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:
null
usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
Throws:
Aplica-se a
Azure SDK for Java