Freigeben über

BlobRequestOptions Klasse

  • Referenz
Paket:
com.microsoft.azure.storage.blob
  • java.lang.Object

public class BlobRequestOptions extends RequestOptions

Stellt eine Reihe von Optionen dar, die für eine Anforderung angegeben werden können.

Zusammenfassung zum Konstruktor

Konstruktor Beschreibung
BlobRequestOptions()

Erstellt eine instance der -Klasse.

BlobRequestOptions(final BlobRequestOptions other)

Erstellt eine instance der -Klasse, indem Werte aus einer anderen instance kopiert werden.

Methodenzusammenfassung

Modifizierer und Typ Methode und Beschreibung
void applyDefaults(final BlobRequestOptions modifiedOptions, final BlobType blobtype)

Wendet standardwerte auf die übergebenen Optionen an.
void assertNoEncryptionPolicyOrStrictMode()

Stellen Sie fest, dass keine Verschlüsselungsrichtlinie angegeben wird, wenn die Validierung aktiviert ist.

void assertPolicyIfRequired()

Stellen Sie fest, dass eine Verschlüsselungsrichtlinie angegeben wird, wenn der strict-Modus aktiviert ist.

Boolean getAbsorbConditionalErrorsOnRetry()

Gibt an, ob ein bedingter Fehler bei einem Wiederholungsversuch für die Anforderung abgefangen werden soll. Weitere Informationen zum Absorbieren conditinal-Fehler bei Wiederholungsstandardeinstellungen finden Sie unter setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry).
boolean getCommitWriteOnInputStreamException()

Ein , der das Verhalten für die Behandlung von Ausnahmen beim Lesen aus und mit definiert. Wenn die Daten, die bis zum Punkt der Ausnahme aus dem Stream gelesen wurden, geleert werden, und ein neues Blob wird mit diesen Daten committet. Andernfalls wird der Upload abgebrochen, und es werden keine Daten committet.

Weitere Informationen zu Standardwerten finden Sie unter setCommitWriteOnInputStreamException(boolean commitWriteOnInputStreamException).
Integer getConcurrentRequestCount()

Ruft die gleichzeitige Anzahl gleichzeitiger Anforderungen pro Vorgang ab. Weitere Informationen zu den Standardwerten für die gleichzeitige Anforderungsanzahl finden Sie unter setConcurrentRequestCount(final Integer concurrentRequestCount).
BlobCustomerProvidedKey getCustomerProvidedKey()

Ruft den vom Kunden bereitgestellten Schlüssel ab, der für diese Anforderung verwendet werden soll.
Boolean getDisableContentMD5Validation()

Ruft ab, ob download und BlobInputStream methoden den ContentMD5-Header des Blobs ignorieren sollen. Weitere Informationen zum Deaktivieren von MD5-Validierungsstandardeinstellungen für Inhalte finden Sie unter setDisableContentMD5Validation(final Boolean disableContentMD5Validation)
BlobEncryptionPolicy getEncryptionPolicy()

Ruft die Verschlüsselungsrichtlinie ab, die für diese Anforderung verwendet werden soll. Weitere Informationen zu den Standardeinstellungen der Verschlüsselungsrichtlinie finden Sie unter setEncryptionPolicy(BlobEncryptionPolicy encryptionPolicy).
Integer getSingleBlobPutThresholdInBytes()

Ruft die Schwellenwertgröße ab, die zum Schreiben eines einzelnen Blobs verwendet wird. Weitere Informationen zu den Standardwerten der Schwellenwertgröße finden Sie unter setSingleBlobPutThresholdInBytes(final Integer singleBlobPutThresholdInBytes).
boolean getSkipEtagLocking()

WARNUNG: Die etag-Sperre wird bei Blobdownloads automatisch verwendet, um sicherzustellen, dass sich das Blob nicht bei der Downloadzeit ändert. Überspringen Sie diese Überprüfung auf eigenes Risiko.

Ruft ab, ob etag-Sperren und -Überprüfungen für Blobdownloads übersprungen werden sollen.
Boolean getStoreBlobContentMD5()

Ruft ab, ob der ContentMD5-Header des Blobs für Uploads festgelegt werden soll. Dieses Feld wird für Seitenblobs nicht unterstützt. Weitere Informationen zum Speichern von Blobinhalten in MD5-Standardeinstellungen finden Sie unter setStoreBlobContentMD5(final Boolean storeBlobContentMD5)
Boolean getUseTransactionalContentMD5()

Ruft ab, ob ein Bereichs-PUT- oder GET-Vorgang den Content-MD5-Header verwendet, um Transaktionssicherheit zu erzwingen. Alle teilweisen Blobuploads oder -downloads sind auf 4 MB beschränkt. Weitere Informationen zu den MD5-Standardeinstellungen für Transaktionsinhalte finden Sie unter setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5).
boolean getValidateEncryptionPolicy()

Ruft den vom Kunden bereitgestellten Schlüssel ab, der für die Quelle für eine Kopieranforderung verwendet werden soll.
final BlobRequestOptions populateAndApplyDefaults(final BlobRequestOptions options, final BlobType blobType, final CloudBlobClient client)

Verwendet die Anzahl gleichzeitiger Anforderungen vom angegebenen Client, wenn ein Standardwert für alles andere festgelegt wird, und legt standardwerte fest, wie in der übergeordneten Klasse definiert.
final BlobRequestOptions populateAndApplyDefaults(final BlobRequestOptions options, final BlobType blobType, final CloudBlobClient client, final boolean setStartTime)

Verwendet die Anzahl gleichzeitiger Anforderungen vom angegebenen Client, wenn ein Standardwert für alles andere festgelegt wird, und legt standardwerte fest, wie in der übergeordneten Klasse definiert.
void setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry)

Legt fest, ob ein bedingter Fehler bei einem Wiederholungsversuch für die Anforderung abgefangen werden soll. Diese Option wird nur von CloudAppendBlob den Upload- und openWrite-Methoden verwendet. Standardmäßig ist er auf festgelegt. Legen Sie dies für ein Szenario mit einem einzelnen Writer auf fest.

Sie können den AbsorbConditionalErrorsOnRetry-Wert für diese Anforderung ändern, indem Sie diese Eigenschaft festlegen. Sie können auch den Wert für das getDefaultRequestOptions() Objekt ändern, sodass alle nachfolgenden Anforderungen, die über den Dienstclient ausgeführt werden, diesen absorbConditionalErrorsOnRetry-Wert verwenden.
void setCommitWriteOnInputStreamException(boolean commitWriteOnInputStreamException)

Ein , der das Verhalten für die Behandlung von Ausnahmen beim Lesen aus und mit definiert. Wenn die Daten, die bis zum Punkt der Ausnahme aus dem Stream gelesen wurden, geleert werden, und ein neues Blob wird mit diesen Daten committet. Andernfalls wird der Upload abgebrochen, und es werden keine Daten committet.

Der Standardwert ist .
void setConcurrentRequestCount(final Integer concurrentRequestCount)

Legt die gleichzeitige Anzahl gleichzeitiger Anforderungen pro Vorgang fest.

Die Standardmäßige Anzahl gleichzeitiger Anforderungen wird auf dem Client festgelegt und ist standardmäßig 1, was keine Parallelität angibt. Sie können die Anzahl gleichzeitiger Anforderungen für diese Anforderung ändern, indem Sie diese Eigenschaft festlegen. Sie können auch den Wert für das getDefaultRequestOptions() Objekt ändern, sodass alle nachfolgenden Anforderungen, die über den Dienstclient gesendet werden, diese gleichzeitige Anforderungsanzahl verwenden.
void setCustomerProvidedKey(BlobCustomerProvidedKey key)

Legt das BlobCustomerProvidedKey-Objekt fest, das für diese Anforderung verwendet werden soll. Die vom Kunden bereitgestellte Schlüsselverschlüsselung wird für die meisten Upload-, Download- und Kopieranforderungen in Blob Storage sowie für das Abrufen von Eigenschaften und Metadaten unterstützt.
void setDisableContentMD5Validation(final Boolean disableContentMD5Validation)

Legt fest, ob download und BlobInputStream methoden den ContentMD5-Header des Blobs ignorieren sollen.

Der Standardwert disableContentMD5Validation wird im Client festgelegt und ist standardmäßig . Sie können den Wert disableContentMD5Validation für diese Anforderung ändern, indem Sie diese Eigenschaft festlegen. Sie können auch den Wert für das getDefaultRequestOptions() Objekt ändern, sodass alle nachfolgenden Anforderungen, die über den Dienstclient gesendet werden, den Wert disableContentMD5Validation verwenden.
void setEncryptionPolicy(BlobEncryptionPolicy encryptionPolicy)

Legt das BlobEncryptionPolicy-Objekt fest, das für diese Anforderung verwendet werden soll.

Die Standardmäßige BlobEncryptionPolicy wird im Client festgelegt und ist standardmäßig NULL, was angibt, dass keine Verschlüsselung erfolgt. Sie können die BlobEncryptionPolicy für diese Anforderung ändern, indem Sie diese Eigenschaft festlegen. Sie können auch den Wert für das getDefaultRequestOptions() Objekt ändern, sodass alle nachfolgenden Anforderungen, die über den Dienstclient gesendet werden, diese BlobEncryptionPolicy verwenden.
void setSingleBlobPutThresholdInBytes(final Integer singleBlobPutThresholdInBytes)

Legt die Schwellenwertgröße fest, die zum Schreiben eines zu verwendenden einzelnen Blobs verwendet wird.

Die Standardschwellengröße wird im Client festgelegt und beträgt standardmäßig 32 MB. Sie können die Schwellenwertgröße für diese Anforderung ändern, indem Sie diese Eigenschaft festlegen. Sie können auch den Wert für das getDefaultRequestOptions() Objekt ändern, sodass alle nachfolgenden Anforderungen, die über den Dienstclient gesendet werden, diese Schwellenwertgröße verwenden.
void setSkipEtagLocking(boolean skipEtagLocking)

WARNUNG: Die etag-Sperre wird bei Blobdownloads automatisch verwendet, um sicherzustellen, dass sich das Blob nicht bei der Downloadzeit ändert. Überspringen Sie diese Überprüfung auf eigenes Risiko.

Legt fest, ob etag-Sperren und -Überprüfungen für Blobdownloads übersprungen werden sollen.
void setStoreBlobContentMD5(final Boolean storeBlobContentMD5)

Legt fest, ob der ContentMD5-Header des Blobs für Uploads festgelegt werden soll. Dieses Feld wird für Seitenblobs nicht unterstützt.

Der Standardwert storeBlobContentMD5 wird im Client festgelegt und ist standardmäßig für Blockblobs. Sie können den StoreBlobContentMD5-Wert für diese Anforderung ändern, indem Sie diese Eigenschaft festlegen. Sie können auch den Wert für das getDefaultRequestOptions() Objekt ändern, sodass alle nachfolgenden Anforderungen, die über den Dienstclient gesendet werden, diesen wert storeBlobContentMD5 verwenden.
void setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5)

Legt fest, ob ein Put- oder GET-Bereichsvorgang den Content-MD5-Header verwendet, um Transaktionssicherheit zu erzwingen. Alle teilweisen Blobuploads oder -downloads sind auf 4 MB beschränkt.

Der Standardwert useTransactionalContentMD5 wird im Client festgelegt und ist standardmäßig . Sie können den useTransactionalContentMD5-Wert für diese Anforderung ändern, indem Sie diese Eigenschaft festlegen. Sie können auch den Wert für das getDefaultRequestOptions() Objekt ändern, sodass alle nachfolgenden Anforderungen, die über den Dienstclient gesendet werden, diesen Wert verwendenTransactionalContentMD5.
void setValidateEncryptionPolicy(boolean validateEncryptionPolicy)

Legt das BlobCustomerProvidedKey-Objekt fest, das für ein Quellblob verwendet werden soll. Die vom Kunden bereitgestellte Schlüsselverschlüsselung wird für die meisten Upload-, Download- und Kopieranforderungen in Blob Storage sowie für das Abrufen von Eigenschaften und Metadaten unterstützt.

Geerbte Elemente

RequestOptions.applyBaseDefaultsInternal(final RequestOptions modifiedOptions) RequestOptions.disableHttpsSocketKeepAlive() RequestOptions.getLocationMode() RequestOptions.getMaximumExecutionTimeInMs() RequestOptions.getOperationExpiryTimeInMs() RequestOptions.getRetryPolicyFactory() RequestOptions.getTimeoutIntervalInMs() RequestOptions.populateRequestOptions(RequestOptions modifiedOptions, final RequestOptions clientOptions, final boolean setStartTime) RequestOptions.RequestOptions() RequestOptions.RequestOptions(final RequestOptions other) RequestOptions.requireEncryption() RequestOptions.setDisableHttpsSocketKeepAlive(Boolean disableHttpsSocketKeepAlive) RequestOptions.setLocationMode(final LocationMode locationMode) RequestOptions.setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs) RequestOptions.setRequireEncryption(Boolean requireEncryption) RequestOptions.setRetryPolicyFactory(final RetryPolicyFactory retryPolicyFactory) RequestOptions.setTimeoutIntervalInMs(final Integer timeoutIntervalInMs)

Details zum Konstruktor

BlobRequestOptions

public BlobRequestOptions()

Erstellt eine instance der -Klasse.

BlobRequestOptions

public BlobRequestOptions(final BlobRequestOptions other)

Erstellt eine instance der -Klasse, indem Werte aus einer anderen instance kopiert werden.

Parameters:

other - Ein BlobRequestOptions -Objekt, das die zu kopierenden Blobanforderungsoptionen darstellt.

Details zur Methode

applyDefaults

protected static void applyDefaults(final BlobRequestOptions modifiedOptions, final BlobType blobtype)

Wendet standardwerte auf die übergebenen Optionen an.

Parameters:

modifiedOptions - Die Optionen, auf die Standardwerte angewendet werden sollen.
blobtype

assertNoEncryptionPolicyOrStrictMode

protected void assertNoEncryptionPolicyOrStrictMode()

Stellen Sie fest, dass keine Verschlüsselungsrichtlinie angegeben wird, wenn die Validierung aktiviert ist.

assertPolicyIfRequired

protected void assertPolicyIfRequired()

Stellen Sie fest, dass eine Verschlüsselungsrichtlinie angegeben wird, wenn der strict-Modus aktiviert ist.

getAbsorbConditionalErrorsOnRetry

public Boolean getAbsorbConditionalErrorsOnRetry()

Gibt an, ob ein bedingter Fehler bei einem Wiederholungsversuch für die Anforderung abgefangen werden soll. Weitere Informationen zum Absorbieren conditinal-Fehler bei Wiederholungsstandardeinstellungen finden Sie unter setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry).

Returns:

absorbConditionalErrorsOnRetry

getCommitWriteOnInputStreamException

public boolean getCommitWriteOnInputStreamException()

Ein , der das Verhalten für die Behandlung von Ausnahmen beim Lesen aus und mit definiert. Wenn die Daten, die bis zum Punkt der Ausnahme aus dem Stream gelesen wurden, geleert werden, und ein neues Blob wird mit diesen Daten committet. Andernfalls wird der Upload abgebrochen, und es werden keine Daten committet.

Weitere Informationen zu Standardwerten finden Sie unter setCommitWriteOnInputStreamException(boolean commitWriteOnInputStreamException).

Returns:

true , wenn daten für eine Ausnahme committet werden; falseandernfalls .

getConcurrentRequestCount

public Integer getConcurrentRequestCount()

Ruft die gleichzeitige Anzahl gleichzeitiger Anforderungen pro Vorgang ab. Weitere Informationen zu den Standardwerten für die gleichzeitige Anforderungsanzahl finden Sie unter setConcurrentRequestCount(final Integer concurrentRequestCount).

Returns:

concurrentRequestCount

getCustomerProvidedKey

public BlobCustomerProvidedKey getCustomerProvidedKey()

Ruft den vom Kunden bereitgestellten Schlüssel ab, der für diese Anforderung verwendet werden soll.

Returns:

Ein BlobCustomerProvidedKey -Objekt, das den aktuellen vom Kunden bereitgestellten Schlüssel darstellt.

getDisableContentMD5Validation

public Boolean getDisableContentMD5Validation()

Ruft ab, ob download und BlobInputStream methoden den ContentMD5-Header des Blobs ignorieren sollen. Weitere Informationen zum Deaktivieren von MD5-Validierungsstandardeinstellungen für Inhalte finden Sie unter setDisableContentMD5Validation(final Boolean disableContentMD5Validation)

Returns:

disableContentMD5Validation

getEncryptionPolicy

public BlobEncryptionPolicy getEncryptionPolicy()

Ruft die Verschlüsselungsrichtlinie ab, die für diese Anforderung verwendet werden soll. Weitere Informationen zu den Standardeinstellungen der Verschlüsselungsrichtlinie finden Sie unter setEncryptionPolicy(BlobEncryptionPolicy encryptionPolicy).

Returns:

Ein BlobEncryptionPolicy -Objekt, das die aktuelle Verschlüsselungsrichtlinie darstellt.

getSingleBlobPutThresholdInBytes

public Integer getSingleBlobPutThresholdInBytes()

Ruft die Schwellenwertgröße ab, die zum Schreiben eines einzelnen Blobs verwendet wird. Weitere Informationen zu den Standardwerten der Schwellenwertgröße finden Sie unter setSingleBlobPutThresholdInBytes(final Integer singleBlobPutThresholdInBytes).

Returns:

Die maximale Größe eines Blobs in Bytes, das als einzelnes Blob hochgeladen werden kann, und reicht von 1 bis einschließlich 64 MB. Wenn eine Blobgröße über dem Schwellenwert liegt, wird sie als Blöcke hochgeladen.

getSkipEtagLocking

public boolean getSkipEtagLocking()

WARNUNG: Die etag-Sperre wird bei Blobdownloads automatisch verwendet, um sicherzustellen, dass sich das Blob nicht bei der Downloadzeit ändert. Überspringen Sie diese Überprüfung auf eigenes Risiko.

Ruft ab, ob etag-Sperren und -Überprüfungen für Blobdownloads übersprungen werden sollen.

Returns:

true , wenn das Überspringen aktiviert ist; falseandernfalls .

getStoreBlobContentMD5

public Boolean getStoreBlobContentMD5()

Ruft ab, ob der ContentMD5-Header des Blobs für Uploads festgelegt werden soll. Dieses Feld wird für Seitenblobs nicht unterstützt. Weitere Informationen zum Speichern von Blobinhalten in MD5-Standardeinstellungen finden Sie unter setStoreBlobContentMD5(final Boolean storeBlobContentMD5)

Returns:

storeBlobContentMD5

getUseTransactionalContentMD5

public Boolean getUseTransactionalContentMD5()

Ruft ab, ob ein Bereichs-PUT- oder GET-Vorgang den Content-MD5-Header verwendet, um Transaktionssicherheit zu erzwingen. Alle teilweisen Blobuploads oder -downloads sind auf 4 MB beschränkt. Weitere Informationen zu den MD5-Standardeinstellungen für Transaktionsinhalte finden Sie unter setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5).

Returns:

useTransactionalContentMD5

getValidateEncryptionPolicy

protected boolean getValidateEncryptionPolicy()

Ruft den vom Kunden bereitgestellten Schlüssel ab, der für die Quelle für eine Kopieranforderung verwendet werden soll.

Returns:

Ein BlobCustomerProvidedKey -Objekt, das den vom Kunden bereitgestellten Schlüssel der Quelle darstellt. Ruft einen Wert ab, der angibt, ob das Vorhandensein der Verschlüsselungsrichtlinie überprüft werden soll.

populateAndApplyDefaults

protected static final BlobRequestOptions populateAndApplyDefaults(final BlobRequestOptions options, final BlobType blobType, final CloudBlobClient client)

Verwendet die Anzahl gleichzeitiger Anforderungen vom angegebenen Client, wenn ein Standardwert für alles andere festgelegt wird, und legt standardwerte fest, wie in der übergeordneten Klasse definiert.

Parameters:

options - Die Eingabeoptionen, aus der beim Anwenden von Standardwerten kopiert werden soll
blobType - BlobType des aktuellen Vorgangs
client - Ein CloudBlobClient -Objekt, das den Dienstclient darstellt, der zum Festlegen des Standardtimeoutintervalls und der Wiederholungsrichtlinie verwendet wird, wenn es sich nullum handelt. Darüber hinaus ist 1der Standardwert von concurrentRequestCount .

populateAndApplyDefaults

protected static final BlobRequestOptions populateAndApplyDefaults(final BlobRequestOptions options, final BlobType blobType, final CloudBlobClient client, final boolean setStartTime)

Verwendet die Anzahl gleichzeitiger Anforderungen vom angegebenen Client, wenn ein Standardwert für alles andere festgelegt wird, und legt standardwerte fest, wie in der übergeordneten Klasse definiert.

Parameters:

options - Die Eingabeoptionen, aus der beim Anwenden von Standardwerten kopiert werden soll
blobType - BlobType des aktuellen Vorgangs
client - Ein CloudBlobClient -Objekt, das den Dienstclient darstellt, der zum Festlegen des Standardtimeoutintervalls und der Wiederholungsrichtlinie verwendet wird, wenn es sich nullum handelt. Darüber hinaus ist 1der Standardwert von concurrentRequestCount .
setStartTime - ob das StartTimeInMs-Feld initialisiert werden soll oder nicht

setAbsorbConditionalErrorsOnRetry

public void setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry)

Legt fest, ob ein bedingter Fehler bei einem Wiederholungsversuch für die Anforderung abgefangen werden soll. Diese Option wird nur von CloudAppendBlob den Upload- und openWrite-Methoden verwendet. Standardmäßig ist er auf festgelegt. Legen Sie dies für ein Szenario mit einem einzelnen Writer auf fest.

Sie können den AbsorbConditionalErrorsOnRetry-Wert für diese Anforderung ändern, indem Sie diese Eigenschaft festlegen. Sie können auch den Wert für das getDefaultRequestOptions() Objekt ändern, sodass alle nachfolgenden Anforderungen, die über den Dienstclient ausgeführt werden, diesen absorbConditionalErrorsOnRetry-Wert verwenden.

Parameters:

absorbConditionalErrorsOnRetry - die festzulegende absorbConditionalErrorsOnRetry

setCommitWriteOnInputStreamException

public void setCommitWriteOnInputStreamException(boolean commitWriteOnInputStreamException)

Ein , der das Verhalten für die Behandlung von Ausnahmen beim Lesen aus und mit definiert. Wenn die Daten, die bis zum Punkt der Ausnahme aus dem Stream gelesen wurden, geleert werden, und ein neues Blob wird mit diesen Daten committet. Andernfalls wird der Upload abgebrochen, und es werden keine Daten committet.

Der Standardwert ist .

Parameters:

commitWriteOnInputStreamException - Verwenden Sie true , wenn daten bei einer Ausnahme committet werden, falseandernfalls .

setConcurrentRequestCount

public void setConcurrentRequestCount(final Integer concurrentRequestCount)

Legt die gleichzeitige Anzahl gleichzeitiger Anforderungen pro Vorgang fest.

Die Standardmäßige Anzahl gleichzeitiger Anforderungen wird auf dem Client festgelegt und ist standardmäßig 1, was keine Parallelität angibt. Sie können die Anzahl gleichzeitiger Anforderungen für diese Anforderung ändern, indem Sie diese Eigenschaft festlegen. Sie können auch den Wert für das getDefaultRequestOptions() Objekt ändern, sodass alle nachfolgenden Anforderungen, die über den Dienstclient gesendet werden, diese gleichzeitige Anforderungsanzahl verwenden.

Parameters:

concurrentRequestCount - die festzulegende concurrentRequestCount

setCustomerProvidedKey

public void setCustomerProvidedKey(BlobCustomerProvidedKey key)

Legt das BlobCustomerProvidedKey-Objekt fest, das für diese Anforderung verwendet werden soll. Die vom Kunden bereitgestellte Schlüsselverschlüsselung wird für die meisten Upload-, Download- und Kopieranforderungen in Blob Storage sowie für das Abrufen von Eigenschaften und Metadaten unterstützt.

Parameters:

key - das BlobCustomerProvidedKey-Objekt, das beim Stellen von Dienstanforderungen verwendet werden soll.

setDisableContentMD5Validation

public void setDisableContentMD5Validation(final Boolean disableContentMD5Validation)

Legt fest, ob download und BlobInputStream methoden den ContentMD5-Header des Blobs ignorieren sollen.

Der Standardwert disableContentMD5Validation wird im Client festgelegt und ist standardmäßig . Sie können den Wert disableContentMD5Validation für diese Anforderung ändern, indem Sie diese Eigenschaft festlegen. Sie können auch den Wert für das getDefaultRequestOptions() Objekt ändern, sodass alle nachfolgenden Anforderungen, die über den Dienstclient gesendet werden, den Wert disableContentMD5Validation verwenden.

Parameters:

disableContentMD5Validation - die festzulegende disableContentMD5Validation

setEncryptionPolicy

public void setEncryptionPolicy(BlobEncryptionPolicy encryptionPolicy)

Legt das BlobEncryptionPolicy-Objekt fest, das für diese Anforderung verwendet werden soll.

Die Standardmäßige BlobEncryptionPolicy wird im Client festgelegt und ist standardmäßig NULL, was angibt, dass keine Verschlüsselung erfolgt. Sie können die BlobEncryptionPolicy für diese Anforderung ändern, indem Sie diese Eigenschaft festlegen. Sie können auch den Wert für das getDefaultRequestOptions() Objekt ändern, sodass alle nachfolgenden Anforderungen, die über den Dienstclient gesendet werden, diese BlobEncryptionPolicy verwenden.

Parameters:

encryptionPolicy - das BlobEncryptionPolicy-Objekt, das beim Stellen von Dienstanforderungen verwendet werden soll.

setSingleBlobPutThresholdInBytes

public void setSingleBlobPutThresholdInBytes(final Integer singleBlobPutThresholdInBytes)

Legt die Schwellenwertgröße fest, die zum Schreiben eines zu verwendenden einzelnen Blobs verwendet wird.

Die Standardschwellengröße wird im Client festgelegt und beträgt standardmäßig 32 MB. Sie können die Schwellenwertgröße für diese Anforderung ändern, indem Sie diese Eigenschaft festlegen. Sie können auch den Wert für das getDefaultRequestOptions() Objekt ändern, sodass alle nachfolgenden Anforderungen, die über den Dienstclient gesendet werden, diese Schwellenwertgröße verwenden.

Parameters:

singleBlobPutThresholdInBytes - Die maximale Größe eines Blobs in Bytes, das als einzelnes Blob hochgeladen werden kann, und reicht von 1 MB bis einschließlich 64 MB. Wenn eine Blobgröße über dem Schwellenwert liegt, wird sie als Blöcke hochgeladen.

Throws:

IllegalArgumentException - Wenn minimumReadSize kleiner als 1 MB oder größer als 64 MB ist.

setSkipEtagLocking

public void setSkipEtagLocking(boolean skipEtagLocking)

WARNUNG: Die etag-Sperre wird bei Blobdownloads automatisch verwendet, um sicherzustellen, dass sich das Blob nicht bei der Downloadzeit ändert. Überspringen Sie diese Überprüfung auf eigenes Risiko.

Legt fest, ob etag-Sperren und -Überprüfungen für Blobdownloads übersprungen werden sollen.

Parameters:

skipEtagLocking - Verwenden Sie true , um etag-Sperren und -Validierungen zu überspringen, falseandernfalls .

setStoreBlobContentMD5

public void setStoreBlobContentMD5(final Boolean storeBlobContentMD5)

Legt fest, ob der ContentMD5-Header des Blobs für Uploads festgelegt werden soll. Dieses Feld wird für Seitenblobs nicht unterstützt.

Der Standardwert storeBlobContentMD5 wird im Client festgelegt und ist standardmäßig für Blockblobs. Sie können den StoreBlobContentMD5-Wert für diese Anforderung ändern, indem Sie diese Eigenschaft festlegen. Sie können auch den Wert für das getDefaultRequestOptions() Objekt ändern, sodass alle nachfolgenden Anforderungen, die über den Dienstclient gesendet werden, diesen wert storeBlobContentMD5 verwenden.

Parameters:

storeBlobContentMD5 - die festzulegende storeBlobContentMD5

setUseTransactionalContentMD5

public void setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5)

Legt fest, ob ein Put- oder GET-Bereichsvorgang den Content-MD5-Header verwendet, um Transaktionssicherheit zu erzwingen. Alle teilweisen Blobuploads oder -downloads sind auf 4 MB beschränkt.

Der Standardwert useTransactionalContentMD5 wird im Client festgelegt und ist standardmäßig . Sie können den useTransactionalContentMD5-Wert für diese Anforderung ändern, indem Sie diese Eigenschaft festlegen. Sie können auch den Wert für das getDefaultRequestOptions() Objekt ändern, sodass alle nachfolgenden Anforderungen, die über den Dienstclient gesendet werden, diesen Wert verwendenTransactionalContentMD5.

Parameters:

useTransactionalContentMD5 - die festzulegende useTransactionalContentMD5

setValidateEncryptionPolicy

protected void setValidateEncryptionPolicy(boolean validateEncryptionPolicy)

Legt das BlobCustomerProvidedKey-Objekt fest, das für ein Quellblob verwendet werden soll. Die vom Kunden bereitgestellte Schlüsselverschlüsselung wird für die meisten Upload-, Download- und Kopieranforderungen in Blob Storage sowie für das Abrufen von Eigenschaften und Metadaten unterstützt.

Parameters:

validateEncryptionPolicy - Verwenden Sie true , um eine Validierung zu erfordern, falseandernfalls .

Gilt für: