SasQueryParameters Klasse

Definition

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 values. Alle SAS-bezogenen Abfrageparameter werden aus valuesentfernt.

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 values. Alle SAS-bezogenen Abfrageparameter werden aus valuesentfernt.

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: