CloudPageBlob Klasse
- java.
lang. Object - ListBlobItem
- CloudBlob
- com.
microsoft. azure. storage. blob. CloudPageBlob
- com.
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<Page |
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<Page |
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<Page |
downloadPageRanges(final long offset, final Long length)
Gibt eine Auflistung von Seitenbereichen und deren Anfangs- und Endbyteoffset zurück. |
List<Page |
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<Page |
downloadPageRangesDiff(final String previousSnapshot)
Ruft die Auflistung von Seitenbereichen ab, die sich zwischen einem angegebenen Momentaufnahme und diesem Objekt unterscheiden. |
List<Page |
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. |
Blob |
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. |
Blob |
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. |
Blob |
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. |
Blob |
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 . |
Blob |
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
Details zum Konstruktor
CloudPageBlob
public CloudPageBlob(final CloudPageBlob otherBlob)
Erstellt eine instance der -Klasse durch Kopieren von Werten aus einem anderen Seitenblob.
Parameters:
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:
Throws:
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:
Throws:
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:
String
, der ggf. die Momentaufnahme Version darstellt.
Throws:
CloudPageBlob
public CloudPageBlob(final URI blobAbsoluteUri)
Erstellt eine instance der -Klasse unter Verwendung des angegebenen absoluten URI und Speicherdienstclients.
Parameters:
java.net.URI
-Objekt, das den absoluten URI für das Blob darstellt.
Throws:
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:
java.net.URI
-Objekt, das den absoluten URI für das Blob darstellt.
Throws:
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:
java.net.URI
-Objekt, das den absoluten URI für das Blob darstellt.
String
, der ggf. die Momentaufnahme Version darstellt.
Throws:
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:
String
, die ggf. die Momentaufnahme Version darstellt.
Throws:
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:
Throws:
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:
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.
long
, die die Länge des zu löschenden Datenbereichs in Bytes darstellt. Dieser Wert muss ein Vielfaches von 512 sein.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Throws:
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:
long
, der die Größe des Seitenblobs in Bytes darstellt.
Throws:
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:
long
, der die Größe des Seitenblobs in Bytes darstellt.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Throws:
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:
long
, der die Größe des Seitenblobs in Bytes darstellt.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Throws:
downloadPageRanges
public ArrayList
Gibt eine Auflistung von Seitenbereichen und deren Anfangs- und Endbyteoffset zurück.
Die Start- und Endbyteoffsets für die einzelnen Seitenbereiche sind inklusiv.
Returns:
ArrayList
-Objekt, das den Satz von Seitenbereichen und deren Anfangs- und Endbyteoffset darstellt.Throws:
downloadPageRanges
public ArrayList
Gibt eine Auflistung von Seitenbereichen und deren Anfangs- und Endbyteoffsets unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts zurück.
Parameters:
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Returns:
ArrayList
-Objekt, das den Satz von Seitenbereichen und deren Anfangs- und Endbyteoffset darstellt.Throws:
downloadPageRanges
public List
Gibt eine Auflistung von Seitenbereichen und deren Anfangs- und Endbyteoffset zurück.
Parameters:
Returns:
List
-Objekt, das den Satz von Seitenbereichen und deren Anfangs- und Endbyteoffset darstellt.Throws:
downloadPageRanges
public List
Gibt eine Auflistung von Seitenbereichen und deren Anfangs- und Endbyteoffsets unter Verwendung der angegebenen Anforderungsoptionen und des angegebenen Vorgangskontexts zurück.
Parameters:
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Returns:
List
-Objekt, das den Satz von Seitenbereichen und deren Anfangs- und Endbyteoffset darstellt.Throws:
downloadPageRangesDiff
public List
Ruft die Auflistung von Seitenbereichen ab, die sich zwischen einem angegebenen Momentaufnahme und diesem Objekt unterscheiden.
Parameters:
Returns:
List
-Objekt, das den Satz unterschiedlicher Seitenbereiche enthält.Throws:
downloadPageRangesDiff
public List
Ruft die Auflistung von Seitenbereichen ab, die sich zwischen einem angegebenen Momentaufnahme und diesem Objekt unterscheiden.
Parameters:
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Returns:
List
-Objekt, das den Satz unterschiedlicher Seitenbereiche enthält.Throws:
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:
Throws:
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:
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Returns:
Throws:
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:
long
, der die Länge des zu erstellenden Streams in Bytes darstellt. Dieser Wert muss ein Vielfaches von 512 sein.
Returns:
Throws:
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:
long
, der die Länge des zu erstellenden Streams in Bytes darstellt. Dieser Wert muss ein Vielfaches von 512 sein.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Returns:
Throws:
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:
long
, der die Länge des zu erstellenden Streams in Bytes darstellt. Dieser Wert muss ein Vielfaches von 512 sein.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Returns:
Throws:
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:
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.
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:
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:
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.
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.
String
, der den MD5-Hash für die Daten darstellt.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Throws:
resize
public void resize(long size)
Ändert die Größe des Seitenblobs in die angegebene Größe.
Parameters:
long
, der die Größe des Seitenblobs in Bytes darstellt.
Throws:
resize
public void resize(long size, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)
Ändert die Größe des Seitenblobs in die angegebene Größe.
Parameters:
long
, der die Größe des Seitenblobs in Bytes darstellt.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Throws:
setStreamWriteSizeInBytes
public void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)
Legt die Anzahl der Bytes fest, die beim Schreiben in eine gepuffert BlobOutputStreamwerden sollen.
Parameters:
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:
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:
CloudPageBlob
-Objekt, das das zu kopierende Quellblob darstellt.
Returns:
String
, der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.Throws:
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:
CloudPageBlob
-Objekt, das das zu kopierende Quellblob darstellt.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Returns:
String
, der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.Throws:
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:
CloudPageBlob
-Objekt, das das zu kopierende Quellblob darstellt.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Returns:
String
, der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.Throws:
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:
CloudPageBlob
-Objekt, das das zu kopierende Quellblob darstellt. Muss ein Momentaufnahme sein.
Returns:
String
, der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.Throws:
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:
CloudPageBlob
-Objekt, das das zu kopierende Quellblob darstellt. Muss ein Momentaufnahme sein.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Returns:
String
, der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.Throws:
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:
CloudPageBlob
-Objekt, das das zu kopierende Quellblob darstellt. Muss ein Momentaufnahme sein.
Returns:
String
, der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.Throws:
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:
CloudPageBlob
-Objekt, das das zu kopierende Quellblob darstellt. Muss ein Momentaufnahme sein.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Returns:
String
, der die kopier-ID darstellt, die dem Kopiervorgang zugeordnet ist.Throws:
updateSequenceNumberFromResponse
protected void updateSequenceNumberFromResponse(HttpURLConnection request)
Parameters:
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:
long
, die die Länge der Datenstromdaten in Bytes darstellt, muss ungleich 0 (null) und ein Vielfaches von 512 sein.
Throws:
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:
long
, der die Länge der Datenstromdaten in Bytes darstellt. Dies muss groß als 0 (null) und ein Vielfaches von 512 sein.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Throws:
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:
long
, der die Länge der Datenstromdaten in Bytes darstellt. Dies muss groß als 0 (null) und ein Vielfaches von 512 sein.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Throws:
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:
byte
Array, das die Daten darstellt, die in das Blob geschrieben werden sollen.
int
, der den Offset des Bytearrays darstellt, aus dem der Datenupload gestartet werden soll.
int
, der die Anzahl der Bytes darstellt, die aus dem Eingabepuffer hochgeladen werden sollen.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Throws:
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:
String
, der den Pfad zur datei darstellt, die hochgeladen werden soll.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Throws:
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:
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.
long
, der die Länge der zu schreibenden Daten in Bytes darstellt. Dieser Wert muss ein Vielfaches von 512 sein.
Throws:
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:
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.
long
, der die Länge der zu schreibenden Daten in Bytes darstellt. Dieser Wert muss ein Vielfaches von 512 sein.
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Throws:
uploadPremiumPageBlobTier
public void uploadPremiumPageBlobTier(final PremiumPageBlobTier premiumBlobTier)
Legt die Blobebene für ein Seitenblob in einem Storage Premium-Konto fest.
Parameters:
Throws:
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:
null
werden die Standardanforderungsoptionen des zugeordneten Dienstclients ( CloudBlobClient) verwendet.
Throws:
Gilt für:
Azure SDK for Java