CloudPageBlob Classe

Pacote:

com.microsoft.azure.storage.blob

• java.lang.Object
• • ListBlobItem
  • • Cloudblob
    • • com.microsoft.azure.storage.blob.CloudPageBlob

public class CloudPageBlob extends CloudBlob

Representa um blob de páginas do Microsoft Azure.

Resumo do Construtor

Construtor	Description
CloudPageBlob(final CloudPageBlob otherBlob)	Cria uma instância da classe copiando valores de outro blob de páginas.
CloudPageBlob(final StorageUri blobAbsoluteUri)	Cria uma instância da classe usando o URI absoluto e o cliente de serviço de armazenamento especificados.
CloudPageBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)	Cria uma instância da classe usando o StorageUri absoluto e as credenciais especificados.
CloudPageBlob(final StorageUri blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)	Cria uma instância da classe usando o StorageUri absoluto, instantâneo ID e credenciais especificados.
CloudPageBlob(final URI blobAbsoluteUri)	Cria uma instância da classe usando o URI absoluto e o cliente de serviço de armazenamento especificados.
CloudPageBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)	Cria uma instância da classe usando o URI absoluto e as credenciais especificados.
CloudPageBlob(final URI blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)	Cria uma instância da classe usando o URI absoluto, instantâneo ID e credenciais especificados.
CloudPageBlob(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.

Resumo do método

Modificador e tipo	Método e descrição
void	clearPages(final long offset, final long length) Limpa páginas de um blob de páginas. A chamada libera o espaço de armazenamento usado pelas páginas especificadas. As páginas que foram limpas não são mais rastreadas como parte do blob de páginas e não incorrem mais em uma cobrança em relação à conta de armazenamento.
void	clearPages(final long offset, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Limpa páginas de um blob de páginas usando a ID de concessão, as opções de solicitação e o contexto de operação especificados. A chamada libera o espaço de armazenamento usado pelas páginas especificadas. As páginas que foram limpas não são mais rastreadas como parte do blob de páginas e não incorrem mais em uma cobrança em relação à conta de armazenamento.
void	create(final long length) Cria um blob de páginas. Se o blob já existir, isso o substituirá. Para gerar um erro se o blob já existir, use a create(final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) sobrecarga com generateIfNotExistsCondition().
void	create(final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Cria um blob de páginas usando as opções de solicitação e o contexto de operação especificados. Se o blob já existir, isso o substituirá. Para gerar um erro se o blob já existir, use generateIfNotExistsCondition().
void	create(final long length, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Cria um blob de páginas usando as opções de solicitação e o contexto de operação especificados. Se o blob já existir, isso o substituirá. Para gerar um erro se o blob já existir, use generateIfNotExistsCondition().
ArrayList<PageRange>	downloadPageRanges() Retorna uma coleção de intervalos de páginas e seus deslocamentos de bytes inicial e final. Os deslocamentos de bytes de início e de término para cada intervalo de páginas são inclusivos.
ArrayList<PageRange>	downloadPageRanges(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Retorna uma coleção de intervalos de páginas e seus deslocamentos de bytes iniciais e finais usando as opções de solicitação especificadas e o contexto de operação.
List<PageRange>	downloadPageRanges(final long offset, final Long length) Retorna uma coleção de intervalos de páginas e seus deslocamentos de bytes inicial e final.
List<PageRange>	downloadPageRanges(final long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Retorna uma coleção de intervalos de páginas e seus deslocamentos de bytes iniciais e finais usando as opções de solicitação especificadas e o contexto de operação.
List<PageRangeDiff>	downloadPageRangesDiff(final String previousSnapshot) Obtém a coleção de intervalos de páginas que diferem entre um instantâneo especificado e esse objeto.
List<PageRangeDiff>	downloadPageRangesDiff(final String previousSnapshot, final Long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Obtém a coleção de intervalos de páginas que diferem entre um instantâneo especificado e esse objeto.
BlobOutputStream	openWriteExisting() Abre um objeto de fluxo de saída para gravar dados no blob de páginas. O blob de páginas já deve existir e todos os dados existentes podem ser substituídos.
BlobOutputStream	openWriteExisting(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Abre um objeto de fluxo de saída para gravar dados no blob de página, usando a ID de concessão especificada, as opções de solicitação e o contexto de operação. O blob de páginas já deve existir e todos os dados existentes podem ser substituídos.
BlobOutputStream	openWriteNew(final long length) Abre um objeto de fluxo de saída para gravar dados no blob de páginas. O blob de páginas ainda não precisa existir e será criado com o comprimento especificado. Se o blob já existir no serviço, ele será substituído. Para evitar a substituição e, em vez disso, gerar um erro, use a openWriteNew(final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) sobrecarga com o apropriado AccessCondition.
BlobOutputStream	openWriteNew(final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Abre um objeto de fluxo de saída para gravar dados no blob de página, usando a ID de concessão especificada, as opções de solicitação e o contexto de operação. O blob de páginas ainda não precisa existir e será criado com o comprimento especificado. Se o blob já existir no serviço, ele será substituído. Para evitar a substituição e, em vez disso, gerar um erro, passe um AccessCondition gerado usando generateIfNotExistsCondition().
BlobOutputStream	openWriteNew(final long length, final PremiumPageBlobTier premiumBlobTier, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Abre um objeto de fluxo de saída para gravar dados no blob de página, usando a ID de concessão especificada, as opções de solicitação e o contexto de operação. O blob de páginas ainda não precisa existir e será criado com o comprimento especificado. Se o blob já existir no serviço, ele será substituído. Para evitar a substituição e, em vez disso, gerar um erro, passe um AccessCondition gerado usando generateIfNotExistsCondition().
void	putPagesFromURI(long offset, long length, final URI copySource, final Long sourceOffset) Grava um PageRange usando a URL de origem especificada.
void	putPagesFromURI(long offset, long length, final URI copySource, final Long sourceOffset, String md5, AccessCondition accessCondition, AccessCondition sourceAccessCondition, BlobRequestOptions options, OperationContext opContext) Grava um PageRange usando a URL de origem especificada.
void	resize(long size) Redimensiona o blob de páginas para o tamanho especificado.
void	resize(long size, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Redimensiona o blob de páginas para o tamanho especificado.
void	setStreamWriteSizeInBytes(final int streamWriteSizeInBytes) Define o número de bytes como buffer ao gravar em um BlobOutputStream.
final String	startCopy(final CloudPageBlob sourceBlob) Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um blob para um novo blob.
final String	startCopy(final CloudPageBlob sourceBlob, 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 blob 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 CloudPageBlob sourceBlob, final PremiumPageBlobTier premiumBlobTier, 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 blob para um novo blob, usando a camada de blob especificada, as condições de acesso, a ID de concessão, as opções de solicitação e o contexto de operação.
final String	startIncrementalCopy(final CloudPageBlob sourceSnapshot) Solicita que o serviço inicie uma cópia incremental do conteúdo, propriedades e metadados de outro blob de páginas para esse blob.
final String	startIncrementalCopy(final CloudPageBlob sourceSnapshot, 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 blob 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	startIncrementalCopy(final URI sourceSnapshot) Solicita que o serviço inicie uma cópia incremental do conteúdo, propriedades e metadados de outro blob de páginas para esse blob.
final String	startIncrementalCopy(final URI sourceSnapshot, 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 blob 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.
void	updateSequenceNumberFromResponse(HttpURLConnection request)
void	upload(final InputStream sourceStream, final long length) Carrega os dados do fluxo de origem no blob de páginas. Se o blob já existir no serviço, ele será substituído.
void	upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Carrega os dados de fluxo de origem no blob de páginas 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	upload(final InputStream sourceStream, final long length, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Carrega os dados de fluxo de origem no blob de páginas 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, final PremiumPageBlobTier premiumBlobTier, 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, final PremiumPageBlobTier premiumBlobTier, 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.
void	uploadPages(final InputStream sourceStream, final long offset, final long length) Carrega um intervalo de páginas contíguas, até 4 MB de tamanho, no deslocamento especificado no blob de páginas.
void	uploadPages(final InputStream sourceStream, final long offset, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Carrega um intervalo de páginas contíguas, até 4 MB de tamanho, no deslocamento especificado no blob de página, usando a ID de concessão especificada, as opções de solicitação e o contexto de operação.
void	uploadPremiumPageBlobTier(final PremiumPageBlobTier premiumBlobTier) Define a camada de blob em um blob de páginas em uma conta de armazenamento premium.
void	uploadPremiumPageBlobTier(final PremiumPageBlobTier premiumBlobTier, BlobRequestOptions options, OperationContext opContext) Define a camada em um blob de páginas em uma conta de armazenamento premium.

Membros herdados

CloudBlob.abortCopy(final String copyId) CloudBlob.abortCopy(final String copyId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.acquireLease() CloudBlob.acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId) CloudBlob.acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.assertCorrectBlobType() CloudBlob.assertNoWriteOperationForSnapshot() CloudBlob.blobServiceClient CloudBlob.breakLease(final Integer breakPeriodInSeconds) CloudBlob.breakLease(final Integer breakPeriodInSeconds, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.changeLease(final String proposedLeaseId, final AccessCondition accessCondition) CloudBlob.changeLease(final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.CloudBlob(final BlobType type, String blobName, String snapshotID, CloudBlobContainer container) CloudBlob.CloudBlob(final BlobType type, final StorageUri uri, final String snapshotID, final StorageCredentials credentials) CloudBlob.CloudBlob(final CloudBlob otherBlob) CloudBlob.createSnapshot() CloudBlob.createSnapshot(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.createSnapshot(final HashMap<String, String> metadata, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.delete() CloudBlob.delete(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.deleteIfExists() CloudBlob.deleteIfExists(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.download(final OutputStream outStream) CloudBlob.download(final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadAccountInfo() CloudBlob.downloadAccountInfo(BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadAccountInformationImpl(final RequestOptions options) CloudBlob.downloadAttributes() CloudBlob.downloadAttributes(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadRange(final long offset, final Long length, final OutputStream outStream) CloudBlob.downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadRangeInternal(final long blobOffset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset) CloudBlob.downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadToByteArray(final byte[] buffer, final int bufferOffset) CloudBlob.downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadToFile(final String path) CloudBlob.downloadToFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.exists() CloudBlob.exists(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier) CloudBlob.generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier) CloudBlob.generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols) CloudBlob.generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols, boolean skipDecoding) CloudBlob.generateUserDelegationSharedAccessSignature(UserDelegationKey delegationKey, SharedAccessBlobPolicy policy) CloudBlob.generateUserDelegationSharedAccessSignature(final UserDelegationKey delegationKey, final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final IPRange ipRange, final SharedAccessProtocols protocols) CloudBlob.getContainer() CloudBlob.getCopyState() CloudBlob.getMetadata() CloudBlob.getName() CloudBlob.getParent() CloudBlob.getParentNameFromURI(final StorageUri resourceAddress, final String delimiter, final CloudBlobContainer container) CloudBlob.getProperties() CloudBlob.getQualifiedStorageUri() CloudBlob.getQualifiedUri() CloudBlob.getServiceClient() CloudBlob.getSnapshotID() CloudBlob.getSnapshotQualifiedStorageUri() CloudBlob.getSnapshotQualifiedUri() CloudBlob.getStorageUri() CloudBlob.getStreamMinimumReadSizeInBytes() CloudBlob.getStreamWriteSizeInBytes() CloudBlob.getTransformedAddress(final OperationContext opContext) CloudBlob.getUri() CloudBlob.isSnapshot() CloudBlob.openInputStream() CloudBlob.openInputStream(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.openInputStream(final long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.parent CloudBlob.releaseLease(final AccessCondition accessCondition) CloudBlob.releaseLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.renewLease(final AccessCondition accessCondition) CloudBlob.renewLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.setContainer(final CloudBlobContainer container) CloudBlob.setMetadata(final HashMap<String, String> metadata) CloudBlob.setProperties(final BlobProperties properties) CloudBlob.setSnapshotID(final String snapshotID) CloudBlob.setStorageUri(final StorageUri storageUri) CloudBlob.setStreamMinimumReadSizeInBytes(final int minimumReadSize) CloudBlob.startCopy(final URI source) CloudBlob.startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.startCopy(final URI source, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.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) CloudBlob.streamMinimumReadSizeInBytes CloudBlob.streamWriteSizeInBytes CloudBlob.undelete() CloudBlob.undelete(BlobRequestOptions options, OperationContext opContext) CloudBlob.updateEtagAndLastModifiedFromResponse(HttpURLConnection request) CloudBlob.updateLengthFromResponse(HttpURLConnection request) CloudBlob.uploadFromByteArray(final byte[] buffer, final int offset, final int length) CloudBlob.uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.uploadFromFile(final String path) CloudBlob.uploadFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.uploadMetadata() CloudBlob.uploadMetadata(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.uploadProperties() CloudBlob.uploadProperties(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.validateCPKHeaders(StorageRequest<CloudBlobClient, T, R> request, BlobRequestOptions options, boolean upload)

Detalhes do construtor

CloudPageBlob

public CloudPageBlob(final CloudPageBlob otherBlob)

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

Parameters:

otherBlob - Um CloudPageBlob objeto que representa o blob de páginas a ser copiado.

CloudPageBlob

public CloudPageBlob(final StorageUri blobAbsoluteUri)

Cria uma instância da classe usando o URI absoluto e o cliente de serviço de armazenamento especificados.

Parameters:

blobAbsoluteUri - Um StorageUri objeto que representa o URI absoluto para o blob.

Throws:

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

CloudPageBlob

public CloudPageBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)

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

Parameters:

blobAbsoluteUri - Um StorageUri objeto que representa o URI absoluto para o blob.

credentials - Um StorageCredentials objeto usado para autenticar o acesso.

Throws:

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

CloudPageBlob

public CloudPageBlob(final StorageUri blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)

Cria uma instância da classe usando o StorageUri absoluto, instantâneo ID e credenciais especificados.

Parameters:

blobAbsoluteUri - Um StorageUri objeto que representa o URI absoluto para o blob.

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.

CloudPageBlob

public CloudPageBlob(final URI blobAbsoluteUri)

Cria uma instância da classe usando o URI absoluto e o cliente de serviço de armazenamento especificados.

Parameters:

blobAbsoluteUri - Um java.net.URI objeto que representa o URI absoluto para o blob.

Throws:

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

CloudPageBlob

public CloudPageBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)

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

Parameters:

blobAbsoluteUri - Um java.net.URI objeto que representa o URI absoluto para o blob.

credentials - Um StorageCredentials objeto usado para autenticar o acesso.

Throws:

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

CloudPageBlob

public CloudPageBlob(final URI blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)

Cria uma instância da classe usando o URI absoluto, instantâneo ID e credenciais especificados.

Parameters:

blobAbsoluteUri - Um java.net.URI objeto que representa o URI absoluto para o blob.

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.

CloudPageBlob

protected CloudPageBlob(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:

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.

Detalhes do método

clearPages

public void clearPages(final long offset, final long length)

Limpa páginas de um blob de páginas.

A chamada libera o espaço de armazenamento usado pelas páginas especificadas. As páginas que foram limpas não são mais rastreadas como parte do blob de páginas e não incorrem mais em uma cobrança em relação à conta de armazenamento.

Parameters:

offset - O deslocamento, em bytes, no qual começar a limpar páginas. Esse valor deve ser um múltiplo de 512.

length - O comprimento, em bytes, do intervalo de dados a ser limpo. Esse valor deve ser um múltiplo de 512.

Throws:

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

clearPages

public void clearPages(final long offset, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Limpa páginas de um blob de páginas usando a ID de concessão, as opções de solicitação e o contexto de operação especificados.

A chamada libera o espaço de armazenamento usado pelas páginas especificadas. As páginas que foram limpas não são mais rastreadas como parte do blob de páginas e não incorrem mais em uma cobrança em relação à conta de armazenamento.

Parameters:

offset - Um long que representa o deslocamento, em bytes, no qual começar a limpar páginas. Esse valor deve ser um múltiplo de 512.

length - Um long que representa o comprimento, em bytes, do intervalo de dados a ser limpo. Esse valor deve ser um múltiplo de 512.

accessCondition - Um AccessCondition objeto 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 OperationContext objeto que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Throws:

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

create

public void create(final long length)

Cria um blob de páginas. Se o blob já existir, isso o substituirá. Para gerar um erro se o blob já existir, use a create(final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) sobrecarga com generateIfNotExistsCondition().

Parameters:

length - Um long que representa o tamanho, em bytes, do blob de páginas.

Throws:

IllegalArgumentException - Se o comprimento não for um múltiplo de 512.

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

create

public void create(final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Cria um blob de páginas usando as opções de solicitação e o contexto de operação especificados. Se o blob já existir, isso o substituirá. Para gerar um erro se o blob já existir, use generateIfNotExistsCondition().

Parameters:

length - Um long que representa o tamanho, em bytes, do blob de páginas.

accessCondition - Um AccessCondition objeto 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 OperationContext objeto 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:

IllegalArgumentException - Se o comprimento não for um múltiplo de 512.

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

create

public void create(final long length, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Cria um blob de páginas usando as opções de solicitação e o contexto de operação especificados. Se o blob já existir, isso o substituirá. Para gerar um erro se o blob já existir, use generateIfNotExistsCondition().

Parameters:

length - Um long que representa o tamanho, em bytes, do blob de páginas.

premiumBlobTier - Um PremiumPageBlobTier objeto que representa a camada do blob.

accessCondition - Um AccessCondition objeto 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 OperationContext objeto 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:

IllegalArgumentException - Se o comprimento não for um múltiplo de 512.

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

downloadPageRanges

public ArrayList downloadPageRanges()

Retorna uma coleção de intervalos de páginas e seus deslocamentos de bytes inicial e final.

Os deslocamentos de bytes de início e de término para cada intervalo de páginas são inclusivos.

Returns:

Um ArrayList objeto que representa o conjunto de intervalos de páginas e seus deslocamentos de bytes inicial e final.

Throws:

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

downloadPageRanges

public ArrayList downloadPageRanges(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Retorna uma coleção de intervalos de páginas e seus deslocamentos de bytes iniciais e finais 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.

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 OperationContext objeto 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 ArrayList objeto que representa o conjunto de intervalos de páginas e seus deslocamentos de bytes inicial e final.

Throws:

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

downloadPageRanges

public List downloadPageRanges(final long offset, final Long length)

Retorna uma coleção de intervalos de páginas e seus deslocamentos de bytes inicial e final.

Parameters:

offset - O deslocamento inicial do intervalo de dados onde são listados intervalos de página, em bytes. Ele deve ser um múltiplo de 512.

length - O tamanho do intervalo de dados onde são listados intervalos de página, em bytes. Ele deve ser um múltiplo de 512.

Returns:

Um List objeto que representa o conjunto de intervalos de páginas e seus deslocamentos de bytes inicial e final.

Throws:

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

downloadPageRanges

public List downloadPageRanges(final long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Retorna uma coleção de intervalos de páginas e seus deslocamentos de bytes iniciais e finais usando as opções de solicitação especificadas e o contexto de operação.

Parameters:

offset - O deslocamento inicial do intervalo de dados onde são listados intervalos de página, em bytes. Ele deve ser um múltiplo de 512.

length - O tamanho do intervalo de dados onde são listados intervalos de página, em bytes. Ele deve ser um múltiplo de 512.

accessCondition - Um AccessCondition objeto 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 OperationContext objeto 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 List objeto que representa o conjunto de intervalos de páginas e seus deslocamentos de bytes inicial e final.

Throws:

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

downloadPageRangesDiff

public List downloadPageRangesDiff(final String previousSnapshot)

Obtém a coleção de intervalos de páginas que diferem entre um instantâneo especificado e esse objeto.

Parameters:

previousSnapshot - Uma cadeia de caracteres que representa o instantâneo a ser usado como ponto de partida para a comparação. Se esse CloudPageBlob representar um instantâneo, o parâmetro previousSnapshot deverá ser anterior ao instantâneo atual.

Returns:

Um List objeto que contém o conjunto de intervalos de páginas diferentes.

Throws:

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

downloadPageRangesDiff

public List downloadPageRangesDiff(final String previousSnapshot, final Long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Obtém a coleção de intervalos de páginas que diferem entre um instantâneo especificado e esse objeto.

Parameters:

previousSnapshot - Uma cadeia de caracteres que representa o carimbo de data/hora instantâneo a ser usado como ponto de partida para a comparação. Se esse CloudPageBlob representar um instantâneo, o parâmetro previousSnapshot deverá ser anterior ao instantâneo atual.

offset - O deslocamento inicial do intervalo de dados onde são listados intervalos de página, em bytes. Ele deve ser um múltiplo de 512.

length - O tamanho do intervalo de dados onde são listados intervalos de página, em bytes. Ele deve ser um múltiplo de 512.

accessCondition - Um AccessCondition objeto 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 OperationContext objeto 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 List objeto que contém o conjunto de intervalos de páginas diferentes.

Throws:

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

openWriteExisting

public BlobOutputStream openWriteExisting()

Abre um objeto de fluxo de saída para gravar dados no blob de páginas. O blob de páginas já deve existir e todos os dados existentes podem ser substituídos.

Returns:

Um BlobOutputStream objeto usado para gravar dados no blob.

Throws:

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

openWriteExisting

public BlobOutputStream openWriteExisting(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Abre um objeto de fluxo de saída para gravar dados no blob de página, usando a ID de concessão especificada, as opções de solicitação e o contexto de operação. O blob de páginas já deve existir e todos os dados existentes podem ser substituídos.

Parameters:

accessCondition - Um AccessCondition objeto 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 OperationContext objeto 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 BlobOutputStream objeto usado para gravar dados no blob.

Throws:

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

openWriteNew

public BlobOutputStream openWriteNew(final long length)

Abre um objeto de fluxo de saída para gravar dados no blob de páginas. O blob de páginas ainda não precisa existir e será criado com o comprimento especificado. Se o blob já existir no serviço, ele será substituído.

Para evitar a substituição e, em vez disso, gerar um erro, use a openWriteNew(final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) sobrecarga com o apropriado AccessCondition.

Parameters:

length - Um long que representa o comprimento, em bytes, do fluxo a ser criado. Esse valor deve ser um múltiplo de 512.

Returns:

Um BlobOutputStream objeto usado para gravar dados no blob.

Throws:

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

openWriteNew

public BlobOutputStream openWriteNew(final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Abre um objeto de fluxo de saída para gravar dados no blob de página, usando a ID de concessão especificada, as opções de solicitação e o contexto de operação. O blob de páginas ainda não precisa existir e será criado com o comprimento especificado. Se o blob já existir no serviço, ele será substituído.

Para evitar a substituição e, em vez disso, gerar um erro, passe um AccessCondition gerado usando generateIfNotExistsCondition().

Parameters:

length - Um long que representa o comprimento, em bytes, do fluxo a ser criado. Esse valor deve ser um múltiplo de 512.

accessCondition - Um AccessCondition objeto 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 OperationContext objeto 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 BlobOutputStream objeto usado para gravar dados no blob.

Throws:

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

openWriteNew

public BlobOutputStream openWriteNew(final long length, final PremiumPageBlobTier premiumBlobTier, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Abre um objeto de fluxo de saída para gravar dados no blob de página, usando a ID de concessão especificada, as opções de solicitação e o contexto de operação. O blob de páginas ainda não precisa existir e será criado com o comprimento especificado. Se o blob já existir no serviço, ele será substituído.

Para evitar a substituição e, em vez disso, gerar um erro, passe um AccessCondition gerado usando generateIfNotExistsCondition().

Parameters:

length - Um long que representa o comprimento, em bytes, do fluxo a ser criado. Esse valor deve ser um múltiplo de 512.

premiumBlobTier - Um PremiumPageBlobTier objeto que representa a camada do blob.

accessCondition - Um AccessCondition objeto 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 OperationContext objeto 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 BlobOutputStream objeto usado para gravar dados no blob.

Throws:

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

putPagesFromURI

public void putPagesFromURI(long offset, long length, final URI copySource, final Long sourceOffset)

Grava um PageRange usando a URL de origem especificada.

Parameters:

offset - O deslocamento, em bytes, no qual começar a escrever páginas. Esse valor deve ser um múltiplo de 512.

length - O comprimento, em bytes, do intervalo de dados a ser gravado. Esse valor deve ser um múltiplo de 512. Esse valor também será usado como o comprimento dos dados a serem copiados da origem.

copySource - O URI dos dados de origem. Ele pode apontar para qualquer Blob ou Arquivo do Azure público ou a URL pode incluir uma assinatura de acesso compartilhado.

sourceOffset - Um long que representa o deslocamento a ser usado como ponto de partida para a origem. O comprimento dos dados a serem copiados da origem será obtido do parâmetro de comprimento de origem.

Throws:

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

putPagesFromURI

public void putPagesFromURI(long offset, long length, final URI copySource, final Long sourceOffset, String md5, AccessCondition accessCondition, AccessCondition sourceAccessCondition, BlobRequestOptions options, OperationContext opContext)

Grava um PageRange usando a URL de origem especificada.

Parameters:

offset - O deslocamento, em bytes, no qual começar a escrever páginas. Esse valor deve ser um múltiplo de 512.

length - O comprimento, em bytes, do intervalo de dados a ser gravado. Esse valor deve ser um múltiplo de 512. Esse valor também será usado como o comprimento dos dados a serem copiados da origem.

copySource - O URI dos dados de origem. Ele pode apontar para qualquer Blob ou Arquivo do Azure público ou a URL pode incluir uma assinatura de acesso compartilhado.

sourceOffset - Um long que representa o deslocamento a ser usado como ponto de partida para a origem. O comprimento dos dados a serem copiados da origem será obtido do parâmetro de comprimento de origem.

md5 - Um String que representa o hash MD5 para os dados.

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

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

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

resize

public void resize(long size)

Redimensiona o blob de páginas para o tamanho especificado.

Parameters:

size - Um long que representa o tamanho do blob de páginas, em bytes.

Throws:

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

resize

public void resize(long size, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Redimensiona o blob de páginas para o tamanho especificado.

Parameters:

size - Um long que representa o tamanho do blob de páginas, em bytes.

accessCondition - Um AccessCondition objeto 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 OperationContext objeto 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.

setStreamWriteSizeInBytes

public void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)

Define o número de bytes como buffer ao gravar em um BlobOutputStream.

Parameters:

streamWriteSizeInBytes - Um int que representa o número máximo de bytes a serem armazenados em buffer ao gravar em um fluxo de blob de páginas. Esse valor deve ser um múltiplo de 512 e menor ou igual a 4 MB.

Throws:

IllegalArgumentException - Se streamWriteSizeInBytes for menor que 512, maior que 4 MB ou não um múltiplo ou 512.

startCopy

public final String startCopy(final CloudPageBlob sourceBlob)

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

Parameters:

sourceBlob - Um CloudPageBlob objeto que representa o blob de origem a ser copiado.

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.

URISyntaxException

startCopy

public final String startCopy(final CloudPageBlob sourceBlob, 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 blob 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:

sourceBlob - Um CloudPageBlob objeto que representa o blob de origem a ser copiado.

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

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

options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).

opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

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

URISyntaxException

startCopy

public final String startCopy(final CloudPageBlob sourceBlob, final PremiumPageBlobTier premiumBlobTier, 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 blob para um novo blob, usando a camada de blob especificada, as condições de acesso, a ID de concessão, as opções de solicitação e o contexto de operação.

Parameters:

sourceBlob - Um CloudPageBlob objeto que representa o blob de origem a ser copiado.

premiumBlobTier - Um PremiumPageBlobTier objeto que representa a camada do blob.

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

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

options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).

opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

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

URISyntaxException

startIncrementalCopy

public final String startIncrementalCopy(final CloudPageBlob sourceSnapshot)

Solicita que o serviço inicie uma cópia incremental do conteúdo, propriedades e metadados de outro blob de páginas para esse blob.

Parameters:

sourceSnapshot - Um CloudPageBlob objeto que representa o blob de origem a ser copiado. Deve ser um instantâneo.

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.

URISyntaxException

startIncrementalCopy

public final String startIncrementalCopy(final CloudPageBlob sourceSnapshot, 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 blob 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:

sourceSnapshot - Um CloudPageBlob objeto que representa o blob de origem a ser copiado. Deve ser um instantâneo.

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

options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).

opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

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

URISyntaxException

startIncrementalCopy

public final String startIncrementalCopy(final URI sourceSnapshot)

Solicita que o serviço inicie uma cópia incremental do conteúdo, propriedades e metadados de outro blob de páginas para esse blob.

Parameters:

sourceSnapshot - Um CloudPageBlob objeto que representa o blob de origem a ser copiado. Deve ser um instantâneo.

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.

URISyntaxException

startIncrementalCopy

public final String startIncrementalCopy(final URI sourceSnapshot, 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 blob 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:

sourceSnapshot - Um CloudPageBlob objeto que representa o blob de origem a ser copiado. Deve ser um instantâneo.

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

options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).

opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

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

URISyntaxException

updateSequenceNumberFromResponse

protected void updateSequenceNumberFromResponse(HttpURLConnection request)

Parameters:

request

upload

public void upload(final InputStream sourceStream, final long length)

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

Parameters:

sourceStream - Um InputStream objeto do qual ler.

length - Um long que representa o comprimento, em bytes, dos dados de fluxo, deve ser diferente de zero e um múltiplo de 512.

Throws:

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

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

upload

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

Carrega os dados de fluxo de origem no blob de páginas 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 do qual ler.

length - Um long que representa o comprimento, em bytes, dos dados de fluxo. Isso deve ser grande que zero e um múltiplo de 512.

accessCondition - Um AccessCondition objeto 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 OperationContext objeto 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.

upload

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

Carrega os dados de fluxo de origem no blob de páginas 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 do qual ler.

length - Um long que representa o comprimento, em bytes, dos dados de fluxo. Isso deve ser grande que zero e um múltiplo de 512.

premiumBlobTier - Um PremiumPageBlobTier objeto que representa a camada do blob.

accessCondition - Um AccessCondition objeto 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 OperationContext objeto 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, final PremiumPageBlobTier premiumBlobTier, 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.

premiumBlobTier - Um PremiumPageBlobTier objeto que representa a camada 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

uploadFromFile

public void uploadFromFile(final String path, final PremiumPageBlobTier premiumBlobTier, 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.

premiumBlobTier - Um PremiumPageBlobTier objeto que representa a camada 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

uploadPages

public void uploadPages(final InputStream sourceStream, final long offset, final long length)

Carrega um intervalo de páginas contíguas, até 4 MB de tamanho, no deslocamento especificado no blob de páginas.

Parameters:

sourceStream - Um InputStream objeto que representa o fluxo de entrada a ser gravado no blob de páginas.

offset - Um long que representa o deslocamento, em número de bytes, no qual começar a gravar os dados. Esse valor deve ser um múltiplo de 512.

length - Um long que representa o comprimento, em bytes, dos dados a serem gravados. Esse valor deve ser um múltiplo de 512.

Throws:

IllegalArgumentException - Se o deslocamento ou o comprimento não forem múltiplos de 512 ou se o comprimento for maior que 4 MB.

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

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

uploadPages

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

Carrega um intervalo de páginas contíguas, até 4 MB de tamanho, no deslocamento especificado no blob de página, usando a ID de concessão especificada, as opções de solicitação e o contexto de operação.

Parameters:

sourceStream - Um InputStream objeto que representa o fluxo de entrada a ser gravado no blob de páginas.

offset - Um long que representa o deslocamento, em número de bytes, no qual começar a gravar os dados. Esse valor deve ser um múltiplo de 512.

length - Um long que representa o comprimento, em bytes, dos dados a serem gravados. Esse valor deve ser um múltiplo de 512.

accessCondition - Um AccessCondition objeto 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 OperationContext objeto 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:

IllegalArgumentException - Se o deslocamento ou o comprimento não forem múltiplos de 512 ou se o comprimento for maior que 4 MB.

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

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

uploadPremiumPageBlobTier

public void uploadPremiumPageBlobTier(final PremiumPageBlobTier premiumBlobTier)

Define a camada de blob em um blob de páginas em uma conta de armazenamento premium.

Parameters:

premiumBlobTier - Um PremiumPageBlobTier objeto que representa a camada do blob.

Throws:

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

uploadPremiumPageBlobTier

public void uploadPremiumPageBlobTier(final PremiumPageBlobTier premiumBlobTier, BlobRequestOptions options, OperationContext opContext)

Define a camada em um blob de páginas em uma conta de armazenamento premium.

Parameters:

premiumBlobTier - Um PremiumPageBlobTier objeto que representa a camada do 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 OperationContext objeto 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.