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
SASQuery |
Crea un'istanza di SASQueryParameters. |
SASQuery |
Crea un'istanza di SASQueryParameters. |
Proprietà
agent |
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. |
cache |
Valore per l'intestazione del controllo cache nella firma di accesso condiviso BLOB/file. |
content |
Valore per l'intestazione di eliminazione contenuto nella firma di accesso condiviso BLOB/File Service. |
content |
Valore per l'intestazione di codifica del contenuto nella firma di accesso condiviso BLOB/File Service. |
content |
Valore per l'intestazione della lunghezza del contenuto nella firma di accesso condiviso BLOB/File Service. |
content |
Valore per l'intestazione del tipo di contenuto nella firma di accesso condiviso BLOB/servizio file. |
correlation |
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. |
directory |
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. |
encryption |
facoltativo. Ambito di crittografia da usare durante l'invio di richieste autorizzate con questo URI di firma di accesso condiviso. |
expires |
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 |
ip |
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. |
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à 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>). |
resource |
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. |
starts |
facoltativo. 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
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
resource
facoltativo. Specifica le risorse accessibili tramite la firma di accesso condiviso (solo per <xref:BlobSASSignatureValues>).
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