ShareServiceClient Klasse

Definition

Mit ShareServiceClient können Sie Azure Storage-Dienstressourcen und -Freigaben bearbeiten. Das Speicherkonto stellt den Namespace der obersten Ebene für den Dateidienst bereit.

public class ShareServiceClient
type ShareServiceClient = class
Public Class ShareServiceClient
Vererbung
ShareServiceClient

Konstruktoren

ShareServiceClient()

Initialisiert eine neue instance der -Klasse für die ShareServiceClient Simulation.

ShareServiceClient(String)

Initialisiert eine neue Instanz der ShareServiceClient-Klasse.

ShareServiceClient(String, ShareClientOptions)

Initialisiert eine neue Instanz der ShareServiceClient-Klasse.

ShareServiceClient(Uri, AzureSasCredential, ShareClientOptions)

Initialisiert eine neue Instanz der ShareServiceClient-Klasse.

ShareServiceClient(Uri, ShareClientOptions)

Initialisiert eine neue Instanz der ShareServiceClient-Klasse.

ShareServiceClient(Uri, StorageSharedKeyCredential, ShareClientOptions)

Initialisiert eine neue Instanz der ShareServiceClient-Klasse.

ShareServiceClient(Uri, TokenCredential, ShareClientOptions)

Initialisiert eine neue Instanz der ShareServiceClient-Klasse.

Beachten Sie, dass Vorgänge auf Dienstebene die Tokenanmeldeinformationsauthentifizierung nicht unterstützen. Dieser Konstruktor ist vorhanden, um die Erstellung eines ShareServiceClient zu ermöglichen, das zum Ableiten eines ShareClient mit Tokenanmeldeinformationsauthentifizierung verwendet werden kann.

Beachten Sie auch, dass ShareTokenIntent derzeit für die Tokenauthentifizierung erforderlich ist.

Eigenschaften

AccountName

Ruft den Speicherkontonamen ab, der dem Dateidienstclient entspricht.

CanGenerateAccountSasUri

Bestimmt, ob der Client eine SAS generieren kann. Wenn der Client mit einem StorageSharedKeyCredentialauthentifiziert wird.

Uri

Ruft den primären Uri Endpunkt des Dateidiensts ab.

Methoden

CreateShare(String, ShareCreateOptions, CancellationToken)

Der CreateShare(String, ShareCreateOptions, CancellationToken)-Vorgang erstellt eine neue Freigabe unter dem angegebenen Konto. Wenn bereits eine Freigabe mit demselben Namen vorhanden ist, schlägt der Vorgang fehl.

Weitere Informationen finden Sie unter Erstellen Sie Freigabe.

CreateShareAsync(String, ShareCreateOptions, CancellationToken)

Der CreateShare(String, ShareCreateOptions, CancellationToken)-Vorgang erstellt eine neue Freigabe unter dem angegebenen Konto. Wenn bereits eine Freigabe mit demselben Namen vorhanden ist, schlägt der Vorgang fehl.

Weitere Informationen finden Sie unter Erstellen Sie Freigabe.

DeleteShare(String, ShareDeleteOptions, CancellationToken)

Markiert die angegebene Freigabe oder freigabe Momentaufnahme zum Löschen. Die Freigabe oder freigabe Momentaufnahme und alle darin enthaltenen Dateien werden später während der Garbage Collection gelöscht, was einige Minuten dauern kann.

Derzeit löscht diese Methode immer Momentaufnahmen. Es gibt keine Möglichkeit, einen separaten Wert für x-ms-delete-snapshots anzugeben.

Weitere Informationen finden Sie unter Freigabe löschen.

DeleteShareAsync(String, ShareDeleteOptions, CancellationToken)

Markiert die angegebene Freigabe oder freigabe Momentaufnahme zum Löschen. Die Freigabe oder freigabe Momentaufnahme und alle darin enthaltenen Dateien werden später während der Garbage Collection gelöscht, was einige Minuten dauern kann.

Derzeit löscht diese Methode immer Momentaufnahmen. Es gibt keine Möglichkeit, einen separaten Wert für x-ms-delete-snapshots anzugeben.

Weitere Informationen finden Sie unter Freigabe löschen.

GenerateAccountSasUri(AccountSasBuilder)

Gibt GenerateAccountSasUri(AccountSasBuilder) eine Uri zurück, die eine Shared Access Signature (SAS) des Freigabekontos basierend auf den übergebenen Clienteigenschaften und dem Übergeben des Generators generiert. Die SAS wird von den Anmeldeinformationen für gemeinsam genutzte Schlüssel des Clients signiert.

Informationen zum Überprüfen, ob der Client eine Dienst-Sas signieren kann, finden Sie unter CanGenerateAccountSasUri.

Weitere Informationen finden Sie unter Erstellen einer Konto-SAS.

GenerateAccountSasUri(AccountSasPermissions, DateTimeOffset, AccountSasResourceTypes)

Gibt GenerateAccountSasUri(AccountSasPermissions, DateTimeOffset, AccountSasResourceTypes) eine Uri zurück, die basierend auf den übergebenen Clienteigenschaften und Parametern eine Shared Access Signature (SAS) für ein Freigabekonto generiert. Die SAS wird von den Anmeldeinformationen für gemeinsam genutzte Schlüssel des Clients signiert.

Informationen zum Überprüfen, ob der Client eine Dienst-Sas signieren kann, finden Sie unter CanGenerateAccountSasUri.

Weitere Informationen finden Sie unter Erstellen einer Konto-SAS.

GetProperties(CancellationToken)

Der GetProperties(CancellationToken) Vorgang ruft die Eigenschaften des Dateidiensts eines Speicherkontos ab, einschließlich eigenschaften für Storage Analytics- und CORS-Regeln (Cross-Origin Resource Sharing).

Weitere Informationen finden Sie unter Abrufen von Dateidiensteigenschaften.

GetPropertiesAsync(CancellationToken)

Der GetPropertiesAsync(CancellationToken) Vorgang ruft die Eigenschaften des Dateidiensts eines Speicherkontos ab, einschließlich eigenschaften für Storage Analytics- und CORS-Regeln (Cross-Origin Resource Sharing).

Weitere Informationen finden Sie unter Abrufen von Dateidiensteigenschaften.

GetShareClient(String)

Erstellen Sie ein neues ShareClient -Objekt, indem Sie am Ende von UrianfügenshareName. Die neue ShareClient verwendet dieselbe Anforderungsrichtlinienpipeline wie die ShareServiceClient.

GetShares(ShareTraits, ShareStates, String, CancellationToken)

Der GetShares(ShareTraits, ShareStates, String, CancellationToken) Vorgang gibt eine asynchrone Sequenz der Freigaben im Speicherkonto zurück. Beim Aufzählen der Freigaben können mehrere Anforderungen an den Dienst gesendet werden, während alle Werte abgerufen werden.

Weitere Informationen finden Sie unter Listenfreigaben auf.

GetSharesAsync(ShareTraits, ShareStates, String, CancellationToken)

Der GetSharesAsync(ShareTraits, ShareStates, String, CancellationToken) Vorgang gibt eine asynchrone Auflistung der Freigaben im Speicherkonto zurück. Beim Aufzählen der Freigaben können mehrere Anforderungen an den Dienst gesendet werden, während alle Werte abgerufen werden.

Weitere Informationen finden Sie unter Listenfreigaben auf.

SetProperties(ShareServiceProperties, CancellationToken)

Der SetProperties(ShareServiceProperties, CancellationToken) Vorgang legt Eigenschaften für den Dateidienstendpunkt eines Speicherkontos fest, einschließlich Eigenschaften für Storage Analytics, CORS-Regeln (Cross-Origin Resource Sharing) und Einstellungen für vorläufiges Löschen. Sie können diesen Vorgang auch verwenden, um die Standardanforderungsversion für alle eingehenden Anforderungen an den Dateidienst festzulegen, für die keine Version angegeben ist.

Weitere Informationen finden Sie unter Legen Sie Die Eigenschaften des Dateidiensts fest.

SetPropertiesAsync(ShareServiceProperties, CancellationToken)

Der SetPropertiesAsync(ShareServiceProperties, CancellationToken) Vorgang legt Eigenschaften für den Dateidienstendpunkt eines Speicherkontos fest, einschließlich Eigenschaften für Storage Analytics, CORS-Regeln (Cross-Origin Resource Sharing) und Einstellungen für vorläufiges Löschen. Sie können diesen Vorgang auch verwenden, um die Standardanforderungsversion für alle eingehenden Anforderungen an den Dateidienst festzulegen, für die keine Version angegeben ist.

Weitere Informationen finden Sie unter Legen Sie Die Eigenschaften des Dateidiensts fest.

UndeleteShare(String, String, CancellationToken)

Stellt eine zuvor gelöschte Freigabe wieder her. Diese API ist nur funktionsfähig, wenn "Vorläufiges Löschen freigeben" für das Speicherkonto aktiviert ist, das der Freigabe zugeordnet ist.

UndeleteShareAsync(String, String, CancellationToken)

Stellt eine zuvor gelöschte Freigabe wieder her. Diese API ist nur funktionsfähig, wenn "Vorläufiges Löschen freigeben" für das Speicherkonto aktiviert ist, das der Freigabe zugeordnet ist.

Gilt für: