ShareFileClient class

Referens

Paket:: @azure/storage-file-share

En ShareFileClient representerar en URL till en Azure Storage-fil.

Extends: StorageClient

Konstruktorer

ShareFileClient(string, Credential_2 \| TokenCredential, ShareClientOptions)	Skapar en instans av ShareFileClient.
ShareFileClient(string, Pipeline, ShareClientConfig)	Skapar en instans av ShareFileClient.

Egenskaper

name	Namnet på filen
path	Filens fullständiga sökväg
shareName	Resursnamnet som motsvarar den här filklienten

Ärvda egenskaper

accountName
url	URL-strängvärde.

Metoder

abortCopyFromURL(string, FileAbortCopyFromURLOptions)	Avbryter en väntande kopieringsfilåtgärd och lämnar en målfil med noll längd och fullständiga metadata. Se https://docs.microsoft.com/en-us/rest/api/storageservices/abort-copy-file
clearRange(number, number, FileClearRangeOptions)	Rensar det angivna intervallet och frigör det utrymme som används i lagringen för det intervallet.
create(number, FileCreateOptions)	Skapar en ny fil eller ersätter en fil. Observera att den endast initierar filen utan innehåll. Se https://docs.microsoft.com/en-us/rest/api/storageservices/create-file
delete(FileDeleteOptions)	Tar bort filen från lagringskontot. När en fil har tagits bort tas den omedelbart bort från lagringskontots index och är inte längre tillgänglig för klienter. Filens data tas senare bort från tjänsten under skräpinsamlingen. Ta bort fil misslyckas med statuskoden 409 (konflikt) och felkoden SharingViolation om filen är öppen på en SMB-klient. Ta bort fil stöds inte på en resursögonblicksbild, vilket är en skrivskyddad kopia av en resurs. Ett försök att utföra den här åtgärden på en resursögonblicksbild misslyckas med 400 (InvalidQueryParameterValue) Se https://docs.microsoft.com/en-us/rest/api/storageservices/delete-file2
deleteIfExists(FileDeleteOptions)	Tar bort filen från lagringskontot om den finns. När en fil har tagits bort tas den omedelbart bort från lagringskontots index och är inte längre tillgänglig för klienter. Filens data tas senare bort från tjänsten under skräpinsamlingen. Ta bort fil misslyckas med statuskoden 409 (konflikt) och felkoden SharingViolation om filen är öppen på en SMB-klient. Ta bort fil stöds inte på en resursögonblicksbild, vilket är en skrivskyddad kopia av en resurs. Ett försök att utföra den här åtgärden på en resursögonblicksbild misslyckas med 400 (InvalidQueryParameterValue) Se https://docs.microsoft.com/en-us/rest/api/storageservices/delete-file2
download(number, number, FileDownloadOptions)	Läser eller laddar ned en fil från systemet, inklusive dess metadata och egenskaper. I Node.js returnerar data i en läsbar dataström `readableStreamBody` I webbläsare returneras data i ett löfte `contentAsBlob` Se https://docs.microsoft.com/en-us/rest/api/storageservices/get-file
downloadToBuffer(Buffer, number, number, FileDownloadToBufferOptions)	ENDAST TILLGÄNGLIGT I NODE.JS RUNTIME. Laddar ned en Azure-fil parallellt med en buffert. Förskjutning och antal är valfria, skicka 0 för båda för att ladda ned hela filen. Varning! Buffertar kan bara ha stöd för filer upp till ungefär en gigabyte på 32-bitarssystem eller cirka två gigabyte på 64-bitarssystem på grund av begränsningar för Node.js/V8. Överväg att ladda nedToFile för filer som är större än den här storleken.
downloadToBuffer(number, number, FileDownloadToBufferOptions)	ENDAST TILLGÄNGLIGT I NODE.JS RUNTIME Laddar ned en Azure-fil parallellt med en buffert. Förskjutning och antal är valfria, skicka 0 för båda för att ladda ned hela filen Varning! Buffertar kan bara ha stöd för filer upp till ungefär en gigabyte på 32-bitarssystem eller cirka två gigabyte på 64-bitarssystem på grund av begränsningar för Node.js/V8. Överväg att ladda nedToFile för filer som är större än den här storleken.
downloadToFile(string, number, number, FileDownloadOptions)	ENDAST TILLGÄNGLIGT I NODE.JS RUNTIME. Laddar ned en Azure Blob till en lokal fil. Misslyckas om den angivna filsökvägen redan avslutas. Förskjutning och antal är valfria, skicka 0 respektive odefinierat för att ladda ned hela bloben.
exists(FileExistsOptions)	Returnerar sant om den angivna filen finns. annars falskt. Obs! Använd den här funktionen med försiktighet eftersom en befintlig fil kan tas bort av andra klienter eller program. Tvärtom kan nya filer läggas till av andra klienter eller program när den här funktionen har slutförts.
forceCloseAllHandles(FileForceCloseHandlesOptions)	Framtvinga stängning av alla referenser för en fil. Se https://docs.microsoft.com/en-us/rest/api/storageservices/force-close-handles
forceCloseHandle(string, FileForceCloseHandlesOptions)	Framtvinga stängning av ett specifikt handtag för en fil. Se https://docs.microsoft.com/en-us/rest/api/storageservices/force-close-handles
generateSasUrl(FileGenerateSasUrlOptions)	Endast tillgängligt för klienter som skapats med en autentiseringsuppgift med delad nyckel. Genererar en SAS-URI (Service Shared Access Signature) 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/constructing-a-service-sas
getProperties(FileGetPropertiesOptions)	Returnerar alla användardefinierade metadata, http-standardegenskaper och systemegenskaper för filen. Det returnerar inte innehållet i filen. Se https://docs.microsoft.com/en-us/rest/api/storageservices/get-file-properties
getRangeList(FileGetRangeListOptions)	Returnerar listan över giltiga intervall för en fil.
getRangeListDiff(string, FileGetRangeListOptions)	Returnerar listan över intervall som skiljer sig mellan en tidigare resursögonblicksbild och den här filen.
getShareLeaseClient(string)	Hämta en ShareLeaseClient som hanterar lån i filen.
listHandles(FileListHandlesOptions)	Returnerar en iterabel iterator som kan asynkronas för att visa alla referenser. under det angivna kontot. .byPage() returnerar en itererbar iterator som kan asynkroniseras för att visa referenser på sidor.
rename(string, FileRenameOptions)	Byter namn på en fil. Det här API:et stöder endast namnbyte av en fil i samma resurs.
resize(number, FileResizeOptions)	Ändra storlek på filen. Se https://docs.microsoft.com/en-us/rest/api/storageservices/set-file-properties
setHttpHeaders(FileHttpHeaders, FileSetHttpHeadersOptions)	Anger HTTP-huvuden i filen. Om inget alternativ anges, eller inget värde som anges för filens HTTP-huvuden i alternativen, rensas dessa HTTP-huvuden utan ett värde. Se https://docs.microsoft.com/en-us/rest/api/storageservices/set-file-properties
setMetadata(Metadata, FileSetMetadataOptions)	Uppdaterar användardefinierade metadata för den angivna filen. Om inga metadata definieras i alternativparametern tas filmetadata bort. Se https://docs.microsoft.com/en-us/rest/api/storageservices/set-file-metadata
setProperties(FileProperties)	Anger egenskaper för filen. Se https://docs.microsoft.com/en-us/rest/api/storageservices/set-file-properties
startCopyFromURL(string, FileStartCopyOptions)	Kopierar en blob eller fil till en målfil i lagringskontot.
uploadData(Blob \| ArrayBuffer \| ArrayBufferView \| Buffer, FileParallelUploadOptions)	Skapar en ny Azure-fil eller ersätter en befintlig Azure-fil och laddar sedan upp en Buffer(Node)/Blob/ArrayBuffer/ArrayBufferView till den.
uploadFile(string, FileParallelUploadOptions)	ENDAST TILLGÄNGLIGT I NODE.JS RUNTIME. Skapar en ny Azure-fil eller ersätter en befintlig Azure-fil och laddar sedan upp en lokal fil till den.
uploadRange(RequestBodyType, number, number, FileUploadRangeOptions)	Ladda upp ett byteintervall till en fil. Den här åtgärden kan bara anropas på en befintlig fil. Det ändrar inte filens storlek, egenskaper eller metadata. Både start och antal för intervallet måste anges. Intervallet kan vara upp till 4 MB stort.
uploadRangeFromURL(string, number, number, number, FileUploadRangeFromURLOptions)	Ladda upp ett byteintervall till en fil där innehållet läse från en annan fils URL. Intervallet kan vara upp till 4 MB stort.
uploadResetableStream((offset: number, count?: number) => ReadableStream, number, FileParallelUploadOptions)	ENDAST TILLGÄNGLIGT I NODE.JS RUNTIME. Accepterar en Node.js Läsbar dataströmfabrik och laddas upp i block till en Azure-fil. Den läsbara dataströmfabriken måste returnera en Node.js läsbar dataström från den definierade förskjutningen. Förskjutningen är förskjutningen i Azure-filen som ska laddas upp.
uploadSeekableBlob((offset: number, size: number) => Blob, number, FileParallelUploadOptions)	ENDAST TILLGÄNGLIGT I WEBBLÄSARE. Laddar upp ett blobobjekt i webbläsaren till en Azure-fil. Kräver en blobFactory som datakälla, som måste returnera ett Blob-objekt med den förskjutning och storlek som anges.
uploadStream(Readable, number, number, number, FileUploadStreamOptions)	ENDAST TILLGÄNGLIGT I NODE.JS RUNTIME. Skapar en ny Azure-fil eller ersätter en befintlig Azure-fil och laddar sedan upp en Node.js läsbar dataström till den. Den här metoden försöker skapa en Azure-fil och börjar sedan ladda upp segment för segment. Storleken på segment definieras av `bufferSize` parametern. Kontrollera att den potentiella storleken på dataströmmen inte överskrider filstorleken. TIPS FÖR PRESTANDAFÖRBÄTTRING: HighWaterMark för indataströmmen är bättre att ange samma värde med bufferSize-parametern, vilket undviker buffer.concat()-åtgärder.
withShareSnapshot(string)	Skapar ett nytt ShareFileClient-objekt som är identiskt med källan men med den angivna tidsstämpeln för resursögonblicksbilder. Ange "" tar bort ögonblicksbilden och returnerar en URL till den grundläggande ShareFileClient.

Konstruktorinformation

Skapar en instans av ShareFileClient.

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

Parametrar

url: string

En URL-sträng som pekar på Azure Storage-filen, till exempel "https://myaccount.file.core.windows.net/myshare/mydirectory/file". Du kan lägga till en SAS om du använder AnonymousCredential, till exempel "https://myaccount.file.core.windows.net/myshare/mydirectory/file?sasString". Den här metoden accepterar en kodad URL eller en icke-kodad URL som pekar på en fil. Kodad URL-sträng kommer INTE att undantagas två gånger, endast specialtecken i URL-sökvägen kommer att undantagas. Men om ett fil- eller katalognamn innehåller %, måste fil- eller katalognamnet kodas i URL:en. Till exempel en fil med namnet "myfile%", ska URL:en vara "https://myaccount.file.core.windows.net/myshare/mydirectory/myfile%25".

credential: Credential | TokenCredential

Till exempel , StorageSharedKeyCredential eller TokenCredential, Om det inte anges används AnonymousCredential.

options: ShareClientOptions

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

Skapar en instans av ShareFileClient.

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

Parametrar

url: string

pipeline: Pipeline

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

options: ShareClientConfig

Egenskapsinformation

Namnet på filen

string name

Egenskapsvärde

string

Filens fullständiga sökväg

string path

Egenskapsvärde

string

Resursnamnet som motsvarar den här filklienten

string shareName

Egenskapsvärde

string

Information om ärvda egenskaper

accountName: string

Egenskapsvärde

string

Ärvd från StorageClient.accountName

URL-strängvärde.

url: string

Egenskapsvärde

string

Ärvd från StorageClient.url

Metodinformation

Avbryter en väntande kopieringsfilåtgärd och lämnar en målfil med noll längd och fullständiga metadata.

Se https://docs.microsoft.com/en-us/rest/api/storageservices/abort-copy-file

function abortCopyFromURL(copyId: string, options?: FileAbortCopyFromURLOptions): Promise<FileAbortCopyResponse>

Parametrar

copyId: string

ID för åtgärden Kopiera fil som ska avbrytas.

options: FileAbortCopyFromURLOptions

Alternativ för att avbryta kopiering av fil från URL-åtgärd.

Returer

Promise<FileAbortCopyResponse>

Rensar det angivna intervallet och frigör det utrymme som används i lagringen för det intervallet.

function clearRange(offset: number, contentLength: number, options?: FileClearRangeOptions): Promise<FileUploadRangeResponse>

Parametrar

offset: number

contentLength: number

options: FileClearRangeOptions

Alternativ för åtgärden Filrensningsintervall.

Returer

Promise<FileUploadRangeResponse>

Skapar en ny fil eller ersätter en fil. Observera att den endast initierar filen utan innehåll.

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

function create(size: number, options?: FileCreateOptions): Promise<FileCreateResponse>

Parametrar

size: number

Anger den maximala storleken i byte för filen, upp till 4 TB.

options: FileCreateOptions

Alternativ för åtgärden Skapa fil.

Returer

Promise<FileCreateResponse>

Svarsdata för åtgärden Skapa fil.

Exempel på användning:

const content = "Hello world!";

// Create the file
await fileClient.create(content.length);
console.log("Created file successfully!");

// Then upload data to the file
await fileClient.uploadRange(content, 0, content.length);
console.log("Updated file successfully!")

Tar bort filen från lagringskontot. När en fil har tagits bort tas den omedelbart bort från lagringskontots index och är inte längre tillgänglig för klienter. Filens data tas senare bort från tjänsten under skräpinsamlingen.

Ta bort fil misslyckas med statuskoden 409 (konflikt) och felkoden SharingViolation om filen är öppen på en SMB-klient.

Ta bort fil stöds inte på en resursögonblicksbild, vilket är en skrivskyddad kopia av en resurs. Ett försök att utföra den här åtgärden på en resursögonblicksbild misslyckas med 400 (InvalidQueryParameterValue)

Se https://docs.microsoft.com/en-us/rest/api/storageservices/delete-file2

function delete(options?: FileDeleteOptions): Promise<FileDeleteResponse>

Parametrar

options: FileDeleteOptions

Alternativ för åtgärden Filborttagning.

Returer

Promise<FileDeleteResponse>

Svarsdata för åtgärden Filborttagning.

Tar bort filen från lagringskontot om den finns. När en fil har tagits bort tas den omedelbart bort från lagringskontots index och är inte längre tillgänglig för klienter. Filens data tas senare bort från tjänsten under skräpinsamlingen.

Ta bort fil misslyckas med statuskoden 409 (konflikt) och felkoden SharingViolation om filen är öppen på en SMB-klient.

Se https://docs.microsoft.com/en-us/rest/api/storageservices/delete-file2

function deleteIfExists(options?: FileDeleteOptions): Promise<FileDeleteIfExistsResponse>

Parametrar

options: FileDeleteOptions

Returer

Promise<FileDeleteIfExistsResponse>

Läser eller laddar ned en fil från systemet, inklusive dess metadata och egenskaper.

I Node.js returnerar data i en läsbar dataström readableStreamBody
I webbläsare returneras data i ett löfte contentAsBlob

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

function download(offset?: number, count?: number, options?: FileDownloadOptions): Promise<FileDownloadResponseModel>

Parametrar

offset: number

Från vilken position filen ska laddas ned, större än eller lika med 0

count: number

Hur mycket data som ska laddas ned, större än 0. Laddas ned till slutet när det är odefinierat

options: FileDownloadOptions

Alternativ för filnedladdning.

Returer

Promise<FileDownloadResponseModel>

Svarsdata för filnedladdningsåtgärden.

Exempel på användning (Node.js):

// Download a file to a string
const downloadFileResponse = await fileClient.download();
console.log(
  "Downloaded file content:",
  (await streamToBuffer(downloadFileResponse.readableStreamBody)).toString()}
);

// A helper method used to read a Node.js readable stream into string
async function streamToBuffer(readableStream) {
  return new Promise((resolve, reject) => {
    const chunks = [];
    readableStream.on("data", (data) => {
      chunks.push(data instanceof Buffer ? data : Buffer.from(data));
    });
    readableStream.on("end", () => {
      resolve(Buffer.concat(chunks));
    });
    readableStream.on("error", reject);
  });
}

Exempel på användning (webbläsare):

// Download a file to a string
const downloadFileResponse = await fileClient.download(0);
console.log(
  "Downloaded file content:",
  await blobToString(await downloadFileResponse.blobBody)}
);

// A helper method used to convert a browser Blob into string.
export async function blobToString(blob: Blob): Promise<string> {
  const fileReader = new FileReader();
  return new Promise<string>((resolve, reject) => {
    fileReader.onloadend = (ev: any) => {
      resolve(ev.target!.result);
    };
    fileReader.onerror = reject;
    fileReader.readAsText(blob);
  });
}

ENDAST TILLGÄNGLIGT I NODE.JS RUNTIME.

Laddar ned en Azure-fil parallellt med en buffert. Förskjutning och antal är valfria, skicka 0 för båda för att ladda ned hela filen.

Varning! Buffertar kan bara ha stöd för filer upp till ungefär en gigabyte på 32-bitarssystem eller cirka två gigabyte på 64-bitarssystem på grund av begränsningar för Node.js/V8. Överväg att ladda nedToFile för filer som är större än den här storleken.

function downloadToBuffer(buffer: Buffer, offset?: number, count?: number, options?: FileDownloadToBufferOptions): Promise<Buffer>

Parametrar

buffer: Buffer

Buffert som ska fyllas, måste ha en längd som är större än antalet

offset: number

Från vilken position azure-filen ska laddas ned

count: number

Hur mycket data som ska laddas ned. Laddas ned till slutet när odefinierade skickas

options: FileDownloadToBufferOptions

Returer

Promise<Buffer>

ENDAST TILLGÄNGLIGT I NODE.JS RUNTIME

Laddar ned en Azure-fil parallellt med en buffert. Förskjutning och antal är valfria, skicka 0 för båda för att ladda ned hela filen

function downloadToBuffer(offset?: number, count?: number, options?: FileDownloadToBufferOptions): Promise<Buffer>

Parametrar

offset: number

Från vilken position azure-filen ska laddas ned

count: number

Hur mycket data som ska laddas ned. Laddas ned till slutet när odefinierade skickas

options: FileDownloadToBufferOptions

Returer

Promise<Buffer>

ENDAST TILLGÄNGLIGT I NODE.JS RUNTIME.

Laddar ned en Azure Blob till en lokal fil. Misslyckas om den angivna filsökvägen redan avslutas. Förskjutning och antal är valfria, skicka 0 respektive odefinierat för att ladda ned hela bloben.

function downloadToFile(filePath: string, offset?: number, count?: number, options?: FileDownloadOptions): Promise<FileDownloadResponseModel>

Parametrar

filePath: string

offset: number

Från vilken position blockbloben ska laddas ned.

count: number

Hur mycket data som ska laddas ned. Laddas ned till slutet när odefinierade skickas.

options: FileDownloadOptions

Alternativ för alternativ för blobnedladdning.

Returer

Promise<FileDownloadResponseModel>

Svarsdata för blobnedladdning, men med readableStreamBody inställt på odefinierat eftersom dess innehåll redan har lästs och skrivits till en lokal fil på den angivna sökvägen.

Returnerar sant om den angivna filen finns. annars falskt.

Obs! Använd den här funktionen med försiktighet eftersom en befintlig fil kan tas bort av andra klienter eller program. Tvärtom kan nya filer läggas till av andra klienter eller program när den här funktionen har slutförts.

function exists(options?: FileExistsOptions): Promise<boolean>

Parametrar

options: FileExistsOptions

alternativ för åtgärden Finns.

Returer

Promise<boolean>

Framtvinga stängning av alla referenser för en fil.

Se https://docs.microsoft.com/en-us/rest/api/storageservices/force-close-handles

function forceCloseAllHandles(options?: FileForceCloseHandlesOptions): Promise<CloseHandlesInfo>

Parametrar

options: FileForceCloseHandlesOptions

Alternativ för att framtvinga en åtgärd för att stänga handtagen.

Returer

Promise<CloseHandlesInfo>

Framtvinga stängning av ett specifikt handtag för en fil.

Se https://docs.microsoft.com/en-us/rest/api/storageservices/force-close-handles

function forceCloseHandle(handleId: string, options?: FileForceCloseHandlesOptions): Promise<FileForceCloseHandlesResponse>

Parametrar

handleId: string

Specifikt referens-ID, kan inte vara asterisk "*". Använd forceCloseAllHandles() för att stänga alla handtag.

options: FileForceCloseHandlesOptions

Returer

Promise<FileForceCloseHandlesResponse>

Endast tillgängligt för klienter som skapats med en autentiseringsuppgift med delad nyckel.

Genererar en SAS-URI (Service Shared Access Signature) 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/constructing-a-service-sas

function generateSasUrl(options: FileGenerateSasUrlOptions): string

Parametrar

options: FileGenerateSasUrlOptions

Valfria parametrar.

Returer

string

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

Returnerar alla användardefinierade metadata, http-standardegenskaper och systemegenskaper för filen. Det returnerar inte innehållet i filen.

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

function getProperties(options?: FileGetPropertiesOptions): Promise<FileGetPropertiesResponse>

Parametrar

options: FileGetPropertiesOptions

Alternativ för åtgärden Hämta egenskaper för fil.

Returer

Promise<FileGetPropertiesResponse>

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

Returnerar listan över giltiga intervall för en fil.

function getRangeList(options?: FileGetRangeListOptions): Promise<FileGetRangeListResponse>

Parametrar

options: FileGetRangeListOptions

Alternativ för åtgärden Hämta intervalllista.

Returer

Promise<FileGetRangeListResponse>

Returnerar listan över intervall som skiljer sig mellan en tidigare resursögonblicksbild och den här filen.

function getRangeListDiff(prevShareSnapshot: string, options?: FileGetRangeListOptions): Promise<FileGetRangeListDiffResponse>

Parametrar

prevShareSnapshot: string

Den föregående ögonblicksbildsparametern är ett ogenomskinliga DateTime-värde som anger den tidigare resursögonblicksbilden att jämföra med.

options: FileGetRangeListOptions

Returer

Promise<FileGetRangeListDiffResponse>

Hämta en ShareLeaseClient som hanterar lån i filen.

function getShareLeaseClient(proposeLeaseId?: string): ShareLeaseClient

Parametrar

proposeLeaseId: string

Ursprungligt föreslaget låne-ID.

Returer

ShareLeaseClient

Ett nytt ShareLeaseClient-objekt för att hantera lån i filen.

Returnerar en iterabel iterator som kan asynkronas för att visa alla referenser. under det angivna kontot.

.byPage() returnerar en itererbar iterator som kan asynkroniseras för att visa referenser på sidor.

function listHandles(options?: FileListHandlesOptions): PagedAsyncIterableIterator<HandleItem, FileListHandlesResponse, PageSettings>

Parametrar

options: FileListHandlesOptions

Alternativ för att lista hanterar åtgärden.

En asyncIterableIterator som stöder växling.

Returer

PagedAsyncIterableIterator<HandleItem, FileListHandlesResponse, PageSettings>

Byter namn på en fil. Det här API:et stöder endast namnbyte av en fil i samma resurs.

function rename(destinationPath: string, options?: FileRenameOptions): Promise<{ destinationFileClient: ShareFileClient, fileRenameResponse: FileRenameResponse }>

Parametrar

destinationPath: string

Anger målsökvägen som du vill byta namn på till. Sökvägen kodas för att placeras i en URL för att ange målet.

options: FileRenameOptions

Alternativ för att byta namn.

Returer

Promise<{ destinationFileClient: ShareFileClient, fileRenameResponse: FileRenameResponse }>

Svarsdata för filbytesåtgärden.

Exempel på användning:


// Rename the file
await fileClient.rename(destinationPath);
console.log("Renamed file successfully!");

Ändra storlek på filen.

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

function resize(length: number, options?: FileResizeOptions): Promise<FileSetHTTPHeadersResponse>

Parametrar

length: number

Ändrar storlek på en fil till den angivna storleken i byte. Om det angivna bytevärdet är mindre än filens aktuella storlek rensas alla intervall ovanför det angivna bytevärdet.

options: FileResizeOptions

Alternativ för filstorleksåtgärd.

Returer

Promise<FileSetHTTPHeadersResponse>

Svarsdata för åtgärden Http-huvuden för filuppsättningar.

Anger HTTP-huvuden i filen.

Om inget alternativ anges, eller inget värde som anges för filens HTTP-huvuden i alternativen, rensas dessa HTTP-huvuden utan ett värde.

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

function setHttpHeaders(fileHttpHeaders?: FileHttpHeaders, options?: FileSetHttpHeadersOptions): Promise<FileSetHTTPHeadersResponse>

Parametrar

fileHttpHeaders: FileHttpHeaders

options: FileSetHttpHeadersOptions

Alternativ för åtgärden Ange HTTP-huvuden.

Returer

Promise<FileSetHTTPHeadersResponse>

Svarsdata för åtgärden Http-huvuden för filuppsättningar.

Uppdaterar användardefinierade metadata för den angivna filen.

Om inga metadata definieras i alternativparametern tas filmetadata bort.

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

function setMetadata(metadata?: Metadata, options?: FileSetMetadataOptions): Promise<FileSetMetadataResponse>

Parametrar

metadata: Metadata

Om inga metadata anges tas alla befintliga katalogmetadata bort

options: FileSetMetadataOptions

Alternativ för åtgärden Filuppsättningsmetadata.

Returer

Promise<FileSetMetadataResponse>

Svarsdata för åtgärden Filuppsättningsmetadata.

Anger egenskaper för filen.

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

function setProperties(properties?: FileProperties): Promise<SetPropertiesResponse>

Parametrar

properties: FileProperties

Filegenskaper. För HTTP-filhuvuden (t.ex. innehållstyp) tas befintliga HTTP-huvuden bort om inga värden anges. För andra filegenskaper(t.ex. fileAttributes) bevaras befintliga värden om inga värden anges.

Returer

Promise<SetPropertiesResponse>

Kopierar en blob eller fil till en målfil i lagringskontot.

function startCopyFromURL(copySource: string, options?: FileStartCopyOptions): Promise<FileStartCopyResponse>

Parametrar

copySource: string

Anger URL:en för källfilen eller bloben, upp till 2 kB. Om du vill kopiera en fil till en annan fil i samma lagringskonto kan du använda delad nyckel för att autentisera källfilen. Om du kopierar en fil från ett annat lagringskonto, eller om du kopierar en blob från samma lagringskonto eller ett annat lagringskonto, måste du autentisera källfilen eller bloben med en signatur för delad åtkomst. Om källan är en offentlig blob krävs ingen autentisering för att utföra kopieringsåtgärden. En fil i en resursögonblicksbild kan också anges som en kopieringskälla.

options: FileStartCopyOptions

Alternativ för åtgärden Starta kopiering av fil.

Returer

Promise<FileStartCopyResponse>

Skapar en ny Azure-fil eller ersätter en befintlig Azure-fil och laddar sedan upp en Buffer(Node)/Blob/ArrayBuffer/ArrayBufferView till den.

function uploadData(data: Blob | ArrayBuffer | ArrayBufferView | Buffer, options?: FileParallelUploadOptions): Promise<void>

Parametrar

data: Blob | ArrayBuffer | ArrayBufferView | Buffer

Buffer(Node), Blob, ArrayBuffer eller ArrayBufferView

options: FileParallelUploadOptions

Returer

Promise<void>

ENDAST TILLGÄNGLIGT I NODE.JS RUNTIME.

Skapar en ny Azure-fil eller ersätter en befintlig Azure-fil och laddar sedan upp en lokal fil till den.

function uploadFile(filePath: string, options?: FileParallelUploadOptions): Promise<void>

Parametrar

filePath: string

Fullständig sökväg till lokal fil

options: FileParallelUploadOptions

Returer

Promise<void>

Ladda upp ett byteintervall till en fil. Den här åtgärden kan bara anropas på en befintlig fil. Det ändrar inte filens storlek, egenskaper eller metadata. Både start och antal för intervallet måste anges. Intervallet kan vara upp till 4 MB stort.

function uploadRange(body: RequestBodyType, offset: number, contentLength: number, options?: FileUploadRangeOptions): Promise<FileUploadRangeResponse>

Parametrar

body: HttpRequestBody

Blob, sträng, ArrayBuffer, ArrayBufferView eller en funktion som returnerar en ny läsbar ström vars förskjutning är från början av datakällan.

offset: number

Förskjutningsposition för målets Azure-fil som ska laddas upp.

contentLength: number

Längd på brödtext i byte. Använd Buffer.byteLength() för att beräkna brödtextlängden för en sträng, inklusive icke-Base64/Hex-kodade tecken.

options: FileUploadRangeOptions

Alternativ för åtgärden Filuppladdningsintervall.

Returer

Promise<FileUploadRangeResponse>

Svarsdata för åtgärden Filuppladdningsintervall.

Exempel på användning:

const content = "Hello world!";

// Create the file
await fileClient.create(content.length);
console.log("Created file successfully!");

// Then upload data to the file
await fileClient.uploadRange(content, 0, content.length);
console.log("Updated file successfully!")

Ladda upp ett byteintervall till en fil där innehållet läse från en annan fils URL. Intervallet kan vara upp till 4 MB stort.

function uploadRangeFromURL(sourceURL: string, sourceOffset: number, destOffset: number, count: number, options?: FileUploadRangeFromURLOptions): Promise<FileUploadRangeFromURLResponse>

Parametrar

sourceURL: string

Ange en URL till kopieringskällan, signatur för delad åtkomst (SAS) som kanske behövs för autentisering.

sourceOffset: number

Källförskjutningen att kopiera från. Skicka 0 för att kopiera från början av källfilen.

destOffset: number

Förskjutning av målfilen.

count: number

Antal byte som ska laddas upp från källfilen.

options: FileUploadRangeFromURLOptions

Alternativ för att konfigurera fil – Ladda upp intervall från URL-åtgärd.

Returer

Promise<FileUploadRangeFromURLResponse>

ENDAST TILLGÄNGLIGT I NODE.JS RUNTIME.

Accepterar en Node.js Läsbar dataströmfabrik och laddas upp i block till en Azure-fil. Den läsbara dataströmfabriken måste returnera en Node.js läsbar dataström från den definierade förskjutningen. Förskjutningen är förskjutningen i Azure-filen som ska laddas upp.

function uploadResetableStream(streamFactory: (offset: number, count?: number) => ReadableStream, size: number, options?: FileParallelUploadOptions): Promise<void>

Parametrar

streamFactory: (offset: number, count?: number) => ReadableStream

Returnerar en Node.js läsbar ström från den definierade förskjutningen

size: number

Storleken på Azure-filen

options: FileParallelUploadOptions

Returer

Promise<void>

ENDAST TILLGÄNGLIGT I WEBBLÄSARE.

Laddar upp ett blobobjekt i webbläsaren till en Azure-fil. Kräver en blobFactory som datakälla, som måste returnera ett Blob-objekt med den förskjutning och storlek som anges.

function uploadSeekableBlob(blobFactory: (offset: number, size: number) => Blob, size: number, options?: FileParallelUploadOptions): Promise<void>

Parametrar

blobFactory: (offset: number, size: number) => Blob

size: number

options: FileParallelUploadOptions

Returer

Promise<void>

ENDAST TILLGÄNGLIGT I NODE.JS RUNTIME.

Skapar en ny Azure-fil eller ersätter en befintlig Azure-fil och laddar sedan upp en Node.js läsbar dataström till den. Den här metoden försöker skapa en Azure-fil och börjar sedan ladda upp segment för segment. Storleken på segment definieras av bufferSize parametern. Kontrollera att den potentiella storleken på dataströmmen inte överskrider filstorleken.

TIPS FÖR PRESTANDAFÖRBÄTTRING:

HighWaterMark för indataströmmen är bättre att ange samma värde med bufferSize-parametern, vilket undviker buffer.concat()-åtgärder.

function uploadStream(stream: Readable, size: number, bufferSize: number, maxBuffers: number, options?: FileUploadStreamOptions): Promise<void>

Parametrar

stream: Readable

Node.js läsbar ström. Måste vara mindre eller lika med filstorleken.

size: number

Storleken på filen som ska skapas. Maximal tillåten storlek är 4 TB. Om det här värdet är större än strömstorleken kommer det att finnas tomma byte i filsvansen.

bufferSize: number

Storleken på varje buffert som allokerats i byte, även segment/intervallstorlek under den uppladdade filen. Storleken måste vara större än 0 och mindre än eller lika med 4 * 1024 * 1024 (4 MB)

maxBuffers: number

Maximalt antal buffertar allokeras under uppladdning, positiv korrelation med maximal samtidighet vid uppladdning

options: FileUploadStreamOptions

Returer

Promise<void>

Skapar ett nytt ShareFileClient-objekt som är identiskt med källan men med den angivna tidsstämpeln för resursögonblicksbilder. Ange "" tar bort ögonblicksbilden och returnerar en URL till den grundläggande ShareFileClient.

function withShareSnapshot(shareSnapshot: string): ShareFileClient

Parametrar

shareSnapshot: string

Tidsstämpeln för resursögonblicksbilden.

Returer

ShareFileClient

Ett nytt ShareFileClient-objekt som är identiskt med källan men med den angivna tidsstämpeln för resursögonblicksbilden.

Dela via

ShareFileClient class

Konstruktorer

Egenskaper

Ärvda egenskaper

Metoder

Konstruktorinformation

ShareFileClient(string, Credential_2 | TokenCredential, ShareClientOptions)

Parametrar

ShareFileClient(string, Pipeline, ShareClientConfig)

Parametrar

Egenskapsinformation

name

Egenskapsvärde

path

Egenskapsvärde

shareName

Egenskapsvärde

Information om ärvda egenskaper

accountName

Egenskapsvärde

url

Egenskapsvärde

Metodinformation

abortCopyFromURL(string, FileAbortCopyFromURLOptions)

Parametrar

Returer

clearRange(number, number, FileClearRangeOptions)

Parametrar

Returer

create(number, FileCreateOptions)

Parametrar

Returer

delete(FileDeleteOptions)

Parametrar

Returer

deleteIfExists(FileDeleteOptions)

Parametrar

Returer

download(number, number, FileDownloadOptions)

Parametrar

Returer

downloadToBuffer(Buffer, number, number, FileDownloadToBufferOptions)

Parametrar

Returer

downloadToBuffer(number, number, FileDownloadToBufferOptions)

Parametrar

Returer

downloadToFile(string, number, number, FileDownloadOptions)

Parametrar

Returer

exists(FileExistsOptions)

Parametrar

Returer

forceCloseAllHandles(FileForceCloseHandlesOptions)

Parametrar

Returer

forceCloseHandle(string, FileForceCloseHandlesOptions)

Parametrar

Returer

generateSasUrl(FileGenerateSasUrlOptions)

Parametrar

Returer

getProperties(FileGetPropertiesOptions)

Parametrar

Returer

getRangeList(FileGetRangeListOptions)

Parametrar

Returer

getRangeListDiff(string, FileGetRangeListOptions)

Parametrar

Returer

getShareLeaseClient(string)

Parametrar

Returer

listHandles(FileListHandlesOptions)

Parametrar

Returer

rename(string, FileRenameOptions)

Parametrar