AppendBlobClient Klasse

Paket:

com.azure.storage.blob.specialized

Maven-Artefakt:

com.azure:azure-storage-blob:12.28.1

• java.lang.Object
• • com.azure.storage.blob.specialized.BlobClientBase
  • • com.azure.storage.blob.specialized.AppendBlobClient

public final class AppendBlobClient
extends BlobClientBase

Client an ein Anfügeblob. Sie kann nur über oder SpecializedBlobClientBuilder über die -Methode getAppendBlobClient()instanziiert werden. Diese Klasse enthält keinen Zustand für ein bestimmtes Blob, sondern ist stattdessen eine bequeme Möglichkeit, geeignete Anforderungen an die Ressource für den Dienst zu senden.

Dieser Client enthält Vorgänge für ein Blob. Vorgänge für einen Container sind in BlobContainerClientverfügbar, und Vorgänge für den Dienst sind auf BlobServiceClientverfügbar.

Weitere Informationen finden Sie in der Azure-Dokumentation .

Feldzusammenfassung

Modifizierer und Typ	Feld und Beschreibung
static final int	MAX_APPEND_BLOCK_BYTES Als veraltet markiert Verwenden Sie getMaxAppendBlockBytes(). Gibt die maximale Anzahl von Bytes an, die in einem Aufruf zum Anfügenvon Block gesendet werden können.
static final int	MAX_BLOCKS Als veraltet markiert Verwenden Sie getMaxBlocks(). Gibt die maximale Anzahl von Blöcken an, die in einem Anfügeblob zulässig sind.

Methodenzusammenfassung

Modifizierer und Typ	Methode und Beschreibung
AppendBlobItem	appendBlock(InputStream data, long length) Committent einen neuen Datenblock an das Ende des vorhandenen Anfügeblobs.
AppendBlobItem	appendBlockFromUrl(String sourceUrl, BlobRange sourceRange) Committent einen neuen Datenblock aus einem anderen Blob an das Ende dieses Anfügeblobs.
Response<AppendBlobItem>	appendBlockFromUrlWithResponse(AppendBlobAppendBlockFromUrlOptions options, Duration timeout, Context context) Committent einen neuen Datenblock aus einem anderen Blob an das Ende dieses Anfügeblobs.
Response<AppendBlobItem>	appendBlockFromUrlWithResponse(String sourceUrl, BlobRange sourceRange, byte[] sourceContentMd5, AppendBlobRequestConditions destRequestConditions, BlobRequestConditions sourceRequestConditions, Duration timeout, Context context) Committent einen neuen Datenblock aus einem anderen Blob an das Ende dieses Anfügeblobs.
Response<AppendBlobItem>	appendBlockWithResponse(InputStream data, long length, byte[] contentMd5, AppendBlobRequestConditions appendBlobRequestConditions, Duration timeout, Context context) Committent einen neuen Datenblock an das Ende des vorhandenen Anfügeblobs.
AppendBlobItem	create() Erstellt ein Anfügeblob mit einer Länge von 0 Länge.
AppendBlobItem	create(boolean overwrite) Erstellt ein Anfügeblob mit einer Länge von 0 Länge.
AppendBlobItem	createIfNotExists() Erstellt ein Anfügeblob mit einer Länge von 0 Länge, wenn es nicht vorhanden ist.
Response<AppendBlobItem>	createIfNotExistsWithResponse(AppendBlobCreateOptions options, Duration timeout, Context context) Erstellt ein Anfügeblob mit einer Länge von 0 Länge, wenn es nicht vorhanden ist.
Response<AppendBlobItem>	createWithResponse(BlobHttpHeaders headers, Map<String,String> metadata, BlobRequestConditions requestConditions, Duration timeout, Context context) Erstellt ein Anfügeblob mit einer Länge von 0 Länge.
Response<AppendBlobItem>	createWithResponse(AppendBlobCreateOptions options, Duration timeout, Context context) Erstellt ein Anfügeblob mit einer Länge von 0 Länge.
BlobOutputStream	getBlobOutputStream() Erstellt und öffnet einen Ausgabedatenstrom, um Daten in das Anfügeblob zu schreiben.
BlobOutputStream	getBlobOutputStream(boolean overwrite) Erstellt und öffnet einen Ausgabedatenstrom, um Daten in das Anfügeblob zu schreiben.
BlobOutputStream	getBlobOutputStream(AppendBlobRequestConditions requestConditions) Erstellt und öffnet einen Ausgabedatenstrom, um Daten in das Anfügeblob zu schreiben.
AppendBlobClient	getCustomerProvidedKeyClient(CustomerProvidedKey customerProvidedKey) Erstellt einen neuen AppendBlobClient mit dem angegebenen customerProvidedKey.
AppendBlobClient	getEncryptionScopeClient(String encryptionScope) Erstellt einen neuen AppendBlobClient mit dem angegebenen encryptionScope.
int	getMaxAppendBlockBytes() Rufen Sie die maximale Anzahl von Anfügeblockbytes basierend auf der verwendeten Dienstversion ab.
int	getMaxBlocks() Rufen Sie die maximale Anzahl von Blöcken ab, die in einem Anfügeblob zulässig sind.
void	seal() Versiegelt ein Anfügeblob, sodass es schreibgeschützt ist.
Response<Void>	sealWithResponse(AppendBlobSealOptions options, Duration timeout, Context context) Versiegelt ein Anfügeblob, sodass es schreibgeschützt ist.

Geerbte Methoden von BlobClientBase

abortCopyFromUrl abortCopyFromUrlWithResponse beginCopy beginCopy beginCopy copyFromUrl copyFromUrlWithResponse copyFromUrlWithResponse createSnapshot createSnapshotWithResponse delete deleteIfExists deleteIfExistsWithResponse deleteImmutabilityPolicy deleteImmutabilityPolicyWithResponse deleteWithResponse download downloadContent downloadContentWithResponse downloadContentWithResponse downloadStream downloadStreamWithResponse downloadToFile downloadToFile downloadToFileWithResponse downloadToFileWithResponse downloadToFileWithResponse downloadWithResponse exists existsWithResponse generateSas generateSas generateSas generateUserDelegationSas generateUserDelegationSas generateUserDelegationSas getAccountInfo getAccountInfoWithResponse getAccountName getAccountUrl getBlobName getBlobUrl getContainerClient getContainerName getCustomerProvidedKey getCustomerProvidedKeyClient getEncryptionScope getEncryptionScopeClient getHttpPipeline getProperties getPropertiesWithResponse getServiceVersion getSnapshotClient getSnapshotId getTags getTagsWithResponse getVersionClient getVersionId isSnapshot openInputStream openInputStream openInputStream openInputStream openQueryInputStream openQueryInputStreamWithResponse openSeekableByteChannelRead query queryWithResponse setAccessTier setAccessTierWithResponse setAccessTierWithResponse setHttpHeaders setHttpHeadersWithResponse setImmutabilityPolicy setImmutabilityPolicyWithResponse setLegalHold setLegalHoldWithResponse setMetadata setMetadataWithResponse setTags setTagsWithResponse undelete undeleteWithResponse

Geerbte Methoden von java.lang.Object

clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Felddetails

MAX_APPEND_BLOCK_BYTES

@Deprecated
public static final int MAX_APPEND_BLOCK_BYTES

Als veraltet markiert

Verwenden Sie getMaxAppendBlockBytes().

Gibt die maximale Anzahl von Bytes an, die in einem Aufruf von appendBlock gesendet werden können.

MAX_BLOCKS

@Deprecated
public static final int MAX_BLOCKS

Als veraltet markiert

Verwenden Sie getMaxBlocks().

Gibt die maximale Anzahl von Blöcken an, die in einem Anfügeblob zulässig sind.

Details zur Methode

appendBlock

public AppendBlobItem appendBlock(InputStream data, long length)

Committent einen neuen Datenblock an das Ende des vorhandenen Anfügeblobs.

Beachten Sie, dass die übergebenen Daten wiedergegeben werden müssen, wenn Wiederholungsversuche aktiviert sind (Standard). Anders ausgedrückt: Die Flux muss bei jedem Abonnieren die gleichen Daten erzeugen. Für Dienstversionen 2022-11-02 und höher beträgt die maximale Blockgröße 100 MB. Bei früheren Versionen beträgt die maximale Blockgröße 4 MB. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

System.out.printf("AppendBlob has %d committed blocks%n",
     client.appendBlock(data, length).getBlobCommittedBlockCount());

Parameter:

data - Die Daten, die in das Blob geschrieben werden sollen. Die Daten müssen markierbar sein. Dies ist, um Wiederholungen zu unterstützen. Wenn die Daten nicht markiert werden können, sollten Sie die Verwendung getBlobOutputStream() und das Schreiben in den zurückgegebenen OutputStream in Betracht ziehen. Alternativ können Sie erwägen, Ihre Datenquelle in einen BufferedInputStream einzuschließen, um Markunterstützung hinzuzufügen.

length - Die genaue Länge der Daten. Es ist wichtig, dass dieser Wert genau mit der Länge der von ausgegebenen FluxDaten übereinstimmt.

Gibt zurück:

Die Informationen des Anfügeblobvorgangs.

appendBlockFromUrl

public AppendBlobItem appendBlockFromUrl(String sourceUrl, BlobRange sourceRange)

Committent einen neuen Datenblock aus einem anderen Blob an das Ende dieses Anfügeblobs.

Codebeispiele

System.out.printf("AppendBlob has %d committed blocks%n",
     client.appendBlockFromUrl(sourceUrl, new BlobRange(offset, count)).getBlobCommittedBlockCount());

Parameter:

sourceUrl - Die URL des Blobs, das die Quelle der Kopie sein wird. Ein Quellblob im selben Speicherkonto kann über einen freigegebenen Schlüssel authentifiziert werden. Wenn die Quelle jedoch ein Blob in einem anderen Konto ist, muss das Quellblob entweder öffentlich sein oder über eine Shared Access Signature authentifiziert werden. Wenn das Quellblob öffentlich ist, ist keine Authentifizierung erforderlich, um den Vorgang auszuführen.

sourceRange - Die zu kopierende Quelle BlobRange .

Gibt zurück:

Die Informationen des Anfügeblobvorgangs.

appendBlockFromUrlWithResponse

public Response appendBlockFromUrlWithResponse(AppendBlobAppendBlockFromUrlOptions options, Duration timeout, Context context)

Committent einen neuen Datenblock aus einem anderen Blob an das Ende dieses Anfügeblobs.

Codebeispiele

AppendBlobRequestConditions appendBlobRequestConditions = new AppendBlobRequestConditions()
     .setAppendPosition(POSITION)
     .setMaxSize(maxSize);

 BlobRequestConditions modifiedRequestConditions = new BlobRequestConditions()
     .setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));

 Context context = new Context("key", "value");

 System.out.printf("AppendBlob has %d committed blocks%n",
     client.appendBlockFromUrlWithResponse(new AppendBlobAppendBlockFromUrlOptions(sourceUrl)
         .setSourceRange(new BlobRange(offset, count))
         .setDestinationRequestConditions(appendBlobRequestConditions)
         .setSourceRequestConditions(modifiedRequestConditions), timeout,
         context).getValue().getBlobCommittedBlockCount());

Parameter:

options - Optionen für den Vorgang

timeout - Ein optionaler Timeoutwert, ab dem ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Gibt zurück:

Die Informationen des Anfügeblobvorgangs.

appendBlockFromUrlWithResponse

public Response appendBlockFromUrlWithResponse(String sourceUrl, BlobRange sourceRange, byte[] sourceContentMd5, AppendBlobRequestConditions destRequestConditions, BlobRequestConditions sourceRequestConditions, Duration timeout, Context context)

Committent einen neuen Datenblock aus einem anderen Blob an das Ende dieses Anfügeblobs.

Codebeispiele

AppendBlobRequestConditions appendBlobRequestConditions = new AppendBlobRequestConditions()
     .setAppendPosition(POSITION)
     .setMaxSize(maxSize);

 BlobRequestConditions modifiedRequestConditions = new BlobRequestConditions()
     .setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));

 Context context = new Context("key", "value");

 System.out.printf("AppendBlob has %d committed blocks%n",
     client.appendBlockFromUrlWithResponse(sourceUrl, new BlobRange(offset, count), null,
         appendBlobRequestConditions, modifiedRequestConditions, timeout,
         context).getValue().getBlobCommittedBlockCount());

Parameter:

sourceUrl - Die URL des Blobs, das die Quelle der Kopie sein wird. Ein Quellblob im selben Speicherkonto kann über einen freigegebenen Schlüssel authentifiziert werden. Wenn die Quelle jedoch ein Blob in einem anderen Konto ist, muss das Quellblob entweder öffentlich sein oder über eine Shared Access Signature authentifiziert werden. Wenn das Quellblob öffentlich ist, ist keine Authentifizierung erforderlich, um den Vorgang auszuführen.

sourceRange - BlobRange

sourceContentMd5 - Ein MD5-Hash des Blockinhalts aus dem Quellblob. Wenn angegeben, berechnet der Dienst den MD5 der empfangenen Daten und schlägt die Anforderung fehl, wenn er nicht mit dem bereitgestellten MD5 übereinstimmt.

destRequestConditions - AppendBlobRequestConditions

sourceRequestConditions - BlobRequestConditions

timeout - Ein optionaler Timeoutwert, ab dem ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Gibt zurück:

Die Informationen des Anfügeblobvorgangs.

appendBlockWithResponse

public Response appendBlockWithResponse(InputStream data, long length, byte[] contentMd5, AppendBlobRequestConditions appendBlobRequestConditions, Duration timeout, Context context)

Committent einen neuen Datenblock an das Ende des vorhandenen Anfügeblobs.

Beachten Sie, dass die übergebenen Daten wiedergegeben werden müssen, wenn Wiederholungsversuche aktiviert sind (Standard). Anders ausgedrückt: Die Flux muss bei jedem Abonnieren die gleichen Daten erzeugen. Für Dienstversionen 2022-11-02 und höher beträgt die maximale Blockgröße 100 MB. Bei früheren Versionen beträgt die maximale Blockgröße 4 MB. Weitere Informationen finden Sie in der Azure-Dokumentation.

Codebeispiele

byte[] md5 = MessageDigest.getInstance("MD5").digest("data".getBytes(StandardCharsets.UTF_8));
 AppendBlobRequestConditions requestConditions = new AppendBlobRequestConditions()
     .setAppendPosition(POSITION)
     .setMaxSize(maxSize);
 Context context = new Context("key", "value");

 System.out.printf("AppendBlob has %d committed blocks%n",
     client.appendBlockWithResponse(data, length, md5, requestConditions, timeout, context)
         .getValue().getBlobCommittedBlockCount());

Parameter:

data - Die Daten, die in das Blob geschrieben werden sollen. Die Daten müssen markierbar sein. Dies ist, um Wiederholungen zu unterstützen. Wenn die Daten nicht markiert werden können, sollten Sie die Verwendung getBlobOutputStream() und das Schreiben in den zurückgegebenen OutputStream in Betracht ziehen. Alternativ können Sie erwägen, Ihre Datenquelle in einen BufferedInputStream einzuschließen, um Markunterstützung hinzuzufügen.

length - Die genaue Länge der Daten. Es ist wichtig, dass dieser Wert genau mit der Länge der von ausgegebenen FluxDaten übereinstimmt.

contentMd5 - Ein MD5-Hash des Blockinhalts. Mithilfe des Hashs wird die Integrität des Blocks während der Übertragung überprüft. Bei Angabe dieses Headers vergleicht der Speicherdienst den Hash des eingegangenen Inhalts mit diesem Headerwert. Beachten Sie, dass dieser MD5-Hash nicht mit dem BLOB gespeichert wird. Wenn die beiden Hashes nicht übereinstimmen, schlägt der Vorgang fehl.

appendBlobRequestConditions - AppendBlobRequestConditions

timeout - Ein optionaler Timeoutwert, ab dem ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Gibt zurück:

Eine Response<T> , der den value Anfügeblobvorgang enthält.

create

public AppendBlobItem create()

Erstellt ein Anfügeblob mit einer Länge von 0 Länge. Rufen Sie appendBlock auf, um Daten an ein Anfügeblob anzufügen. Standardmäßig überschreibt diese Methode kein vorhandenes Blob.

Codebeispiele

System.out.printf("Created AppendBlob at %s%n", client.create().getLastModified());

Gibt zurück:

Die Informationen des erstellten angefügten Blobs.

create

public AppendBlobItem create(boolean overwrite)

Erstellt ein Anfügeblob mit einer Länge von 0 Länge. Rufen Sie appendBlock auf, um Daten an ein Anfügeblob anzufügen.

Codebeispiele

boolean overwrite = false; // Default value
 System.out.printf("Created AppendBlob at %s%n", client.create(overwrite).getLastModified());

Parameter:

overwrite - Unabhängig davon, ob überschrieben werden soll, sollten Daten im Blob vorhanden sein.

Gibt zurück:

Die Informationen des erstellten angefügten Blobs.

createIfNotExists

public AppendBlobItem createIfNotExists()

Erstellt ein Anfügeblob mit einer Länge von 0 Länge, wenn es nicht vorhanden ist. Rufen Sie appendBlock auf, um Daten an ein Anfügeblob anzufügen.

Codebeispiele

client.createIfNotExists();
 System.out.println("Created AppendBlob");

Gibt zurück:

AppendBlobItem enthält Informationen zum erstellten angefügten Blob.

createIfNotExistsWithResponse

public Response createIfNotExistsWithResponse(AppendBlobCreateOptions options, Duration timeout, Context context)

Erstellt ein Anfügeblob mit einer Länge von 0 Länge, wenn es nicht vorhanden ist. Rufen Sie appendBlock auf, um Daten an ein Anfügeblob anzufügen.

Codebeispiele

BlobHttpHeaders headers = new BlobHttpHeaders()
     .setContentType("binary")
     .setContentLanguage("en-US");
 Map<String, String> metadata = Collections.singletonMap("metadata", "value");
 Map<String, String> tags = Collections.singletonMap("tags", "value");
 Context context = new Context("key", "value");

 Response<AppendBlobItem> response = client.createIfNotExistsWithResponse(new AppendBlobCreateOptions()
     .setHeaders(headers).setMetadata(metadata).setTags(tags), timeout, context);
 if (response.getStatusCode() == 409) {
     System.out.println("Already existed.");
 } else {
     System.out.printf("Create completed with status %d%n", response.getStatusCode());
 }

Parameter:

options - AppendBlobCreateOptions

timeout - Ein optionaler Timeoutwert, ab dem ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Gibt zurück:

Eine reaktive Antwort Response<T> , die die Vervollständigung signalisiert, deren value Informationen AppendBlobItem zum Anfügeblob enthält. Wenn Response<T>der status Code 201 ist, wurde erfolgreich ein neues Anfügeblob erstellt. Wenn status Code 409 ist, war an diesem Speicherort bereits ein Anfügeblob vorhanden.

createWithResponse

public Response createWithResponse(BlobHttpHeaders headers, Map metadata, BlobRequestConditions requestConditions, Duration timeout, Context context)

Erstellt ein Anfügeblob mit einer Länge von 0 Länge. Rufen Sie appendBlock auf, um Daten an ein Anfügeblob anzufügen.

Um ein Überschreiben zu vermeiden, übergeben Sie "*" an setIfNoneMatch(String ifNoneMatch).

Codebeispiele

BlobHttpHeaders headers = new BlobHttpHeaders()
     .setContentType("binary")
     .setContentLanguage("en-US");
 Map<String, String> metadata = Collections.singletonMap("metadata", "value");
 BlobRequestConditions requestConditions = new BlobRequestConditions()
     .setLeaseId(leaseId)
     .setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));
 Context context = new Context("key", "value");

 System.out.printf("Created AppendBlob at %s%n",
     client.createWithResponse(headers, metadata, requestConditions, timeout, context).getValue()
         .getLastModified());

Parameter:

headers - BlobHttpHeaders

metadata - Metadaten, die dem Blob zugeordnet werden sollen. Wenn führende oder nachfolgende Leerzeichen in einem Metadatenschlüssel oder -wert vorhanden sind, muss er entfernt oder codiert werden.

requestConditions - BlobRequestConditions

timeout - Ein optionaler Timeoutwert, ab dem ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Gibt zurück:

Ein Response<T> , dessen das value erstellte angefügte Blob enthält.

createWithResponse

public Response createWithResponse(AppendBlobCreateOptions options, Duration timeout, Context context)

Erstellt ein Anfügeblob mit einer Länge von 0 Länge. Rufen Sie appendBlock auf, um Daten an ein Anfügeblob anzufügen.

Um ein Überschreiben zu vermeiden, übergeben Sie "*" an setIfNoneMatch(String ifNoneMatch).

Codebeispiele

BlobHttpHeaders headers = new BlobHttpHeaders()
     .setContentType("binary")
     .setContentLanguage("en-US");
 Map<String, String> metadata = Collections.singletonMap("metadata", "value");
 Map<String, String> tags = Collections.singletonMap("tags", "value");
 BlobRequestConditions requestConditions = new BlobRequestConditions()
     .setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));
 Context context = new Context("key", "value");

 System.out.printf("Created AppendBlob at %s%n",
     client.createWithResponse(new AppendBlobCreateOptions().setHeaders(headers).setMetadata(metadata)
         .setTags(tags).setRequestConditions(requestConditions), timeout, context).getValue()
         .getLastModified());

Parameter:

options - AppendBlobCreateOptions

timeout - Ein optionaler Timeoutwert, ab dem ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Gibt zurück:

Ein Response<T> , dessen das value erstellte angefügte Blob enthält.

getBlobOutputStream

public BlobOutputStream getBlobOutputStream()

Erstellt und öffnet einen Ausgabedatenstrom, um Daten in das Anfügeblob zu schreiben. Wenn das Blob bereits im Dienst vorhanden ist, werden neue Daten an das vorhandene Blob angefügt.

Gibt zurück:

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

getBlobOutputStream

public BlobOutputStream getBlobOutputStream(boolean overwrite)

Erstellt und öffnet einen Ausgabedatenstrom, um Daten in das Anfügeblob zu schreiben. Wenn überschreiben angegeben truewird, wird das vorhandene Blob gelöscht und neu erstellt, falls Daten im Blob vorhanden sind. Wenn überschreiben angegeben falseist, werden neue Daten an das vorhandene Blob angefügt.

Parameter:

overwrite - Gibt an, ob ein vorhandenes Blob gelöscht und neu erstellt werden soll, wenn Daten im Blob vorhanden sind.

Gibt zurück:

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

getBlobOutputStream

public BlobOutputStream getBlobOutputStream(AppendBlobRequestConditions requestConditions)

Erstellt und öffnet einen Ausgabedatenstrom, um Daten in das Anfügeblob zu schreiben.

Parameter:

requestConditions - Ein BlobRequestConditions -Objekt, das die Zugriffsbedingungen für das Blob darstellt.

Gibt zurück:

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

getCustomerProvidedKeyClient

public AppendBlobClient getCustomerProvidedKeyClient(CustomerProvidedKey customerProvidedKey)

Erstellt einen neuen AppendBlobClient mit dem angegebenen customerProvidedKey.

Überschreibt:

AppendBlobClient.getCustomerProvidedKeyClient(CustomerProvidedKey customerProvidedKey)

Parameter:

customerProvidedKey - für CustomerProvidedKey das Blob übergeben null , um keinen vom Kunden bereitgestellten Schlüssel zu verwenden.

Gibt zurück:

ein AppendBlobClient mit dem angegebenen customerProvidedKey.

getEncryptionScopeClient

public AppendBlobClient getEncryptionScopeClient(String encryptionScope)

Erstellt einen neuen AppendBlobClient mit dem angegebenen encryptionScope.

Überschreibt:

AppendBlobClient.getEncryptionScopeClient(String encryptionScope)

Parameter:

encryptionScope - den Verschlüsselungsbereich für das Blob übergeben, null um keinen Verschlüsselungsbereich zu verwenden.

Gibt zurück:

ein AppendBlobClient mit dem angegebenen encryptionScope.

getMaxAppendBlockBytes

public int getMaxAppendBlockBytes()

Rufen Sie die maximale Anzahl von Anfügeblockbytes basierend auf der verwendeten Dienstversion ab. Die Dienstversionen 2022-11-02 und höher unterstützen das Hochladen von Blockbytes bis zu 100 MB, alle älteren Dienstversionen unterstützen bis zu 4 MB.

Gibt zurück:

die maximale Anzahl von Blockbytes, die basierend auf der Dienstversion hochgeladen werden können.

getMaxBlocks

public int getMaxBlocks()

Rufen Sie die maximale Anzahl von Blöcken ab, die in einem Anfügeblob zulässig sind.

Gibt zurück:

die maximale Anzahl von Blöcken, die in ein Anfügeblob hochgeladen werden können.

seal

public void seal()

Versiegelt ein Anfügeblob, sodass es schreibgeschützt ist. Bei nachfolgenden Anfügevorgängen tritt ein Fehler auf.

Codebeispiele

client.seal();
 System.out.println("Sealed AppendBlob");

sealWithResponse

public Response sealWithResponse(AppendBlobSealOptions options, Duration timeout, Context context)

Versiegelt ein Anfügeblob, sodass es schreibgeschützt ist. Bei nachfolgenden Anfügevorgängen tritt ein Fehler auf.

Codebeispiele

AppendBlobRequestConditions requestConditions = new AppendBlobRequestConditions().setLeaseId(leaseId)
     .setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));
 Context context = new Context("key", "value");

 client.sealWithResponse(new AppendBlobSealOptions().setRequestConditions(requestConditions), timeout, context);
 System.out.println("Sealed AppendBlob");

Parameter:

options - AppendBlobSealOptions

timeout - Ein optionaler Timeoutwert, über den ein RuntimeException ausgelöst wird.

context - Zusätzlicher Kontext, der während des Dienstaufrufs über die HTTP-Pipeline übergeben wird.

Gibt zurück:

Abschluss einer reaktiven Antwortsignalisierung.