Condividi tramite

DataLakeSASSignatureValues interface

Pacchetto:
@azure/storage-file-datalake

DISPONIBILE SOLO IN NODE.JS RUNTIME.

DataLakeSASSignatureValues viene usato per generare token di firma di accesso condiviso del servizio Blob e DataLake per contenitori, BLOB, file system, directory e file.

Proprietà

agentObjectId

Opzionale. A partire dalla versione 2020-02-10, specifica l'ID oggetto AAD non autorizzato in formato GUID. ID oggetto AAD di un utente considerato non autorizzato dal proprietario della chiave di delega utente. Il servizio di archiviazione di Azure eseguirà un controllo ACL POSIX aggiuntivo per determinare se l'utente è autorizzato a eseguire l'operazione richiesta. Questo non può essere usato in combinazione con preauthorizedAgentObjectId. Questa operazione viene usata solo per la firma di accesso condiviso della delega utente.
cacheControl

Opzionale. Intestazione del controllo cache per la firma di accesso condiviso.
contentDisposition

Opzionale. Intestazione content-disposition per la firma di accesso condiviso.
contentEncoding

Opzionale. Intestazione di codifica del contenuto per la firma di accesso condiviso.
contentLanguage

Opzionale. Intestazione content-language per la firma di accesso condiviso.
contentType

Opzionale. Intestazione content-type per la firma di accesso condiviso.
correlationId

Opzionale. A partire dalla versione 2020-02-10, si tratta di un valore GUID che verrà registrato nei log di diagnostica di archiviazione e che può essere usato per correlare la generazione della firma di accesso condiviso con l'accesso alle risorse di archiviazione. Questa operazione viene usata solo per la firma di accesso condiviso della delega utente.
directoryDepth

Opzionale. A partire dalla versione 2020-02-10, indicare la profondità della directory specificata nel campo canonicalizedresource del segno da stringa a segno. La profondità della directory è il numero di directory sotto la cartella radice.
encryptionScope

Opzionale. Ambito di crittografia da usare quando si inviano richieste autorizzate con questo URI di firma di accesso condiviso.
expiresOn

Facoltativo solo quando viene specificato l'identificatore. Tempo dopo il quale la firma di accesso condiviso non funzionerà più.
fileSystemName

Il nome del file system a cui l'utente sas può accedere.
identifier

Opzionale. Nome dei criteri di accesso nel file system a cui fa riferimento questa firma di accesso condiviso, se presente.

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

Opzionale. Intervalli IP consentiti in questa firma di accesso condiviso.
isDirectory

Opzionale. A partire dalla versione 2020-02-10, questo valore definisce se il pathName è una directory. Se questo valore è impostato su true, path è una directory per una firma di accesso condiviso della directory. Se impostato su false o predefinito, il percorso è un percorso file per una firma di accesso condiviso percorso file.
pathName

Opzionale. Il nome del percorso della directory o dell'utente sas del file può accedere. Obbligatorio se viene specificato snapshotTime.
permissions

Facoltativo solo quando viene specificato l'identificatore. Vedere FileSystemSASPermissions, DirectorySASPermissions o DataLakeSASPermissions a seconda della risorsa a cui si accede per la creazione della stringa di autorizzazioni.
preauthorizedAgentObjectId

Opzionale. A partire dalla versione 2020-02-10, specifica l'ID oggetto AAD autorizzato in formato GUID. ID oggetto AAD di un utente autorizzato dal proprietario della chiave di delega utente per eseguire l'azione concessa dalla firma di accesso condiviso. Il servizio Archiviazione di Azure garantisce che il proprietario della chiave di delega utente disponga delle autorizzazioni necessarie prima di concedere l'accesso, ma non verrà eseguito alcun controllo di autorizzazione aggiuntivo per l'utente specificato in questo valore. Questo non può essere usato in combinazione con agentObjectId. Questa operazione viene usata solo per la firma di accesso condiviso della delega utente.
protocol

Opzionale. Protocolli sas, solo HTTPS o HTTPSandHTTP
snapshotTime

Opzionale. Stringa di timestamp dello snapshot a cui l'utente sas può accedere. Supportato solo dall'API versione 2018-11-09.
startsOn

Opzionale. Quando la firma di accesso condiviso avrà effetto.
version

La versione del servizio di destinazione della firma di accesso condiviso. Se non specificato, per impostazione predefinita verrà usata la versione di destinazione della libreria.

Dettagli proprietà

agentObjectId

Opzionale. A partire dalla versione 2020-02-10, specifica l'ID oggetto AAD non autorizzato in formato GUID. ID oggetto AAD di un utente considerato non autorizzato dal proprietario della chiave di delega utente. Il servizio di archiviazione di Azure eseguirà un controllo ACL POSIX aggiuntivo per determinare se l'utente è autorizzato a eseguire l'operazione richiesta. Questo non può essere usato in combinazione con preauthorizedAgentObjectId. Questa operazione viene usata solo per la firma di accesso condiviso della delega utente.

agentObjectId?: string

Valore della proprietà

string

cacheControl

Opzionale. Intestazione del controllo cache per la firma di accesso condiviso.

cacheControl?: string

Valore della proprietà

string

contentDisposition

Opzionale. Intestazione content-disposition per la firma di accesso condiviso.

contentDisposition?: string

Valore della proprietà

string

contentEncoding

Opzionale. Intestazione di codifica del contenuto per la firma di accesso condiviso.

contentEncoding?: string

Valore della proprietà

string

contentLanguage

Opzionale. Intestazione content-language per la firma di accesso condiviso.

contentLanguage?: string

Valore della proprietà

string

contentType

Opzionale. Intestazione content-type per la firma di accesso condiviso.

contentType?: string

Valore della proprietà

string

correlationId

Opzionale. A partire dalla versione 2020-02-10, si tratta di un valore GUID che verrà registrato nei log di diagnostica di archiviazione e che può essere usato per correlare la generazione della firma di accesso condiviso con l'accesso alle risorse di archiviazione. Questa operazione viene usata solo per la firma di accesso condiviso della delega utente.

correlationId?: string

Valore della proprietà

string

directoryDepth

Opzionale. A partire dalla versione 2020-02-10, indicare la profondità della directory specificata nel campo canonicalizedresource del segno da stringa a segno. La profondità della directory è il numero di directory sotto la cartella radice.

directoryDepth?: number

Valore della proprietà

number

encryptionScope

Opzionale. Ambito di crittografia da usare quando si inviano richieste autorizzate con questo URI di firma di accesso condiviso.

encryptionScope?: string

Valore della proprietà

string

expiresOn

Facoltativo solo quando viene specificato l'identificatore. Tempo dopo il quale la firma di accesso condiviso non funzionerà più.

expiresOn?: Date

Valore della proprietà

Date

fileSystemName

Il nome del file system a cui l'utente sas può accedere.

fileSystemName: string

Valore della proprietà

string

identifier

Opzionale. Nome dei criteri di accesso nel file system a cui fa riferimento questa firma di accesso condiviso, se presente.

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

identifier?: string

Valore della proprietà

string

ipRange

Opzionale. Intervalli IP consentiti in questa firma di accesso condiviso.

ipRange?: SasIPRange

Valore della proprietà

SasIPRange

isDirectory

Opzionale. A partire dalla versione 2020-02-10, questo valore definisce se il pathName è una directory. Se questo valore è impostato su true, path è una directory per una firma di accesso condiviso della directory. Se impostato su false o predefinito, il percorso è un percorso file per una firma di accesso condiviso percorso file.

isDirectory?: boolean

Valore della proprietà

boolean

pathName

Opzionale. Il nome del percorso della directory o dell'utente sas del file può accedere. Obbligatorio se viene specificato snapshotTime.

pathName?: string

Valore della proprietà

string

permissions

Facoltativo solo quando viene specificato l'identificatore. Vedere FileSystemSASPermissions, DirectorySASPermissions o DataLakeSASPermissions a seconda della risorsa a cui si accede per la creazione della stringa di autorizzazioni.

permissions?: DataLakeSASPermissions | DirectorySASPermissions | FileSystemSASPermissions

Valore della proprietà

DataLakeSASPermissions | DirectorySASPermissions | FileSystemSASPermissions

preauthorizedAgentObjectId

Opzionale. A partire dalla versione 2020-02-10, specifica l'ID oggetto AAD autorizzato in formato GUID. ID oggetto AAD di un utente autorizzato dal proprietario della chiave di delega utente per eseguire l'azione concessa dalla firma di accesso condiviso. Il servizio Archiviazione di Azure garantisce che il proprietario della chiave di delega utente disponga delle autorizzazioni necessarie prima di concedere l'accesso, ma non verrà eseguito alcun controllo di autorizzazione aggiuntivo per l'utente specificato in questo valore. Questo non può essere usato in combinazione con agentObjectId. Questa operazione viene usata solo per la firma di accesso condiviso della delega utente.

preauthorizedAgentObjectId?: string

Valore della proprietà

string

protocol

Opzionale. Protocolli sas, solo HTTPS o HTTPSandHTTP

protocol?: SASProtocol

Valore della proprietà

SASProtocol

snapshotTime

Opzionale. Stringa di timestamp dello snapshot a cui l'utente sas può accedere. Supportato solo dall'API versione 2018-11-09.

snapshotTime?: string

Valore della proprietà

string

startsOn

Opzionale. Quando la firma di accesso condiviso avrà effetto.

startsOn?: Date

Valore della proprietà

Date

version

La versione del servizio di destinazione della firma di accesso condiviso. Se non specificato, per impostazione predefinita verrà usata la versione di destinazione della libreria.

version?: string

Valore della proprietà

string