AZSBlobRequestOptions Class Reference

Inherits from AZSRequestOptions : NSObject
Declared in AZSBlobRequestOptions.h
AZSBlobRequestOptions.m

Overview

AZSBlobRequestOptions contains options used for requests to the blob service.

AZSBlobRequestOptions is used for configuring the behavior of blob requests. Defaults will be used if any options that are not set, or if a AZSBlobRequestOptions object is not provided.

– init

Initializes a new AZSBlobRequestOptions object. Once the object is initialized, individual properties can be set.

- (instancetype)init

Discussion

Initializes a new AZSBlobRequestOptions object. Once the object is initialized, individual properties can be set.

Declared In

AZSBlobRequestOptions.h

– useTransactionalMD5

If YES, all operations that support it will calculate the MD5 of the message bodies on both the client and the service, to validate that there were no errors in transmission. This has nothing to do with the content-MD5 header stored on a blob.

- (BOOL)useTransactionalMD5

Discussion

If YES, all operations that support it will calculate the MD5 of the message bodies on both the client and the service, to validate that there were no errors in transmission. This has nothing to do with the content-MD5 header stored on a blob.

Declared In

AZSBlobRequestOptions.h

– storeBlobContentMD5

If YES, when uploading a blob, the content-MD5 header will be stored along with the blob. If one is not supplied, the library will calculate one where possible.

- (BOOL)storeBlobContentMD5

Discussion

If YES, when uploading a blob, the content-MD5 header will be stored along with the blob. If one is not supplied, the library will calculate one where possible.

Declared In

AZSBlobRequestOptions.h

– disableContentMD5Validation

If YES, the library will not calculate and validate the MD5 when downloading a blob.

- (BOOL)disableContentMD5Validation

Discussion

If YES, the library will not calculate and validate the MD5 when downloading a blob.

Declared In

AZSBlobRequestOptions.h

– parallelismFactor

The number of simultaneous outstanding block uploads to permit when uploading a blob as a series of blocks.

- (NSInteger)parallelismFactor

Discussion

The number of simultaneous outstanding block uploads to permit when uploading a blob as a series of blocks.

Declared In

AZSBlobRequestOptions.h

– absorbConditionalErrorsOnRetry

If YES, when uploading an append blob in a streaming fashion, conditional errors should be ignored.

- (BOOL)absorbConditionalErrorsOnRetry

Discussion

If YES, when uploading an append blob in a streaming fashion, conditional errors should be ignored.

When uploading append blobs in a streaming fashion, an append-offset conditional header is used to avoid duplicate blocks. If this is set to YES, errors from the append-offset header will be ignored when the error is coming from a block already being written to the service. Only set this to YES if there is no possiblity of multiple writers writing to the blob simultaneously. Otherwise, data corruption can occur.

Declared In

AZSBlobRequestOptions.h