Dela via

ShareServiceClient class

  • Referens
Paket:
@azure/storage-file-share

En ShareServiceClient representerar en URL till Azure Storage File-tjänsten så att du kan ändra filresurser.

Extends

StorageClient

Konstruktorer

ShareServiceClient(string, Credential_2 | TokenCredential, ShareClientOptions)

Skapar en instans av ShareServiceClient.
ShareServiceClient(string, Pipeline, ShareClientConfig)

Skapar en instans av ShareServiceClient.

Ärvda egenskaper

accountName
url

URL-strängvärde.

Metoder

createShare(string, ShareCreateOptions)

Skapar en resurs.
deleteShare(string, ShareDeleteMethodOptions)

Tar bort en resurs.
fromConnectionString(string, ShareClientOptions)

Skapar en instans av ShareServiceClient från anslutningssträngen.
generateAccountSasUrl(Date, AccountSASPermissions, string, ServiceGenerateAccountSasUrlOptions)

Endast tillgängligt för ShareServiceClient som skapats med autentiseringsuppgifter för delad nyckel.

Genererar ett kontos URI för signatur för delad åtkomst (SAS) baserat på de klientegenskaper och parametrar som skickas. SAS signeras av klientens autentiseringsuppgifter för delad nyckel.

Se https://docs.microsoft.com/en-us/rest/api/storageservices/create-account-sas
getProperties(ServiceGetPropertiesOptions)

Hämtar egenskaperna för ett lagringskontos filtjänst, inklusive egenskaper för lagringsanalys och CORS-regler (resursdelning mellan ursprung).

Se https://docs.microsoft.com/en-us/rest/api/storageservices/get-file-service-properties
getShareClient(string)

Skapar ett ShareClient-objekt.
listShares(ServiceListSharesOptions)

Returnerar en asynkron iterbar iterator för att visa alla resurser under det angivna kontot.

.byPage() returnerar en iterator som kan itereras asynkront för att visa en lista över resurser i sidor.

Exempel med syntax for await :

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

Exempel med 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();
}

Exempel med 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}`);
    }
  }
}

Exempel med sidindelning med en markör:

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}`);
  }
}
setProperties(FileServiceProperties, ServiceSetPropertiesOptions)

Anger egenskaper för ett lagringskontos filtjänstslutpunkt, inklusive egenskaper för lagringsanalys, CORS-regler (resursdelning för korsande ursprung) och inställningar för mjuk borttagning.

Se https://docs.microsoft.com/en-us/rest/api/storageservices/set-file-service-properties
undeleteShare(string, string, ServiceUndeleteShareOptions)

Återställer en tidigare borttagen resurs. Det här API:et fungerar bara om Mjuk borttagning av resurser är aktiverat för lagringskontot som är associerat med resursen.

Konstruktorinformation

ShareServiceClient(string, Credential_2 | TokenCredential, ShareClientOptions)

Skapar en instans av ShareServiceClient.

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

Parametrar

url

string

En URL-sträng som pekar på Azure Storage-filtjänsten, till exempel "https://myaccount.file.core.windows.net". Du kan lägga till en SAS om du använder AnonymousCredential, till exempel "https://myaccount.file.core.windows.net?sasString".

credential

Credential | TokenCredential

Som AnonymousCredential, StorageSharedKeyCredential eller TokenCredential används AnonymousCredential om det inte anges.

options
ShareClientOptions

Valfritt. Alternativ för att konfigurera HTTP-pipelinen.

ShareServiceClient(string, Pipeline, ShareClientConfig)

Skapar en instans av ShareServiceClient.

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

Parametrar

url

string

En URL-sträng som pekar på Azure Storage-filtjänsten, till exempel "https://myaccount.file.core.windows.net". Du kan lägga till en SAS om du använder AnonymousCredential, till exempel "https://myaccount.file.core.windows.net?sasString".

pipeline
Pipeline

Anropa newPipeline() för att skapa en standardpipeline eller ange en anpassad pipeline.

options
ShareClientConfig

Valfritt. Alternativ för att konfigurera HTTP-pipelinen.

Information om ärvda egenskaper

accountName 

accountName: string

Egenskapsvärde

string

Ärvd från StorageClient.accountName

url

URL-strängvärde.

url: string

Egenskapsvärde

string

Ärvd från StorageClient.url

Metodinformation

createShare(string, ShareCreateOptions)

Skapar en resurs.

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

Parametrar

shareName

string

options
ShareCreateOptions

Returer

Promise<{ shareClient: ShareClient, shareCreateResponse: ShareCreateResponse }>

Svar på skapande av resurs och motsvarande resursklient.

deleteShare(string, ShareDeleteMethodOptions)

Tar bort en resurs.

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

Parametrar

shareName

string

options
ShareDeleteMethodOptions

Returer

Promise<ShareDeleteResponse>

Svar på resursborttagning och motsvarande resursklient.

fromConnectionString(string, ShareClientOptions)

Skapar en instans av ShareServiceClient från anslutningssträngen.

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

Parametrar

connectionString

string

Kontoanslutningssträng eller en SAS-anslutningssträng för ett Azure Storage-konto. [ Obs! – Kontoanslutningssträngen kan bara användas i NODE.JS körning. ] Exempel på kontoanslutningssträng –DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=accountKey;EndpointSuffix=core.windows.net EXEMPEL på SAS-anslutningssträng – BlobEndpoint=https://myaccount.blob.core.windows.net/;QueueEndpoint=https://myaccount.queue.core.windows.net/;FileEndpoint=https://myaccount.file.core.windows.net/;TableEndpoint=https://myaccount.table.core.windows.net/;SharedAccessSignature=sasString

options
ShareClientOptions

Alternativ för att konfigurera HTTP-pipelinen.

Returer

ShareServiceClient

En ny ShareServiceClient från den angivna anslutningssträngen.

generateAccountSasUrl(Date, AccountSASPermissions, string, ServiceGenerateAccountSasUrlOptions)

Endast tillgängligt för ShareServiceClient som skapats med autentiseringsuppgifter för delad nyckel.

Genererar ett kontos URI för signatur för delad åtkomst (SAS) baserat på de klientegenskaper och parametrar som skickas. SAS signeras av klientens autentiseringsuppgifter för delad nyckel.

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

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

Parametrar

expiresOn

Date

Valfritt. Den tidpunkt då signaturen för delad åtkomst blir ogiltig. Standardvärdet är en timme senare om det inte anges.

permissions
AccountSASPermissions

Anger listan över behörigheter som ska associeras med SAS.

resourceTypes

string

Anger de resurstyper som är associerade med signaturen för delad åtkomst.

options
ServiceGenerateAccountSasUrlOptions

Valfria parametrar.

Returer

string

En SAS-URI för kontot som består av URI:n för den resurs som representeras av den här klienten, följt av den genererade SAS-token.

getProperties(ServiceGetPropertiesOptions)

Hämtar egenskaperna för ett lagringskontos filtjänst, inklusive egenskaper för lagringsanalys och CORS-regler (resursdelning mellan ursprung).

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

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

Parametrar

options
ServiceGetPropertiesOptions

Alternativ för att hämta egenskaper.

Returer

Promise<ServiceGetPropertiesResponse>

Svarsdata för åtgärden Hämta egenskaper.

getShareClient(string)

Skapar ett ShareClient-objekt.

function getShareClient(shareName: string): ShareClient

Parametrar

shareName

string

Namnet på en resurs.

Returer

ShareClient

ShareClient-objektet för det angivna resursnamnet.

Exempel på användning:

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

listShares(ServiceListSharesOptions)

Returnerar en asynkron iterbar iterator för att visa alla resurser under det angivna kontot.

.byPage() returnerar en iterator som kan itereras asynkront för att visa en lista över resurser i sidor.

Exempel med syntax for await :

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

Exempel med 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();
}

Exempel med 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}`);
    }
  }
}

Exempel med sidindelning med en markör:

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>

Parametrar

options
ServiceListSharesOptions

Alternativ för att lista resursåtgärder.

En asyncIterableIterator som stöder sidindelning.

Returer

PagedAsyncIterableIterator<ShareItem, ServiceListSharesSegmentResponse, PageSettings>

setProperties(FileServiceProperties, ServiceSetPropertiesOptions)

Anger egenskaper för ett lagringskontos filtjänstslutpunkt, inklusive egenskaper för lagringsanalys, CORS-regler (resursdelning för korsande ursprung) och inställningar för mjuk borttagning.

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

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

Parametrar

properties
FileServiceProperties
options
ServiceSetPropertiesOptions

Alternativ för att ange egenskaper.

Returer

Promise<ServiceSetPropertiesResponse>

Svarsdata för åtgärden Ange egenskaper.

undeleteShare(string, string, ServiceUndeleteShareOptions)

Återställer en tidigare borttagen resurs. Det här API:et fungerar bara om Mjuk borttagning av resurser är aktiverat för lagringskontot som är associerat med resursen.

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

Parametrar

deletedShareName

string

Namnet på den tidigare borttagna resursen.

deletedShareVersion

string

Versionen av den tidigare borttagna resursen.

options
ServiceUndeleteShareOptions

Alternativ för att dela oborttagningsåtgärd.

Returer

Promise<ShareClient>

Återställd resurs.