Partager via


DataLakePathClient class

Un DataLakePathClient représente une URL vers le chemin d’accès au stockage Azure (répertoire ou fichier).

Extends

Constructeurs

DataLakePathClient(string, Pipeline)

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

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

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

Propriétés

fileSystemName

Nom du système de fichiers actuel.

name

Nom du chemin d’accès actuel (répertoire ou fichier).

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(PathResourceTypeModel, PathCreateOptions)

Créez un répertoire ou un chemin d’accès.

Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create

createIfNotExists(PathResourceTypeModel, PathCreateIfNotExistsOptions)

Créez un répertoire ou un fichier. Si la ressource existe déjà, elle n’est pas modifiée.

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

delete(boolean, PathDeleteOptions)

Supprimez le chemin actuel (répertoire ou fichier).

Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete

deleteIfExists(boolean, PathDeleteOptions)

Supprimez le chemin actuel (répertoire ou fichier) s’il existe.

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

exists(PathExistsOptions)

Retourne true si le fichier Data Lake représenté par ce client existe ; false dans le cas contraire. REMARQUE : utilisez cette fonction avec précaution, car un fichier existant peut être supprimé par d’autres clients ou applications. Inversement, de nouveaux fichiers peuvent être ajoutés par d’autres clients ou applications une fois cette fonction terminée.

getAccessControl(PathGetAccessControlOptions)

Retourne les données de contrôle d’accès d’un chemin d’accès (répertoire du fichier).

Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/getproperties

getDataLakeLeaseClient(string)

Obtenez un DataLakeLeaseClient qui gère les baux sur le chemin d’accès (répertoire ou fichier).

getProperties(PathGetPropertiesOptions)

Retourne toutes les métadonnées définies par l’utilisateur, les propriétés HTTP standard et les propriétés système du chemin d’accès (répertoire ou fichier). 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 les méthodes de cette liste de chemins à l’aide de DataLakeFileSystemClient l’option includeMetadata , qui conservera leur casse d’origine.

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

move(string, PathMoveOptions)

Déplacer un répertoire ou un fichier dans le même système de fichiers.

Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create

move(string, string, PathMoveOptions)

Déplacer le répertoire ou le fichier vers un autre système de fichiers.

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

removeAccessControlRecursive(RemovePathAccessControlItem[], PathChangeAccessControlRecursiveOptions)

Supprime le Access Control sur un chemin d’accès et des sous-chemins.

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update

setAccessControl(PathAccessControlItem[], PathSetAccessControlOptions)

Définissez les données de contrôle d’accès pour un chemin d’accès (répertoire de fichier).

Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update

setAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)

Définit le Access Control sur un chemin d’accès et des sous-chemins.

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update

setHttpHeaders(PathHttpHeaders, PathSetHttpHeadersOptions)

Définit les propriétés système sur le chemin d’accès (répertoire ou fichier). Si aucune valeur n’est fournie ou aucune valeur fournie pour les en-têtes HTTP d’objet blob spécifiés, ces en-têtes HTTP blob sans valeur sont effacés.

Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties

setMetadata(Metadata, PathSetMetadataOptions)

Définit les métadonnées définies par l’utilisateur pour le chemin d’accès spécifié (répertoire du fichier) sous la forme d’une ou plusieurs paires nom-valeur. Si aucune option n’est fournie ou si aucune métadonnées n’est définie dans le paramètre, les métadonnées de chemin d’accès sont supprimées.

Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata

setPermissions(PathPermissions, PathSetPermissionsOptions)

Définit les autorisations de fichier sur un chemin d’accès.

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update

toDirectoryClient()

Convertissez DataLakePathClient actuel en DataLakeDirectoryClient si le chemin actuel est un répertoire.

toFileClient()

Convertissez DataLakePathClient actuel en DataLakeFileClient si le chemin actuel est un fichier.

updateAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)

Modifie le Access Control sur un chemin et des sous-chemins.

Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update

Détails du constructeur

DataLakePathClient(string, Pipeline)

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

new DataLakePathClient(url: string, pipeline: Pipeline)

Paramètres

url

string

Chaîne cliente pointant vers le chemin d’accès du lac de données stockage Azure (répertoire ou fichier), telle que «https://myaccount.dfs.core.windows.net/filesystem/directory" ; ou « https://myaccount.dfs.core.windows.net/filesystem/file". Vous pouvez ajouter une signature d’accès partagé si vous utilisez AnonymousCredential, par exemple «https://myaccount.dfs.core.windows.net/filesystem/directory?sasString" ; ».

pipeline
Pipeline

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

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

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

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

Paramètres

url

string

Chaîne cliente pointant vers le chemin d’accès du lac de données stockage Azure (répertoire ou fichier), telle que «https://myaccount.dfs.core.windows.net/filesystem/directory" ; ou « https://myaccount.dfs.core.windows.net/filesystem/file". Vous pouvez ajouter une signature d’accès partagé si vous utilisez AnonymousCredential, par exemple «https://myaccount.dfs.core.windows.net/filesystem/directory?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

facultatif. Options pour configurer le pipeline HTTP.

Détails de la propriété

fileSystemName

Nom du système de fichiers actuel.

string fileSystemName

Valeur de propriété

string

name

Nom du chemin d’accès actuel (répertoire ou fichier).

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é deStorageClient.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é deStorageClient.credential

url

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

url: string

Valeur de propriété

string

Hérité deStorageClient.url

Détails de la méthode

create(PathResourceTypeModel, PathCreateOptions)

Créez un répertoire ou un chemin d’accès.

Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create

function create(resourceType: PathResourceTypeModel, options?: PathCreateOptions): Promise<PathCreateResponse>

Paramètres

resourceType
PathResourceTypeModel

Type de ressource, « répertoire » ou « fichier ».

options
PathCreateOptions

facultatif. Options lors de la création du chemin d’accès.

Retours

createIfNotExists(PathResourceTypeModel, PathCreateIfNotExistsOptions)

Créez un répertoire ou un fichier. Si la ressource existe déjà, elle n’est pas modifiée.

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

function createIfNotExists(resourceType: PathResourceTypeModel, options?: PathCreateIfNotExistsOptions): Promise<PathCreateIfNotExistsResponse>

Paramètres

resourceType
PathResourceTypeModel

Type de ressource, « répertoire » ou « fichier ».

Retours

delete(boolean, PathDeleteOptions)

Supprimez le chemin actuel (répertoire ou fichier).

Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete

function delete(recursive?: boolean, options?: PathDeleteOptions): Promise<PathDeleteResponse>

Paramètres

recursive

boolean

Obligatoire et valide uniquement lorsque la ressource est un répertoire. Si « true », tous les chemins d’accès situés sous le répertoire seront supprimés.

options
PathDeleteOptions

facultatif. Options lors de la suppression du chemin d’accès.

Retours

deleteIfExists(boolean, PathDeleteOptions)

Supprimez le chemin actuel (répertoire ou fichier) s’il existe.

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

function deleteIfExists(recursive?: boolean, options?: PathDeleteOptions): Promise<PathDeleteIfExistsResponse>

Paramètres

recursive

boolean

Obligatoire et valide uniquement lorsque la ressource est un répertoire. Si « true », tous les chemins d’accès situés sous le répertoire seront supprimés.

Retours

exists(PathExistsOptions)

Retourne true si le fichier Data Lake représenté par ce client existe ; false dans le cas contraire. REMARQUE : utilisez cette fonction avec précaution, car un fichier existant peut être supprimé par d’autres clients ou applications. Inversement, de nouveaux fichiers peuvent être ajoutés par d’autres clients ou applications une fois cette fonction terminée.

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

Paramètres

options
PathExistsOptions

options de l’opération Exists.

Retours

Promise<boolean>

getAccessControl(PathGetAccessControlOptions)

Retourne les données de contrôle d’accès d’un chemin d’accès (répertoire du fichier).

Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/getproperties

function getAccessControl(options?: PathGetAccessControlOptions): Promise<PathGetAccessControlResponse>

Paramètres

options
PathGetAccessControlOptions

facultatif. Options lors de l’obtention du contrôle d’accès aux fichiers.

Retours

getDataLakeLeaseClient(string)

Obtenez un DataLakeLeaseClient qui gère les baux sur le chemin d’accès (répertoire ou fichier).

function getDataLakeLeaseClient(proposeLeaseId?: string): DataLakeLeaseClient

Paramètres

proposeLeaseId

string

facultatif. ID de bail initial proposé.

Retours

getProperties(PathGetPropertiesOptions)

Retourne toutes les métadonnées définies par l’utilisateur, les propriétés HTTP standard et les propriétés système du chemin d’accès (répertoire ou fichier). 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 les méthodes de cette liste de chemins à l’aide de DataLakeFileSystemClient l’option includeMetadata , qui conservera leur casse d’origine.

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

function getProperties(options?: PathGetPropertiesOptions): Promise<PathGetPropertiesResponse>

Paramètres

options
PathGetPropertiesOptions

facultatif. Options lors de l’obtention des propriétés de chemin d’accès.

Retours

move(string, PathMoveOptions)

Déplacer un répertoire ou un fichier dans le même système de fichiers.

Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create

function move(destinationPath: string, options?: PathMoveOptions): Promise<PathMoveResponse>

Paramètres

destinationPath

string

Chemin du répertoire de destination comme « répertoire » ou chemin de fichier « répertoire/fichier ». Si destinationPath est authentifié auprès de SAS, ajoutez la sap au chemin d’accès de destination, par exemple « répertoire/fichier?sasToken ».

options
PathMoveOptions

facultatif. Options lors du déplacement d’un répertoire ou d’un fichier.

Retours

Promise<PathMoveResponse>

move(string, string, PathMoveOptions)

Déplacer le répertoire ou le fichier vers un autre système de fichiers.

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

function move(destinationFileSystem: string, destinationPath: string, options?: PathMoveOptions): Promise<PathMoveResponse>

Paramètres

destinationFileSystem

string

Système de fichiers de destination comme « système de fichiers ».

destinationPath

string

Chemin du répertoire de destination comme « répertoire » ou chemin de fichier « répertoire/fichier » Si le destinationPath est authentifié auprès de la sap, ajoutez la sap au chemin de destination, comme « répertoire/fichier?sasToken ».

options
PathMoveOptions

facultatif. Options lors du déplacement d’un répertoire ou d’un fichier.

Retours

Promise<PathMoveResponse>

removeAccessControlRecursive(RemovePathAccessControlItem[], PathChangeAccessControlRecursiveOptions)

Supprime le Access Control sur un chemin d’accès et des sous-chemins.

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update

function removeAccessControlRecursive(acl: RemovePathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>

Paramètres

acl

RemovePathAccessControlItem[]

Liste de contrôle d’accès POSIX pour le fichier ou le répertoire.

options
PathChangeAccessControlRecursiveOptions

facultatif. Options

Retours

setAccessControl(PathAccessControlItem[], PathSetAccessControlOptions)

Définissez les données de contrôle d’accès pour un chemin d’accès (répertoire de fichier).

Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update

function setAccessControl(acl: PathAccessControlItem[], options?: PathSetAccessControlOptions): Promise<PathSetAccessControlResponse>

Paramètres

acl

PathAccessControlItem[]

Liste de contrôle d’accès POSIX pour le fichier ou le répertoire.

options
PathSetAccessControlOptions

facultatif. Options lors de la définition du contrôle d’accès au chemin d’accès.

Retours

setAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)

Définit le Access Control sur un chemin d’accès et des sous-chemins.

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update

function setAccessControlRecursive(acl: PathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>

Paramètres

acl

PathAccessControlItem[]

Liste de contrôle d’accès POSIX pour le fichier ou le répertoire.

options
PathChangeAccessControlRecursiveOptions

facultatif. Options

Retours

setHttpHeaders(PathHttpHeaders, PathSetHttpHeadersOptions)

Définit les propriétés système sur le chemin d’accès (répertoire ou fichier). Si aucune valeur n’est fournie ou aucune valeur fournie pour les en-têtes HTTP d’objet blob spécifiés, ces en-têtes HTTP blob sans valeur sont effacés.

Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties

function setHttpHeaders(httpHeaders: PathHttpHeaders, options?: PathSetHttpHeadersOptions): Promise<PathSetHttpHeadersResponse>

Paramètres

httpHeaders
PathHttpHeaders

Retours

setMetadata(Metadata, PathSetMetadataOptions)

Définit les métadonnées définies par l’utilisateur pour le chemin d’accès spécifié (répertoire du fichier) sous la forme d’une ou plusieurs paires nom-valeur. Si aucune option n’est fournie ou si aucune métadonnées n’est définie dans le paramètre, les métadonnées de chemin d’accès sont supprimées.

Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata

function setMetadata(metadata?: Metadata, options?: PathSetMetadataOptions): Promise<PathSetMetadataResponse>

Paramètres

metadata
Metadata

facultatif. 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
PathSetMetadataOptions

facultatif. Options lors de la définition des métadonnées de chemin d’accès.

Retours

setPermissions(PathPermissions, PathSetPermissionsOptions)

Définit les autorisations de fichier sur un chemin d’accès.

Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update

function setPermissions(permissions: PathPermissions, options?: PathSetPermissionsOptions): Promise<PathSetAccessControlResponse>

Paramètres

permissions
PathPermissions

Autorisations d’accès POSIX pour le propriétaire du fichier, le groupe propriétaire du fichier et d’autres.

options
PathSetPermissionsOptions

facultatif. Options lors de la définition des autorisations de chemin d’accès.

Retours

toDirectoryClient()

Convertissez DataLakePathClient actuel en DataLakeDirectoryClient si le chemin actuel est un répertoire.

function toDirectoryClient(): DataLakeDirectoryClient

Retours

toFileClient()

Convertissez DataLakePathClient actuel en DataLakeFileClient si le chemin actuel est un fichier.

function toFileClient(): DataLakeFileClient

Retours

updateAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)

Modifie le Access Control sur un chemin et des sous-chemins.

Consultez https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update

function updateAccessControlRecursive(acl: PathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>

Paramètres

acl

PathAccessControlItem[]

Liste de contrôle d’accès POSIX pour le fichier ou le répertoire.

options
PathChangeAccessControlRecursiveOptions

facultatif. Options

Retours