com.azure.storage.file.datalake.sas

Class DataLakeServiceSasSignatureValues

java.lang.Object

com.azure.storage.file.datalake.sas.DataLakeServiceSasSignatureValues

public final class DataLakeServiceSasSignatureValues
extends Object

Used to initialize parameters for a Shared Access Signature (SAS) for an Azure Data Lake Storage service. Once all the values here are set, use the appropriate SAS generation method on the desired file system/path client to obtain a representation of the SAS which can then be applied to a new client using the .sasToken(String) method on the desired client builder.

See Also:

Storage SAS overview, Constructing a Service SAS, Constructing a User Delegation SAS

Constructor Summary

Constructors

Constructor and Description
DataLakeServiceSasSignatureValues(OffsetDateTime expiryTime, FileSystemSasPermission permissions) Creates an object with the specified expiry time and permissions
DataLakeServiceSasSignatureValues(OffsetDateTime expiryTime, PathSasPermission permissions) Creates an object with the specified expiry time and permissions
DataLakeServiceSasSignatureValues(String identifier) Creates an object with the specified identifier.

Method Summary

Modifier and Type	Method and Description
String	getCacheControl()
String	getContentDisposition()
String	getContentEncoding()
String	getContentLanguage()
String	getContentType()
OffsetDateTime	getExpiryTime()
String	getIdentifier()
String	getPermissions()
com.azure.storage.common.sas.SasProtocol	getProtocol()
com.azure.storage.common.sas.SasIpRange	getSasIpRange()
OffsetDateTime	getStartTime()
String	getVersion()
DataLakeServiceSasSignatureValues	setCacheControl(String cacheControl) Sets the cache-control header for the SAS.
DataLakeServiceSasSignatureValues	setContentDisposition(String contentDisposition) Sets the content-disposition header for the SAS.
DataLakeServiceSasSignatureValues	setContentEncoding(String contentEncoding) Sets the content-encoding header for the SAS.
DataLakeServiceSasSignatureValues	setContentLanguage(String contentLanguage) Sets the content-language header for the SAS.
DataLakeServiceSasSignatureValues	setContentType(String contentType) Sets the content-type header for the SAS.
DataLakeServiceSasSignatureValues	setExpiryTime(OffsetDateTime expiryTime) Sets the time after which the SAS will no longer work.
DataLakeServiceSasSignatureValues	setIdentifier(String identifier) Sets the name of the access policy on the file system this SAS references if any.
DataLakeServiceSasSignatureValues	setPermissions(FileSystemSasPermission permissions) Sets the File System permissions allowed by the SAS.
DataLakeServiceSasSignatureValues	setPermissions(PathSasPermission permissions) Sets the Path permissions allowed by the SAS.
DataLakeServiceSasSignatureValues	setProtocol(com.azure.storage.common.sas.SasProtocol protocol) Sets the SasProtocol which determines the protocols allowed by the SAS.
DataLakeServiceSasSignatureValues	setSasIpRange(com.azure.storage.common.sas.SasIpRange sasIpRange) Sets the SasIpRange which determines the IP ranges that are allowed to use the SAS.
DataLakeServiceSasSignatureValues	setStartTime(OffsetDateTime startTime) Sets when the SAS will take effect.
DataLakeServiceSasSignatureValues	setVersion(String version) Sets the version of the service this SAS will target.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DataLakeServiceSasSignatureValues

public DataLakeServiceSasSignatureValues(OffsetDateTime expiryTime,
                                         FileSystemSasPermission permissions)

Creates an object with the specified expiry time and permissions

Parameters:

expiryTime - The time after which the SAS will no longer work.

permissions - FileSystemSasPermission allowed by the SAS.

DataLakeServiceSasSignatureValues

public DataLakeServiceSasSignatureValues(OffsetDateTime expiryTime,
                                         PathSasPermission permissions)

Creates an object with the specified expiry time and permissions

Parameters:

expiryTime - When the SAS will no longer work

permissions - PathSasPermission allowed by the SAS

DataLakeServiceSasSignatureValues

public DataLakeServiceSasSignatureValues(String identifier)

Creates an object with the specified identifier. NOTE: Identifier can not be used for a UserDelegationKey SAS.

Parameters:

identifier - Name of the access policy

Method Detail

getVersion

public String getVersion()

Returns:

the version of the service this SAS will target. If not specified, it will default to the version targeted by the library.

setVersion

public DataLakeServiceSasSignatureValues setVersion(String version)

Sets the version of the service this SAS will target. If not specified, it will default to the version targeted by the library.

Parameters:

version - Version to target

Returns:

the updated DataLakeServiceSasSignatureValues object

getProtocol

public com.azure.storage.common.sas.SasProtocol getProtocol()

Returns:

the SasProtocol which determines the protocols allowed by the SAS.

setProtocol

public DataLakeServiceSasSignatureValues setProtocol(com.azure.storage.common.sas.SasProtocol protocol)

Sets the SasProtocol which determines the protocols allowed by the SAS.

Parameters:

protocol - Protocol for the SAS

Returns:

the updated DataLakeServiceSasSignatureValues object

getStartTime

public OffsetDateTime getStartTime()

Returns:

when the SAS will take effect.

setStartTime

public DataLakeServiceSasSignatureValues setStartTime(OffsetDateTime startTime)

Sets when the SAS will take effect.

Parameters:

startTime - When the SAS takes effect

Returns:

the updated DataLakeServiceSasSignatureValues object

getExpiryTime

public OffsetDateTime getExpiryTime()

Returns:

the time after which the SAS will no longer work.

setExpiryTime

public DataLakeServiceSasSignatureValues setExpiryTime(OffsetDateTime expiryTime)

Sets the time after which the SAS will no longer work.

Parameters:

expiryTime - When the SAS will no longer work

Returns:

the updated DataLakeServiceSasSignatureValues object

getPermissions

public String getPermissions()

Returns:

the permissions string allowed by the SAS. Please refer to either FileSystemSasPermission or PathSasPermission depending on the resource being accessed for help determining the permissions allowed.

setPermissions

public DataLakeServiceSasSignatureValues setPermissions(PathSasPermission permissions)

Sets the Path permissions allowed by the SAS.

Parameters:

permissions - PathSasPermission

Returns:

the updated DataLakeServiceSasSignatureValues object

Throws:

NullPointerException - if permissions is null.

setPermissions

public DataLakeServiceSasSignatureValues setPermissions(FileSystemSasPermission permissions)

Sets the File System permissions allowed by the SAS.

Parameters:

permissions - FileSystemSasPermission

Returns:

the updated DataLakeServiceSasSignatureValues object

Throws:

NullPointerException - if permissions is null.

getSasIpRange

public com.azure.storage.common.sas.SasIpRange getSasIpRange()

Returns:

the SasIpRange which determines the IP ranges that are allowed to use the SAS.

setSasIpRange

public DataLakeServiceSasSignatureValues setSasIpRange(com.azure.storage.common.sas.SasIpRange sasIpRange)

Sets the SasIpRange which determines the IP ranges that are allowed to use the SAS.

Parameters:

sasIpRange - Allowed IP range to set

Returns:

the updated DataLakeServiceSasSignatureValues object

getIdentifier

public String getIdentifier()

Returns:

the name of the access policy on the file system this SAS references if any. Please see here for more information.

setIdentifier

public DataLakeServiceSasSignatureValues setIdentifier(String identifier)

Sets the name of the access policy on the file system this SAS references if any. Please see here for more information.

Parameters:

identifier - Name of the access policy

Returns:

the updated DataLakeServiceSasSignatureValues object

getCacheControl

public String getCacheControl()

Returns:

the cache-control header for the SAS.

setCacheControl

public DataLakeServiceSasSignatureValues setCacheControl(String cacheControl)

Sets the cache-control header for the SAS.

Parameters:

cacheControl - Cache-Control header value

Returns:

the updated DataLakeServiceSasSignatureValues object

getContentDisposition

public String getContentDisposition()

Returns:

the content-disposition header for the SAS.

setContentDisposition

public DataLakeServiceSasSignatureValues setContentDisposition(String contentDisposition)

Sets the content-disposition header for the SAS.

Parameters:

contentDisposition - Content-Disposition header value

Returns:

the updated DataLakeServiceSasSignatureValues object

getContentEncoding

public String getContentEncoding()

Returns:

the content-encoding header for the SAS.

setContentEncoding

public DataLakeServiceSasSignatureValues setContentEncoding(String contentEncoding)

Sets the content-encoding header for the SAS.

Parameters:

contentEncoding - Content-Encoding header value

Returns:

the updated DataLakeServiceSasSignatureValues object

getContentLanguage

public String getContentLanguage()

Returns:

the content-language header for the SAS.

setContentLanguage

public DataLakeServiceSasSignatureValues setContentLanguage(String contentLanguage)

Sets the content-language header for the SAS.

Parameters:

contentLanguage - Content-Language header value

Returns:

the updated DataLakeServiceSasSignatureValues object

getContentType

public String getContentType()

Returns:

the content-type header for the SAS.

setContentType

public DataLakeServiceSasSignatureValues setContentType(String contentType)

Sets the content-type header for the SAS.

Parameters:

contentType - Content-Type header value

Returns:

the updated DataLakeServiceSasSignatureValues object