Condividi tramite


SASQueryParameters class

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 tipi AccountSASSignatureValues e BlobSASSignatureValues . Una volta generato, può essere codificato in un toString() 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, 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.

encryptionScope

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

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 BlobSASSignatureValues).

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

ipRange

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

permissions

Facoltativo solo quando viene fornito l'identificatore. Per altre informazioni, vedere AccountSASPermissions, BlobSASPermissions o 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 BlobSASSignatureValues).

Vedere https://docs.microsoft.com/rest/api/storageservices/create-service-sas#specifying-the-signed-resource-blob-service-only

resourceTypes

Facoltativa. Tipi di risorse di archiviazione a cui si accede (solo per firma di accesso condiviso dell'account). Per altri dettagli, vedere AccountSASResourceTypes .

services

Facoltativa. I servizi di archiviazione a cui si accede (solo per la firma di accesso condiviso dell'account). Per altri dettagli, vedere 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, 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, encryptionScope?: 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)

encryptionScope

string

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

encryptionScope

Facoltativa. 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 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 BlobSASSignatureValues).

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

identifier?: string

Valore della proprietà

string

ipRange

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

undefined | SasIPRange ipRange

Valore della proprietà

undefined | SasIPRange

permissions

Facoltativo solo quando viene fornito l'identificatore. Per altre informazioni, vedere AccountSASPermissions, BlobSASPermissions o 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à

resource

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

Vedere https://docs.microsoft.com/rest/api/storageservices/create-service-sas#specifying-the-signed-resource-blob-service-only

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, vedere 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, vedere 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(): string

Restituisce

string