Partager via


DataLakeFileSystemClient class

Un DataLakeFileSystemClient représente une URL du système de fichiers stockage Azure qui vous permet de manipuler ses répertoires et fichiers.

Extends

StorageClient

Constructeurs

DataLakeFileSystemClient(string, Pipeline)

Crée une instance de DataLakeFileSystemClient à partir de l’URL et du pipeline.

DataLakeFileSystemClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

Crée une instance de DataLakeFileSystemClient à partir de l’URL et des informations d’identification.

Propriétés

name

Nom du système de fichiers actuel.

Propriétés héritées

accountName
credential

Par exemple, AnonymousCredential, StorageSharedKeyCredential ou toutes les informations d’identification du @azure/identity package pour authentifier les demandes adressées au service. Vous pouvez également fournir un objet qui implémente l’interface TokenCredential. S’il n’est pas spécifié, AnonymousCredential est utilisé.

url

Valeur de chaîne d’URL encodée.

Méthodes

create(FileSystemCreateOptions)

Crée un système de fichiers sous le compte spécifié. Si le système de fichiers portant le même nom existe déjà, l’opération échoue.

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

createIfNotExists(FileSystemCreateOptions)

Crée un système de fichiers sous le compte spécifié. Si le système de fichiers portant le même nom existe déjà, il n’est pas modifié.

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

delete(FileSystemDeleteOptions)

Supprimez le système de fichiers actuel.

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/delete-container

deleteIfExists(FileSystemDeleteOptions)

Supprimez le système de fichiers actuel s’il existe.

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/delete-container

exists(FileSystemExistsOptions)

Retourne true si le système de fichiers représenté par ce client existe ; false dans le cas contraire.

REMARQUE : utilisez cette fonction avec soin, car un système de fichiers existant peut être supprimé par d’autres clients ou applications. Inversement, un nouveau système de fichiers portant le même nom peut être ajouté par d’autres clients ou applications une fois cette fonction terminée.

generateSasUrl(FileSystemGenerateSasUrlOptions)

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

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

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas

getAccessPolicy(FileSystemGetAccessPolicyOptions)

Obtient les autorisations pour le système de fichiers spécifié. Les autorisations indiquent si les données du système de fichiers sont accessibles publiquement.

AVERTISSEMENT : JavaScript Date risque de perdre la précision lors de l’analyse commenceOn et expire Des chaînes De données. Par exemple, new Date(« 2018-12-31T03:44:23.8827891Z »). toISOString() obtient « 2018-12-31T03:44:23.882Z ».

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/get-container-acl

getDataLakeLeaseClient(string)

Obtenez un DataLakeLeaseClient qui gère les baux sur le système de fichiers.

getDirectoryClient(string)

Crée un objet DataLakeDirectoryClient sous le système de fichiers actuel.

getFileClient(string)

Crée un objet DataLakeFileClient sous le système de fichiers actuel.

getProperties(FileSystemGetPropertiesOptions)

Retourne toutes les métadonnées et propriétés système définies par l’utilisateur pour le système de fichiers spécifié.

AVERTISSEMENT : L’objet metadata retourné dans la réponse aura ses clés en minuscules, même si elles contenaient à l’origine des caractères majuscules. Cela diffère des clés de métadonnées retournées par la listFileSystems méthode de DataLakeServiceClient à l’aide de l’option includeMetadata , qui conserve leur casse d’origine.

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

listDeletedPaths(ListDeletedPathsOptions)

Retourne un itérateur asynchrone itérable pour répertorier tous les chemins d’accès (répertoires et fichiers) sous le système de fichiers spécifié.

.byPage() retourne un itérateur asynchrone itérable pour répertorier les chemins d’accès dans les pages.

Exemple utilisant la for await syntaxe :

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

Exemple utilisant 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();
}

Exemple utilisant 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}`);
  }
}

Exemple d’utilisation de la pagination avec un marqueur :

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

Voir https://docs.microsoft.com/rest/api/storageservices/list-blobs

listPaths(ListPathsOptions)

Retourne un itérateur asynchrone itérable pour répertorier tous les chemins d’accès (répertoires et fichiers) sous le système de fichiers spécifié.

.byPage() retourne un itérateur asynchrone itérable pour répertorier les chemins d’accès dans les pages.

Exemple utilisant la for await syntaxe :

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

Exemple utilisant 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();
}

Exemple utilisant 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}`);
  }
}

Exemple d’utilisation de la pagination avec un marqueur :

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

Voir https://docs.microsoft.com/rest/api/storageservices/list-blobs

setAccessPolicy(PublicAccessType, SignedIdentifier<AccessPolicy>[], FileSystemSetAccessPolicyOptions)

Définit les autorisations pour le système de fichiers spécifié. Les autorisations indiquent si les répertoires ou les fichiers d’un système de fichiers peuvent être accessibles publiquement.

Lorsque vous définissez des autorisations pour un système de fichiers, les autorisations existantes sont remplacées. Si aucun accès ou containerAcl n’est fourni, la liste de contrôle d’accès du système de fichiers existante est supprimée.

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/set-container-acl

setMetadata(Metadata, FileSystemSetMetadataOptions)

Définit une ou plusieurs paires nom-valeur définies par l’utilisateur pour le système de fichiers spécifié.

Si aucune option n’est fournie ou si aucune métadonnées n’est définie dans le paramètre , les métadonnées du système de fichiers sont supprimées.

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/set-container-metadata

undeletePath(string, string, FileSystemUndeletePathOption)

Restaure un chemin supprimé de manière réversible.

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/undelete-blob

Détails du constructeur

DataLakeFileSystemClient(string, Pipeline)

Crée une instance de DataLakeFileSystemClient à partir de l’URL et du pipeline.

new DataLakeFileSystemClient(url: string, pipeline: Pipeline)

Paramètres

url

string

Chaîne cliente pointant vers le système de fichiers de lac de données stockage Azure, telle que « https://myaccount.dfs.core.windows.net/filesystem". Vous pouvez ajouter une signature d’accès partagé si vous utilisez AnonymousCredential, par exemple «https://myaccount.dfs.core.windows.net/filesystem?sasString" ; ».

pipeline
Pipeline

Appelez newPipeline() pour créer un pipeline par défaut ou fournissez un pipeline personnalisé.

DataLakeFileSystemClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

Crée une instance de DataLakeFileSystemClient à partir de l’URL et des informations d’identification.

new DataLakeFileSystemClient(url: string, credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: StoragePipelineOptions)

Paramètres

url

string

Chaîne cliente pointant vers le système de fichiers de lac de données stockage Azure, telle que « https://myaccount.dfs.core.windows.net/filesystem". Vous pouvez ajouter une signature d’accès partagé si vous utilisez AnonymousCredential, par exemple «https://myaccount.dfs.core.windows.net/filesystem?sasString" ; ».

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Par exemple, AnonymousCredential, StorageSharedKeyCredential ou toutes les informations d’identification du @azure/identity package pour authentifier les demandes adressées au service. Vous pouvez également fournir un objet qui implémente l’interface TokenCredential. S’il n’est pas spécifié, AnonymousCredential est utilisé.

options
StoragePipelineOptions

Optionnel. Options pour configurer le pipeline HTTP.

Détails de la propriété

name

Nom du système de fichiers actuel.

string name

Valeur de propriété

string

Détails de la propriété héritée

accountName

accountName: string

Valeur de propriété

string

Hérité de StorageClient.accountName

credential

Par exemple, AnonymousCredential, StorageSharedKeyCredential ou toutes les informations d’identification du @azure/identity package pour authentifier les demandes adressées au service. Vous pouvez également fournir un objet qui implémente l’interface TokenCredential. S’il n’est pas spécifié, AnonymousCredential est utilisé.

credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Valeur de propriété

Hérité de StorageClient.credential

url

Valeur de chaîne d’URL encodée.

url: string

Valeur de propriété

string

Hérité de StorageClient.url

Détails de la méthode

create(FileSystemCreateOptions)

Crée un système de fichiers sous le compte spécifié. Si le système de fichiers portant le même nom existe déjà, l’opération échoue.

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

function create(options?: FileSystemCreateOptions): Promise<FileSystemCreateResponse>

Paramètres

options
FileSystemCreateOptions

Optionnel. Options lors de la création d’un système de fichiers.

Retours

createIfNotExists(FileSystemCreateOptions)

Crée un système de fichiers sous le compte spécifié. Si le système de fichiers portant le même nom existe déjà, il n’est pas modifié.

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

function createIfNotExists(options?: FileSystemCreateOptions): Promise<FileSystemCreateIfNotExistsResponse>

Paramètres

Retours

delete(FileSystemDeleteOptions)

Supprimez le système de fichiers actuel.

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/delete-container

function delete(options?: FileSystemDeleteOptions): Promise<FileSystemDeleteResponse>

Paramètres

options
FileSystemDeleteOptions

Optionnel. Options lors de la suppression du système de fichiers.

Retours

deleteIfExists(FileSystemDeleteOptions)

Supprimez le système de fichiers actuel s’il existe.

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/delete-container

function deleteIfExists(options?: FileSystemDeleteOptions): Promise<FileSystemDeleteIfExistsResponse>

Paramètres

Retours

exists(FileSystemExistsOptions)

Retourne true si le système de fichiers représenté par ce client existe ; false dans le cas contraire.

REMARQUE : utilisez cette fonction avec soin, car un système de fichiers existant peut être supprimé par d’autres clients ou applications. Inversement, un nouveau système de fichiers portant le même nom peut être ajouté par d’autres clients ou applications une fois cette fonction terminée.

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

Paramètres

Retours

Promise<boolean>

generateSasUrl(FileSystemGenerateSasUrlOptions)

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

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

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas

function generateSasUrl(options: FileSystemGenerateSasUrlOptions): Promise<string>

Paramètres

options
FileSystemGenerateSasUrlOptions

Paramètres facultatifs.

Retours

Promise<string>

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

getAccessPolicy(FileSystemGetAccessPolicyOptions)

Obtient les autorisations pour le système de fichiers spécifié. Les autorisations indiquent si les données du système de fichiers sont accessibles publiquement.

AVERTISSEMENT : JavaScript Date risque de perdre la précision lors de l’analyse commenceOn et expire Des chaînes De données. Par exemple, new Date(« 2018-12-31T03:44:23.8827891Z »). toISOString() obtient « 2018-12-31T03:44:23.882Z ».

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/get-container-acl

function getAccessPolicy(options?: FileSystemGetAccessPolicyOptions): Promise<FileSystemGetAccessPolicyResponse>

Paramètres

options
FileSystemGetAccessPolicyOptions

Optionnel. Options lors de l’obtention de la stratégie d’accès au système de fichiers.

Retours

getDataLakeLeaseClient(string)

Obtenez un DataLakeLeaseClient qui gère les baux sur le système de fichiers.

function getDataLakeLeaseClient(proposeLeaseId?: string): DataLakeLeaseClient

Paramètres

proposeLeaseId

string

Optionnel. ID de bail initial proposé.

Retours

getDirectoryClient(string)

Crée un objet DataLakeDirectoryClient sous le système de fichiers actuel.

function getDirectoryClient(directoryName: string): DataLakeDirectoryClient

Paramètres

directoryName

string

Retours

getFileClient(string)

Crée un objet DataLakeFileClient sous le système de fichiers actuel.

function getFileClient(fileName: string): DataLakeFileClient

Paramètres

fileName

string

Retours

getProperties(FileSystemGetPropertiesOptions)

Retourne toutes les métadonnées et propriétés système définies par l’utilisateur pour le système de fichiers spécifié.

AVERTISSEMENT : L’objet metadata retourné dans la réponse aura ses clés en minuscules, même si elles contenaient à l’origine des caractères majuscules. Cela diffère des clés de métadonnées retournées par la listFileSystems méthode de DataLakeServiceClient à l’aide de l’option includeMetadata , qui conserve leur casse d’origine.

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

function getProperties(options?: FileSystemGetPropertiesOptions): Promise<FileSystemGetPropertiesResponse>

Paramètres

options
FileSystemGetPropertiesOptions

Optionnel. Options lors de l’obtention des propriétés du système de fichiers.

Retours

listDeletedPaths(ListDeletedPathsOptions)

Retourne un itérateur asynchrone itérable pour répertorier tous les chemins d’accès (répertoires et fichiers) sous le système de fichiers spécifié.

.byPage() retourne un itérateur asynchrone itérable pour répertorier les chemins d’accès dans les pages.

Exemple utilisant la for await syntaxe :

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

Exemple utilisant 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();
}

Exemple utilisant 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}`);
  }
}

Exemple d’utilisation de la pagination avec un marqueur :

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

Voir https://docs.microsoft.com/rest/api/storageservices/list-blobs

function listDeletedPaths(options?: ListDeletedPathsOptions): PagedAsyncIterableIterator<DeletedPath, FileSystemListDeletedPathsResponse, PageSettings>

Paramètres

options
ListDeletedPathsOptions

Optionnel. Options lors de la liste des chemins d’accès supprimés.

Retours

listPaths(ListPathsOptions)

Retourne un itérateur asynchrone itérable pour répertorier tous les chemins d’accès (répertoires et fichiers) sous le système de fichiers spécifié.

.byPage() retourne un itérateur asynchrone itérable pour répertorier les chemins d’accès dans les pages.

Exemple utilisant la for await syntaxe :

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

Exemple utilisant 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();
}

Exemple utilisant 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}`);
  }
}

Exemple d’utilisation de la pagination avec un marqueur :

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

Voir https://docs.microsoft.com/rest/api/storageservices/list-blobs

function listPaths(options?: ListPathsOptions): PagedAsyncIterableIterator<Path, FileSystemListPathsResponse, PageSettings>

Paramètres

options
ListPathsOptions

Optionnel. Options lors de la liste des chemins d’accès.

Retours

setAccessPolicy(PublicAccessType, SignedIdentifier<AccessPolicy>[], FileSystemSetAccessPolicyOptions)

Définit les autorisations pour le système de fichiers spécifié. Les autorisations indiquent si les répertoires ou les fichiers d’un système de fichiers peuvent être accessibles publiquement.

Lorsque vous définissez des autorisations pour un système de fichiers, les autorisations existantes sont remplacées. Si aucun accès ou containerAcl n’est fourni, la liste de contrôle d’accès du système de fichiers existante est supprimée.

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/set-container-acl

function setAccessPolicy(access?: PublicAccessType, fileSystemAcl?: SignedIdentifier<AccessPolicy>[], options?: FileSystemSetAccessPolicyOptions): Promise<FileSystemSetAccessPolicyResponse>

Paramètres

access
PublicAccessType

Optionnel. Niveau d’accès public aux données dans le système de fichiers.

fileSystemAcl

SignedIdentifier<AccessPolicy>[]

Optionnel. Tableau d’éléments ayant chacun un ID unique et des détails de la stratégie d’accès.

options
FileSystemSetAccessPolicyOptions

Optionnel. Options lors de la définition de la stratégie d’accès au système de fichiers.

Retours

setMetadata(Metadata, FileSystemSetMetadataOptions)

Définit une ou plusieurs paires nom-valeur définies par l’utilisateur pour le système de fichiers spécifié.

Si aucune option n’est fournie ou si aucune métadonnées n’est définie dans le paramètre , les métadonnées du système de fichiers sont supprimées.

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/set-container-metadata

function setMetadata(metadata?: Metadata, options?: FileSystemSetMetadataOptions): Promise<FileSystemSetMetadataResponse>

Paramètres

metadata
Metadata

Remplacez les métadonnées existantes par cette valeur. Si aucune valeur n’a été fournie, les métadonnées existantes seront supprimées.

options
FileSystemSetMetadataOptions

Optionnel. Options lors de la définition des métadonnées du système de fichiers.

Retours

undeletePath(string, string, FileSystemUndeletePathOption)

Restaure un chemin supprimé de manière réversible.

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/undelete-blob

function undeletePath(deletedPath: string, deletionId: string, options?: FileSystemUndeletePathOption): Promise<FileSystemUndeletePathResponse>

Paramètres

deletedPath

string

Obligatoire. Chemin d’accès du chemin supprimé.

deletionId

string

Obligatoire. ID de suppression associé au chemin d’accès supprimé de manière réversible.

Retours