DataLakeSASSignatureValues interface

Csomag:

@azure/storage-file-datalake

CSAK NODE.JS FUTTATÓKÖRNYEZETBEN ÉRHETŐ EL.

A DataLakeSASSignatureValues segítségével blob- és DataLake-szolgáltatás SAS-jogkivonatokat hozhat létre tárolókhoz, blobokhoz, fájlrendszerekhez, könyvtárakhoz és fájlokhoz.

Kellékek

agentObjectId	Optional. A 2020-02-10-es verziótól kezdődően a nem engedélyezett AAD-objektumazonosítót adja meg GUID formátumban. Egy felhasználó AAD-objektumazonosítója, amelyet a felhasználó delegálási kulcsának tulajdonosa jogosulatlannak vél. Az Azure Storage szolgáltatás egy további POSIX ACL-ellenőrzést végez annak megállapításához, hogy a felhasználó jogosult-e a kért művelet végrehajtására. Ez nem használható preauthorizedAgentObjectId. Ez csak a felhasználói delegálási SAS-hez használatos.
cacheControl	Optional. Az SAS gyorsítótár-vezérlési fejléce.
contentDisposition	Optional. Az SAS tartalomeloszlási fejléce.
contentEncoding	Optional. Az SAS tartalomkódoló fejléce.
contentLanguage	Optional. Az SAS tartalomnyelvi fejléce.
contentType	Optional. Az SAS tartalomtípus-fejléce.
correlationId	Optional. A 2020-02-10-es verziótól kezdődően ez egy GUID-érték, amely a tárolási diagnosztikai naplókban lesz naplózva, és használható az SAS-generáció és a tárerőforrás-hozzáférés korrelációjához. Ez csak a felhasználói delegálási SAS-hez használatos.
delegatedUserObjectId	Optional. A 2025-07-05-ös verziótól ez az érték megadja annak az Entra ID-jét, amelyhez a felhasználó jogosult lenne a SAS URL használatára. A kapott SAS URL-t egy Entra ID tokenrel kell együtt használni, amelyet az adott értékben megadott felhasználónak adtak ki.
directoryDepth	Optional. A 2020-02-10-es verziótól kezdve adja meg a sztring-jel canonicalizedresource mezőjében megadott könyvtár mélységét. A könyvtár mélysége a gyökérmappa alatti könyvtárak száma.
encryptionScope	Optional. Az sas URI-val engedélyezett kérések küldésekor használandó titkosítási hatókör.
expiresOn	Csak akkor választható, ha az azonosító meg van adva. Az az idő, amely után az SAS már nem fog működni.
fileSystemName	Annak a fájlrendszernek a neve, amelyhez az SAS-felhasználó hozzáférhet.
identifier	Optional. A fájlrendszer hozzáférési szabályzatának neve, ha van ilyen, erre az SAS-ra hivatkozik. Lásd: https://learn.microsoft.com/rest/api/storageservices/establishing-a-stored-access-policy
ipRange	Optional. Az SAS-ben engedélyezett IP-tartományok.
isDirectory	Optional. A 2020-02-10-es verziótól kezdődően ez az érték határozza meg, hogy a pathName könyvtár-e. Ha ez az érték igaz értékre van állítva, az elérési út egy címtár sas könyvtára. Ha hamis vagy alapértelmezett értékre van állítva, az elérési út egy fájlelérési út SAS fájl elérési útja.
pathName	Optional. A címtár vagy a fájl SAS-felhasználójának elérési útja. A snapshotTime megadása kötelező.
permissions	Csak akkor választható, ha az azonosító meg van adva. Tekintse meg FileSystemSASPermissions, DirectorySASPermissions vagy DataLakeSASPermissions az erőforrástól függően, amely az engedélysztring létrehozásához szükséges.
preauthorizedAgentObjectId	Optional. A 2020-02-10-es verziótól kezdődően az engedélyezett AAD-objektumazonosítót adja meg GUID formátumban. A felhasználó AAD-objektumazonosítója, amelyet a felhasználódelegálási kulcs tulajdonosa engedélyezett az SAS által megadott művelet végrehajtásához. Az Azure Storage szolgáltatás biztosítja, hogy a felhasználói delegálási kulcs tulajdonosa rendelkezzen a szükséges engedélyekkel a hozzáférés megadása előtt, de az ebben az értékben megadott felhasználó további engedélyellenőrzése nem történik meg. Ez nem használható agentObjectId. Ez csak a felhasználói delegálási SAS-hez használatos.
protocol	Optional. SAS-protokollok, csak HTTPS vagy HTTPSandHTTP
snapshotTime	Optional. Pillanatkép időbélyeg-sztringje, amelyhez az SAS-felhasználó hozzáférhet. Csak az API 2018-11-09-es verziójából támogatott.
startsOn	Optional. Mikor lép érvénybe az SAS.
version	Az SAS által megcélzott szolgáltatás verziója. Ha nincs megadva, az alapértelmezés szerint a tár által megcélzott verzió lesz.

Ingatlan részletei

agentObjectId

Optional. A 2020-02-10-es verziótól kezdődően a nem engedélyezett AAD-objektumazonosítót adja meg GUID formátumban. Egy felhasználó AAD-objektumazonosítója, amelyet a felhasználó delegálási kulcsának tulajdonosa jogosulatlannak vél. Az Azure Storage szolgáltatás egy további POSIX ACL-ellenőrzést végez annak megállapításához, hogy a felhasználó jogosult-e a kért művelet végrehajtására. Ez nem használható preauthorizedAgentObjectId. Ez csak a felhasználói delegálási SAS-hez használatos.

agentObjectId?: string

Ingatlanérték

string

cacheControl

Optional. Az SAS gyorsítótár-vezérlési fejléce.

cacheControl?: string

Ingatlanérték

string

contentDisposition

Optional. Az SAS tartalomeloszlási fejléce.

contentDisposition?: string

Ingatlanérték

string

contentEncoding

Optional. Az SAS tartalomkódoló fejléce.

contentEncoding?: string

Ingatlanérték

string

contentLanguage

Optional. Az SAS tartalomnyelvi fejléce.

contentLanguage?: string

Ingatlanérték

string

contentType

Optional. Az SAS tartalomtípus-fejléce.

contentType?: string

Ingatlanérték

string

correlationId

Optional. A 2020-02-10-es verziótól kezdődően ez egy GUID-érték, amely a tárolási diagnosztikai naplókban lesz naplózva, és használható az SAS-generáció és a tárerőforrás-hozzáférés korrelációjához. Ez csak a felhasználói delegálási SAS-hez használatos.

correlationId?: string

Ingatlanérték

string

delegatedUserObjectId

Optional. A 2025-07-05-ös verziótól ez az érték megadja annak az Entra ID-jét, amelyhez a felhasználó jogosult lenne a SAS URL használatára. A kapott SAS URL-t egy Entra ID tokenrel kell együtt használni, amelyet az adott értékben megadott felhasználónak adtak ki.

delegatedUserObjectId?: string

Ingatlanérték

string

directoryDepth

Optional. A 2020-02-10-es verziótól kezdve adja meg a sztring-jel canonicalizedresource mezőjében megadott könyvtár mélységét. A könyvtár mélysége a gyökérmappa alatti könyvtárak száma.

directoryDepth?: number

Ingatlanérték

number

encryptionScope

Optional. Az sas URI-val engedélyezett kérések küldésekor használandó titkosítási hatókör.

encryptionScope?: string

Ingatlanérték

string

expiresOn

Csak akkor választható, ha az azonosító meg van adva. Az az idő, amely után az SAS már nem fog működni.

expiresOn?: Date

Ingatlanérték

Date

fileSystemName

Annak a fájlrendszernek a neve, amelyhez az SAS-felhasználó hozzáférhet.

fileSystemName: string

Ingatlanérték

string

identifier

Optional. A fájlrendszer hozzáférési szabályzatának neve, ha van ilyen, erre az SAS-ra hivatkozik.

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

identifier?: string

Ingatlanérték

string

ipRange

Optional. Az SAS-ben engedélyezett IP-tartományok.

ipRange?: SasIPRange

Ingatlanérték

SasIPRange

isDirectory

Optional. A 2020-02-10-es verziótól kezdődően ez az érték határozza meg, hogy a pathName könyvtár-e. Ha ez az érték igaz értékre van állítva, az elérési út egy címtár sas könyvtára. Ha hamis vagy alapértelmezett értékre van állítva, az elérési út egy fájlelérési út SAS fájl elérési útja.

isDirectory?: boolean

Ingatlanérték

boolean

pathName

Optional. A címtár vagy a fájl SAS-felhasználójának elérési útja. A snapshotTime megadása kötelező.

pathName?: string

Ingatlanérték

string

permissions

Csak akkor választható, ha az azonosító meg van adva. Tekintse meg FileSystemSASPermissions, DirectorySASPermissions vagy DataLakeSASPermissions az erőforrástól függően, amely az engedélysztring létrehozásához szükséges.

permissions?: DataLakeSASPermissions | DirectorySASPermissions | FileSystemSASPermissions

Ingatlanérték

DataLakeSASPermissions | DirectorySASPermissions | FileSystemSASPermissions

preauthorizedAgentObjectId

Optional. A 2020-02-10-es verziótól kezdődően az engedélyezett AAD-objektumazonosítót adja meg GUID formátumban. A felhasználó AAD-objektumazonosítója, amelyet a felhasználódelegálási kulcs tulajdonosa engedélyezett az SAS által megadott művelet végrehajtásához. Az Azure Storage szolgáltatás biztosítja, hogy a felhasználói delegálási kulcs tulajdonosa rendelkezzen a szükséges engedélyekkel a hozzáférés megadása előtt, de az ebben az értékben megadott felhasználó további engedélyellenőrzése nem történik meg. Ez nem használható agentObjectId. Ez csak a felhasználói delegálási SAS-hez használatos.

preauthorizedAgentObjectId?: string

Ingatlanérték

string

protocol

Optional. SAS-protokollok, csak HTTPS vagy HTTPSandHTTP

protocol?: SASProtocol

Ingatlanérték

SASProtocol

snapshotTime

Optional. Pillanatkép időbélyeg-sztringje, amelyhez az SAS-felhasználó hozzáférhet. Csak az API 2018-11-09-es verziójából támogatott.

snapshotTime?: string

Ingatlanérték

string

startsOn

Optional. Mikor lép érvénybe az SAS.

startsOn?: Date

Ingatlanérték

Date

version

Az SAS által megcélzott szolgáltatás verziója. Ha nincs megadva, az alapértelmezés szerint a tár által megcélzott verzió lesz.

version?: string

Ingatlanérték

string