DataLakeFileSystemClient class
DataLakeFileSystemClient představuje adresu URL systému souborů Azure Storage, který umožňuje manipulovat s jeho adresáři a soubory.
- Extends
-
StorageClient
Konstruktory
Data |
Vytvoří instanci DataLakeFileSystemClient z adresy URL a kanálu. |
Data |
Vytvoří instanci DataLakeFileSystemClient z adresy URL a přihlašovacích údajů. |
Vlastnosti
name | Název aktuálního systému souborů |
Zděděné vlastnosti
account |
|
credential | Například AnonymousCredential, StorageSharedKeyCredential nebo jakékoli přihlašovací údaje z balíčku |
url | Zakódovaná hodnota řetězce adresy URL. |
Metody
create(File |
Vytvoří nový systém souborů v rámci zadaného účtu. Pokud již systém souborů se stejným názvem existuje, operace selže. Viz https://docs.microsoft.com/en-us/rest/api/storageservices/create-container |
create |
Vytvoří nový systém souborů v rámci zadaného účtu. Pokud již systém souborů se stejným názvem existuje, nezmění se. Viz https://docs.microsoft.com/en-us/rest/api/storageservices/create-container |
delete(File |
Odstraňte aktuální systém souborů. Viz https://docs.microsoft.com/en-us/rest/api/storageservices/delete-container |
delete |
Pokud existuje, odstraňte aktuální systém souborů. Viz https://docs.microsoft.com/en-us/rest/api/storageservices/delete-container |
exists(File |
Vrátí hodnotu true, pokud systém souborů reprezentovaný tímto klientem existuje; jinak nepravda. POZNÁMKA: Tuto funkci používejte opatrně, protože existující systém souborů může být odstraněn jinými klienty nebo aplikacemi. Po dokončení této funkce může být nový systém souborů se stejným názvem přidán jinými klienty nebo aplikacemi. |
generate |
K dispozici pouze pro DataLakeFileSystemClient vytvořený s přihlašovacími údaji sdíleného klíče. Vygeneruje řetězec pro podepsání identifikátoru URI sdíleného přístupového podpisu služby (SAS) na základě vlastností klienta a parametrů předaných. Sas je podepsán přihlašovacími údaji sdíleného klíče klienta. Viz https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas |
generate |
K dispozici pouze pro DataLakeFileSystemClient vytvořený s přihlašovacími údaji sdíleného klíče. Vygeneruje identifikátor URI sdíleného přístupového podpisu (SAS) služby na základě vlastností klienta a parametrů předaných. Sas je podepsán přihlašovacími údaji sdíleného klíče klienta. Viz https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas |
generate |
Vygeneruje řetězec pro podepsání identifikátoru URI sdíleného přístupového podpisu služby (SAS) na základě vlastností klienta a parametrů předaných. SAS je podepsán vstupním klíčem delegování uživatele. Viz https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas |
generate |
Vygeneruje identifikátor URI sdíleného přístupového podpisu (SAS) služby na základě vlastností klienta a parametrů předaných. SAS je podepsán vstupním klíčem delegování uživatele. Viz https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas |
get |
Získá oprávnění pro zadaný systém souborů. Oprávnění indikují, jestli se k datům systému souborů může přistupovat veřejně. UPOZORNĚNÍ: JavaScript Date může přijít o přesnost při analýze startOn a vypršení platnosti řetězcůOn. Například nové datum("2018-12-31T03:44:23.8827891Z"). toISOString() získá "2018-12-31T03:44:23.882Z". Viz https://docs.microsoft.com/en-us/rest/api/storageservices/get-container-acl |
get |
Získejte DataLakeLeaseClient, který spravuje zapůjčení v systému souborů. |
get |
Vytvoří objekt DataLakeDirectoryClient v aktuálním systému souborů. |
get |
Vytvoří objekt DataLakeFileClient v aktuálním systému souborů. |
get |
Vrátí všechna uživatelsky definovaná metadata a systémové vlastnosti pro zadaný systém souborů. UPOZORNĚNÍ: Objekt Viz https://docs.microsoft.com/en-us/rest/api/storageservices/get-container-properties |
list |
Vrátí asynchronní iterátor pro výpis všech cest (adresářů a souborů) v zadaném systému souborů. .byPage() vrátí asynchronní iterátor pro výpis cest na stránkách. Příklad použití syntaxe
Příklad použití
Příklad použití
Příklad použití stránkování se značkou:
Viz https://docs.microsoft.com/rest/api/storageservices/list-blobs |
list |
Vrátí asynchronní iterátor pro výpis všech cest (adresářů a souborů) v zadaném systému souborů. .byPage() vrátí asynchronní iterátor pro výpis cest na stránkách. Příklad použití syntaxe
Příklad použití
Příklad použití
Příklad použití stránkování se značkou:
Viz https://docs.microsoft.com/rest/api/storageservices/list-blobs |
set |
Nastaví oprávnění pro zadaný systém souborů. Oprávnění označují, jestli se k adresářům nebo souborům v systému souborů může přistupovat veřejně. Když nastavíte oprávnění pro systém souborů, nahradí se stávající oprávnění. Pokud není k dispozici žádný přístup nebo seznam ContainerAcl, odebere se stávající seznam ACL systému souborů. Viz https://docs.microsoft.com/en-us/rest/api/storageservices/set-container-acl |
set |
Nastaví jeden nebo více uživatelsky definovaných párů name-value pro zadaný systém souborů. Pokud není k dispozici žádná možnost nebo v parametru nejsou definována žádná metadata, odeberou se metadata systému souborů. Viz https://docs.microsoft.com/en-us/rest/api/storageservices/set-container-metadata |
undelete |
Obnoví obnovitelně odstraněnou cestu. Viz https://docs.microsoft.com/en-us/rest/api/storageservices/undelete-blob |
Podrobnosti konstruktoru
DataLakeFileSystemClient(string, Pipeline)
Vytvoří instanci DataLakeFileSystemClient z adresy URL a kanálu.
new DataLakeFileSystemClient(url: string, pipeline: Pipeline)
Parametry
- url
-
string
Klientský řetězec odkazující na systém souborů Azure Storage Data Lake, například "https://myaccount.dfs.core.windows.net/filesystem". Sas můžete připojit, pokud používáte AnonymousCredential, například "https://myaccount.dfs.core.windows.net/filesystem?sasString".
- pipeline
- Pipeline
Voláním metody newPipeline() vytvořte výchozí kanál nebo zadejte přizpůsobený kanál.
DataLakeFileSystemClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)
Vytvoří instanci DataLakeFileSystemClient z adresy URL a přihlašovacích údajů.
new DataLakeFileSystemClient(url: string, credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: StoragePipelineOptions)
Parametry
- url
-
string
Klientský řetězec odkazující na systém souborů Azure Storage Data Lake, například "https://myaccount.dfs.core.windows.net/filesystem". Sas můžete připojit, pokud používáte AnonymousCredential, například "https://myaccount.dfs.core.windows.net/filesystem?sasString".
- credential
-
StorageSharedKeyCredential | AnonymousCredential | TokenCredential
Například AnonymousCredential, StorageSharedKeyCredential nebo jakékoli přihlašovací údaje z balíčku @azure/identity
k ověření požadavků na službu. Můžete také poskytnout objekt, který implementuje TokenCredential rozhraní. Pokud není zadáno, použije se anonymnícredential.
- options
- StoragePipelineOptions
Volitelný. Možnosti konfigurace kanálu HTTP
Podrobnosti vlastnosti
name
Název aktuálního systému souborů
string name
Hodnota vlastnosti
string
Podrobnosti zděděných vlastností
accountName
accountName: string
Hodnota vlastnosti
string
zděděno ze StorageClient.accountName
credential
Například AnonymousCredential, StorageSharedKeyCredential nebo jakékoli přihlašovací údaje z balíčku @azure/identity
k ověření požadavků na službu. Můžete také poskytnout objekt, který implementuje TokenCredential rozhraní. Pokud není zadáno, použije se anonymnícredential.
credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential
Hodnota vlastnosti
zděděné z StorageClient.credential
url
Zakódovaná hodnota řetězce adresy URL.
url: string
Hodnota vlastnosti
string
zděděno ze StorageClient.url
Podrobnosti metody
create(FileSystemCreateOptions)
Vytvoří nový systém souborů v rámci zadaného účtu. Pokud již systém souborů se stejným názvem existuje, operace selže.
Viz https://docs.microsoft.com/en-us/rest/api/storageservices/create-container
function create(options?: FileSystemCreateOptions): Promise<FileSystemCreateResponse>
Parametry
- options
- FileSystemCreateOptions
Volitelný. Možnosti při vytváření systému souborů
Návraty
Promise<FileSystemCreateResponse>
createIfNotExists(FileSystemCreateOptions)
Vytvoří nový systém souborů v rámci zadaného účtu. Pokud již systém souborů se stejným názvem existuje, nezmění se.
Viz https://docs.microsoft.com/en-us/rest/api/storageservices/create-container
function createIfNotExists(options?: FileSystemCreateOptions): Promise<FileSystemCreateIfNotExistsResponse>
Parametry
- options
- FileSystemCreateOptions
Návraty
Promise<FileSystemCreateIfNotExistsResponse>
delete(FileSystemDeleteOptions)
Odstraňte aktuální systém souborů.
Viz https://docs.microsoft.com/en-us/rest/api/storageservices/delete-container
function delete(options?: FileSystemDeleteOptions): Promise<FileSystemDeleteResponse>
Parametry
- options
- FileSystemDeleteOptions
Volitelný. Možnosti při odstraňování systému souborů
Návraty
Promise<FileSystemDeleteResponse>
deleteIfExists(FileSystemDeleteOptions)
Pokud existuje, odstraňte aktuální systém souborů.
Viz https://docs.microsoft.com/en-us/rest/api/storageservices/delete-container
function deleteIfExists(options?: FileSystemDeleteOptions): Promise<FileSystemDeleteIfExistsResponse>
Parametry
- options
- FileSystemDeleteOptions
Návraty
Promise<FileSystemDeleteIfExistsResponse>
exists(FileSystemExistsOptions)
Vrátí hodnotu true, pokud systém souborů reprezentovaný tímto klientem existuje; jinak nepravda.
POZNÁMKA: Tuto funkci používejte opatrně, protože existující systém souborů může být odstraněn jinými klienty nebo aplikacemi. Po dokončení této funkce může být nový systém souborů se stejným názvem přidán jinými klienty nebo aplikacemi.
function exists(options?: FileSystemExistsOptions): Promise<boolean>
Parametry
- options
- FileSystemExistsOptions
Návraty
Promise<boolean>
generateSasStringToSign(FileSystemGenerateSasUrlOptions)
K dispozici pouze pro DataLakeFileSystemClient vytvořený s přihlašovacími údaji sdíleného klíče.
Vygeneruje řetězec pro podepsání identifikátoru URI sdíleného přístupového podpisu služby (SAS) na základě vlastností klienta a parametrů předaných. Sas je podepsán přihlašovacími údaji sdíleného klíče klienta.
Viz https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
function generateSasStringToSign(options: FileSystemGenerateSasUrlOptions): string
Parametry
- options
- FileSystemGenerateSasUrlOptions
Volitelné parametry.
Návraty
string
Identifikátor URI SAS, který se skládá z identifikátoru URI pro prostředek reprezentovaný tímto klientem, následovaný vygenerovaným tokenem SAS.
generateSasUrl(FileSystemGenerateSasUrlOptions)
K dispozici pouze pro DataLakeFileSystemClient vytvořený s přihlašovacími údaji sdíleného klíče.
Vygeneruje identifikátor URI sdíleného přístupového podpisu (SAS) služby na základě vlastností klienta a parametrů předaných. Sas je podepsán přihlašovacími údaji sdíleného klíče klienta.
Viz https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
function generateSasUrl(options: FileSystemGenerateSasUrlOptions): Promise<string>
Parametry
- options
- FileSystemGenerateSasUrlOptions
Volitelné parametry.
Návraty
Promise<string>
Identifikátor URI SAS, který se skládá z identifikátoru URI pro prostředek reprezentovaný tímto klientem, následovaný vygenerovaným tokenem SAS.
generateUserDelegationSasStringToSign(FileSystemGenerateSasUrlOptions, UserDelegationKey)
Vygeneruje řetězec pro podepsání identifikátoru URI sdíleného přístupového podpisu služby (SAS) na základě vlastností klienta a parametrů předaných. SAS je podepsán vstupním klíčem delegování uživatele.
Viz https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
function generateUserDelegationSasStringToSign(options: FileSystemGenerateSasUrlOptions, userDelegationKey: UserDelegationKey): string
Parametry
- options
- FileSystemGenerateSasUrlOptions
Volitelné parametry.
- userDelegationKey
- UserDelegationKey
Návratová hodnota blobServiceClient.getUserDelegationKey()
Návraty
string
Identifikátor URI SAS, který se skládá z identifikátoru URI pro prostředek reprezentovaný tímto klientem, následovaný vygenerovaným tokenem SAS.
generateUserDelegationSasUrl(FileSystemGenerateSasUrlOptions, UserDelegationKey)
Vygeneruje identifikátor URI sdíleného přístupového podpisu (SAS) služby na základě vlastností klienta a parametrů předaných. SAS je podepsán vstupním klíčem delegování uživatele.
Viz https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
function generateUserDelegationSasUrl(options: FileSystemGenerateSasUrlOptions, userDelegationKey: UserDelegationKey): Promise<string>
Parametry
- options
- FileSystemGenerateSasUrlOptions
Volitelné parametry.
- userDelegationKey
- UserDelegationKey
Návratová hodnota blobServiceClient.getUserDelegationKey()
Návraty
Promise<string>
Identifikátor URI SAS, který se skládá z identifikátoru URI pro prostředek reprezentovaný tímto klientem, následovaný vygenerovaným tokenem SAS.
getAccessPolicy(FileSystemGetAccessPolicyOptions)
Získá oprávnění pro zadaný systém souborů. Oprávnění indikují, jestli se k datům systému souborů může přistupovat veřejně.
UPOZORNĚNÍ: JavaScript Date může přijít o přesnost při analýze startOn a vypršení platnosti řetězcůOn. Například nové datum("2018-12-31T03:44:23.8827891Z"). toISOString() získá "2018-12-31T03:44:23.882Z".
Viz https://docs.microsoft.com/en-us/rest/api/storageservices/get-container-acl
function getAccessPolicy(options?: FileSystemGetAccessPolicyOptions): Promise<FileSystemGetAccessPolicyResponse>
Parametry
- options
- FileSystemGetAccessPolicyOptions
Volitelný. Možnosti při získávání zásad přístupu k systému souborů
Návraty
Promise<FileSystemGetAccessPolicyResponse>
getDataLakeLeaseClient(string)
Získejte DataLakeLeaseClient, který spravuje zapůjčení v systému souborů.
function getDataLakeLeaseClient(proposeLeaseId?: string): DataLakeLeaseClient
Parametry
- proposeLeaseId
-
string
Volitelný. Počáteční navrhované ID zapůjčení
Návraty
getDirectoryClient(string)
Vytvoří objekt DataLakeDirectoryClient v aktuálním systému souborů.
function getDirectoryClient(directoryName: string): DataLakeDirectoryClient
Parametry
- directoryName
-
string
Návraty
getFileClient(string)
Vytvoří objekt DataLakeFileClient v aktuálním systému souborů.
function getFileClient(fileName: string): DataLakeFileClient
Parametry
- fileName
-
string
Návraty
getProperties(FileSystemGetPropertiesOptions)
Vrátí všechna uživatelsky definovaná metadata a systémové vlastnosti pro zadaný systém souborů.
UPOZORNĚNÍ: Objekt metadata
vrácený v odpovědi bude mít klíče malými písmeny, i když původně obsahovaly velké znaky. To se liší od klíčů metadat vrácených metodou listFileSystems
DataLakeServiceClient pomocí možnosti includeMetadata
, která zachová původní velikost skříně.
Viz https://docs.microsoft.com/en-us/rest/api/storageservices/get-container-properties
function getProperties(options?: FileSystemGetPropertiesOptions): Promise<FileSystemGetPropertiesResponse>
Parametry
- options
- FileSystemGetPropertiesOptions
Volitelný. Možnosti při získávání vlastností systému souborů
Návraty
Promise<FileSystemGetPropertiesResponse>
listDeletedPaths(ListDeletedPathsOptions)
Vrátí asynchronní iterátor pro výpis všech cest (adresářů a souborů) v zadaném systému souborů.
.byPage() vrátí asynchronní iterátor pro výpis cest na stránkách.
Příklad použití syntaxe for await
:
// Get the fileSystemClient before you run these snippets,
// Can be obtained from `serviceClient.getFileSystemClient("<your-filesystem-name>");`
let i = 1;
for await (const deletePath of fileSystemClient.listDeletedPaths()) {
console.log(`Path ${i++}: ${deletePath.name}`);
}
Příklad použití iter.next()
:
let i = 1;
let iter = fileSystemClient.listDeletedPaths();
let deletedPathItem = await iter.next();
while (!deletedPathItem.done) {
console.log(`Path ${i++}: ${deletedPathItem.value.name}`);
pathItem = await iter.next();
}
Příklad použití byPage()
:
// passing optional maxPageSize in the page settings
let i = 1;
for await (const response of fileSystemClient.listDeletedPaths().byPage({ maxPageSize: 20 })) {
for (const deletePath of response.pathItems) {
console.log(`Path ${i++}: ${deletePath.name}`);
}
}
Příklad použití stránkování se značkou:
let i = 1;
let iterator = fileSystemClient.listDeletedPaths().byPage({ maxPageSize: 2 });
let response = (await iterator.next()).value;
// Prints 2 path names
for (const path of response.pathItems) {
console.log(`Path ${i++}: ${path.name}}`);
}
// Gets next marker
let marker = response.continuationToken;
// Passing next marker as continuationToken
iterator = fileSystemClient.listDeletedPaths().byPage({ continuationToken: marker, maxPageSize: 10 });
response = (await iterator.next()).value;
// Prints 10 path names
for (const deletePath of response.deletedPathItems) {
console.log(`Path ${i++}: ${deletePath.name}`);
}
Viz https://docs.microsoft.com/rest/api/storageservices/list-blobs
function listDeletedPaths(options?: ListDeletedPathsOptions): PagedAsyncIterableIterator<DeletedPath, FileSystemListDeletedPathsResponse, PageSettings>
Parametry
- options
- ListDeletedPathsOptions
Volitelný. Možnosti při výpisu odstraněných cest
Návraty
listPaths(ListPathsOptions)
Vrátí asynchronní iterátor pro výpis všech cest (adresářů a souborů) v zadaném systému souborů.
.byPage() vrátí asynchronní iterátor pro výpis cest na stránkách.
Příklad použití syntaxe for await
:
// Get the fileSystemClient before you run these snippets,
// Can be obtained from `serviceClient.getFileSystemClient("<your-filesystem-name>");`
let i = 1;
for await (const path of fileSystemClient.listPaths()) {
console.log(`Path ${i++}: ${path.name}, isDirectory?: ${path.isDirectory}`);
}
Příklad použití iter.next()
:
let i = 1;
let iter = fileSystemClient.listPaths();
let pathItem = await iter.next();
while (!pathItem.done) {
console.log(`Path ${i++}: ${pathItem.value.name}, isDirectory?: ${pathItem.value.isDirectory}`);
pathItem = await iter.next();
}
Příklad použití byPage()
:
// passing optional maxPageSize in the page settings
let i = 1;
for await (const response of fileSystemClient.listPaths().byPage({ maxPageSize: 20 })) {
for (const path of response.pathItems) {
console.log(`Path ${i++}: ${path.name}, isDirectory?: ${path.isDirectory}`);
}
}
Příklad použití stránkování se značkou:
let i = 1;
let iterator = fileSystemClient.listPaths().byPage({ maxPageSize: 2 });
let response = (await iterator.next()).value;
// Prints 2 path names
for (const path of response.pathItems) {
console.log(`Path ${i++}: ${path.name}, isDirectory?: ${path.isDirectory}`);
}
// Gets next marker
let marker = response.continuationToken;
// Passing next marker as continuationToken
iterator = fileSystemClient.listPaths().byPage({ continuationToken: marker, maxPageSize: 10 });
response = (await iterator.next()).value;
// Prints 10 path names
for (const path of response.pathItems) {
console.log(`Path ${i++}: ${path.name}, isDirectory?: ${path.isDirectory}`);
}
Viz https://docs.microsoft.com/rest/api/storageservices/list-blobs
function listPaths(options?: ListPathsOptions): PagedAsyncIterableIterator<Path, FileSystemListPathsResponse, PageSettings>
Parametry
- options
- ListPathsOptions
Volitelný. Možnosti při výpisu cest
Návraty
setAccessPolicy(PublicAccessType, SignedIdentifier<AccessPolicy>[], FileSystemSetAccessPolicyOptions)
Nastaví oprávnění pro zadaný systém souborů. Oprávnění označují, jestli se k adresářům nebo souborům v systému souborů může přistupovat veřejně.
Když nastavíte oprávnění pro systém souborů, nahradí se stávající oprávnění. Pokud není k dispozici žádný přístup nebo seznam ContainerAcl, odebere se stávající seznam ACL systému souborů.
Viz https://docs.microsoft.com/en-us/rest/api/storageservices/set-container-acl
function setAccessPolicy(access?: PublicAccessType, fileSystemAcl?: SignedIdentifier<AccessPolicy>[], options?: FileSystemSetAccessPolicyOptions): Promise<FileSystemSetAccessPolicyResponse>
Parametry
- access
- PublicAccessType
Volitelný. Úroveň veřejného přístupu k datům v systému souborů.
- fileSystemAcl
Volitelný. Pole prvků, které mají jedinečné ID a podrobnosti o zásadách přístupu.
- options
- FileSystemSetAccessPolicyOptions
Volitelný. Možnosti při nastavování zásad přístupu k systému souborů
Návraty
Promise<FileSystemSetAccessPolicyResponse>
setMetadata(Metadata, FileSystemSetMetadataOptions)
Nastaví jeden nebo více uživatelsky definovaných párů name-value pro zadaný systém souborů.
Pokud není k dispozici žádná možnost nebo v parametru nejsou definována žádná metadata, odeberou se metadata systému souborů.
Viz https://docs.microsoft.com/en-us/rest/api/storageservices/set-container-metadata
function setMetadata(metadata?: Metadata, options?: FileSystemSetMetadataOptions): Promise<FileSystemSetMetadataResponse>
Parametry
- metadata
- Metadata
Nahraďte stávající metadata touto hodnotou. Pokud není zadaná žádná hodnota, stávající metadata se odeberou.
- options
- FileSystemSetMetadataOptions
Volitelný. Možnosti při nastavování metadat systému souborů
Návraty
Promise<FileSystemSetMetadataResponse>
undeletePath(string, string, FileSystemUndeletePathOption)
Obnoví obnovitelně odstraněnou cestu.
Viz https://docs.microsoft.com/en-us/rest/api/storageservices/undelete-blob
function undeletePath(deletedPath: string, deletionId: string, options?: FileSystemUndeletePathOption): Promise<FileSystemUndeletePathResponse>
Parametry
- deletedPath
-
string
Požadovaný. Cesta odstraněné cesty.
- deletionId
-
string
Požadovaný. ID odstranění přidružené k obnovitelně odstraněné cestě.
- options
- FileSystemUndeletePathOption
Návraty
Promise<FileSystemUndeletePathResponse>