SASQueryParameters class
Stellt die Komponenten dar, aus denen die Abfrageparameter einer Azure Storage-SAS bestehen. Dieser Typ wird nicht direkt vom Benutzer erstellt. sie wird nur von den Typen AccountSASSignatureValues und BlobSASSignatureValues generiert. Nach der Generierung kann es in eine toString() codiert und direkt an eine URL angefügt werden (wobei hier Vorsicht geboten ist, wenn abfrageparameter vorhanden sind, was sich auf die geeignete Methode zum Anfügen dieser Abfrageparameter auswirken kann).
HINWEIS: Instanzen dieser Klasse sind unveränderlich.
Konstruktoren
SASQuery |
Erstellt eine Instanz von SASQueryParameters. |
SASQuery |
Erstellt eine Instanz von SASQueryParameters. |
Eigenschaften
cache |
Wert für cache-control-Header in Blob/File Service SAS. |
content |
Wert für content-disposition header in Blob/File Service SAS. |
content |
Wert für den Inhaltscodierungsheader in blob/File Service SAS. |
content |
Wert für den Inhaltslängenheader in blob/File Service SAS. |
content |
Wert für den Inhaltstypheader in blob/File Service SAS. |
correlation |
Ein GUID-Wert, der in den Speicherdiagnoseprotokollen protokolliert wird und verwendet werden kann, um die SAS-Generierung mit dem Speicherressourcenzugriff zu korrelieren. Dies wird nur für die SAS für die Benutzerdelegierung verwendet. |
encryption |
Optional. Verschlüsselungsbereich, der beim Senden von Anforderungen verwendet werden soll, die mit diesem SAS-URI autorisiert sind. |
expires |
Nur optional, wenn der Bezeichner angegeben wird. Die Ablaufzeit für dieses SAS-Token. |
identifier | Optional. Der signierte Bezeichner (nur für BlobSASSignatureValues). Siehe https://docs.microsoft.com/en-us/rest/api/storageservices/establishing-a-stored-access-policy. |
ip |
Optional. Für diese SAS zulässiger IP-Bereich. |
permissions | Nur optional, wenn der Bezeichner angegeben wird. Weitere Informationen finden Sie unter AccountSASPermissions, BlobSASPermissions oder ContainerSASPermissions . |
preauthorized |
Autorisierte AAD-Objekt-ID im GUID-Format. Die AAD-Objekt-ID eines Benutzers, der vom Besitzer des Benutzerdelegierungsschlüssels autorisiert wurde, um die von der SAS gewährte Aktion auszuführen. Der Azure Storage-Dienst stellt sicher, dass der Besitzer des Benutzerdelegierungsschlüssels über die erforderlichen Berechtigungen verfügt, bevor der Zugriff gewährt wird, aber es wird keine zusätzliche Berechtigungsprüfung für den in diesem Wert angegebenen Benutzer durchgeführt. Dies wird nur für die SAS für die Benutzerdelegierung verwendet. |
protocol | Optional. Die zulässigen HTTP-Protokolle. |
resource | Optional. Gibt an, auf welche Ressourcen über die SAS zugegriffen werden kann (nur für BlobSASSignatureValues). |
resource |
Optional. Die Speicherressourcentypen, auf die zugegriffen wird (nur für Konto-SAS). Weitere Informationen finden Sie unter AccountSASResourceTypes . |
services | Optional. Auf die Speicherdienste, auf die zugegriffen wird (nur für Konto-SAS). Weitere Informationen finden Sie unter AccountSASServices . |
signature | Die Signatur für das SAS-Token. |
starts |
Optional. Die Startzeit für dieses SAS-Token. |
version | Die Speicher-API-Version. |
Methoden
to |
Codiert alle SAS-Abfrageparameter in eine Zeichenfolge, die an eine URL angefügt werden kann. |
Details zum Konstruktor
SASQueryParameters(string, string, SASQueryParametersOptions)
Erstellt eine Instanz von SASQueryParameters.
new SASQueryParameters(version: string, signature: string, options?: SASQueryParametersOptions)
Parameter
- version
-
string
Darstellen der Speicherversion
- signature
-
string
Darstellen der Signatur für das SAS-Token
- options
- SASQueryParametersOptions
Optional. Optionen zum Erstellen der SASQueryParameters.
SASQueryParameters(string, string, string, string, string, SASProtocol, Date, Date, SasIPRange, string, string, string, string, string, string, string, UserDelegationKey, string, string, string)
Erstellt eine Instanz von 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)
Parameter
- version
-
string
Darstellen der Speicherversion
- signature
-
string
Darstellen der Signatur für das SAS-Token
- permissions
-
string
Darstellen der Speicherberechtigungen
- services
-
string
Darstellung der Speicherdienste, auf die zugegriffen wird (nur für Konto-SAS)
- resourceTypes
-
string
Darstellung der Speicherressourcentypen, auf die zugegriffen wird (nur für Konto-SAS)
- protocol
- SASProtocol
Darstellen der zulässigen HTTP-Protokolle
- startsOn
-
Date
Stellt die Startzeit für dieses SAS-Token dar.
- expiresOn
-
Date
Darstellen der Ablaufzeit für dieses SAS-Token
- ipRange
- SasIPRange
Darstellen des Bereichs der gültigen IP-Adressen für dieses SAS-Token
- identifier
-
string
Darstellen des signierten Bezeichners (nur für Dienst-SAS)
- resource
-
string
Darstellen des Speichercontainers oder Blobs (nur für Dienst-SAS)
- cacheControl
-
string
Darstellen des Cache-Control-Headers (nur für Blob-/Dateidienst-SAS)
- contentDisposition
-
string
Darstellen des Inhaltsdispositionsheaders (nur für Blob-/Dateidienst-SAS)
- contentEncoding
-
string
Darstellen des Inhaltscodierungsheaders (nur für Blob-/Dateidienst-SAS)
- contentLanguage
-
string
Darstellen des Inhaltssprachheaders (nur für Blob-/Dateidienst-SAS)
- contentType
-
string
Darstellen des Inhaltstypheaders (nur für Blob-/Dateidienst-SAS)
- userDelegationKey
- UserDelegationKey
Darstellen der Eigenschaften des Benutzerdelegierungsschlüssels
- preauthorizedAgentObjectId
-
string
Darstellen der autorisierten AAD-Objekt-ID (nur für benutzerdelegierungs-SAS)
- correlationId
-
string
Darstellen der Korrelations-ID (nur für benutzerdelegierungs-SAS)
- encryptionScope
-
string
Details zur Eigenschaft
cacheControl
Wert für cache-control-Header in Blob/File Service SAS.
cacheControl?: string
Eigenschaftswert
string
contentDisposition
Wert für content-disposition header in Blob/File Service SAS.
contentDisposition?: string
Eigenschaftswert
string
contentEncoding
Wert für den Inhaltscodierungsheader in blob/File Service SAS.
contentEncoding?: string
Eigenschaftswert
string
contentLanguage
Wert für den Inhaltslängenheader in blob/File Service SAS.
contentLanguage?: string
Eigenschaftswert
string
contentType
Wert für den Inhaltstypheader in blob/File Service SAS.
contentType?: string
Eigenschaftswert
string
correlationId
Ein GUID-Wert, der in den Speicherdiagnoseprotokollen protokolliert wird und verwendet werden kann, um die SAS-Generierung mit dem Speicherressourcenzugriff zu korrelieren. Dies wird nur für die SAS für die Benutzerdelegierung verwendet.
correlationId?: string
Eigenschaftswert
string
encryptionScope
Optional. Verschlüsselungsbereich, der beim Senden von Anforderungen verwendet werden soll, die mit diesem SAS-URI autorisiert sind.
encryptionScope?: string
Eigenschaftswert
string
expiresOn
Nur optional, wenn der Bezeichner angegeben wird. Die Ablaufzeit für dieses SAS-Token.
expiresOn?: Date
Eigenschaftswert
Date
identifier
Optional. Der signierte Bezeichner (nur für BlobSASSignatureValues).
Siehe https://docs.microsoft.com/en-us/rest/api/storageservices/establishing-a-stored-access-policy.
identifier?: string
Eigenschaftswert
string
ipRange
Optional. Für diese SAS zulässiger IP-Bereich.
undefined | SasIPRange ipRange
Eigenschaftswert
undefined | SasIPRange
permissions
Nur optional, wenn der Bezeichner angegeben wird. Weitere Informationen finden Sie unter AccountSASPermissions, BlobSASPermissions oder ContainerSASPermissions .
permissions?: string
Eigenschaftswert
string
preauthorizedAgentObjectId
Autorisierte AAD-Objekt-ID im GUID-Format. Die AAD-Objekt-ID eines Benutzers, der vom Besitzer des Benutzerdelegierungsschlüssels autorisiert wurde, um die von der SAS gewährte Aktion auszuführen. Der Azure Storage-Dienst stellt sicher, dass der Besitzer des Benutzerdelegierungsschlüssels über die erforderlichen Berechtigungen verfügt, bevor der Zugriff gewährt wird, aber es wird keine zusätzliche Berechtigungsprüfung für den in diesem Wert angegebenen Benutzer durchgeführt. Dies wird nur für die SAS für die Benutzerdelegierung verwendet.
preauthorizedAgentObjectId?: string
Eigenschaftswert
string
protocol
resource
Optional. Gibt an, auf welche Ressourcen über die SAS zugegriffen werden kann (nur für BlobSASSignatureValues).
resource?: string
Eigenschaftswert
string
resourceTypes
Optional. Die Speicherressourcentypen, auf die zugegriffen wird (nur für Konto-SAS). Weitere Informationen finden Sie unter AccountSASResourceTypes .
resourceTypes?: string
Eigenschaftswert
string
services
Optional. Auf die Speicherdienste, auf die zugegriffen wird (nur für Konto-SAS). Weitere Informationen finden Sie unter AccountSASServices .
services?: string
Eigenschaftswert
string
signature
Die Signatur für das SAS-Token.
signature: string
Eigenschaftswert
string
startsOn
Optional. Die Startzeit für dieses SAS-Token.
startsOn?: Date
Eigenschaftswert
Date
version
Die Speicher-API-Version.
version: string
Eigenschaftswert
string
Details zur Methode
toString()
Codiert alle SAS-Abfrageparameter in eine Zeichenfolge, die an eine URL angefügt werden kann.
function toString(): string
Gibt zurück
string