DataLakeSASSignatureValues interface

Paket:

@azure/storage-file-datalake

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR.

DataLakeSASSignatureValues kapsayıcılar, bloblar, dosya sistemi, dizinler ve dosyalar için Blob ve DataLake hizmeti SAS belirteçleri oluşturmaya yardımcı olmak için kullanılır.

Özellikler

agentObjectId	Optional. Sürüm 2020-02-10'da başlayarak, Yetkisiz AAD Nesne Kimliğini GUID biçiminde belirtir. Kullanıcı temsilcisi anahtarının sahibi tarafından yetkisiz olduğu varsayılan kullanıcının AAD Nesne Kimliği. Azure Depolama Hizmeti, kullanıcının istenen işlemi gerçekleştirme yetkisine sahip olup olmadığını belirlemek için ek bir POSIX ACL denetimi gerçekleştirir. Bu, preauthorizedAgentObjectIdile birlikte kullanılamaz. Bu yalnızca Kullanıcı Temsilcisi SAS için kullanılır.
cacheControl	Optional. SAS için önbellek denetimi üst bilgisi.
contentDisposition	Optional. SAS için içerik ayrıştırma üst bilgisi.
contentEncoding	Optional. SAS için içerik kodlama üst bilgisi.
contentLanguage	Optional. SAS için içerik dili üst bilgisi.
contentType	Optional. SAS için içerik türü üst bilgisi.
correlationId	Optional. Sürüm 2020-02-10'da başlayarak bu, depolama tanılama günlüklerinde günlüğe kaydedilecek ve SAS oluşturma işlemini depolama kaynağı erişimiyle ilişkilendirmek için kullanılabilen bir GUID değeridir. Bu yalnızca Kullanıcı Temsilcisi SAS için kullanılır.
delegatedUserObjectId	Optional. 2025-07-05 sürümünden itibaren, bu değer kullanıcının ortaya çıkan SAS URL'sini kullanmasına izin verecek Entra ID'sini belirtir. Ortaya çıkan SAS URL, bu değerde belirtilen kullanıcıya verilen bir Entra ID tokenı ile birlikte kullanılmalıdır.
directoryDepth	Optional. Sürüm 2020-02-10'dan başlayarak, dizeden imzaya alanının canonicalizedresource alanında belirtilen dizinin derinliğini gösterir. Dizinin derinliği, kök klasörün altındaki dizin sayısıdır.
encryptionScope	Optional. Bu SAS URI'si ile yetkilendirilmiş istekleri gönderirken kullanılacak şifreleme kapsamı.
expiresOn	İsteğe bağlı olarak yalnızca tanımlayıcı sağlandığında. SAS'nin çalışmadığı süre.
fileSystemName	SAS kullanıcısının erişebileceği dosya sisteminin adı.
identifier	Optional. Varsa, bu SAS'nin başvurarak dosya sistemindeki erişim ilkesinin adı. Bkz. https://learn.microsoft.com/rest/api/storageservices/establishing-a-stored-access-policy
ipRange	Optional. Bu SAS'de izin verilen IP aralıkları.
isDirectory	Optional. Sürüm 2020-02-10'da başlayarak, bu değer pathName bir dizin olup olmadığını tanımlar. Bu değer true olarak ayarlanırsa, Yol bir Dizin SAS'sinin Dizinidir. False veya varsayılan olarak ayarlanırsa, Yol bir Dosya Yolu SAS'sinin Dosya Yolu'dur.
pathName	Optional. SAS kullanıcısının erişebileceği dizin veya dosyanın yol adı. snapshotTime sağlanmışsa gereklidir.
permissions	İsteğe bağlı olarak yalnızca tanımlayıcı sağlandığında. İzin dizesini oluşturma konusunda yardım almak için erişilen kaynağa bağlı olarak FileSystemSASPermissions, DirectorySASPermissions veya DataLakeSASPermissions başvurun.
preauthorizedAgentObjectId	Optional. Sürüm 2020-02-10'da başlayarak, Yetkili AAD Nesne Kimliğini GUID biçiminde belirtir. SAS tarafından verilen eylemi gerçekleştirmek için kullanıcı temsilcisi anahtarının sahibi tarafından yetkilendirilmiş bir kullanıcının AAD Nesne Kimliği. Azure Depolama hizmeti, erişim vermeden önce kullanıcı temsilcisi anahtarının sahibinin gerekli izinlere sahip olmasını sağlar, ancak bu değerde belirtilen kullanıcı için ek izin denetimi gerçekleştirilmeyecektir. Bu, agentObjectIdile birlikte kullanılamaz. Bu yalnızca Kullanıcı Temsilcisi SAS için kullanılır.
protocol	Optional. SAS protokolleri, yalnızca HTTPS veya HTTPSandHTTP
snapshotTime	Optional. SAS kullanıcısının erişebileceği anlık görüntü zaman damgası dizesi. Yalnızca API 2018-11-09 sürümünde desteklenir.
startsOn	Optional. SAS'nin etkin olacağı zaman.
version	Bu SAS'nin hedefleeceği hizmetin sürümü. Belirtilmezse, kitaplık tarafından hedeflenen sürüm varsayılan olarak kullanılır.

Özellik Ayrıntıları

agentObjectId

Optional. Sürüm 2020-02-10'da başlayarak, Yetkisiz AAD Nesne Kimliğini GUID biçiminde belirtir. Kullanıcı temsilcisi anahtarının sahibi tarafından yetkisiz olduğu varsayılan kullanıcının AAD Nesne Kimliği. Azure Depolama Hizmeti, kullanıcının istenen işlemi gerçekleştirme yetkisine sahip olup olmadığını belirlemek için ek bir POSIX ACL denetimi gerçekleştirir. Bu, preauthorizedAgentObjectIdile birlikte kullanılamaz. Bu yalnızca Kullanıcı Temsilcisi SAS için kullanılır.

agentObjectId?: string

Özellik Değeri

string

cacheControl

Optional. SAS için önbellek denetimi üst bilgisi.

cacheControl?: string

Özellik Değeri

string

contentDisposition

Optional. SAS için içerik ayrıştırma üst bilgisi.

contentDisposition?: string

Özellik Değeri

string

contentEncoding

Optional. SAS için içerik kodlama üst bilgisi.

contentEncoding?: string

Özellik Değeri

string

contentLanguage

Optional. SAS için içerik dili üst bilgisi.

contentLanguage?: string

Özellik Değeri

string

contentType

Optional. SAS için içerik türü üst bilgisi.

contentType?: string

Özellik Değeri

string

correlationId

Optional. Sürüm 2020-02-10'da başlayarak bu, depolama tanılama günlüklerinde günlüğe kaydedilecek ve SAS oluşturma işlemini depolama kaynağı erişimiyle ilişkilendirmek için kullanılabilen bir GUID değeridir. Bu yalnızca Kullanıcı Temsilcisi SAS için kullanılır.

correlationId?: string

Özellik Değeri

string

delegatedUserObjectId

Optional. 2025-07-05 sürümünden itibaren, bu değer kullanıcının ortaya çıkan SAS URL'sini kullanmasına izin verecek Entra ID'sini belirtir. Ortaya çıkan SAS URL, bu değerde belirtilen kullanıcıya verilen bir Entra ID tokenı ile birlikte kullanılmalıdır.

delegatedUserObjectId?: string

Özellik Değeri

string

directoryDepth

Optional. Sürüm 2020-02-10'dan başlayarak, dizeden imzaya alanının canonicalizedresource alanında belirtilen dizinin derinliğini gösterir. Dizinin derinliği, kök klasörün altındaki dizin sayısıdır.

directoryDepth?: number

Özellik Değeri

number

encryptionScope

Optional. Bu SAS URI'si ile yetkilendirilmiş istekleri gönderirken kullanılacak şifreleme kapsamı.

encryptionScope?: string

Özellik Değeri

string

expiresOn

İsteğe bağlı olarak yalnızca tanımlayıcı sağlandığında. SAS'nin çalışmadığı süre.

expiresOn?: Date

Özellik Değeri

Date

fileSystemName

SAS kullanıcısının erişebileceği dosya sisteminin adı.

fileSystemName: string

Özellik Değeri

string

identifier

Optional. Varsa, bu SAS'nin başvurarak dosya sistemindeki erişim ilkesinin adı.

Bkz. https://learn.microsoft.com/rest/api/storageservices/establishing-a-stored-access-policy

identifier?: string

Özellik Değeri

string

ipRange

Optional. Bu SAS'de izin verilen IP aralıkları.

ipRange?: SasIPRange

Özellik Değeri

SasIPRange

isDirectory

Optional. Sürüm 2020-02-10'da başlayarak, bu değer pathName bir dizin olup olmadığını tanımlar. Bu değer true olarak ayarlanırsa, Yol bir Dizin SAS'sinin Dizinidir. False veya varsayılan olarak ayarlanırsa, Yol bir Dosya Yolu SAS'sinin Dosya Yolu'dur.

isDirectory?: boolean

Özellik Değeri

boolean

pathName

Optional. SAS kullanıcısının erişebileceği dizin veya dosyanın yol adı. snapshotTime sağlanmışsa gereklidir.

pathName?: string

Özellik Değeri

string

permissions

İsteğe bağlı olarak yalnızca tanımlayıcı sağlandığında. İzin dizesini oluşturma konusunda yardım almak için erişilen kaynağa bağlı olarak FileSystemSASPermissions, DirectorySASPermissions veya DataLakeSASPermissions başvurun.

permissions?: DataLakeSASPermissions | DirectorySASPermissions | FileSystemSASPermissions

Özellik Değeri

DataLakeSASPermissions | DirectorySASPermissions | FileSystemSASPermissions

preauthorizedAgentObjectId

Optional. Sürüm 2020-02-10'da başlayarak, Yetkili AAD Nesne Kimliğini GUID biçiminde belirtir. SAS tarafından verilen eylemi gerçekleştirmek için kullanıcı temsilcisi anahtarının sahibi tarafından yetkilendirilmiş bir kullanıcının AAD Nesne Kimliği. Azure Depolama hizmeti, erişim vermeden önce kullanıcı temsilcisi anahtarının sahibinin gerekli izinlere sahip olmasını sağlar, ancak bu değerde belirtilen kullanıcı için ek izin denetimi gerçekleştirilmeyecektir. Bu, agentObjectIdile birlikte kullanılamaz. Bu yalnızca Kullanıcı Temsilcisi SAS için kullanılır.

preauthorizedAgentObjectId?: string

Özellik Değeri

string

protocol

Optional. SAS protokolleri, yalnızca HTTPS veya HTTPSandHTTP

protocol?: SASProtocol

Özellik Değeri

SASProtocol

snapshotTime

Optional. SAS kullanıcısının erişebileceği anlık görüntü zaman damgası dizesi. Yalnızca API 2018-11-09 sürümünde desteklenir.

snapshotTime?: string

Özellik Değeri

string

startsOn

Optional. SAS'nin etkin olacağı zaman.

startsOn?: Date

Özellik Değeri

Date

version

Bu SAS'nin hedefleeceği hizmetin sürümü. Belirtilmezse, kitaplık tarafından hedeflenen sürüm varsayılan olarak kullanılır.

version?: string

Özellik Değeri

string