ShareServiceClient class

Crée une instance de ShareServiceClient.

new ShareServiceClient(url: string, credential?: Credential_2 | TokenCredential, options?: ShareClientOptions)

Paramètres

Crée une instance de ShareServiceClient.

new ShareServiceClient(url: string, pipeline: Pipeline, options?: ShareClientConfig)

Paramètres

accountName: string

Valeur de propriété

Hérité de StorageClient.accountName

Valeur de chaîne d’URL.

url: string

Valeur de propriété

Hérité de StorageClient.url

Crée un partage.

function createShare(shareName: string, options?: ShareCreateOptions): Promise<{ shareClient: ShareClient, shareCreateResponse: ShareCreateResponse }>

Paramètres

Retours

Réponse de création de partage et le client de partage correspondant.

Supprime un partage.

function deleteShare(shareName: string, options?: ShareDeleteMethodOptions): Promise<ShareDeleteResponse>

Paramètres

Retours

Réponse de suppression de partage et client de partage correspondant.

Crée une instance de ShareServiceClient à partir de la chaîne de connexion.

static function fromConnectionString(connectionString: string, options?: ShareClientOptions): ShareServiceClient

Paramètres

Retours

Nouveau ShareServiceClient à partir de la chaîne de connexion donnée.

Disponible uniquement pour ShareServiceClient construit avec des informations d’identification de clé partagée.

Génère un URI de signature d’accès partagé (SAS) de compte en fonction des propriétés et paramètres du client transmis. La sap est signée par les informations d’identification de clé partagée du client.

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/create-account-sas

function generateAccountSasUrl(expiresOn?: Date, permissions?: AccountSASPermissions, resourceTypes?: string, options?: ServiceGenerateAccountSasUrlOptions): string

Paramètres

Retours

URI SAP de compte constitué de l’URI de la ressource représentée par ce client, suivi du jeton SAP généré.

Obtient les propriétés du service de fichiers d’un compte de stockage, y compris les propriétés pour les règles Storage Analytics et CORS (Cross-Origin Resource Sharing).

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/get-file-service-properties

function getProperties(options?: ServiceGetPropertiesOptions): Promise<ServiceGetPropertiesResponse>

Paramètres

Retours

Données de réponse pour l’opération Obtenir les propriétés.

Crée un objet ShareClient.

function getShareClient(shareName: string): ShareClient

Paramètres

Retours

Objet ShareClient pour le nom de partage donné.

Exemple d’utilisation :

const shareClient = serviceClient.getShareClient("<share name>");
await shareClient.create();
console.log("Created share successfully!");

Retourne un itérateur asynchrone itérable pour répertorier tous les partages sous le compte spécifié.

.byPage() retourne un itérateur itérateur asynchrone pour répertorier les partages dans les pages.

Exemple utilisant la for await syntaxe :

let i = 1;
for await (const share of serviceClient.listShares()) {
  console.log(`Share ${i++}: ${share.name}`);
}

Exemple utilisant iter.next() :

let i = 1;
let iter = serviceClient.listShares();
let shareItem = await iter.next();
while (!shareItem.done) {
  console.log(`Share ${i++}: ${shareItem.value.name}`);
  shareItem = await iter.next();
}

Exemple utilisant byPage() :

// passing optional maxPageSize in the page settings
let i = 1;
for await (const response of serviceClient.listShares().byPage({ maxPageSize: 20 })) {
  if (response.shareItems) {
   for (const share of response.shareItems) {
       console.log(`Share ${i++}: ${share.name}`);
    }
  }
}

Exemple d’utilisation de la pagination avec un marqueur :

let i = 1;
let iterator = serviceClient.listShares().byPage({ maxPageSize: 2 });
let response = (await iterator.next()).value;

// Prints 2 share names
if (response.shareItems) {
  for (const share of response.shareItems) {
    console.log(`Share ${i++}: ${share.name}`);
  }
}

// Gets next marker
let marker = response.continuationToken;

// Passing next marker as continuationToken
iterator = serviceClient.listShares().byPage({ continuationToken: marker, maxPageSize: 10 });
response = (await iterator.next()).value;

// Prints 10 share names
if (response.shareItems) {
  for (const share of response.shareItems) {
    console.log(`Share ${i++}: ${share.name}`);
  }
}

function listShares(options?: ServiceListSharesOptions): PagedAsyncIterableIterator<ShareItem, ServiceListSharesSegmentResponse, PageSettings>

Paramètres

Retours

Définit les propriétés du point de terminaison de service de fichiers d’un compte de stockage, notamment les propriétés pour Storage Analytics, les règles CORS (Cross-Origin Resource Sharing) et les paramètres de suppression réversible.

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/set-file-service-properties

function setProperties(properties: FileServiceProperties, options?: ServiceSetPropertiesOptions): Promise<ServiceSetPropertiesResponse>

Paramètres

Retours

Données de réponse pour l’opération Définir les propriétés.

Restaure un partage précédemment supprimé. Cette API est uniquement fonctionnelle si la suppression réversible de partage est activée pour le compte de stockage associé au partage.

function undeleteShare(deletedShareName: string, deletedShareVersion: string, options?: ServiceUndeleteShareOptions): Promise<ShareClient>

Paramètres

Retours

Partage restauré.