SASQueryParameters class

Riferimento

Pacchetto:: @azure/storage-blob

Rappresenta i componenti che costituiscono i parametri di query della firma di accesso condiviso di Archiviazione di Azure. Questo tipo non viene costruito direttamente dall'utente; viene generato solo dai <xref:AccountSASSignatureValues> tipi e <xref:BlobSASSignatureValues> . Una volta generato, può essere codificato in un <xref:String> oggetto e aggiunto direttamente a un URL( anche se è necessario prestare attenzione nel caso in cui siano presenti parametri di query esistenti, che potrebbero influire sui mezzi appropriati per accodare questi parametri di query). NOTA: le istanze di questa classe non sono modificabili.

Costruttori

SASQueryParameters(string, string, SASQueryParametersOptions)	Crea un'istanza di SASQueryParameters.
SASQueryParameters(string, string, string, string, string, SASProtocol, Date, Date, SasIPRange, string, string, string, string, string, string, string, UserDelegationKey, string, string)	Crea un'istanza di SASQueryParameters.

Proprietà

cacheControl	Valore per l'intestazione del controllo cache nella firma di accesso condiviso blob/servizio file.
contentDisposition	Valore per l'intestazione content-disposition nella firma di accesso condiviso blob/servizio file.
contentEncoding	Valore per l'intestazione content-encoding nella firma di accesso condiviso blob/servizio file.
contentLanguage	Valore per l'intestazione content-length nella firma di accesso condiviso blob/servizio file.
contentType	Valore per l'intestazione content-type nella firma di accesso condiviso blob/servizio file.
correlationId	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 opzione viene usata solo per la firma di accesso condiviso della delega utente.
expiresOn	Facoltativo solo quando viene fornito l'identificatore. Ora di scadenza per questo token di firma di accesso condiviso.
identifier	Facoltativa. Identificatore firmato (solo per <xref:BlobSASSignatureValues>).
ipRange	Facoltativa. Intervallo IP consentito per questa firma di accesso condiviso.
permissions	Facoltativo solo quando viene fornito l'identificatore. Per altri dettagli, vedere <xref:AccountSASPermissions>, <xref:BlobSASPermissions>o <xref:ContainerSASPermissions> .
preauthorizedAgentObjectId	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. Questa opzione viene usata solo per la firma di accesso condiviso della delega utente.
protocol	Facoltativa. Protocolli HTTP consentiti.
resource	Facoltativa. Specifica le risorse accessibili tramite la firma di accesso condiviso (solo per <xref:BlobSASSignatureValues>).
resourceTypes	Facoltativa. Tipi di risorse di archiviazione a cui si accede (solo per firma di accesso condiviso dell'account). Per altri dettagli, fare riferimento a <xref:AccountSASResourceTypes> .
services	Facoltativa. I servizi di archiviazione a cui si accede (solo per la firma di accesso condiviso dell'account). Per altri dettagli, fare riferimento a <xref:AccountSASServices> .
signature	Firma per il token di firma di accesso condiviso.
startsOn	Facoltativa. Ora di inizio per questo token di firma di accesso condiviso.
version	Versione dell'API di archiviazione.

Metodi

toString()

Codifica tutti i parametri di query sas in una stringa che può essere aggiunta a un URL.

Dettagli costruttore

SASQueryParameters(string, string, SASQueryParametersOptions)

Crea un'istanza di SASQueryParameters.

new SASQueryParameters(version: string, signature: string, options?: SASQueryParametersOptions)

Parametri

version: string

Rappresentazione della versione di archiviazione

signature: string

Rappresentazione della firma per il token di firma di accesso condiviso

options: SASQueryParametersOptions

Facoltativa. Opzioni per costruire SASQueryParameters.

SASQueryParameters(string, string, string, string, string, SASProtocol, Date, Date, SasIPRange, string, string, string, string, string, string, string, UserDelegationKey, string, string)

Crea un'istanza di SASQueryParameters.

new SASQueryParameters(version: string, signature: string, permissions?: string, services?: string, resourceTypes?: string, protocol?: SASProtocol, startsOn?: Date, expiresOn?: Date, ipRange?: SasIPRange, identifier?: string, resource?: string, cacheControl?: string, contentDisposition?: string, contentEncoding?: string, contentLanguage?: string, contentType?: string, userDelegationKey?: UserDelegationKey, preauthorizedAgentObjectId?: string, correlationId?: string)

Parametri

version: string

Rappresentazione della versione di archiviazione

signature: string

Rappresentazione della firma per il token di firma di accesso condiviso

permissions: string

Rappresentazione delle autorizzazioni di archiviazione

services: string

Rappresentazione dei servizi di archiviazione a cui si accede (solo per la firma di accesso condiviso dell'account)

resourceTypes: string

Rappresentazione dei tipi di risorse di archiviazione a cui si accede (solo per la firma di accesso condiviso dell'account)

protocol: SASProtocol

Rappresentazione dei protocolli HTTP consentiti

startsOn: Date

Rappresenta l'ora di inizio per questo token di firma di accesso condiviso

expiresOn: Date

Rappresenta l'ora di scadenza per questo token di firma di accesso condiviso

ipRange: SasIPRange

Rappresenta l'intervallo di indirizzi IP validi per questo token di firma di accesso condiviso

identifier: string

Rappresentazione dell'identificatore firmato (solo per la firma di accesso condiviso del servizio)

resource: string

Rappresentazione del contenitore di archiviazione o del BLOB (solo per la firma di accesso condiviso del servizio)

cacheControl: string

Rappresentazione dell'intestazione del controllo cache (solo per la firma di accesso condiviso del servizio BLOB/file)

contentDisposition: string

Rappresentazione dell'intestazione content-disposition (solo per la firma di accesso condiviso del servizio BLOB/file)

contentEncoding: string

Rappresentazione dell'intestazione content-encoding (solo per la firma di accesso condiviso del servizio BLOB/file)

contentLanguage: string

Rappresentazione dell'intestazione content-language (solo per la firma di accesso condiviso del servizio BLOB/file)

contentType: string

Rappresentazione dell'intestazione content-type (solo per la firma di accesso condiviso del servizio BLOB/file)

userDelegationKey: UserDelegationKey

Rappresentazione delle proprietà della chiave di delega utente

preauthorizedAgentObjectId: string

Rappresentazione dell'ID oggetto AAD autorizzato (solo per firma di accesso condiviso delega utente)

correlationId: string

Rappresentazione dell'ID di correlazione (solo per firma di accesso condiviso delega utente)

Dettagli proprietà

cacheControl

Valore per l'intestazione del controllo cache nella firma di accesso condiviso blob/servizio file.

cacheControl?: string

Valore della proprietà

string

contentDisposition

Valore per l'intestazione content-disposition nella firma di accesso condiviso blob/servizio file.

contentDisposition?: string

Valore della proprietà

string

contentEncoding

Valore per l'intestazione content-encoding nella firma di accesso condiviso blob/servizio file.

contentEncoding?: string

Valore della proprietà

string

contentLanguage

Valore per l'intestazione content-length nella firma di accesso condiviso blob/servizio file.

contentLanguage?: string

Valore della proprietà

string

contentType

Valore per l'intestazione content-type nella firma di accesso condiviso blob/servizio file.

contentType?: string

Valore della proprietà

string

correlationId

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 opzione viene usata solo per la firma di accesso condiviso della delega utente.

correlationId?: string

Valore della proprietà

string

expiresOn

Facoltativo solo quando viene fornito l'identificatore. Ora di scadenza per questo token di firma di accesso condiviso.

expiresOn?: Date

Valore della proprietà

Date

identifier

Facoltativa. Identificatore firmato (solo per <xref:BlobSASSignatureValues>).

identifier?: string

Valore della proprietà

string

ipRange

Facoltativa. Intervallo IP consentito per questa firma di accesso condiviso.

SasIPRange | undefined ipRange

Valore della proprietà

SasIPRange | undefined

permissions

Facoltativo solo quando viene fornito l'identificatore. Per altri dettagli, vedere <xref:AccountSASPermissions>, <xref:BlobSASPermissions>o <xref:ContainerSASPermissions> .

permissions?: string

Valore della proprietà

string

preauthorizedAgentObjectId

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. Questa opzione viene usata solo per la firma di accesso condiviso della delega utente.

preauthorizedAgentObjectId?: string

Valore della proprietà

string

protocol

Facoltativa. Protocolli HTTP consentiti.

protocol?: SASProtocol

Valore della proprietà

SASProtocol

resource

Facoltativa. Specifica le risorse accessibili tramite la firma di accesso condiviso (solo per <xref:BlobSASSignatureValues>).

resource?: string

Valore della proprietà

string

resourceTypes

Facoltativa. Tipi di risorse di archiviazione a cui si accede (solo per firma di accesso condiviso dell'account). Per altri dettagli, fare riferimento a <xref:AccountSASResourceTypes> .

resourceTypes?: string

Valore della proprietà

string

services

Facoltativa. I servizi di archiviazione a cui si accede (solo per la firma di accesso condiviso dell'account). Per altri dettagli, fare riferimento a <xref:AccountSASServices> .

services?: string

Valore della proprietà

string

signature

Firma per il token di firma di accesso condiviso.

signature: string

Valore della proprietà

string

startsOn

Facoltativa. Ora di inizio per questo token di firma di accesso condiviso.

startsOn?: Date

Valore della proprietà

Date

version

Versione dell'API di archiviazione.

version: string

Valore della proprietà

string

Dettagli metodo

toString()

Codifica tutti i parametri di query sas in una stringa che può essere aggiunta a un URL.

function toString()

Restituisce

string

Condividi tramite

SASQueryParameters class

Costruttori

Proprietà

Metodi

Dettagli costruttore

SASQueryParameters(string, string, SASQueryParametersOptions)

Parametri

SASQueryParameters(string, string, string, string, string, SASProtocol, Date, Date, SasIPRange, string, string, string, string, string, string, string, UserDelegationKey, string, string)

Parametri

Dettagli proprietà

cacheControl

Valore della proprietà

contentDisposition

Valore della proprietà

contentEncoding

Valore della proprietà

contentLanguage

Valore della proprietà

contentType

Valore della proprietà

correlationId

Valore della proprietà

expiresOn

Valore della proprietà

identifier

Valore della proprietà

ipRange

Valore della proprietà

permissions

Valore della proprietà

preauthorizedAgentObjectId

Valore della proprietà

protocol

Valore della proprietà

resource

Valore della proprietà

resourceTypes

Valore della proprietà

services

Valore della proprietà

signature

Valore della proprietà

startsOn

Valore della proprietà

version

Valore della proprietà

Dettagli metodo

toString()

Restituisce

Risorse aggiuntive