CloudBlob Classe

Pacote:

com.microsoft.azure.storage.blob

• java.lang.Object
• • ListBlobItem
  • • com.microsoft.azure.storage.blob.CloudBlob

public class CloudBlob implements ListBlobItem

Representa um blob do Microsoft Azure. Essa é a classe base para as CloudBlockBlob classes e CloudPageBlob .

Resumo do campo

Modificador e tipo	Campo e descrição
CloudBlobClient	blobServiceClient Representa o cliente blob.
CloudBlobDirectory	parent Representa o diretório do blob.
int	streamMinimumReadSizeInBytes Mantém o tamanho mínimo de leitura ao usar um BlobInputStream.
int	streamWriteSizeInBytes Contém o número de bytes a serem armazenados em buffer ao gravar em um BlobOutputStream (blobs de página e bloco).

Resumo do Construtor

Construtor	Description
CloudBlob(final BlobType type, final StorageUri uri, final String snapshotID, final StorageCredentials credentials)	Cria uma instância da classe usando o URI especificado, instantâneo ID e o cliente de blob de nuvem.
CloudBlob(final BlobType type, String blobName, String snapshotID, CloudBlobContainer container)	Cria uma instância da classe usando o tipo, o nome, a ID de instantâneo e o contêiner especificados.
CloudBlob(final CloudBlob otherBlob)	Cria uma instância da classe copiando valores de outro blob.

Resumo do método

Modificador e tipo	Método e descrição
final void	abortCopy(final String copyId) Anula uma operação de cópia de blob em andamento.
final void	abortCopy(final String copyId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Anula uma operação de cópia de blob em andamento.
final String	acquireLease() Adquire uma nova concessão infinita no blob.
final String	acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId) Adquire uma nova concessão no blob 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 blob 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 void	assertCorrectBlobType() Afirma que o blob tem o tipo de blob correto especificado nos atributos de blob.
void	assertNoWriteOperationForSnapshot() Afirma que a operação de gravação não é feita para instantâneo.
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.
final CloudBlob	createSnapshot() Cria um instantâneo do blob.
final CloudBlob	createSnapshot(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Cria uma instantâneo do blob usando as opções de solicitação especificadas e o contexto de operação.
final CloudBlob	createSnapshot(final HashMap<String, String> metadata, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Cria uma instantâneo do blob usando as opções de solicitação especificadas e o contexto de operação.
final void	delete() Exclui o blob. Se uma política de retenção de exclusão estiver habilitada no serviço, o blob será retido por um período de tempo especificado, antes de ser removido permanentemente pela coleta de lixo.
final void	delete(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Exclui o blob usando as opções de instantâneo e solicitação especificadas e o contexto de operação. Se uma política de retenção de exclusão estiver habilitada no serviço, o blob será retido por um período de tempo especificado, antes de ser removido permanentemente pela coleta de lixo. Um blob que possui instantâneos não pode ser excluído a menos que os instantâneos também sejam excluídos. Se um blob tiver instantâneos, use o DELETE_SNAPSHOTS_ONLY valor ou INCLUDE_SNAPSHOTS no parâmetro para especificar como os instantâneos devem ser tratados quando o blob é excluído.
final boolean	deleteIfExists() Exclui o blob se ele existir. Um blob que possui instantâneos não pode ser excluído a menos que os instantâneos também sejam excluídos. Se um blob tiver instantâneos, use o DELETE_SNAPSHOTS_ONLY valor ou INCLUDE_SNAPSHOTS no parâmetro para especificar como os instantâneos devem ser tratados quando o blob é excluído.
final boolean	deleteIfExists(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Exclui o blob se ele existir, usando as opções de instantâneo e solicitação especificadas e o contexto de operação. Um blob que possui instantâneos não pode ser excluído a menos que os instantâneos também sejam excluídos. Se um blob tiver instantâneos, use o DELETE_SNAPSHOTS_ONLY valor ou INCLUDE_SNAPSHOTS no parâmetro para especificar como os instantâneos devem ser tratados quando o blob é excluído.
final void	download(final OutputStream outStream) Baixa o conteúdo de um blob em um fluxo.
final void	download(final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Baixa o conteúdo de um blob em um fluxo usando as opções de solicitação especificadas e o contexto de operação.
AccountInformation	downloadAccountInfo() Obtém informações relacionadas à conta de armazenamento na qual esse blob reside.
AccountInformation	downloadAccountInfo(BlobRequestOptions options, OperationContext opContext) Obtém informações relacionadas à conta de armazenamento na qual esse blob reside.
StorageRequest<ServiceClient, CloudBlob, AccountInformation>	downloadAccountInformationImpl(final RequestOptions options)
final void	downloadAttributes() Popula as propriedades e os metadados de um blob. Esse método preenche as propriedades do sistema do blob e os metadados definidos pelo usuário. Antes de ler ou modificar as propriedades ou metadados de um blob, chame esse método ou sua sobrecarga para recuperar os valores mais recentes para as propriedades e metadados do blob do serviço de armazenamento do Microsoft Azure.
final void	downloadAttributes(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Preenche as propriedades e metadados de um blob usando as opções de solicitação especificadas e o contexto de operação. Esse método preenche as propriedades do sistema do blob e os metadados definidos pelo usuário. Antes de ler ou modificar as propriedades ou metadados de um blob, chame esse método ou sua sobrecarga para recuperar os valores mais recentes para as propriedades e metadados do blob do serviço de armazenamento do Microsoft Azure.
final void	downloadRange(final long offset, final Long length, final OutputStream outStream) Baixa o conteúdo de um blob em um fluxo.
final void	downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Baixa o conteúdo de um blob em um fluxo usando as opções de solicitação especificadas e o contexto de operação.
final int	downloadRangeInternal(final long blobOffset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Baixa um intervalo de bytes do blob para o buffer de bytes fornecido.
final int	downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset) Baixa um intervalo de bytes do blob para o buffer de bytes fornecido.
final int	downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Baixa um intervalo de bytes do blob para o buffer de bytes fornecido, usando as opções de solicitação especificadas e o contexto de operação.
final int	downloadToByteArray(final byte[] buffer, final int bufferOffset) Baixa um intervalo de bytes do blob para o buffer de bytes fornecido.
final int	downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Baixa um intervalo de bytes do blob para o buffer de bytes fornecido, usando as opções de solicitação e o contexto de operação especificados.
void	downloadToFile(final String path) Baixa um blob, armazenando o conteúdo em um arquivo.
void	downloadToFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Baixa um blob, armazenando o conteúdo em um arquivo.
final boolean	exists() Verifica se o blob existe.
final boolean	exists(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Verifica se o blob existe, usando as opções de solicitação e o contexto de operação especificados.
String	generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier) Retorna uma assinatura de acesso compartilhado para o blob usando o identificador de política de grupo e o contexto de operação especificados. Observe que isso não contém o "?".
String	generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols) Retorna uma assinatura de acesso compartilhado para o blob usando o identificador de política de grupo e o contexto de operação especificados. Observe que isso não contém o "?".
String	generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols, boolean skipDecoding) Retorna uma assinatura de acesso compartilhado para o blob usando o identificador de política de grupo e o contexto de operação especificados. Observe que isso não contém o "?".
String	generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier) Retorna uma assinatura de acesso compartilhado para o blob usando o identificador de política de grupo e o contexto de operação especificados. Observe que isso não contém o "?".
String	generateUserDelegationSharedAccessSignature(final UserDelegationKey delegationKey, final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final IPRange ipRange, final SharedAccessProtocols protocols) Retorna uma assinatura de acesso compartilhado com base em uma chave de delegação de usuário para o blob usando o identificador de política de grupo e o contexto de operação especificados. Observe que isso não contém o "?".
String	generateUserDelegationSharedAccessSignature(UserDelegationKey delegationKey, SharedAccessBlobPolicy policy) Retorna uma assinatura de acesso compartilhado com base em uma chave de delegação de usuário para o blob usando o identificador de política de grupo e o contexto de operação especificados. Observe que isso não contém o "?".
final CloudBlobContainer	getContainer() Retorna o contêiner do blob.
CopyState	getCopyState() Retorna o estado de cópia do blob.
final HashMap<String, String>	getMetadata() Retorna os metadados do blob.
final String	getName() Retorna o nome do blob.
final CloudBlobDirectory	getParent() Retorna o pai do item de blob.
String	getParentNameFromURI(final StorageUri resourceAddress, final String delimiter, final CloudBlobContainer container) Recupera o nome pai de um URI de blob.
final BlobProperties	getProperties() Retorna as propriedades do blob.
final StorageUri	getQualifiedStorageUri() Retorna o URI qualificado de assinatura de acesso compartilhado e/ou instantâneo para esse blob. <xreftitle>Deprecated</xreftitle> <xrefdescription> <p>use <xref uid="com.microsoft.azure.storage.blob.CloudBlob.getSnapshotQualifiedStorageUri()" data-throw-if-not-resolved="false" data-raw-source="getSnapshotQualifiedStorageUri()"></xref> instead.</p> </xrefdescription>
final URI	getQualifiedUri() Retorna o URI qualificado de assinatura de acesso compartilhado ou instantâneo para esse blob. <xreftitle>Deprecated</xreftitle> <xrefdescription> <p>use <xref uid="com.microsoft.azure.storage.blob.CloudBlob.getSnapshotQualifiedUri()" data-throw-if-not-resolved="false" data-raw-source="getSnapshotQualifiedUri()"></xref> instead.</p> </xrefdescription>
final CloudBlobClient	getServiceClient() Retorna o cliente do serviço Blob associado ao blob.
final String	getSnapshotID() Obtém a ID do Instantâneo do Blob.
final StorageUri	getSnapshotQualifiedStorageUri() Retorna o URI do blob para os locais primário e secundário, incluindo informações de cadeia de caracteres de consulta se o blob for um instantâneo.
final URI	getSnapshotQualifiedUri() Retorna o URI absoluto para o blob, incluindo informações de cadeia de caracteres de consulta se o blob for um instantâneo.
final StorageUri	getStorageUri() Retorna a lista de URIs para todos os locais.
final int	getStreamMinimumReadSizeInBytes() Retorna o tamanho mínimo de leitura ao usar um BlobInputStream.
final int	getStreamWriteSizeInBytes() Obtém o número de bytes a serem armazenados em buffer ao gravar em um BlobOutputStream (blobs de blocos e páginas).
final StorageUri	getTransformedAddress(final OperationContext opContext) Retorna o URI transformado para o recurso se as credenciais fornecidas exigirem transformação.
final URI	getUri() Retorna o URI para esse blob.
final boolean	isSnapshot() Indica se esse blob é um instantâneo.
final BlobInputStream	openInputStream() Abre um fluxo de entrada de blob para baixar o blob. Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar o tamanho de leitura.
final BlobInputStream	openInputStream(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Abre um fluxo de entrada de blob para baixar o blob usando as opções de solicitação especificadas e o contexto de operação. Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar o tamanho de leitura.
final BlobInputStream	openInputStream(final long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Abre um fluxo de entrada de blob para baixar o blob usando as opções de solicitação especificadas e o contexto de operação. Se o blob for descriptografado conforme ele for baixado, a validação final do MD5 será ignorada. Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar o tamanho de leitura.
final void	releaseLease(final AccessCondition accessCondition) Libera a concessão do blob.
final void	releaseLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Libera a concessão no blob usando as opções de solicitação especificadas e o contexto de operação.
final void	renewLease(final AccessCondition accessCondition) Renova uma concessão existente.
final void	renewLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Renova uma concessão existente usando as opções de solicitação especificadas e o contexto de operação.
final void	setContainer(final CloudBlobContainer container) Define o contêiner para o blob.
final void	setMetadata(final HashMap<String, String> metadata) Define os metadados do blob.
final void	setProperties(final BlobProperties properties) Define as propriedades do blob.
final void	setSnapshotID(final String snapshotID) Define o blob instantâneo ID.
void	setStorageUri(final StorageUri storageUri) Define a lista de URIs para todos os locais.
void	setStreamMinimumReadSizeInBytes(final int minimumReadSize) Define o tamanho mínimo de leitura ao usar um BlobInputStream.
abstract void	setStreamWriteSizeInBytes(int streamWriteSizeInBytes) Define o número de bytes a serem armazenados em buffer ao gravar em um BlobOutputStream (blobs de página e bloco).
final String	startCopy(final URI source) Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um URI para um novo blob.
final String	startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um URI para um novo blob, usando as condições de acesso especificadas, a ID de concessão, as opções de solicitação e o contexto de operação.
final String	startCopy(final URI source, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um URI para um novo blob, usando a camada de blob de página premium especificada, as condições de acesso, a ID de concessão, as opções de solicitação e o contexto de operação. Observação: a configuração do premiumPageBlobTier só tem suporte para contas premium.
final String	startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um URI para um novo blob, usando a camada de blob de página premium especificada, as condições de acesso, a ID de concessão, as opções de solicitação e o contexto de operação. Observação: a configuração do premiumPageBlobTier só tem suporte para contas premium.
final String	startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um URI para um novo blob, usando a camada de blob de página premium especificada, a prioridade de reidratação, as condições de acesso, a ID de concessão, as opções de solicitação e o contexto de operação especificados. Observação: a configuração do premiumPageBlobTier só tem suporte para contas premium.
StorageRequest<CloudBlobClient, CloudBlob, String>	startCopyImpl(final URI source, final String contentMd5, final boolean syncCopy, final boolean incrementalCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, final BlobRequestOptions options)
final void	undelete() Cancela a exclusão de um blob e todos os seus instantâneos que foram excluídos temporariamente.
final void	undelete(BlobRequestOptions options, OperationContext opContext) Cancela a exclusão de um blob que foi excluído temporariamente, usando as opções de solicitação especificadas e o contexto de operação. A operação de blob sem exclusão restaura o conteúdo e os metadados do blob excluído reversível e de todos os seus instantâneos. A tentativa de desmarcar um blob ou instantâneo que não seja excluído de forma reversível terá êxito sem nenhuma alteração.
void	updateEtagAndLastModifiedFromResponse(HttpURLConnection request)
void	updateLengthFromResponse(HttpURLConnection request)
abstract void	upload(InputStream sourceStream, long length) Carrega os dados do fluxo de origem para o blob. Se o blob já existir no serviço, ele será substituído.
abstract void	upload(InputStream sourceStream, long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Carrega os dados do fluxo de origem para o blob usando a ID de concessão, as opções de solicitação e o contexto de operação especificados. Se o blob já existir no serviço, ele será substituído.
void	uploadFromByteArray(final byte[] buffer, final int offset, final int length) Carrega um blob de dados em uma matriz de bytes. Se o blob já existir no serviço, ele será substituído.
void	uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Carrega um blob de dados em uma matriz de bytes. Se o blob já existir no serviço, ele será substituído.
void	uploadFromFile(final String path) Carrega um blob de um arquivo. Se o blob já existir no serviço, ele será substituído.
void	uploadFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Carrega um blob de um arquivo. Se o blob já existir no serviço, ele será substituído.
final void	uploadMetadata() Carrega os metadados do blob no serviço de armazenamento. Use downloadAttributes() para recuperar os valores mais recentes para as propriedades e metadados do blob do serviço de armazenamento do Microsoft Azure.
final void	uploadMetadata(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Carrega os metadados do blob para o serviço de armazenamento usando a ID de concessão, as opções de solicitação e o contexto de operação especificados. Use downloadAttributes() para recuperar os valores mais recentes para as propriedades e metadados do blob do serviço de armazenamento do Microsoft Azure.
final void	uploadProperties() Atualizações as propriedades do blob para o serviço de armazenamento. Use downloadAttributes() para recuperar os valores mais recentes para as propriedades e metadados do blob do serviço de armazenamento do Microsoft Azure.
final void	uploadProperties(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Atualizações as propriedades do blob usando a ID de concessão, as opções de solicitação e o contexto de operação especificados. Use downloadAttributes() para recuperar os valores mais recentes para as propriedades e metadados do blob do serviço de armazenamento do Microsoft Azure.
static<T extends CloudBlob, R> void	validateCPKHeaders(StorageRequest<CloudBlobClient, T, R> request, BlobRequestOptions options, boolean upload) Se as opções de solicitação contiverem um CPK, valide os cabeçalhos de resposta associados.

Detalhes do campo

blobServiceClient

protected CloudBlobClient blobServiceClient

Representa o cliente blob.

parent

protected CloudBlobDirectory parent

Representa o diretório do blob.

streamMinimumReadSizeInBytes

protected int streamMinimumReadSizeInBytes= Constants.DEFAULT_MINIMUM_READ_SIZE_IN_BYTES

Mantém o tamanho mínimo de leitura ao usar um BlobInputStream.

streamWriteSizeInBytes

protected int streamWriteSizeInBytes= Constants.DEFAULT_STREAM_WRITE_IN_BYTES

Contém o número de bytes a serem armazenados em buffer ao gravar em um BlobOutputStream (blobs de página e bloco).

Detalhes do construtor

CloudBlob

protected CloudBlob(final BlobType type, final StorageUri uri, final String snapshotID, final StorageCredentials credentials)

Cria uma instância da classe usando o URI especificado, instantâneo ID e o cliente de blob de nuvem.

Parameters:

type - Um BlobType valor que representa o tipo do blob.

uri - Um StorageUri objeto que representa o URI para o blob, começando com o nome do contêiner.

snapshotID - Um String que representa a versão instantâneo, se aplicável.

credentials - Um StorageCredentials objeto usado para autenticar o acesso.

Throws:

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

CloudBlob

protected CloudBlob(final BlobType type, String blobName, String snapshotID, CloudBlobContainer container)

Cria uma instância da classe usando o tipo, o nome, a ID de instantâneo e o contêiner especificados.

Parameters:

type - Um BlobType valor que representa o tipo do blob.

blobName - O nome do blob.

snapshotID - Um String que representa a versão instantâneo, se aplicável.

container - A referência ao contêiner pai.

Throws:

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

CloudBlob

protected CloudBlob(final CloudBlob otherBlob)

Cria uma instância da classe copiando valores de outro blob.

Parameters:

otherBlob - Um CloudBlob objeto que representa o blob a ser copiado.

Detalhes do método

abortCopy

public final void abortCopy(final String copyId)

Anula uma operação de cópia de blob em andamento.

Parameters:

copyId - Um String objeto que identifica a operação de cópia.

Throws:

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

abortCopy

public final void abortCopy(final String copyId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Anula uma operação de cópia de blob em andamento.

Parameters:

copyId - Um String objeto que identifica a operação de cópia.

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. 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.

acquireLease

public final String acquireLease()

Adquire uma nova concessão infinita no blob.

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 blob 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 blob 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 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:

Um String que representa a ID de concessão.

Throws:

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

assertCorrectBlobType

protected final void assertCorrectBlobType()

Afirma que o blob tem o tipo de blob correto especificado nos atributos de blob.

Throws:

StorageException - Se um tipo de blob incorreto for usado.

assertNoWriteOperationForSnapshot

protected void assertNoWriteOperationForSnapshot()

Afirma que a operação de gravação não é feita para instantâneo.

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 - 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:

Um long que especifica 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:

Um long que representa 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 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.

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.

createSnapshot

public final CloudBlob createSnapshot()

Cria um instantâneo do blob.

Returns:

Um CloudBlob objeto que representa o instantâneo do blob.

Throws:

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

createSnapshot

public final CloudBlob createSnapshot(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Cria uma instantâneo do blob usando as opções de solicitação especificadas e o contexto de operação.

Parameters:

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. 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 o instantâneo do blob.

Throws:

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

createSnapshot

public final CloudBlob createSnapshot(final HashMap metadata, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Cria uma instantâneo do blob usando as opções de solicitação especificadas e o contexto de operação.

Parameters:

metadata - Uma coleção de pares nome-valor definindo os metadados do instantâneo ou nulo.

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. 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 o instantâneo do blob.

Throws:

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

delete

public final void delete()

Exclui o blob.

Se uma política de retenção de exclusão estiver habilitada no serviço, o blob será retido por um período de tempo especificado, antes de ser removido permanentemente pela coleta de lixo.

Throws:

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

delete

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

Exclui o blob usando as opções de instantâneo e solicitação especificadas e o contexto de operação.

Se uma política de retenção de exclusão estiver habilitada no serviço, o blob será retido por um período de tempo especificado, antes de ser removido permanentemente pela coleta de lixo.

Um blob que possui instantâneos não pode ser excluído a menos que os instantâneos também sejam excluídos. Se um blob tiver instantâneos, use o DELETE_SNAPSHOTS_ONLY valor ou INCLUDE_SNAPSHOTS no parâmetro para especificar como os instantâneos devem ser tratados quando o blob é excluído.

Parameters:

deleteSnapshotsOption - Um DeleteSnapshotsOption objeto que indica se é necessário excluir apenas instantâneos ou o blob e seus instantâneos.

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. 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 final boolean deleteIfExists()

Exclui o blob se ele existir.

Um blob que possui instantâneos não pode ser excluído a menos que os instantâneos também sejam excluídos. Se um blob tiver instantâneos, use o DELETE_SNAPSHOTS_ONLY valor ou INCLUDE_SNAPSHOTS no parâmetro para especificar como os instantâneos devem ser tratados quando o blob é excluído.

Returns:

true se o blob foi excluído; caso contrário, false.

Throws:

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

deleteIfExists

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

Exclui o blob se ele existir, usando as opções de instantâneo e solicitação especificadas e o contexto de operação.

Um blob que possui instantâneos não pode ser excluído a menos que os instantâneos também sejam excluídos. Se um blob tiver instantâneos, use o DELETE_SNAPSHOTS_ONLY valor ou INCLUDE_SNAPSHOTS no parâmetro para especificar como os instantâneos devem ser tratados quando o blob é excluído.

Parameters:

deleteSnapshotsOption - Um DeleteSnapshotsOption objeto que indica se é necessário excluir apenas instantâneos ou o blob e seus instantâneos.

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. 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 blob existia e foi excluído; Caso contrário false

Throws:

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

download

public final void download(final OutputStream outStream)

Baixa o conteúdo de um blob em um fluxo.

Parameters:

outStream - Um OutputStream objeto que representa o fluxo de destino.

Throws:

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

download

public final void download(final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Baixa o conteúdo de um blob em um fluxo usando as opções de solicitação especificadas e o contexto de operação.

Parameters:

outStream - Um OutputStream objeto que representa o fluxo de destino.

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. 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.

downloadAccountInfo

public AccountInformation downloadAccountInfo()

Obtém informações relacionadas à conta de armazenamento na qual esse blob 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 blob reside.

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:

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 final void downloadAttributes()

Popula as propriedades e os metadados de um blob.

Esse método preenche as propriedades do sistema do blob e os metadados definidos pelo usuário. Antes de ler ou modificar as propriedades ou metadados de um blob, chame esse método ou sua sobrecarga para recuperar os valores mais recentes para as propriedades e metadados do blob do serviço de armazenamento do Microsoft Azure.

Throws:

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

downloadAttributes

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

Preenche as propriedades e metadados de um blob usando as opções de solicitação especificadas e o contexto de operação.

Esse método preenche as propriedades do sistema do blob e os metadados definidos pelo usuário. Antes de ler ou modificar as propriedades ou metadados de um blob, chame esse método ou sua sobrecarga para recuperar os valores mais recentes para as propriedades e metadados do blob do serviço de armazenamento do Microsoft Azure.

Parameters:

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. 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.

downloadRange

public final void downloadRange(final long offset, final Long length, final OutputStream outStream)

Baixa o conteúdo de um blob em um fluxo.

Parameters:

offset - Um long que representa o deslocamento a ser usado como ponto de partida para a origem.

length - Um Long que representa o número de bytes a serem lidos ou null.

outStream - Um OutputStream objeto que representa o fluxo de destino.

Throws:

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

downloadRange

public final void downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Baixa o conteúdo de um blob em um fluxo usando as opções de solicitação especificadas e o contexto de operação.

Parameters:

offset - Um long que representa o deslocamento a ser usado como ponto de partida para a origem.

length - Um Long que representa o número de bytes a serem lidos ou null.

outStream - Um OutputStream objeto que representa o fluxo de destino.

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. 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.

downloadRangeInternal

protected final int downloadRangeInternal(final long blobOffset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Baixa um intervalo de bytes do blob para o buffer de bytes fornecido.

Parameters:

blobOffset - Um long que representa o deslocamento dentro do blob para começar a baixar.

length - Um Long que representa o número de bytes a serem lidos.

buffer - Uma byte matriz que representa o buffer no qual gravar.

bufferOffset - Um int que representa o deslocamento no buffer de bytes para começar a gravar.

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.

opContext - Um OperationContext objeto usado para acompanhar a execução da operação.

Returns:

O número total de bytes lidos do buffer.

Throws:

StorageException - uma exceção que representa qualquer erro que ocorreu durante a operação.

downloadRangeToByteArray

public final int downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset)

Baixa um intervalo de bytes do blob para o buffer de bytes fornecido.

Parameters:

offset - Um long que representa o deslocamento de bytes a ser usado como ponto de partida para a origem.

length - Um Long que representa o número de bytes a serem lidos ou nulos.

buffer - Uma byte matriz que representa o buffer no qual os bytes de blob são baixados.

bufferOffset - Um int que representa o deslocamento de bytes a ser usado como ponto de partida para o destino.

Returns:

O número total de bytes lidos do buffer.

Throws:

StorageException

downloadRangeToByteArray

public final int downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Baixa um intervalo de bytes do blob para o buffer de bytes fornecido, usando as opções de solicitação especificadas e o contexto de operação.

Parameters:

offset - Um long que representa o deslocamento de bytes a ser usado como ponto de partida para a origem.

length - Um Long que representa o número de bytes a serem lidos ou null.

buffer - Uma byte matriz que representa o buffer no qual os bytes de blob são baixados.

bufferOffset - Um int que representa o deslocamento de bytes a ser usado como ponto de partida para o destino.

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. 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:

O número total de bytes lidos do buffer.

Throws:

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

downloadToByteArray

public final int downloadToByteArray(final byte[] buffer, final int bufferOffset)

Baixa um intervalo de bytes do blob para o buffer de bytes fornecido.

Parameters:

buffer - Uma byte matriz que representa o buffer no qual os bytes de blob são baixados.

bufferOffset - Um int que representa o deslocamento de bytes a ser usado como ponto de partida para o destino.

Throws:

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

downloadToByteArray

public final int downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Baixa um intervalo de bytes do blob para o buffer de bytes fornecido, usando as opções de solicitação e o contexto de operação especificados.

Parameters:

buffer - Uma byte matriz que representa o buffer no qual os bytes de blob são baixados.

bufferOffset - Um long que representa o deslocamento de bytes a ser usado como ponto de partida para o destino.

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.

Throws:

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

downloadToFile

public void downloadToFile(final String path)

Baixa um blob, armazenando o conteúdo em um arquivo.

Parameters:

path - Um String que representa o caminho para o arquivo que será criado com o conteúdo do blob.

Throws:

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

IOException

downloadToFile

public void downloadToFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Baixa um blob, armazenando o conteúdo em um arquivo.

Parameters:

path - Um String que representa o caminho para o arquivo que será criado com o conteúdo 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.

Throws:

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

IOException

exists

public final boolean exists()

Verifica se o blob existe.

Returns:

true se o blob existir, caso contrário false, .

Throws:

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

exists

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

Verifica se o blob existe, usando 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.

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 blob existir, outros sábios false.

Throws:

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

generateSharedAccessSignature

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

Retorna uma assinatura de acesso compartilhado para o blob usando o identificador de política de grupo e o contexto de operação especificados. Observe que isso não contém o "?".

Parameters:

policy - Um SharedAccessPolicy objeto que representa a política de acesso para a assinatura de acesso compartilhado.

headers - Um SharedAccessBlobHeaders objeto que representa os valores de cabeçalho opcionais a serem definidos para um blob acessado com essa 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 a assinatura de acesso compartilhado.

Throws:

IllegalArgumentException - Se as credenciais forem inválidas ou o blob for um instantâneo.

InvalidKeyException - Se as credenciais forem inválidas.

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

generateSharedAccessSignature

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

Retorna uma assinatura de acesso compartilhado para o blob usando o identificador de política de grupo e o contexto de operação especificados. Observe que isso não contém o "?".

Parameters:

policy - Um SharedAccessPolicy objeto que representa a política de acesso para a assinatura de acesso compartilhado.

headers - Um SharedAccessBlobHeaders objeto que representa os valores de cabeçalho opcionais a serem definidos para um blob acessado com essa 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 a assinatura de acesso compartilhado.

Throws:

IllegalArgumentException - Se as credenciais forem inválidas ou o blob for um instantâneo.

InvalidKeyException - Se as credenciais forem inválidas.

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

generateSharedAccessSignature

public String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols, boolean skipDecoding)

Retorna uma assinatura de acesso compartilhado para o blob usando o identificador de política de grupo e o contexto de operação especificados. Observe que isso não contém o "?".

Parameters:

policy - Um SharedAccessPolicy objeto que representa a política de acesso para a assinatura de acesso compartilhado.

headers - Um SharedAccessBlobHeaders objeto que representa os valores de cabeçalho opcionais a serem definidos para um blob acessado com essa 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.

skipDecoding - Um boolean para indicar que os parâmetros de consulta não devem ser decodificados antes de serem assinados. Isso só deverá ser usado se o cliente tiver certeza de que os valores passados estão no formato desejado. Isso pode ser útil em alguns cenários em que o cliente é usado para gerar uma sas para terceiros que não usará esse sdk para fazer as solicitações.

Returns:

Um String que representa a assinatura de acesso compartilhado.

Throws:

IllegalArgumentException - Se as credenciais forem inválidas ou o blob for um instantâneo.

InvalidKeyException - Se as credenciais forem inválidas.

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 blob usando o identificador de política de grupo e o contexto de operação especificados. Observe que isso não contém o "?".

Parameters:

policy - Um SharedAccessPolicy 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 a assinatura de acesso compartilhado.

Throws:

IllegalArgumentException - Se as credenciais forem inválidas ou o blob for um instantâneo.

InvalidKeyException - Se as credenciais forem inválidas.

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

generateUserDelegationSharedAccessSignature

public String generateUserDelegationSharedAccessSignature(final UserDelegationKey delegationKey, final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final IPRange ipRange, final SharedAccessProtocols protocols)

Retorna uma assinatura de acesso compartilhado com base em uma chave de delegação de usuário para o blob usando o identificador de política de grupo e o contexto de operação especificados. Observe que isso não contém o "?".

Parameters:

delegationKey - Um UserDelegationKey que representa a chave usada para assinar essa assinatura.

policy - Um SharedAccessPolicy objeto que representa a política de acesso para a assinatura de acesso compartilhado.

headers - Um SharedAccessBlobHeaders objeto que representa os valores de cabeçalho opcionais a serem definidos para um blob acessado com essa assinatura de acesso compartilhado.

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 a assinatura de acesso compartilhado.

Throws:

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

generateUserDelegationSharedAccessSignature

public String generateUserDelegationSharedAccessSignature(UserDelegationKey delegationKey, SharedAccessBlobPolicy policy)

Retorna uma assinatura de acesso compartilhado com base em uma chave de delegação de usuário para o blob usando o identificador de política de grupo e o contexto de operação especificados. Observe que isso não contém o "?".

Parameters:

delegationKey - Um UserDelegationKey que representa a chave usada para assinar essa assinatura.

policy - Um SharedAccessPolicy objeto que representa a política de acesso para a assinatura de acesso compartilhado.

Returns:

Um String que representa a assinatura de acesso compartilhado.

Throws:

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

getContainer

public final CloudBlobContainer getContainer()

Retorna o contêiner do blob.

Overrides:

CloudBlob.getContainer()

Returns:

Um CloudBlobContainer objeto que representa o contêiner do blob.

Throws:

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

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

getCopyState

public CopyState getCopyState()

Retorna o estado de cópia do blob.

Returns:

Um CopyState objeto que representa o estado de cópia do blob.

getMetadata

public final HashMap getMetadata()

Retorna os metadados do blob.

Returns:

Um java.util.HashMap objeto que representa os metadados do blob.

getName

public final String getName()

Retorna o nome do blob.

Returns:

Um String que representa o nome do blob.

getParent

public final CloudBlobDirectory getParent()

Retorna o pai do item de blob.

Overrides:

CloudBlob.getParent()

Returns:

Um CloudBlobDirectory objeto que representa o diretório pai para o blob.

Throws:

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

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

getParentNameFromURI

protected static String getParentNameFromURI(final StorageUri resourceAddress, final String delimiter, final CloudBlobContainer container)

Recupera o nome pai de um URI de blob.

Parameters:

resourceAddress - Um StorageUri objeto que representa o URI do recurso.

delimiter - Um String que especifica o delimitador de diretório a ser usado.

container - Um CloudBlobContainer objeto que representa o contêiner de blob.

Returns:

Um String que representa o endereço pai de um URI de blob.

Throws:

URISyntaxException

getProperties

public final BlobProperties getProperties()

Retorna as propriedades do blob.

Returns:

Um BlobProperties objeto que representa as propriedades do blob.

getQualifiedStorageUri

public final StorageUri getQualifiedStorageUri()

Retorna o URI qualificado de assinatura de acesso compartilhado e/ou instantâneo para esse blob.

<xreftitle>Deprecated</xreftitle>

<xrefdescription>

  <p>use <xref uid="com.microsoft.azure.storage.blob.CloudBlob.getSnapshotQualifiedStorageUri()" data-throw-if-not-resolved="false" data-raw-source="getSnapshotQualifiedStorageUri()"></xref> instead.</p>

</xrefdescription>

Returns:

Um StorageUri objeto que representa o instantâneo ou a assinatura de acesso compartilhado.

Throws:

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

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

getQualifiedUri

public final URI getQualifiedUri()

Retorna o URI qualificado de assinatura de acesso compartilhado ou instantâneo para esse blob.

<xreftitle>Deprecated</xreftitle>

<xrefdescription>

  <p>use <xref uid="com.microsoft.azure.storage.blob.CloudBlob.getSnapshotQualifiedUri()" data-throw-if-not-resolved="false" data-raw-source="getSnapshotQualifiedUri()"></xref> instead.</p>

</xrefdescription>

Returns:

Um java.net.URI objeto que representa o instantâneo ou a assinatura de acesso compartilhado.

Throws:

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

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

getServiceClient

public final CloudBlobClient getServiceClient()

Retorna o cliente do serviço Blob associado ao blob.

Returns:

Um CloudBlobClient objeto que representa o cliente.

getSnapshotID

public final String getSnapshotID()

Obtém a ID do Instantâneo do Blob.

Returns:

Um String que representa a ID do Instantâneo de Blob.

getSnapshotQualifiedStorageUri

public final StorageUri getSnapshotQualifiedStorageUri()

Retorna o URI do blob para os locais primário e secundário, incluindo informações de cadeia de caracteres de consulta se o blob for um instantâneo.

Returns:

Um StorageUri objeto que contém os URIs do blob para os locais primário e secundário, incluindo instantâneo informações de consulta se o blob for um instantâneo.

Throws:

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

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

getSnapshotQualifiedUri

public final URI getSnapshotQualifiedUri()

Retorna o URI absoluto para o blob, incluindo informações de cadeia de caracteres de consulta se o blob for um instantâneo.

Returns:

Um java.net.URI objeto que especifica o URI absoluto para o blob, incluindo instantâneo informações de consulta se o blob for um instantâneo.

Throws:

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

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

getStorageUri

public final StorageUri getStorageUri()

Retorna a lista de URIs para todos os locais.

Overrides:

CloudBlob.getStorageUri()

Returns:

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

getStreamMinimumReadSizeInBytes

public final int getStreamMinimumReadSizeInBytes()

Retorna o tamanho mínimo de leitura ao usar um BlobInputStream.

Returns:

Um int que representa o tamanho mínimo de leitura, em bytes, ao usar um BlobInputStream objeto .

getStreamWriteSizeInBytes

public final int getStreamWriteSizeInBytes()

Obtém o número de bytes a serem armazenados em buffer ao gravar em um BlobOutputStream (blobs de blocos e páginas).

Returns:

Um int que representa o número de bytes a serem armazenados em buffer ou o tamanho de um bloco, em bytes.

getTransformedAddress

protected final StorageUri getTransformedAddress(final OperationContext opContext)

Retorna o URI transformado para o recurso se as credenciais fornecidas exigirem transformação.

Parameters:

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 StorageUri objeto que representa o URI transformado.

Throws:

IllegalArgumentException - Se o URI não for absoluto.

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

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

getUri

public final URI getUri()

Retorna o URI para esse blob.

Overrides:

CloudBlob.getUri()

Returns:

Um java.net.URI objeto que representa o URI do blob.

isSnapshot

public final boolean isSnapshot()

Indica se esse blob é um instantâneo.

Returns:

truese o blob for um instantâneo, caso contráriofalse, .

openInputStream

public final BlobInputStream openInputStream()

Abre um fluxo de entrada de blob para baixar o blob.

Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar o tamanho de leitura.

Returns:

Um InputStream objeto que representa o fluxo a ser usado para leitura do blob.

Throws:

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

openInputStream

public final BlobInputStream openInputStream(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Abre um fluxo de entrada de blob para baixar o blob usando as opções de solicitação especificadas e o contexto de operação.

Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar o tamanho de leitura.

Parameters:

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. 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 InputStream objeto que representa o fluxo a ser usado para leitura do blob.

Throws:

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

openInputStream

public final BlobInputStream openInputStream(final long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Abre um fluxo de entrada de blob para baixar o blob usando as opções de solicitação especificadas e o contexto de operação. Se o blob for descriptografado conforme ele for baixado, a validação final do MD5 será ignorada.

Use setStreamMinimumReadSizeInBytes(final int minimumReadSize) para configurar o tamanho de leitura.

Parameters:

offset - Um long que representa o deslocamento a ser usado como ponto de partida para a origem.

length - Um Long que representa o número de bytes a serem lidos ou null.

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. 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 InputStream objeto que representa o fluxo a ser usado para leitura do blob.

Throws:

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

releaseLease

public final void releaseLease(final AccessCondition accessCondition)

Libera a concessão do blob.

Parameters:

accessCondition - Um objeto AccessCondition que representa as condições de acesso para o blob. O LeaseID é necessário para ser definido no AccessCondition.

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 blob usando as opções de solicitação especificadas e o contexto de operação.

Parameters:

accessCondition - Um AccessCondition objeto que representa as condições de acesso para o blob. O LeaseID é necessário para ser definido no AccessCondition.

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.

renewLease

public final void renewLease(final AccessCondition accessCondition)

Renova uma concessão existente.

Parameters:

accessCondition - Um objeto AccessCondition que representa as condições de acesso para o blob. O LeaseID é necessário para ser definido no AccessCondition.

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 usando as opções de solicitação especificadas e o contexto de operação.

Parameters:

accessCondition - Um objeto AccessCondition que representa as condições de acesso para o blob. O LeaseID é necessário para ser definido no AccessCondition.

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.

setContainer

protected final void setContainer(final CloudBlobContainer container)

Define o contêiner para o blob.

Parameters:

container - Um CloudBlobContainer objeto que representa o contêiner que está sendo atribuído ao blob.

setMetadata

public final void setMetadata(final HashMap metadata)

Define os metadados do blob.

Parameters:

metadata - Um java.util.HashMap objeto que contém os metadados atribuídos ao blob.

setProperties

protected final void setProperties(final BlobProperties properties)

Define as propriedades do blob.

Parameters:

properties - Um BlobProperties objeto que representa as propriedades que estão sendo atribuídas ao blob.

setSnapshotID

protected final void setSnapshotID(final String snapshotID)

Define o blob instantâneo ID.

Parameters:

snapshotID - Um String que representa a ID de instantâneo que está sendo atribuída ao blob.

setStorageUri

protected void setStorageUri(final StorageUri storageUri)

Define a lista de URIs para todos os locais.

Parameters:

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

setStreamMinimumReadSizeInBytes

public void setStreamMinimumReadSizeInBytes(final int minimumReadSize)

Define o tamanho mínimo de leitura ao usar um BlobInputStream.

Parameters:

minimumReadSize - Um int que representa o tamanho mínimo do bloco, em bytes, para leitura de um blob ao usar um BlobInputStream objeto . Deve ser maior ou igual a 16 KB.

Throws:

IllegalArgumentException - Se minimumReadSize for menor que 16 KB.

setStreamWriteSizeInBytes

public abstract void setStreamWriteSizeInBytes(int streamWriteSizeInBytes)

Define o número de bytes a serem armazenados em buffer ao gravar em um BlobOutputStream (blobs de página e bloco).

Parameters:

streamWriteSizeInBytes - Um int que representa o número de bytes a serem armazenados em buffer ou o tamanho de um bloco, em bytes.

startCopy

public final String startCopy(final URI source)

Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um URI para um novo blob.

Parameters:

source - Um java.net.URI URI de origem. UrIs para recursos fora do Azure só podem ser copiados em blobs de blocos.

Returns:

Um String que representa a ID de cópia associada à operação de cópia.

Throws:

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

startCopy

public final String startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um URI para um novo blob, usando as condições de acesso especificadas, a ID de concessão, as opções de solicitação e o contexto de operação.

Parameters:

source - Um java.net.URI URI de origem. UrIs para recursos fora do Azure só podem ser copiados em blobs de blocos.

sourceAccessCondition - Um AccessCondition objeto que representa as condições de acesso para a origem.

destinationAccessCondition - Um AccessCondition objeto que representa as condições de acesso para o destino.

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 String que representa a ID de cópia associada à operação de cópia.

Throws:

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

startCopy

protected final String startCopy(final URI source, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um URI para um novo blob, usando a camada de blob de página premium especificada, as condições de acesso, a ID de concessão, as opções de solicitação e o contexto de operação.

Observação: a configuração do premiumPageBlobTier só tem suporte para contas premium.

Parameters:

source - Um java.net.URI URI de origem. UrIs para recursos fora do Azure só podem ser copiados em blobs de blocos.

blobTierString - Uma Cadeia de Caracteres que representa a camada do blob.

sourceAccessCondition - Um AccessCondition objeto que representa as condições de acesso para a origem.

destinationAccessCondition - Um AccessCondition objeto que representa as condições de acesso para o destino.

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 String que representa a ID de cópia associada à operação de cópia.

Throws:

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

startCopy

protected final String startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um URI para um novo blob, usando a camada de blob de página premium especificada, as condições de acesso, a ID de concessão, as opções de solicitação e o contexto de operação.

Observação: a configuração do premiumPageBlobTier só tem suporte para contas premium.

Parameters:

source - Um java.net.URI URI de origem. UrIs para recursos fora do Azure só podem ser copiados em blobs de blocos.

contentMd5 - Um valor de hash opcional usado para garantir a integridade transacional para a operação. Pode estar null ou vazio.

syncCopy - Um boolean que indica se a cópia deve ser feita de forma síncrona no serviço.

blobTierString - Uma Cadeia de Caracteres que representa a camada do blob.

sourceAccessCondition - Um AccessCondition objeto que representa as condições de acesso para a origem.

destinationAccessCondition - Um AccessCondition objeto que representa as condições de acesso para o destino.

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 String que representa a ID de cópia associada à operação de cópia.

Throws:

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

startCopy

protected final String startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um URI para um novo blob, usando a camada de blob de página premium especificada, a prioridade de reidratação, as condições de acesso, a ID de concessão, as opções de solicitação e o contexto de operação especificados.

Observação: a configuração do premiumPageBlobTier só tem suporte para contas premium.

Parameters:

source - Um java.net.URI URI de origem. UrIs para recursos fora do Azure só podem ser copiados em blobs de blocos.

contentMd5 - Um valor de hash opcional usado para garantir a integridade transacional para a operação. Pode estar null ou vazio.

syncCopy - Um boolean que indica se a cópia deve ser feita de forma síncrona no serviço.

blobTierString - Um String objeto que representa a camada do blob.

rehydratePriority - Um RehydratePriority objeto que representa a prioridade de reidratação.

sourceAccessCondition - Um AccessCondition objeto que representa as condições de acesso para a origem.

destinationAccessCondition - Um AccessCondition objeto que representa as condições de acesso para o destino.

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 String que representa a ID de cópia associada à operação de cópia.

Throws:

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

startCopyImpl

protected StorageRequest startCopyImpl(final URI source, final String contentMd5, final boolean syncCopy, final boolean incrementalCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, final BlobRequestOptions options)

Parameters:

source

contentMd5

syncCopy

incrementalCopy

blobTierString

rehydratePriority

sourceAccessCondition

destinationAccessCondition

options

undelete

public final void undelete()

Cancela a exclusão de um blob e todos os seus instantâneos que foram excluídos temporariamente.

Throws:

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

undelete

public final void undelete(BlobRequestOptions options, OperationContext opContext)

Cancela a exclusão de um blob que foi excluído temporariamente, usando as opções de solicitação especificadas e o contexto de operação.

A operação de blob sem exclusão restaura o conteúdo e os metadados do blob excluído reversível e de todos os seus instantâneos. A tentativa de desmarcar um blob ou instantâneo que não seja excluído de forma reversível terá êxito sem nenhuma alteraçã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.

updateEtagAndLastModifiedFromResponse

protected void updateEtagAndLastModifiedFromResponse(HttpURLConnection request)

Parameters:

request

updateLengthFromResponse

protected void updateLengthFromResponse(HttpURLConnection request)

Parameters:

request

upload

public abstract void upload(InputStream sourceStream, long length)

Carrega os dados do fluxo de origem para o blob. Se o blob já existir no serviço, ele será substituído.

Parameters:

sourceStream - Um InputStream objeto que representa o fluxo de origem a ser carregado.

length - Um long que representa o comprimento dos dados de fluxo em bytes ou -1, se desconhecido. O comprimento deve ser maior que zero e um múltiplo de 512 para blobs de páginas.

Throws:

IOException - Se ocorreu uma exceção de E/S.

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

upload

public abstract void upload(InputStream sourceStream, long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Carrega os dados do fluxo de origem para o blob usando a ID de concessão, as opções de solicitação e o contexto de operação especificados. Se o blob já existir no serviço, ele será substituído.

Parameters:

sourceStream - Um InputStream objeto que representa o fluxo de origem a ser carregado.

length - O comprimento dos dados de fluxo em bytes ou -1, se desconhecido. O comprimento deve ser maior que zero e um múltiplo de 512 para blobs de páginas.

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. 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:

IOException - Se ocorreu uma exceção de E/S.

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

uploadFromByteArray

public void uploadFromByteArray(final byte[] buffer, final int offset, final int length)

Carrega um blob de dados em uma matriz de bytes. Se o blob já existir no serviço, ele será substituído.

Parameters:

buffer - Uma byte matriz que representa os dados a serem gravados no blob.

offset - Um int que representa o deslocamento da matriz de bytes da qual iniciar o upload de dados.

length - Um int que representa o número de bytes a serem carregados do buffer de entrada.

Throws:

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

IOException

uploadFromByteArray

public void uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Carrega um blob de dados em uma matriz de bytes. Se o blob já existir no serviço, ele será substituído.

Parameters:

buffer - Uma byte matriz que representa os dados a serem gravados no blob.

offset - Um int que representa o deslocamento da matriz de bytes da qual iniciar o upload de dados.

length - Um int que representa o número de bytes a serem carregados do buffer de entrada.

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.

Throws:

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

IOException

uploadFromFile

public void uploadFromFile(final String path)

Carrega um blob de um arquivo. Se o blob já existir no serviço, ele será substituído.

Parameters:

path - Um String que representa o caminho para o arquivo a ser carregado.

Throws:

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

IOException

uploadFromFile

public void uploadFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Carrega um blob de um arquivo. Se o blob já existir no serviço, ele será substituído.

Parameters:

path - Um String que representa o caminho para o arquivo a ser carregado.

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.

Throws:

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

IOException

uploadMetadata

public final void uploadMetadata()

Carrega os metadados do blob no serviço de armazenamento.

Use downloadAttributes() para recuperar os valores mais recentes para as propriedades e metadados do blob do serviço de armazenamento do Microsoft Azure.

Throws:

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

uploadMetadata

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

Carrega os metadados do blob para o serviço de armazenamento usando a ID de concessão, as opções de solicitação e o contexto de operação especificados.

Use downloadAttributes() para recuperar os valores mais recentes para as propriedades e metadados do blob do serviço de armazenamento do Microsoft Azure.

Parameters:

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.

Throws:

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

uploadProperties

public final void uploadProperties()

Atualizações as propriedades do blob para o serviço de armazenamento.

Use downloadAttributes() para recuperar os valores mais recentes para as propriedades e metadados do blob do serviço de armazenamento do Microsoft Azure.

Throws:

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

uploadProperties

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

Atualizações as propriedades do blob usando a ID de concessão, as opções de solicitação e o contexto de operação especificados.

Use downloadAttributes() para recuperar os valores mais recentes para as propriedades e metadados do blob do serviço de armazenamento do Microsoft Azure.

Parameters:

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.

Throws:

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

validateCPKHeaders

protected static static void validateCPKHeaders(StorageRequest request, BlobRequestOptions options, boolean upload)

Se as opções de solicitação contiverem um CPK, valide os cabeçalhos de resposta associados.

Parameters:

request - A solicitação de armazenamento da qual marcar a resposta.

options - As opções de blob usadas na solicitação.

upload - Se foi um upload ou se estamos apenas recuperando dados.

Throws:

StorageException - Gerará se o CPK foi usado na solicitação e a resposta falhou na validação.