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() e accodato 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
SASQuery |
Crea un'istanza di SASQueryParameters. |
SASQuery |
Crea un'istanza di SASQueryParameters. |
Proprietà
cache |
Valore per l'intestazione cache-control nella firma di accesso condiviso blob/servizio file. |
content |
Valore per l'intestazione content-disposition nella firma di accesso condiviso blob/servizio file. |
content |
Valore per l'intestazione content-encoding nella firma di accesso condiviso blob/servizio file. |
content |
Valore per l'intestazione content-length nella firma di accesso condiviso blob/servizio file. |
content |
Valore per l'intestazione content-type nella firma di accesso condiviso blob/servizio file. |
correlation |
Valore GUID che verrà registrato nei log di diagnostica dell'archiviazione e che può essere usato per correlare la generazione di 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. |
encryption |
Opzionale. Ambito di crittografia da usare quando si inviano richieste autorizzate con questo URI di firma di accesso condiviso. |
expires |
Facoltativo solo quando viene specificato l'identificatore. Ora di scadenza per questo token di firma di accesso condiviso. |
identifier | Opzionale. Identificatore firmato (solo per BlobSASSignatureValues). Vedere https://docs.microsoft.com/en-us/rest/api/storageservices/establishing-a-stored-access-policy |
ip |
Opzionale. Intervallo IP consentito per questa firma di accesso condiviso. |
permissions | Facoltativo solo quando viene specificato l'identificatore. Per altre informazioni, vedere AccountSASPermissions, BlobSASPermissionso ContainerSASPermissions. |
preauthorized |
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 operazione viene usata solo per la firma di accesso condiviso della delega utente. |
protocol | Opzionale. Protocolli HTTP consentiti. |
resource | Opzionale. Specifica le risorse accessibili tramite la firma di accesso condiviso (solo per BlobSASSignatureValues). |
resource |
Opzionale. Tipi di risorse di archiviazione a cui si accede (solo per firma di accesso condiviso dell'account). Per altre informazioni, vedere AccountSASResourceTypes. |
services | Opzionale. I servizi di archiviazione a cui si accede (solo per la firma di accesso condiviso dell'account). Per altre informazioni, vedere AccountSASServices. |
signature | Firma per il token di firma di accesso condiviso. |
starts |
Opzionale. Ora di inizio per questo token di firma di accesso condiviso. |
version | Versione dell'API di archiviazione. |
Metodi
to |
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
Opzionale. 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 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
Rappresentazione dell'ora di inizio per questo token di firma di accesso condiviso
- expiresOn
-
Date
Rappresentazione dell'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 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 la firma di accesso condiviso della delega utente)
- encryptionScope
-
string
Dettagli proprietà
cacheControl
Valore per l'intestazione cache-control 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 dell'archiviazione e che può essere usato per correlare la generazione di 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
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. Ora di scadenza per questo token di firma di accesso condiviso.
expiresOn?: Date
Valore della proprietà
Date
identifier
Opzionale. 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
Opzionale. Intervallo IP consentito per questa firma di accesso condiviso.
undefined | SasIPRange ipRange
Valore della proprietà
undefined | SasIPRange
permissions
Facoltativo solo quando viene specificato l'identificatore. Per altre informazioni, vedere AccountSASPermissions, BlobSASPermissionso 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 operazione viene usata solo per la firma di accesso condiviso della delega utente.
preauthorizedAgentObjectId?: string
Valore della proprietà
string
protocol
resource
Opzionale. Specifica le risorse accessibili tramite la firma di accesso condiviso (solo per BlobSASSignatureValues).
resource?: string
Valore della proprietà
string
resourceTypes
Opzionale. Tipi di risorse di archiviazione a cui si accede (solo per firma di accesso condiviso dell'account). Per altre informazioni, vedere AccountSASResourceTypes.
resourceTypes?: string
Valore della proprietà
string
services
Opzionale. I servizi di archiviazione a cui si accede (solo per la firma di accesso condiviso dell'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
Opzionale. 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