Sdílet prostřednictvím


ShareServiceClient Třída

Definice

Umožňuje ShareServiceClient manipulovat s prostředky a sdílenými složkami služby Azure Storage. Účet úložiště poskytuje obor názvů nejvyšší úrovně pro službu File.

public class ShareServiceClient
type ShareServiceClient = class
Public Class ShareServiceClient
Dědičnost
ShareServiceClient

Konstruktory

ShareServiceClient()

Inicializuje novou instanci ShareServiceClient třídy pro napodobení.

ShareServiceClient(String)

Inicializuje novou instanci ShareServiceClient třídy .

ShareServiceClient(String, ShareClientOptions)

Inicializuje novou instanci ShareServiceClient třídy .

ShareServiceClient(Uri, AzureSasCredential, ShareClientOptions)

Inicializuje novou instanci ShareServiceClient třídy .

ShareServiceClient(Uri, ShareClientOptions)

Inicializuje novou instanci ShareServiceClient třídy .

ShareServiceClient(Uri, StorageSharedKeyCredential, ShareClientOptions)

Inicializuje novou instanci ShareServiceClient třídy .

ShareServiceClient(Uri, TokenCredential, ShareClientOptions)

Inicializuje novou instanci ShareServiceClient třídy .

Mějte na paměti, že operace na úrovni služby nepodporují ověřování přihlašovacích údajů tokenu. Tento konstruktor existuje, aby bylo možné vytvořit objekt ShareServiceClient , který lze použít k odvození tokenu ShareClient s ověřováním přihlašovacích údajů.

Upozorňujeme také, že ShareTokenIntent se aktuálně vyžaduje pro ověřování pomocí tokenu.

Vlastnosti

AccountName

Získá název účtu úložiště odpovídající klientovi souborové služby.

CanGenerateAccountSasUri

Určuje, jestli klient může vygenerovat SAS. Pokud je klient ověřený pomocí StorageSharedKeyCredential.

Uri

Získá primární Uri koncový bod souborové služby.

Metody

CreateShare(String, ShareCreateOptions, CancellationToken)

Operace CreateShare(String, ShareCreateOptions, CancellationToken) vytvoří novou sdílenou složku pod zadaným účtem. Pokud sdílená složka se stejným názvem již existuje, operace se nezdaří.

Další informace najdete v tématu Vytvořit sdílenou složku.

CreateShareAsync(String, ShareCreateOptions, CancellationToken)

Operace CreateShare(String, ShareCreateOptions, CancellationToken) vytvoří novou sdílenou složku pod zadaným účtem. Pokud sdílená složka se stejným názvem již existuje, operace se nezdaří.

Další informace najdete v tématu Vytvořit sdílenou složku.

DeleteShare(String, ShareDeleteOptions, CancellationToken)

Označí zadanou sdílenou složku nebo snímek sdílené složky k odstranění. Snímek sdílené složky nebo sdílené složky a všechny soubory v něm obsažené se později odstraní během uvolňování paměti, což může trvat několik minut.

V současné době tato metoda vždy odstraní snímky. Neexistuje žádný způsob, jak zadat samostatnou hodnotu pro x-ms-delete-snapshots.

Další informace najdete v tématu Odstranit sdílenou složku.

DeleteShareAsync(String, ShareDeleteOptions, CancellationToken)

Označí zadanou sdílenou složku nebo snímek sdílené složky k odstranění. Snímek sdílené složky nebo sdílené složky a všechny soubory v něm obsažené se později odstraní během uvolňování paměti, což může trvat několik minut.

V současné době tato metoda vždy odstraní snímky. Neexistuje žádný způsob, jak zadat samostatnou hodnotu pro x-ms-delete-snapshots.

Další informace najdete v tématu Odstranit sdílenou složku.

GenerateAccountSasUri(AccountSasBuilder)

Vrátí GenerateAccountSasUri(AccountSasBuilder) hodnotu Uri , která vygeneruje sdílený přístupový podpis (SAS) pro sdílený účet na základě vlastností klienta a předaného tvůrce. Sas je podepsaný přihlašovacími údaji sdíleného klíče klienta.

Pokud chcete zkontrolovat, jestli klient může podepsat sas služby, projděte si téma CanGenerateAccountSasUri.

Další informace najdete v tématu Vytvoření sdíleného přístupového podpisu účtu

GenerateAccountSasUri(AccountSasPermissions, DateTimeOffset, AccountSasResourceTypes)

Vrátí GenerateAccountSasUri(AccountSasPermissions, DateTimeOffset, AccountSasResourceTypes) hodnotu Uri , která vygeneruje sdílený přístupový podpis (SAS) účtu sdílené složky na základě předaných parametrů a vlastností klienta. Sas je podepsaný přihlašovacími údaji sdíleného klíče klienta.

Pokud chcete zkontrolovat, jestli klient může podepsat sas služby, projděte si téma CanGenerateAccountSasUri.

Další informace najdete v tématu Vytvoření sdíleného přístupového podpisu účtu

GetProperties(CancellationToken)

Operace GetProperties(CancellationToken) získá vlastnosti souborové služby účtu úložiště, včetně vlastností pro pravidla Analýza úložiště a CORS (Sdílení prostředků mezi zdroji).

Další informace najdete v tématu Načíst vlastnosti souborové služby.

GetPropertiesAsync(CancellationToken)

Operace GetPropertiesAsync(CancellationToken) získá vlastnosti souborové služby účtu úložiště, včetně vlastností pro pravidla Analýza úložiště a CORS (Sdílení prostředků mezi zdroji).

Další informace najdete v tématu Načíst vlastnosti souborové služby.

GetShareClient(String)

Vytvořte nový ShareClient objekt připojením shareName na konec objektu Uri. Nová ShareClient verze používá stejný kanál zásad požadavků jako ShareServiceClient.

GetShares(ShareTraits, ShareStates, String, CancellationToken)

Operace GetShares(ShareTraits, ShareStates, String, CancellationToken) vrátí asynchronní sekvenci sdílených složek v účtu úložiště. Při vytváření výčtu sdílených složek může být na službu při načítání všech hodnot více požadavků.

Další informace najdete v tématu Seznam sdílených složek.

GetSharesAsync(ShareTraits, ShareStates, String, CancellationToken)

Operace GetSharesAsync(ShareTraits, ShareStates, String, CancellationToken) vrátí asynchronní kolekci sdílených složek v účtu úložiště. Při vytváření výčtu sdílených složek může být na službu při načítání všech hodnot více požadavků.

Další informace najdete v tématu Seznam sdílených složek.

SetProperties(ShareServiceProperties, CancellationToken)

Operace SetProperties(ShareServiceProperties, CancellationToken) nastaví vlastnosti koncového bodu souborové služby účtu úložiště, včetně vlastností pro Analýza úložiště, pravidel CORS (Sdílení prostředků mezi zdroji) a nastavení obnovitelného odstranění. Tuto operaci můžete také použít k nastavení výchozí verze žádosti pro všechny příchozí požadavky na souborovou službu, které nemají zadanou verzi.

Další informace najdete v tématu Nastavte vlastnosti souborové služby.

SetPropertiesAsync(ShareServiceProperties, CancellationToken)

Operace SetPropertiesAsync(ShareServiceProperties, CancellationToken) nastaví vlastnosti koncového bodu souborové služby účtu úložiště, včetně vlastností pro Analýza úložiště, pravidel CORS (Sdílení prostředků mezi zdroji) a nastavení obnovitelného odstranění. Tuto operaci můžete také použít k nastavení výchozí verze žádosti pro všechny příchozí požadavky na souborovou službu, které nemají zadanou verzi.

Další informace najdete v tématu Nastavte vlastnosti souborové služby.

UndeleteShare(String, String, CancellationToken)

Obnoví dříve odstraněnou sdílenou složku. Toto rozhraní API je funkční jenom v případě, že je pro účet úložiště přidružený ke sdílené složce povolené obnovitelné odstranění sdílené složky.

UndeleteShareAsync(String, String, CancellationToken)

Obnoví dříve odstraněnou sdílenou složku. Toto rozhraní API je funkční jenom v případě, že je pro účet úložiště přidružený ke sdílené složce povolené obnovitelné odstranění sdílené složky.

Platí pro