Freigeben über


CloudPageBlob Klasse

public class CloudPageBlob extends CloudBlob

Stellt ein Microsoft Azure-Seitenblob dar.

Zusammenfassung zum Konstruktor

Konstruktor Beschreibung
CloudPageBlob(final CloudPageBlob otherBlob)

Erstellt eine instance der -Klasse durch Kopieren von Werten aus einem anderen Seitenblob.

CloudPageBlob(final StorageUri blobAbsoluteUri)

Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI und Speicherdienstclients.

CloudPageBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)

Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten StorageUri und der angegebenen Anmeldeinformationen.

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

Erstellt eine instance der -Klasse mit dem angegebenen absoluten StorageUri, Momentaufnahme-ID und Anmeldeinformationen.

CloudPageBlob(final URI blobAbsoluteUri)

Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI und Speicherdienstclients.

CloudPageBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)

Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI und der angegebenen Anmeldeinformationen.

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

Erstellt eine instance der -Klasse mit dem angegebenen absoluten URI, Momentaufnahme ID und Anmeldeinformationen.

CloudPageBlob(String blobName, String snapshotID, CloudBlobContainer container)

Erstellt eine instance der Klasse unter Verwendung des angegebenen Typs, namens, Momentaufnahme ID und Des Containers.

Methodenzusammenfassung

Modifizierer und Typ Methode und Beschreibung
void clearPages(final long offset, final long length)

Löscht Seiten aus einem Seitenblob.

Beim Aufrufen wird der von den angegebenen Seiten verwendete Speicherplatz freigegeben. Gelöschte Seiten werden nicht mehr als Teil des Seitenblobs nachverfolgt, und es fallen keine Gebühren mehr für das Speicherkonto an.

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

Löscht Seiten aus einem Seitenblob unter Verwendung der angegebenen Lease-ID, der Anforderungsoptionen und des Vorgangskontexts.

Beim Aufrufen wird der von den angegebenen Seiten verwendete Speicherplatz freigegeben. Gelöschte Seiten werden nicht mehr als Teil des Seitenblobs nachverfolgt, und es fallen keine Gebühren mehr für das Speicherkonto an.

void create(final long length)

Erstellt ein Seitenblob. Wenn das Blob bereits vorhanden ist, wird es ersetzt. Um stattdessen einen Fehler auszulösen, wenn das Blob bereits vorhanden ist, verwenden Sie die create(final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Überladung mit generateIfNotExistsCondition().

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

Erstellt ein Seitenblob mit den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext. Wenn das Blob bereits vorhanden ist, wird es ersetzt. Verwenden Sie generateIfNotExistsCondition(), um stattdessen einen Fehler auszulösen, wenn das Blob bereits vorhanden ist.

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

Erstellt ein Seitenblob mit den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext. Wenn das Blob bereits vorhanden ist, wird es ersetzt. Verwenden Sie generateIfNotExistsCondition(), um stattdessen einen Fehler auszulösen, wenn das Blob bereits vorhanden ist.

ArrayList<PageRange> downloadPageRanges()

Gibt eine Auflistung von Seitenbereichen und deren Anfangs- und Endbyteoffset zurück.

Die Start- und Endbyteoffsets für die einzelnen Seitenbereiche sind inklusiv.

ArrayList<PageRange> downloadPageRanges(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Gibt eine Auflistung von Seitenbereichen und deren Anfangs- und Endbyteoffsets unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts zurück.

List<PageRange> downloadPageRanges(final long offset, final Long length)

Gibt eine Auflistung von Seitenbereichen und deren Anfangs- und Endbyteoffset zurück.

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

Gibt eine Auflistung von Seitenbereichen und deren Anfangs- und Endbyteoffsets unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts zurück.

List<PageRangeDiff> downloadPageRangesDiff(final String previousSnapshot)

Ruft die Auflistung von Seitenbereichen ab, die sich zwischen einem angegebenen Momentaufnahme und diesem Objekt unterscheiden.

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

Ruft die Auflistung von Seitenbereichen ab, die sich zwischen einem angegebenen Momentaufnahme und diesem Objekt unterscheiden.

BlobOutputStream openWriteExisting()

Öffnet ein Ausgabestreamobjekt zum Schreiben von Daten in das Seitenblob. Das Seitenblob muss bereits vorhanden sein, und alle vorhandenen Daten können überschrieben werden.

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

Öffnet ein Ausgabestreamobjekt, um Daten unter Verwendung der angegebenen Lease-ID, der Angegebenen Anforderungsoptionen und des Vorgangskontexts in das Seitenblob zu schreiben. Das Seitenblob muss bereits vorhanden sein, und alle vorhandenen Daten können überschrieben werden.

BlobOutputStream openWriteNew(final long length)

Öffnet ein Ausgabestreamobjekt zum Schreiben von Daten in das Seitenblob. Das Seitenblob muss noch nicht vorhanden sein und wird mit der angegebenen Länge erstellt. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

Um ein Überschreiben zu vermeiden und stattdessen einen Fehler auszulösen, verwenden Sie die openWriteNew(final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Überladung mit der entsprechenden AccessCondition.

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

Öffnet ein Ausgabestreamobjekt, um Daten unter Verwendung der angegebenen Lease-ID, der Angegebenen Anforderungsoptionen und des Vorgangskontexts in das Seitenblob zu schreiben. Das Seitenblob muss noch nicht vorhanden sein und wird mit der angegebenen Länge erstellt. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

Um ein Überschreiben zu vermeiden und stattdessen einen Fehler auszulösen, übergeben Sie eine AccessCondition mit generateIfNotExistsCondition()generierte .

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

Öffnet ein Ausgabestreamobjekt, um Daten unter Verwendung der angegebenen Lease-ID, der Angegebenen Anforderungsoptionen und des Vorgangskontexts in das Seitenblob zu schreiben. Das Seitenblob muss noch nicht vorhanden sein und wird mit der angegebenen Länge erstellt. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

Um ein Überschreiben zu vermeiden und stattdessen einen Fehler auszulösen, übergeben Sie eine AccessCondition mit generateIfNotExistsCondition()generierte .

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

Schreibt einen PageRange-Wert unter Verwendung der angegebenen Quell-URL.

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

Schreibt einen PageRange-Wert unter Verwendung der angegebenen Quell-URL.

void resize(long size)

Ändert die Größe des Seitenblobs in die angegebene Größe.

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

Ändert die Größe des Seitenblobs in die angegebene Größe.

void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)

Legt die Anzahl der Bytes fest, die beim Schreiben in eine gepuffert BlobOutputStreamwerden sollen.

final String startCopy(final CloudPageBlob sourceBlob)

Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines Blobs in ein neues Blob zu beginnen.

final String startCopy(final CloudPageBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines Blobs in ein neues Blob unter Verwendung der angegebenen Zugriffsbedingungen, der Lease-ID, der Anforderungsoptionen und des Vorgangskontexts zu beginnen.

final String startCopy(final CloudPageBlob sourceBlob, final PremiumPageBlobTier premiumBlobTier, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines Blobs in ein neues Blob unter Verwendung der angegebenen Blobebene, der angegebenen Zugriffsbedingungen, der Lease-ID, der Anforderungsoptionen und des Vorgangskontexts zu beginnen.

final String startIncrementalCopy(final CloudPageBlob sourceSnapshot)

Fordert den Dienst auf, eine inkrementelle Kopie des Inhalts, der Eigenschaften und der Metadaten eines anderen Seitenblobs für dieses Blob zu starten.

final String startIncrementalCopy(final CloudPageBlob sourceSnapshot, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines Blobs in ein neues Blob unter Verwendung der angegebenen Zugriffsbedingungen, der Lease-ID, der Anforderungsoptionen und des Vorgangskontexts zu beginnen.

final String startIncrementalCopy(final URI sourceSnapshot)

Fordert den Dienst auf, eine inkrementelle Kopie des Inhalts, der Eigenschaften und der Metadaten eines anderen Seitenblobs für dieses Blob zu starten.

final String startIncrementalCopy(final URI sourceSnapshot, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines Blobs in ein neues Blob unter Verwendung der angegebenen Zugriffsbedingungen, der Lease-ID, der Anforderungsoptionen und des Vorgangskontexts zu beginnen.

void updateSequenceNumberFromResponse(HttpURLConnection request)
void upload(final InputStream sourceStream, final long length)

Lädt die Quellstreamdaten in das Seitenblob hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

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

Lädt die Quellstreamdaten unter Verwendung der angegebenen Lease-ID, der angegebenen Anforderungsoptionen und des Vorgangskontexts in das Seitenblob hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

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

Lädt die Quellstreamdaten unter Verwendung der angegebenen Lease-ID, der angegebenen Anforderungsoptionen und des Vorgangskontexts in das Seitenblob hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

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

Lädt ein Blob aus Daten in einem Bytearray hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

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

Lädt ein Blob aus einer Datei hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

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

Lädt einen Bereich zusammenhängender Seiten mit einer Größe von bis zu 4 MB am angegebenen Offset im Seitenblob hoch.

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

Lädt einen Bereich von zusammenhängenden Seiten mit einer Größe von bis zu 4 MB am angegebenen Offset im Seitenblob hoch, wobei die angegebene Lease-ID, die angegebenen Anforderungsoptionen und der angegebene Vorgangskontext verwendet werden.

void uploadPremiumPageBlobTier(final PremiumPageBlobTier premiumBlobTier)

Legt die Blobebene für ein Seitenblob in einem Storage Premium-Konto fest.

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

Legt die Ebene für ein Seitenblob in einem Storage Premium-Konto fest.

Geerbte Elemente

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)

Details zum Konstruktor

CloudPageBlob

public CloudPageBlob(final CloudPageBlob otherBlob)

Erstellt eine instance der -Klasse durch Kopieren von Werten aus einem anderen Seitenblob.

Parameters:

otherBlob - Ein CloudPageBlob -Objekt, das das zu kopierende Seitenblob darstellt.

CloudPageBlob

public CloudPageBlob(final StorageUri blobAbsoluteUri)

Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI und Speicherdienstclients.

Parameters:

blobAbsoluteUri - Ein StorageUri -Objekt, das den absoluten URI für das Blob darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

CloudPageBlob

public CloudPageBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)

Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten StorageUri und der angegebenen Anmeldeinformationen.

Parameters:

blobAbsoluteUri - Ein StorageUri -Objekt, das den absoluten URI für das Blob darstellt.
credentials - Ein StorageCredentials -Objekt, das zum Authentifizieren des Zugriffs verwendet wird.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

CloudPageBlob

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

Erstellt eine instance der -Klasse mit dem angegebenen absoluten StorageUri, Momentaufnahme-ID und Anmeldeinformationen.

Parameters:

blobAbsoluteUri - Ein StorageUri -Objekt, das den absoluten URI für das Blob darstellt.
snapshotID - Ein String , der ggf. die Momentaufnahme Version darstellt.
credentials - Ein StorageCredentials -Objekt, das zum Authentifizieren des Zugriffs verwendet wird.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

CloudPageBlob

public CloudPageBlob(final URI blobAbsoluteUri)

Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI und Speicherdienstclients.

Parameters:

blobAbsoluteUri - Ein java.net.URI -Objekt, das den absoluten URI für das Blob darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

CloudPageBlob

public CloudPageBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)

Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI und der angegebenen Anmeldeinformationen.

Parameters:

blobAbsoluteUri - Ein java.net.URI -Objekt, das den absoluten URI für das Blob darstellt.
credentials - Ein StorageCredentials -Objekt, das zum Authentifizieren des Zugriffs verwendet wird.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

CloudPageBlob

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

Erstellt eine instance der -Klasse mit dem angegebenen absoluten URI, Momentaufnahme ID und Anmeldeinformationen.

Parameters:

blobAbsoluteUri - Ein java.net.URI -Objekt, das den absoluten URI für das Blob darstellt.
snapshotID - Ein String , der ggf. die Momentaufnahme Version darstellt.
credentials - Ein StorageCredentials -Objekt, das zum Authentifizieren des Zugriffs verwendet wird.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

CloudPageBlob

protected CloudPageBlob(String blobName, String snapshotID, CloudBlobContainer container)

Erstellt eine instance der Klasse unter Verwendung des angegebenen Typs, namens, Momentaufnahme ID und Des Containers.

Parameters:

blobName - Der Name des Blobs.
snapshotID - EineString, die ggf. die Momentaufnahme Version darstellt.
container - Der Verweis auf den übergeordneten Container.

Throws:

URISyntaxException - Wenn der Ressourcen-URI ungültig ist.

Details zur Methode

clearPages

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

Löscht Seiten aus einem Seitenblob.

Beim Aufrufen wird der von den angegebenen Seiten verwendete Speicherplatz freigegeben. Gelöschte Seiten werden nicht mehr als Teil des Seitenblobs nachverfolgt, und es fallen keine Gebühren mehr für das Speicherkonto an.

Parameters:

offset - Der Offset in Bytes, bei dem mit dem Löschen von Seiten begonnen werden soll. Dieser Wert muss ein Vielfaches von 512 sein.
length - Die Länge des zu löschenden Datenbereichs in Bytes. Dieser Wert muss ein Vielfaches von 512 sein.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

clearPages

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

Löscht Seiten aus einem Seitenblob unter Verwendung der angegebenen Lease-ID, der Anforderungsoptionen und des Vorgangskontexts.

Beim Aufrufen wird der von den angegebenen Seiten verwendete Speicherplatz freigegeben. Gelöschte Seiten werden nicht mehr als Teil des Seitenblobs nachverfolgt, und es fallen keine Gebühren mehr für das Speicherkonto an.

Parameters:

offset - Ein long , der den Offset in Bytes darstellt, an dem mit dem Löschen von Seiten begonnen werden soll. Dieser Wert muss ein Vielfaches von 512 sein.
length - Eine long , die die Länge des zu löschenden Datenbereichs in Bytes darstellt. Dieser Wert muss ein Vielfaches von 512 sein.
accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Blob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

create

public void create(final long length)

Erstellt ein Seitenblob. Wenn das Blob bereits vorhanden ist, wird es ersetzt. Um stattdessen einen Fehler auszulösen, wenn das Blob bereits vorhanden ist, verwenden Sie die create(final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Überladung mit generateIfNotExistsCondition().

Parameters:

length - Ein long , der die Größe des Seitenblobs in Bytes darstellt.

Throws:

IllegalArgumentException - Wenn die Länge kein Vielfaches von 512 ist.
StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

create

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

Erstellt ein Seitenblob mit den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext. Wenn das Blob bereits vorhanden ist, wird es ersetzt. Verwenden Sie generateIfNotExistsCondition(), um stattdessen einen Fehler auszulösen, wenn das Blob bereits vorhanden ist.

Parameters:

length - Ein long , der die Größe des Seitenblobs in Bytes darstellt.
accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Blob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

IllegalArgumentException - Wenn die Länge kein Vielfaches von 512 ist.
StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

create

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

Erstellt ein Seitenblob mit den angegebenen Anforderungsoptionen und dem angegebenen Vorgangskontext. Wenn das Blob bereits vorhanden ist, wird es ersetzt. Verwenden Sie generateIfNotExistsCondition(), um stattdessen einen Fehler auszulösen, wenn das Blob bereits vorhanden ist.

Parameters:

length - Ein long , der die Größe des Seitenblobs in Bytes darstellt.
premiumBlobTier - Ein PremiumPageBlobTier -Objekt, das die Ebene des Blobs darstellt.
accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Blob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

IllegalArgumentException - Wenn die Länge kein Vielfaches von 512 ist.
StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadPageRanges

public ArrayList downloadPageRanges()

Gibt eine Auflistung von Seitenbereichen und deren Anfangs- und Endbyteoffset zurück.

Die Start- und Endbyteoffsets für die einzelnen Seitenbereiche sind inklusiv.

Returns:

Ein ArrayList -Objekt, das den Satz von Seitenbereichen und deren Anfangs- und Endbyteoffset darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadPageRanges

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

Gibt eine Auflistung von Seitenbereichen und deren Anfangs- und Endbyteoffsets unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts zurück.

Parameters:

accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Blob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein ArrayList -Objekt, das den Satz von Seitenbereichen und deren Anfangs- und Endbyteoffset darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadPageRanges

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

Gibt eine Auflistung von Seitenbereichen und deren Anfangs- und Endbyteoffset zurück.

Parameters:

offset - Der Startoffset des Datenbereichs, über den Seitenbereiche aufgelistet werden (in Bytes). Muss ein Vielfaches von 512 sein.
length - Die Länge des Datenbereichs, über den Seitenbereiche aufgelistet werden (in Bytes). Muss ein Vielfaches von 512 sein.

Returns:

Ein List -Objekt, das den Satz von Seitenbereichen und deren Anfangs- und Endbyteoffset darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadPageRanges

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

Gibt eine Auflistung von Seitenbereichen und deren Anfangs- und Endbyteoffsets unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts zurück.

Parameters:

offset - Der Startoffset des Datenbereichs, über den Seitenbereiche aufgelistet werden (in Bytes). Muss ein Vielfaches von 512 sein.
length - Die Länge des Datenbereichs, über den Seitenbereiche aufgelistet werden (in Bytes). Muss ein Vielfaches von 512 sein.
accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Blob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein List -Objekt, das den Satz von Seitenbereichen und deren Anfangs- und Endbyteoffset darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadPageRangesDiff

public List downloadPageRangesDiff(final String previousSnapshot)

Ruft die Auflistung von Seitenbereichen ab, die sich zwischen einem angegebenen Momentaufnahme und diesem Objekt unterscheiden.

Parameters:

previousSnapshot - Eine Zeichenfolge, die die Momentaufnahme darstellt, die als Ausgangspunkt für die diff verwendet werden sollen. Wenn dieser CloudPageBlob eine Momentaufnahme darstellt, muss der vorherigeSnapshot-Parameter vor dem aktuellen Momentaufnahme.

Returns:

Ein List -Objekt, das den Satz unterschiedlicher Seitenbereiche enthält.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

downloadPageRangesDiff

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

Ruft die Auflistung von Seitenbereichen ab, die sich zwischen einem angegebenen Momentaufnahme und diesem Objekt unterscheiden.

Parameters:

previousSnapshot - Eine Zeichenfolge, die den Momentaufnahme Zeitstempel darstellt, der als Ausgangspunkt für die diff verwendet werden soll. Wenn dieser CloudPageBlob eine Momentaufnahme darstellt, muss der vorherigeSnapshot-Parameter vor dem aktuellen Momentaufnahme.
offset - Der Startoffset des Datenbereichs, über den Seitenbereiche aufgelistet werden (in Bytes). Muss ein Vielfaches von 512 sein.
length - Die Länge des Datenbereichs, über den Seitenbereiche aufgelistet werden (in Bytes). Muss ein Vielfaches von 512 sein.
accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Blob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein List -Objekt, das den Satz unterschiedlicher Seitenbereiche enthält.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

openWriteExisting

public BlobOutputStream openWriteExisting()

Öffnet ein Ausgabestreamobjekt zum Schreiben von Daten in das Seitenblob. Das Seitenblob muss bereits vorhanden sein, und alle vorhandenen Daten können überschrieben werden.

Returns:

Ein BlobOutputStream -Objekt, das zum Schreiben von Daten in das Blob verwendet wird.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

openWriteExisting

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

Öffnet ein Ausgabestreamobjekt, um Daten unter Verwendung der angegebenen Lease-ID, der Angegebenen Anforderungsoptionen und des Vorgangskontexts in das Seitenblob zu schreiben. Das Seitenblob muss bereits vorhanden sein, und alle vorhandenen Daten können überschrieben werden.

Parameters:

accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Blob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein BlobOutputStream -Objekt, das zum Schreiben von Daten in das Blob verwendet wird.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

openWriteNew

public BlobOutputStream openWriteNew(final long length)

Öffnet ein Ausgabestreamobjekt zum Schreiben von Daten in das Seitenblob. Das Seitenblob muss noch nicht vorhanden sein und wird mit der angegebenen Länge erstellt. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

Um ein Überschreiben zu vermeiden und stattdessen einen Fehler auszulösen, verwenden Sie die openWriteNew(final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) Überladung mit der entsprechenden AccessCondition.

Parameters:

length - Ein long , der die Länge des zu erstellenden Streams in Bytes darstellt. Dieser Wert muss ein Vielfaches von 512 sein.

Returns:

Ein BlobOutputStream -Objekt, das zum Schreiben von Daten in das Blob verwendet wird.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

openWriteNew

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

Öffnet ein Ausgabestreamobjekt, um Daten unter Verwendung der angegebenen Lease-ID, der Angegebenen Anforderungsoptionen und des Vorgangskontexts in das Seitenblob zu schreiben. Das Seitenblob muss noch nicht vorhanden sein und wird mit der angegebenen Länge erstellt. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

Um ein Überschreiben zu vermeiden und stattdessen einen Fehler auszulösen, übergeben Sie eine AccessCondition mit generateIfNotExistsCondition()generierte .

Parameters:

length - Ein long , der die Länge des zu erstellenden Streams in Bytes darstellt. Dieser Wert muss ein Vielfaches von 512 sein.
accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Blob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein BlobOutputStream -Objekt, das zum Schreiben von Daten in das Blob verwendet wird.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

openWriteNew

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

Öffnet ein Ausgabestreamobjekt, um Daten unter Verwendung der angegebenen Lease-ID, der Angegebenen Anforderungsoptionen und des Vorgangskontexts in das Seitenblob zu schreiben. Das Seitenblob muss noch nicht vorhanden sein und wird mit der angegebenen Länge erstellt. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

Um ein Überschreiben zu vermeiden und stattdessen einen Fehler auszulösen, übergeben Sie eine AccessCondition mit generateIfNotExistsCondition()generierte .

Parameters:

length - Ein long , der die Länge des zu erstellenden Streams in Bytes darstellt. Dieser Wert muss ein Vielfaches von 512 sein.
premiumBlobTier - Ein PremiumPageBlobTier -Objekt, das die Ebene des Blobs darstellt.
accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Blob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein BlobOutputStream -Objekt, das zum Schreiben von Daten in das Blob verwendet wird.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

putPagesFromURI

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

Schreibt einen PageRange-Wert unter Verwendung der angegebenen Quell-URL.

Parameters:

offset - Der Offset in Bytes, an dem mit dem Schreiben von Seiten begonnen werden soll. Dieser Wert muss ein Vielfaches von 512 sein.
length - Die Länge des zu schreibenden Datenbereichs in Bytes. Dieser Wert muss ein Vielfaches von 512 sein. Dieser Wert wird auch als Länge der Daten verwendet, die aus der Quelle kopiert werden sollen.
copySource - Die URI der Quelldaten. Sie kann auf ein beliebiges Azure-Blob oder eine Datei verweisen, die öffentlich ist, oder die URL kann eine Shared Access Signature enthalten.
sourceOffset - Ein long , der den Offset darstellt, der als Ausgangspunkt für die Quelle verwendet werden soll. Die Länge der daten, die aus der Quelle kopiert werden sollen, wird aus dem Parameter für die Quelllänge übernommen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

putPagesFromURI

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

Schreibt einen PageRange-Wert unter Verwendung der angegebenen Quell-URL.

Parameters:

offset - Der Offset in Bytes, an dem mit dem Schreiben von Seiten begonnen werden soll. Dieser Wert muss ein Vielfaches von 512 sein.
length - Die Länge des zu schreibenden Datenbereichs in Bytes. Dieser Wert muss ein Vielfaches von 512 sein. Dieser Wert wird auch als Länge der Daten verwendet, die aus der Quelle kopiert werden sollen.
copySource - Die URI der Quelldaten. Sie kann auf ein beliebiges Azure-Blob oder eine Datei verweisen, die öffentlich ist, oder die URL kann eine Shared Access Signature enthalten.
sourceOffset - Ein long , der den Offset darstellt, der als Ausgangspunkt für die Quelle verwendet werden soll. Die Länge der daten, die aus der Quelle kopiert werden sollen, wird aus dem Parameter für die Quelllänge übernommen.
md5 - Ein String , der den MD5-Hash für die Daten darstellt.
accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Blob darstellt.
sourceAccessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Quellblob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

resize

public void resize(long size)

Ändert die Größe des Seitenblobs in die angegebene Größe.

Parameters:

size - Ein long , der die Größe des Seitenblobs in Bytes darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

resize

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

Ändert die Größe des Seitenblobs in die angegebene Größe.

Parameters:

size - Ein long , der die Größe des Seitenblobs in Bytes darstellt.
accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Blob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

setStreamWriteSizeInBytes

public void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)

Legt die Anzahl der Bytes fest, die beim Schreiben in eine gepuffert BlobOutputStreamwerden sollen.

Parameters:

streamWriteSizeInBytes - Ein int , der die maximale Anzahl von Bytes darstellt, die beim Schreiben in einen Seitenblobstream gepuffert werden sollen. Dieser Wert muss ein Vielfaches von 512 und kleiner oder gleich 4 MB sein.

Throws:

IllegalArgumentException - Wenn streamWriteSizeInBytes kleiner als 512, größer als 4 MB oder kein Vielfaches oder 512 ist.

startCopy

public final String startCopy(final CloudPageBlob sourceBlob)

Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines Blobs in ein neues Blob zu beginnen.

Parameters:

sourceBlob - Ein CloudPageBlob -Objekt, das das zu kopierende Quellblob darstellt.

Returns:

Ein String , der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.
URISyntaxException

startCopy

public final String startCopy(final CloudPageBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines Blobs in ein neues Blob unter Verwendung der angegebenen Zugriffsbedingungen, der Lease-ID, der Anforderungsoptionen und des Vorgangskontexts zu beginnen.

Parameters:

sourceBlob - Ein CloudPageBlob -Objekt, das das zu kopierende Quellblob darstellt.
sourceAccessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Quellblob darstellt.
destinationAccessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Zielblob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein String , der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.
URISyntaxException

startCopy

public final String startCopy(final CloudPageBlob sourceBlob, final PremiumPageBlobTier premiumBlobTier, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines Blobs in ein neues Blob unter Verwendung der angegebenen Blobebene, der angegebenen Zugriffsbedingungen, der Lease-ID, der Anforderungsoptionen und des Vorgangskontexts zu beginnen.

Parameters:

sourceBlob - Ein CloudPageBlob -Objekt, das das zu kopierende Quellblob darstellt.
premiumBlobTier - Ein PremiumPageBlobTier -Objekt, das die Ebene des Blobs darstellt.
sourceAccessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Quellblob darstellt.
destinationAccessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Zielblob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein String , der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.
URISyntaxException

startIncrementalCopy

public final String startIncrementalCopy(final CloudPageBlob sourceSnapshot)

Fordert den Dienst auf, eine inkrementelle Kopie des Inhalts, der Eigenschaften und der Metadaten eines anderen Seitenblobs für dieses Blob zu starten.

Parameters:

sourceSnapshot - Ein CloudPageBlob -Objekt, das das zu kopierende Quellblob darstellt. Muss ein Momentaufnahme sein.

Returns:

Ein String , der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.
URISyntaxException

startIncrementalCopy

public final String startIncrementalCopy(final CloudPageBlob sourceSnapshot, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines Blobs in ein neues Blob unter Verwendung der angegebenen Zugriffsbedingungen, der Lease-ID, der Anforderungsoptionen und des Vorgangskontexts zu beginnen.

Parameters:

sourceSnapshot - Ein CloudPageBlob -Objekt, das das zu kopierende Quellblob darstellt. Muss ein Momentaufnahme sein.
destinationAccessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Zielblob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein String , der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.
URISyntaxException

startIncrementalCopy

public final String startIncrementalCopy(final URI sourceSnapshot)

Fordert den Dienst auf, eine inkrementelle Kopie des Inhalts, der Eigenschaften und der Metadaten eines anderen Seitenblobs für dieses Blob zu starten.

Parameters:

sourceSnapshot - Ein CloudPageBlob -Objekt, das das zu kopierende Quellblob darstellt. Muss ein Momentaufnahme sein.

Returns:

Ein String , der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.
URISyntaxException

startIncrementalCopy

public final String startIncrementalCopy(final URI sourceSnapshot, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Fordert den Dienst auf, mit dem Kopieren der Inhalte, Eigenschaften und Metadaten eines Blobs in ein neues Blob unter Verwendung der angegebenen Zugriffsbedingungen, der Lease-ID, der Anforderungsoptionen und des Vorgangskontexts zu beginnen.

Parameters:

sourceSnapshot - Ein CloudPageBlob -Objekt, das das zu kopierende Quellblob darstellt. Muss ein Momentaufnahme sein.
destinationAccessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Zielblob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

Ein String , der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.
URISyntaxException

updateSequenceNumberFromResponse

protected void updateSequenceNumberFromResponse(HttpURLConnection request)

Parameters:

request

upload

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

Lädt die Quellstreamdaten in das Seitenblob hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

Parameters:

sourceStream - Ein InputStream Objekt, aus dem gelesen werden soll.
length - Eine long , die die Länge der Datenstromdaten in Bytes darstellt, muss ungleich 0 (null) und ein Vielfaches von 512 sein.

Throws:

IOException - Wenn eine E/A-Ausnahme aufgetreten ist.
StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

upload

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

Lädt die Quellstreamdaten unter Verwendung der angegebenen Lease-ID, der angegebenen Anforderungsoptionen und des Vorgangskontexts in das Seitenblob hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

Parameters:

sourceStream - Ein InputStream Objekt, aus dem gelesen werden soll.
length - Ein long , der die Länge der Datenstromdaten in Bytes darstellt. Dies muss groß als 0 (null) und ein Vielfaches von 512 sein.
accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Blob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

IOException - Wenn eine E/A-Ausnahme aufgetreten ist.
StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

upload

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

Lädt die Quellstreamdaten unter Verwendung der angegebenen Lease-ID, der angegebenen Anforderungsoptionen und des Vorgangskontexts in das Seitenblob hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

Parameters:

sourceStream - Ein InputStream Objekt, aus dem gelesen werden soll.
length - Ein long , der die Länge der Datenstromdaten in Bytes darstellt. Dies muss groß als 0 (null) und ein Vielfaches von 512 sein.
premiumBlobTier - Ein PremiumPageBlobTier -Objekt, das die Ebene des Blobs darstellt.
accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Blob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

IOException - Wenn eine E/A-Ausnahme aufgetreten ist.
StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

uploadFromByteArray

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

Lädt ein Blob aus Daten in einem Bytearray hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

Parameters:

buffer - Ein byte Array, das die Daten darstellt, die in das Blob geschrieben werden sollen.
offset - Ein int , der den Offset des Bytearrays darstellt, aus dem der Datenupload gestartet werden soll.
length - Ein int , der die Anzahl der Bytes darstellt, die aus dem Eingabepuffer hochgeladen werden sollen.
premiumBlobTier - Ein PremiumPageBlobTier -Objekt, das die Ebene des Blobs darstellt.
accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.
IOException

uploadFromFile

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

Lädt ein Blob aus einer Datei hoch. Wenn das Blob bereits im Dienst vorhanden ist, wird es überschrieben.

Parameters:

path - Ein String , der den Pfad zur datei darstellt, die hochgeladen werden soll.
premiumBlobTier - Ein PremiumPageBlobTier -Objekt, das die Ebene des Blobs darstellt.
accessCondition - Ein AccessCondition-Objekt, das die Zugriffsbedingungen für das Blob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.
IOException

uploadPages

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

Lädt einen Bereich zusammenhängender Seiten mit einer Größe von bis zu 4 MB am angegebenen Offset im Seitenblob hoch.

Parameters:

sourceStream - Ein InputStream -Objekt, das den Eingabedatenstrom darstellt, der in das Seitenblob geschrieben werden soll.
offset - Ein long , der den Offset in Byte darstellt, an dem mit dem Schreiben der Daten begonnen werden soll. Dieser Wert muss ein Vielfaches von 512 sein.
length - Ein long , der die Länge der zu schreibenden Daten in Bytes darstellt. Dieser Wert muss ein Vielfaches von 512 sein.

Throws:

IllegalArgumentException - Wenn der Offset oder die Länge kein Vielfaches von 512 sind oder wenn die Länge größer als 4 MB ist.
IOException - Wenn eine E/A-Ausnahme aufgetreten ist.
StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

uploadPages

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

Lädt einen Bereich von zusammenhängenden Seiten mit einer Größe von bis zu 4 MB am angegebenen Offset im Seitenblob hoch, wobei die angegebene Lease-ID, die angegebenen Anforderungsoptionen und der angegebene Vorgangskontext verwendet werden.

Parameters:

sourceStream - Ein InputStream -Objekt, das den Eingabedatenstrom darstellt, der in das Seitenblob geschrieben werden soll.
offset - Ein long , der den Offset in Byte darstellt, an dem mit dem Schreiben der Daten begonnen werden soll. Dieser Wert muss ein Vielfaches von 512 sein.
length - Ein long , der die Länge der zu schreibenden Daten in Bytes darstellt. Dieser Wert muss ein Vielfaches von 512 sein.
accessCondition - Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Blob darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

IllegalArgumentException - Wenn der Offset oder die Länge kein Vielfaches von 512 sind oder wenn die Länge größer als 4 MB ist.
IOException - Wenn eine E/A-Ausnahme aufgetreten ist.
StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

uploadPremiumPageBlobTier

public void uploadPremiumPageBlobTier(final PremiumPageBlobTier premiumBlobTier)

Legt die Blobebene für ein Seitenblob in einem Storage Premium-Konto fest.

Parameters:

premiumBlobTier - Ein PremiumPageBlobTier -Objekt, das die Ebene des Blobs darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

uploadPremiumPageBlobTier

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

Legt die Ebene für ein Seitenblob in einem Storage Premium-Konto fest.

Parameters:

premiumBlobTier - Ein PremiumPageBlobTier -Objekt, das die Ebene des Blobs darstellt.
options - Ein BlobRequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Wenn Sie angeben, null werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
opContext - Ein OperationContext -Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

Gilt für: