PathUpdateAccessControlRecursiveOptions Class

Package:

com.azure.storage.file.datalake.options

Maven Artifact:

com.azure:azure-storage-file-datalake:12.19.1

• java.lang.Object
• • com.azure.storage.file.datalake.options.PathUpdateAccessControlRecursiveOptions

public class PathUpdateAccessControlRecursiveOptions

Optional parameters for Update Access Control Recursive.

Constructor Summary

Constructor	Description
PathUpdateAccessControlRecursiveOptions(List<PathAccessControlEntry> accessControlList)	Constructs a new options object.

Method Summary

Modifier and Type	Method and Description
List<PathAccessControlEntry>	getAccessControlList() Returns the POSIX access control list for the file or directory.
Integer	getBatchSize() Gets the batch size.
String	getContinuationToken() Returns a token that can be used to resume previously stopped operation.
Integer	getMaxBatches() Gets the maximum number of batches that single change Access Control operation can execute.
Consumer<Response<AccessControlChanges>>	getProgressHandler() Gets a callback where caller can track progress of the operation as well as collect paths that failed to change Access Control.
boolean	isContinueOnFailure() Returns if the operation should continue on user failure.
PathUpdateAccessControlRecursiveOptions	setBatchSize(Integer batchSize) Sets the batch size.
PathUpdateAccessControlRecursiveOptions	setContinuationToken(String continuationToken) Sets a token that can be used to resume previously stopped operation.
PathUpdateAccessControlRecursiveOptions	setContinueOnFailure(boolean continueOnFailure) Sets if the operation should continue on user failure.
PathUpdateAccessControlRecursiveOptions	setMaxBatches(Integer maxBatches) Sets the maximum number of batches that single change Access Control operation can execute.
PathUpdateAccessControlRecursiveOptions	setProgressHandler(Consumer<Response<AccessControlChanges>> progressHandler) Sets a callback where caller can track progress of the operation as well as collect paths that failed to change Access Control.

Methods inherited from java.lang.Object

clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Constructor Details

PathUpdateAccessControlRecursiveOptions

public PathUpdateAccessControlRecursiveOptions(List accessControlList)

Constructs a new options object.

Parameters:

accessControlList - The POSIX access control list for the file or directory.

Method Details

getAccessControlList

public List getAccessControlList()

Returns the POSIX access control list for the file or directory.

Returns:

The POSIX access control list for the file or directory.

getBatchSize

public Integer getBatchSize()

Gets the batch size.

If data set size exceeds batch size then operation will be split into multiple requests so that progress can be tracked. Batch size should be between 1 and 2000. The default when unspecified is 2000.

Returns:

The size of the batch.

getContinuationToken

public String getContinuationToken()

Returns a token that can be used to resume previously stopped operation.

Returns:

A token that can be used to resume previously stopped operation.

getMaxBatches

public Integer getMaxBatches()

Gets the maximum number of batches that single change Access Control operation can execute.

If maximum is reached before all subpaths are processed then continuation token can be used to resume operation. Empty value indicates that maximum number of batches in unbound and operation continues till end. Operation may also halt if an error is hit and continueOnFailure is false.

Returns:

The maximum number of batches.

getProgressHandler

public Consumer<>> getProgressHandler()

Gets a callback where caller can track progress of the operation as well as collect paths that failed to change Access Control.

Returns:

The progress handler.

isContinueOnFailure

public boolean isContinueOnFailure()

Returns if the operation should continue on user failure.

If set to false, the operation will terminate quickly on encountering user failures. If true, the operation will ignore user failures and proceed with the operation on other sub-entities of the directory.

Returns:

If the operation should continue on user failure.

setBatchSize

public PathUpdateAccessControlRecursiveOptions setBatchSize(Integer batchSize)

Sets the batch size.

If data set size exceeds batch size then operation will be split into multiple requests so that progress can be tracked. Batch size should be between 1 and 2000. The default when unspecified is 2000.

Parameters:

batchSize - The size of the batch.

Returns:

The updated object.

setContinuationToken

public PathUpdateAccessControlRecursiveOptions setContinuationToken(String continuationToken)

Sets a token that can be used to resume previously stopped operation.

Parameters:

continuationToken - A token that can be used to resume previously stopped operation.

Returns:

The updated object.

setContinueOnFailure

public PathUpdateAccessControlRecursiveOptions setContinueOnFailure(boolean continueOnFailure)

Sets if the operation should continue on user failure.

If set to false, the operation will terminate quickly on encountering user failures. If true, the operation will ignore user failures and proceed with the operation on other sub-entities of the directory.

Parameters:

continueOnFailure - Whether the operation should continue on user failure.

Returns:

The updated object.

setMaxBatches

public PathUpdateAccessControlRecursiveOptions setMaxBatches(Integer maxBatches)

Sets the maximum number of batches that single change Access Control operation can execute.

If maximum is reached before all subpaths are processed then continuation token can be used to resume operation. Empty value indicates that maximum number of batches in unbound and operation continues till end. Operation may * also halt if an error is hit and continueOnFailure is false.

Parameters:

maxBatches - The maximum number of batches.

Returns:

The updated object.

setProgressHandler

public PathUpdateAccessControlRecursiveOptions setProgressHandler(Consumer<>> progressHandler)

Sets a callback where caller can track progress of the operation as well as collect paths that failed to change Access Control.

Parameters:

progressHandler - The progress handler.

Returns:

The updated object.