Freigeben über


ShareSasBuilder Klasse

Definition

ShareSasBuilder wird verwendet, um eine Shared Access Signature (SAS) für eine Azure Storage-Freigabe, ein Verzeichnis oder eine Datei zu generieren.

   For more information, see
Erstellen einer Dienst-SAS.
public class ShareSasBuilder
type ShareSasBuilder = class
Public Class ShareSasBuilder
Vererbung
ShareSasBuilder

Konstruktoren

ShareSasBuilder(ShareFileSasPermissions, DateTimeOffset)

Initialisiert eine neue instance der ShareSasBuilder -Klasse, um eine Azure File Sas zu erstellen.

ShareSasBuilder(ShareSasPermissions, DateTimeOffset)

Initialisiert einen neuen instance der ShareSasBuilder -Klasse, um eine Dateifreigabe-Sas zu erstellen.

Eigenschaften

CacheControl

Überschreiben Sie den für Cache-Control Antwortheader zurückgegebenen Wert.

ContentDisposition

Überschreiben Sie den für den Content-Disposition-Antwortheader zurückgegebenen Wert.

ContentEncoding

Überschreiben Sie den für Cache-Encoding Antwortheader zurückgegebenen Wert.

ContentLanguage

Überschreiben Sie den für Cache-Language Antwortheader zurückgegebenen Wert.

ContentType

Überschreiben Sie den für Cache-Type Antwortheader zurückgegebenen Wert.

ExpiresOn

Der Zeitpunkt, zu dem die Shared Access Signature ungültig wird. Dieses Feld muss ausgelassen werden, wenn es in einer zugehörigen gespeicherten Zugriffsrichtlinie angegeben wurde.

FilePath

Der Pfad der Datei oder des Verzeichnisses, auf die zugegriffen werden soll, oder Empty für eine Freigabe-SAS.

Identifier

Ein optionaler eindeutiger Wert mit einer Länge von bis zu 64 Zeichen, der mit einer für die Freigabe angegebenen Zugriffsrichtlinie korreliert.

IPRange

Gibt eine IP-Adresse oder einen IP-Adressbereich an, von dem Anforderungen akzeptiert werden sollen. Wenn die IP-Adresse, von der die Anforderung stammt, nicht mit der IM SAS-Token angegebenen IP-Adresse oder dem Adressbereich übereinstimmt, wird die Anforderung nicht authentifiziert. Beachten Sie beim Angeben eines IP-Adressbereichs, dass der Bereich inklusive ist.

Permissions

Die Berechtigungen, die der SAS 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. ShareFileSasPermissions, ShareSasPermissionsoder ShareAccountSasPermissions kann verwendet werden, um die Berechtigungszeichenfolge zu erstellen.

Protocol

Das optionale Feld mit signiertem Protokoll gibt das Protokoll an, das für eine Anforderung zulässig ist, die mit der SAS durchgeführt wird. Mögliche Werte sind HttpsAndHttp, Https und None.

Resource

Gibt an, auf welche Ressourcen über die Shared Access Signature zugegriffen werden kann.

Geben Sie "f" an, wenn die freigegebene Ressource eine Datei ist. Dadurch wird Zugriff auf den Inhalt und die Metadaten der Datei gewährt.

Geben Sie "s" an, wenn die freigegebene Ressource eine Freigabe ist. Dadurch wird Zugriff auf den Inhalt und die Metadaten einer beliebigen Datei in der Freigabe sowie auf die Liste der Verzeichnisse und Dateien in der Freigabe gewährt.

ShareName

Der Name der Freigabe, auf die zugegriffen werden soll.

StartsOn

Geben Sie optional den Zeitpunkt an, zu dem die Shared Access Signature gültig wird. Wenn bei verwendung von DateTimeOffset.MinValue nicht angegeben wird, wird davon ausgegangen, dass die Startzeit für diesen Aufruf der Zeitpunkt ist, zu dem der Speicherdienst die Anforderung empfängt.

Methoden

SetPermissions(ShareAccountSasPermissions)

Legt die Berechtigungen für eine SAS auf Dateikontoebene fest.

SetPermissions(ShareFileSasPermissions)

Legt die Berechtigungen für eine Datei-SAS fest.

SetPermissions(ShareSasPermissions)

Legt die Berechtigungen für eine Freigabe-SAS fest.

SetPermissions(String)

Legt die Berechtigungen für die SAS mithilfe einer unformatierten Berechtigungszeichenfolge fest.

SetPermissions(String, Boolean)

Legt die Berechtigungen für die SAS mithilfe einer unformatierten Berechtigungszeichenfolge fest.

ToSasQueryParameters(StorageSharedKeyCredential)

Verwenden Sie ein Konto, StorageSharedKeyCredential um diese Shared Access Signature-Werte zu signieren, um die richtigen SAS-Abfrageparameter für die Authentifizierung von Anforderungen zu erstellen.

Gilt für: