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 e <xref:BlobSASSignatureValues>accountSASSignatureValues. Dopo aver generato, può essere codificato in un URL e accodato direttamente a un toString() URL (anche se è consigliabile prendere attenzione in questo caso, in caso di parametri di query esistenti, che potrebbero influire sui mezzi appropriati di accodamento di 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, number, string, string, string, string)

Crea un'istanza di SASQueryParameters.

Proprietà

agentObjectId

ID oggetto AAD non autorizzato in formato GUID. ID oggetto AAD di un utente che si presuppone 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. Impossibile usare questa operazione in combinazione con <xref:signedAuthorizedUserObjectId>. Questa operazione viene usata solo per la firma di accesso condiviso delega utente.

cacheControl

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

contentDisposition

Valore per l'intestazione di eliminazione contenuto nella firma di accesso condiviso BLOB/File Service.

contentEncoding

Valore per l'intestazione di codifica del contenuto nella firma di accesso condiviso BLOB/File Service.

contentLanguage

Valore per l'intestazione della lunghezza del contenuto nella firma di accesso condiviso BLOB/File Service.

contentType

Valore per l'intestazione del tipo di contenuto nella firma di accesso condiviso BLOB/servizio file.

correlationId

Valore GUID che verrà registrato nei log di diagnostica di archiviazione e 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 delega utente.

directoryDepth

Indicare la profondità della directory specificata nel campo canonicoizedresource del segno da stringa a segno. La profondità della directory è il numero di directory sotto la cartella radice.

encryptionScope

facoltativo. Ambito di crittografia da usare durante l'invio di 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

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

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

ipRange

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

permissions

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

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à eseguita alcuna verifica aggiuntiva per l'utente specificato in questo valore. Impossibile usare questa operazione in combinazione con <xref:signedUnauthorizedUserObjectId>. Questa operazione viene usata solo per la firma di accesso condiviso delega utente.

protocol

facoltativo. Protocolli HTTP consentiti.

resource

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

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

resourceTypes

facoltativo. I tipi di risorse di archiviazione a cui si accede (solo per La firma di accesso condiviso account). Per altre informazioni, vedere AccountSASResourceTypes .

services

facoltativo. I servizi di archiviazione a cui si accede (solo per la firma di accesso condiviso account). Per altre informazioni, vedere AccountSASServices .

signature

Firma per il token di firma di accesso condiviso.

startsOn

facoltativo. 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

facoltativo. Opzioni per costruire sasQueryParameters.

SASQueryParameters(string, string, string, string, string, SASProtocol, Date, Date, SasIPRange, string, string, string, string, string, string, string, UserDelegationKey, number, string, 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, directoryDepth?: number, preauthorizedAgentObjectId?: string, agentObjectId?: 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 firma di accesso condiviso account)

resourceTypes

string

Rappresentazione dei tipi di risorse di archiviazione a cui si accede (solo per firma di accesso condiviso 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

Rappresentazione dell'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 BLOB/File Service)

contentDisposition

string

Rappresentazione dell'intestazione di eliminazione del contenuto (solo per la firma di accesso condiviso blob/file)

contentEncoding

string

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

contentLanguage

string

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

contentType

string

Rappresentazione dell'intestazione del tipo di contenuto (solo per la firma di accesso condiviso blob/servizio file)

userDelegationKey
UserDelegationKey

Rappresentazione delle proprietà della chiave di delega utente

directoryDepth

number

preauthorizedAgentObjectId

string

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

agentObjectId

string

Rappresentazione dell'ID oggetto AAD non 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à

agentObjectId

ID oggetto AAD non autorizzato in formato GUID. ID oggetto AAD di un utente che si presuppone 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. Impossibile usare questa operazione in combinazione con <xref:signedAuthorizedUserObjectId>. Questa operazione viene usata solo per la firma di accesso condiviso delega utente.

agentObjectId?: string

Valore della proprietà

string

cacheControl

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

cacheControl?: string

Valore della proprietà

string

contentDisposition

Valore per l'intestazione di eliminazione contenuto nella firma di accesso condiviso BLOB/File Service.

contentDisposition?: string

Valore della proprietà

string

contentEncoding

Valore per l'intestazione di codifica del contenuto nella firma di accesso condiviso BLOB/File Service.

contentEncoding?: string

Valore della proprietà

string

contentLanguage

Valore per l'intestazione della lunghezza del contenuto nella firma di accesso condiviso BLOB/File Service.

contentLanguage?: string

Valore della proprietà

string

contentType

Valore per l'intestazione del tipo di contenuto 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 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 delega utente.

correlationId?: string

Valore della proprietà

string

directoryDepth

Indicare la profondità della directory specificata nel campo canonicoizedresource 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

facoltativo. Ambito di crittografia da usare durante l'invio di 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

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

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

identifier?: string

Valore della proprietà

string

ipRange

facoltativo. 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 altri dettagli, vedere AccountSASPermissions, <xref:BlobSASPermissions>o <xref:ContainerSASPermissions> per altri dettagli.

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à eseguita alcuna verifica aggiuntiva per l'utente specificato in questo valore. Impossibile usare questa operazione in combinazione con <xref:signedUnauthorizedUserObjectId>. Questa operazione viene usata solo per la firma di accesso condiviso delega utente.

preauthorizedAgentObjectId?: string

Valore della proprietà

string

protocol

facoltativo. Protocolli HTTP consentiti.

protocol?: SASProtocol

Valore della proprietà

resource

facoltativo. Specifica le risorse accessibili tramite la firma di accesso condiviso (solo per <xref: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

facoltativo. I tipi di risorse di archiviazione a cui si accede (solo per La firma di accesso condiviso account). Per altre informazioni, vedere AccountSASResourceTypes .

resourceTypes?: string

Valore della proprietà

string

services

facoltativo. I servizi di archiviazione a cui si accede (solo per la firma di accesso condiviso account). Per altre informazioni, 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

facoltativo. 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