SasQueryParameters Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ein SasQueryParameters -Objekt stellt die Komponenten dar, aus denen die Abfrageparameter einer Azure Storage-Shared Access-Signatur bestehen. Sie enthält Komponenten, die von allen Azure Storage-Ressourcen (Blobcontainer, Blobs, Dateien und Warteschlangen) verwendet werden. Sie können eine neue instance mit den dienstspezifischen SAS-Generatortypen erstellen. Weitere Informationen finden Sie unter: Erstellen Sie eine Dienst-SAS.
public class SasQueryParameters
type SasQueryParameters = class
Public Class SasQueryParameters
- Vererbung
-
SasQueryParameters
- Abgeleitet
Konstruktoren
SasQueryParameters() |
Initialisiert eine neue Instanz der SasQueryParameters-Klasse. |
SasQueryParameters(IDictionary<String,String>) |
Erstellt eine neue instance des SasQueryParameters Typs basierend auf den angegebenen Abfrageparametern |
SasQueryParameters(String, Nullable<AccountSasServices>, Nullable<AccountSasResourceTypes>, SasProtocol, DateTimeOffset, DateTimeOffset, SasIPRange, String, String, String, String, String, String, String, String, String, String, String, String, Nullable<Int32>, String) |
Erstellt eine neue SasQueryParameters-instance. |
Felder
DefaultSasVersion |
Die Standarddienstversion, die für Shared Access Signatures verwendet werden soll. |
Eigenschaften
AgentObjectId |
Ruft die nicht autorisierte AAD-Objekt-ID ab, die der Shared Access Signature zugeordnet ist. Die AAD-Objekt-ID eines Benutzers, der vom Besitzer des Benutzerdelegierungsschlüssels als nicht autorisiert angenommen wird. Der Azure Storage-Dienst führt eine zusätzliche POSIX-ACL-Überprüfung durch, um zu ermitteln, ob der Benutzer zum Ausführen des angeforderten Vorgangs autorisiert ist. Dies kann nicht in der Conjuction mit PreauthorizedAgentObjectIdverwendet werden. Nur gültig in einem HNS-aktivierten Konto. Wenn dieser Wert in einem Nicht-HNS-aktivierten Konto festgelegt wird, wird ein Autorisierungsfehler ausgelöst. |
CacheControl |
Ruft den Cache-Control-Antwortheader ab, der es ermöglicht, die clientseitige Zwischenspeicherung anzugeben, die für Blob- und Dateidownloads verwendet werden soll. |
ContentDisposition |
Ruft den Content-Disposition-Antwortheader ab, mit dem angegeben werden kann, wie der Blob- oder Dateiinhalt im Browser angezeigt werden kann. |
ContentEncoding |
Ruft den Content-Encoding-Antwortheader ab, mit dem der Typ der Codierung angegeben werden kann, die für Blob- und Dateidownloads verwendet wird. |
ContentLanguage |
Ruft den Content-Language-Antwortheader ab, mit dem die Sprache des heruntergeladenen Blob- oder Dateiinhalts angegeben werden kann. |
ContentType |
Ruft den Content-Type-Antwortheader ab, mit dem der Typ des heruntergeladenen Blob- oder Dateiinhalts angegeben werden kann. |
CorrelationId |
Ruft die Korrelations-ID ab, die der Shared Access Signature zugeordnet ist. Dies wird verwendet, um die Speicherüberwachungsprotokolle mit den Überwachungsprotokollen zu korrelieren, die vom Prinzipal verwendet werden, der SAS generiert und verteilt. |
DirectoryDepth |
Ruft die Verzeichnistiefe ab, die im Feld canonicalizedResource des Zeichenfolgen-zu-Sign-Felds angegeben ist. Die Tiefe des Verzeichnisses ist die Anzahl der Verzeichnisse unter dem Stammordner. Erforderlich, wenn Ressource (sr) = d, um die Tiefe des Verzeichnisses anzugeben. Der Wert muss eine nicht negative ganze Zahl sein. |
Empty |
Ruft leere Abfrageparameter für Shared Access-Signaturen ab. |
EncryptionScope |
Ruft den Verschlüsselungsbereich ab, der der Shared Access Signature zugeordnet ist. |
ExpiresOn |
Ruft den Zeitpunkt ab, zu dem die Freigegebene Zugriffssignatur ungültig wird. MinValue bedeutet nicht festgelegt. |
Identifier |
Ruft den optionalen eindeutigen Wert mit einer Länge von bis zu 64 Zeichen ab, der mit einer Zugriffsrichtlinie korreliert, die für den Blobcontainer, die Warteschlange oder die Freigabe angegeben ist. |
IPRange |
Ruft die optionale IP-Adresse oder einen Bereich von IP-Adressen ab, von denen Anforderungen akzeptiert werden sollen. Beachten Sie beim Angeben eines Bereichs, dass der Bereich inklusiv ist. |
Permissions |
Ruft die Berechtigungen ab, die der Freigegebenen Zugriffssignatur zugeordnet sind. Der Benutzer ist auf Vorgänge beschränkt, für die er eine Berechtigung besitzt. Dieses Feld muss ausgelassen werden, wenn es in einer zugehörigen gespeicherten Zugriffsrichtlinie angegeben wurde. |
PreauthorizedAgentObjectId |
Ruft die autorisierte AAD-Objekt-ID ab, die der Freigegebenen Zugriffssignatur zugeordnet ist. Die AAD-Objekt-ID eines Benutzers, der vom Besitzer des Benutzerdelegierungsschlüssels autorisiert ist, 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 kann nicht in der Conjuction mit AgentObjectIdverwendet werden. Nur gültig in einem HNS-aktivierten Konto. Wenn dieser Wert in einem Nicht-HNS-aktivierten Konto festgelegt wird, wird ein Autorisierungsfehler ausgelöst. |
Protocol |
Optional. Gibt das Protokoll an, das für eine Anforderung zulässig ist, die mit der Shared Access Signature ausgeführt wird. |
Resource |
Ruft die Ressourcen ab, auf die über die Freigegebene Zugriffssignatur zugegriffen werden kann. |
ResourceTypes |
Ruft ab, auf welche Ressourcen über die Freigegebene Zugriffssignatur zugegriffen werden kann. |
Services |
Ruft die signierten Dienste ab, auf die mit einer Shared Access Signature auf Kontoebene zugegriffen werden kann. |
Signature |
Ruft die Zeichenfolge ab, eine eindeutige Zeichenfolge, die aus den Feldern erstellt wird, die überprüft werden müssen, um die Anforderung zu authentifizieren. Die Signatur ist ein HMAC, der mithilfe des SHA256-Algorithmus für eine StringToSign-Zeichenfolge und einen Schlüssel berechnet wird. Das Ergebnis wird anschließend mit der Base64-Codierung verschlüsselt. |
StartsOn |
Ruft den optionalen Zeitpunkt ab, zu dem die Freigegebene Zugriffssignatur gültig wird. Wenn Sie diesen Wert weglassen, wird als Startzeit dieses Aufrufs die Uhrzeit verwendet, zu der die Anforderung vom Speicherdienst empfangen wird. MinValue bedeutet nicht festgelegt. |
Version |
Ruft die Speicherdienstversion ab, die zum Authentifizieren von Anforderungen mit dieser Shared Access Signature verwendet werden soll, und die Dienstversion, die beim Verarbeiten von Anforderungen mit dieser Shared Access Signature verwendet werden soll. |
Methoden
AppendProperties(StringBuilder) |
Erstellt die Abfrageparameterzeichenfolge für die SasQueryParameters-instance. |
Create(IDictionary<String,String>) |
Erstellt eine neue instance des SasQueryParameters Typs basierend auf den angegebenen Abfrageparametern |
Create(String, Nullable<AccountSasServices>, Nullable<AccountSasResourceTypes>, SasProtocol, DateTimeOffset, DateTimeOffset, SasIPRange, String, String, String, String, String, String, String, String, String, String, String, String, Nullable<Int32>, String) |
Erstellt eine neue SasQueryParameters-instance. |
ToString() |
Konvertieren Sie die SAS-Abfrageparameter in eine URL-codierte Abfragezeichenfolge. |
Gilt für:
Azure SDK for .NET