DataLakeDirectoryClient class
Un DataLakeDirectoryClient représente une URL vers le répertoire Stockage Azure.
- Extends
Constructeurs
Data |
Crée une instance de DataLakePathClient à partir de l’URL et du pipeline. |
Data |
Crée une instance de DataLakePathClient à partir de l’URL et des informations d’identification. |
Propriétés
file |
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
account |
|
credential | Tels que AnonymousCredential, StorageSharedKeyCredential ou toutes les informations d’identification du package |
url | Valeur de chaîne d’URL encodée. |
Méthodes
Méthodes héritées
delete(boolean, Path |
Supprimez le chemin actuel (répertoire ou fichier). Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete |
delete |
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(Path |
Retourne true si le fichier Data Lake représenté par ce client existe ; false sinon. REMARQUE : utilisez cette fonction avec soin, 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. |
get |
Retourne les données de contrôle d’accès pour un chemin d’accès (répertoire de fichier). Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/getproperties |
get |
Obtenez un DataLakeLeaseClient qui gère les baux sur le chemin d’accès (répertoire ou fichier). |
get |
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 Voir https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob-properties |
move(string, Path |
Déplacer le répertoire ou le fichier dans le même système de fichiers. Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create |
move(string, string, Path |
Déplacez 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 |
remove |
Supprime le contrôle d’accès sur un chemin d’accès et un sous-chemin d’accès. Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update |
set |
Définissez les données de contrôle d’accès pour un chemin d’accès (répertoire de fichier). Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update |
set |
Définit le contrôle d’accès sur un chemin d’accès et des sous-chemins. Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update |
set |
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 d’objet blob sans valeur seront effacés. Voir https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties |
set |
Définit les métadonnées définies par l’utilisateur pour le chemin d’accès spécifié (répertoire de fichier) sous la forme d’une ou plusieurs paires nom-valeur. Si aucune option n’est fournie ou aucune métadonnées définie dans le paramètre, les métadonnées de chemin d’accès sont supprimées. Voir https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata |
set |
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 |
to |
Convertissez dataLakePathClient actuel en DataLakeDirectoryClient si le chemin actuel est un répertoire. |
to |
Convertissez dataLakePathClient actuel en DataLakeFileClient si le chemin actuel est un fichier. |
update |
Modifie le contrôle d’accès sur un chemin d’accès et des sous-chemins. Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update |
Détails du constructeur
DataLakeDirectoryClient(string, Pipeline)
Crée une instance de DataLakePathClient à partir de l’URL et du pipeline.
new DataLakeDirectoryClient(url: string, pipeline: Pipeline)
Paramètres
- url
-
string
Chaîne cliente pointant vers le chemin du lac de données Stockage Azure (répertoire ou fichier), par exemple «https://myaccount.dfs.core.windows.net/filesystem/directory" ou "https://myaccount.dfs.core.windows.net/filesystem/file". Vous pouvez ajouter une SAP 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é.
DataLakeDirectoryClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)
Crée une instance de DataLakePathClient à partir de l’URL et des informations d’identification.
new DataLakeDirectoryClient(url: string, credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: StoragePipelineOptions)
Paramètres
- url
-
string
Chaîne cliente pointant vers le chemin du lac de données Stockage Azure (répertoire ou fichier), par exemple «https://myaccount.dfs.core.windows.net/filesystem/directory" ou "https://myaccount.dfs.core.windows.net/filesystem/file". Vous pouvez ajouter une SAP si vous utilisez AnonymousCredential, par exemple «https://myaccount.dfs.core.windows.net/filesystem/directory?sasString".
- credential
-
StorageSharedKeyCredential | AnonymousCredential | TokenCredential
Tels que AnonymousCredential, StorageSharedKeyCredential ou toutes les informations d’identification du package @azure/identity
pour authentifier les demandes auprès du service. Vous pouvez également fournir un objet qui implémente l’interface TokenCredential. Si ce n’est pas spécifié, AnonymousCredential est utilisé.
- options
- StoragePipelineOptions
Optionnel. Options de configuration du 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
credential
Tels que AnonymousCredential, StorageSharedKeyCredential ou toutes les informations d’identification du package @azure/identity
pour authentifier les demandes auprès du service. Vous pouvez également fournir un objet qui implémente l’interface TokenCredential. Si ce n’est pas spécifié, AnonymousCredential est utilisé.
credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential
Valeur de propriété
héritée deDataLakePathClient.credential
url
Valeur de chaîne d’URL encodée.
url: string
Valeur de propriété
string
héritée deDataLakePathClient.url
Détails de la méthode
create(DirectoryCreateOptions)
Créez un répertoire.
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create
function create(options?: DirectoryCreateOptions): Promise<DirectoryCreateResponse>
Paramètres
- options
- DirectoryCreateOptions
Optionnel. Options lors de la création d’un répertoire.
Retours
Promise<DirectoryCreateResponse>
create(PathResourceTypeModel, PathCreateOptions)
Créez un répertoire.
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create
function create(resourceType: PathResourceTypeModel, options?: PathCreateOptions): Promise<PathCreateResponse>
Paramètres
- resourceType
- PathResourceTypeModel
Le type de ressource doit être « directory » pour DataLakeDirectoryClient.
- options
- PathCreateOptions
Optionnel. Options lors de la création d’un répertoire.
Retours
Promise<PathCreateResponse>
createIfNotExists(DirectoryCreateIfNotExistsOptions)
Créez un répertoire s’il n’existe pas déjà.
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create
function createIfNotExists(options?: DirectoryCreateIfNotExistsOptions): Promise<DirectoryCreateIfNotExistsResponse>
Paramètres
Retours
Promise<DirectoryCreateIfNotExistsResponse>
createIfNotExists(PathResourceTypeModel, PathCreateIfNotExistsOptions)
Créez un répertoire s’il n’existe pas déjà.
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
Le type de ressource doit être « directory » pour DataLakeDirectoryClient.
- options
- PathCreateIfNotExistsOptions
Retours
Promise<PathCreateIfNotExistsResponse>
generateSasStringToSign(DirectoryGenerateSasUrlOptions)
Génère une chaîne à signer pour un URI de signature d’accès partagé de service (SAP) en fonction des propriétés et paramètres du client transmis.
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
function generateSasStringToSign(options: DirectoryGenerateSasUrlOptions): string
Paramètres
- options
- DirectoryGenerateSasUrlOptions
Paramètres facultatifs.
Retours
string
URI SAP constitué de l’URI de la ressource représentée par ce client, suivi du jeton SAP généré.
generateSasUrl(DirectoryGenerateSasUrlOptions)
Disponible uniquement pour les clients construits avec des informations d’identification de clé partagée.
Génère un URI de signature d’accès partagé (SAP) de service en fonction des propriétés et paramètres du client transmis. La SAP 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: DirectoryGenerateSasUrlOptions): Promise<string>
Paramètres
- options
- DirectoryGenerateSasUrlOptions
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é.
generateUserDelegationSasStringToSign(DirectoryGenerateSasUrlOptions, UserDelegationKey)
Génère la chaîne à signer pour un URI de signature d’accès partagé de service (SAP) en fonction des propriétés et paramètres du client transmis dans la SAP est signée par la clé de délégation de l’utilisateur d’entrée.
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
function generateUserDelegationSasStringToSign(options: DirectoryGenerateSasUrlOptions, userDelegationKey: UserDelegationKey): string
Paramètres
- options
- DirectoryGenerateSasUrlOptions
Paramètres facultatifs.
- userDelegationKey
- UserDelegationKey
Valeur de retour de blobServiceClient.getUserDelegationKey()
Retours
string
URI SAP constitué de l’URI de la ressource représentée par ce client, suivi du jeton SAP généré.
generateUserDelegationSasUrl(DirectoryGenerateSasUrlOptions, UserDelegationKey)
Génère un URI de signature d’accès partagé (SAP) de service en fonction des propriétés et paramètres du client transmis. La SAP est signée par la clé de délégation d’utilisateur d’entrée.
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
function generateUserDelegationSasUrl(options: DirectoryGenerateSasUrlOptions, userDelegationKey: UserDelegationKey): Promise<string>
Paramètres
- options
- DirectoryGenerateSasUrlOptions
Paramètres facultatifs.
- userDelegationKey
- UserDelegationKey
Valeur de retour de blobServiceClient.getUserDelegationKey()
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é.
getFileClient(string)
Crée un objet DataLakeFileClient sous le répertoire actif.
function getFileClient(fileName: string): DataLakeFileClient
Paramètres
- fileName
-
string
Retours
getSubdirectoryClient(string)
Crée un objet DataLakeDirectoryClient sous le répertoire actif.
function getSubdirectoryClient(subdirectoryName: string): DataLakeDirectoryClient
Paramètres
- subdirectoryName
-
string
Nom du sous-répertoire.
Retours
Détails de la méthode héritée
delete(boolean, PathDeleteOptions)
Supprimez le chemin actuel (répertoire ou fichier).
Voir 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 la valeur est « true », tous les chemins d’accès sous le répertoire sont supprimés.
- options
- PathDeleteOptions
Optionnel. Options lors de la suppression du chemin d’accès.
Retours
Promise<PathDeleteResponse>
héritée deDataLakePathClient.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
function deleteIfExists(recursive?: boolean, options?: PathDeleteOptions): Promise<PathDeleteIfExistsResponse>
Paramètres
- recursive
-
boolean
Obligatoire et valide uniquement lorsque la ressource est un répertoire. Si la valeur est « true », tous les chemins d’accès sous le répertoire sont supprimés.
- options
- PathDeleteOptions
Retours
Promise<PathDeleteIfExistsResponse>
héritée deDataLakePathClient.deleteIfExists
exists(PathExistsOptions)
Retourne true si le fichier Data Lake représenté par ce client existe ; false sinon.
REMARQUE : utilisez cette fonction avec soin, 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 pour l’opération Exists.
Retours
Promise<boolean>
héritée deDataLakePathClient.exists
getAccessControl(PathGetAccessControlOptions)
Retourne les données de contrôle d’accès pour un chemin d’accès (répertoire de fichier).
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/getproperties
function getAccessControl(options?: PathGetAccessControlOptions): Promise<PathGetAccessControlResponse>
Paramètres
- options
- PathGetAccessControlOptions
Optionnel. Options lors de l’obtention du contrôle d’accès aux fichiers.
Retours
Promise<PathGetAccessControlResponse>
héritée deDataLakePathClient.getAccessControl
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
Optionnel. 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 s’ils contenaient initialement des caractères majuscules. Cela diffère des clés de métadonnées retournées par les méthodes de DataLakeFileSystemClient qui répertorient les chemins d’accès à l’aide de l’option includeMetadata
, qui conserve 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
Optionnel. Options lors de l’obtention des propriétés de chemin d’accès.
Retours
Promise<PathGetPropertiesResponse>
héritée deDataLakePathClient.getProperties
move(string, PathMoveOptions)
Déplacer le répertoire ou le fichier dans le même système de fichiers.
Voir 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 d’accès au répertoire de destination, tel que « répertoire » ou chemin d’accès au fichier « répertoire/fichier ». Si destinationPath est authentifié avec SAS, ajoutez la signature d’accès partagé au chemin de destination tel que « directory/file ?sasToken ».
- options
- PathMoveOptions
Optionnel. Options lors du déplacement d’un répertoire ou d’un fichier.
Retours
Promise<PathMoveResponse>
héritée deDataLakePathClient.move
move(string, string, PathMoveOptions)
Déplacez 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 tel que « système de fichiers ».
- destinationPath
-
string
Chemin d’accès au répertoire de destination comme « répertoire » ou chemin d’accès au fichier « répertoire/fichier » Si destinationPath est authentifié avec SAS, ajoutez la SAP au chemin de destination tel que « directory/file ?sasToken ».
- options
- PathMoveOptions
Optionnel. Options lors du déplacement d’un répertoire ou d’un fichier.
Retours
Promise<PathMoveResponse>
héritée deDataLakePathClient.move
removeAccessControlRecursive(RemovePathAccessControlItem[], PathChangeAccessControlRecursiveOptions)
Supprime le contrôle d’accès sur un chemin d’accès et un sous-chemin d’accès.
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
function removeAccessControlRecursive(acl: RemovePathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>
Paramètres
Liste de contrôle d’accès POSIX pour le fichier ou le répertoire.
Optionnel. 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).
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
function setAccessControl(acl: PathAccessControlItem[], options?: PathSetAccessControlOptions): Promise<PathSetAccessControlResponse>
Paramètres
- acl
Liste de contrôle d’accès POSIX pour le fichier ou le répertoire.
- options
- PathSetAccessControlOptions
Optionnel. Options lors de la définition du contrôle d’accès du chemin d’accès.
Retours
Promise<PathSetAccessControlResponse>
héritée deDataLakePathClient.setAccessControl
setAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)
Définit le contrôle d’accès 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
Liste de contrôle d’accès POSIX pour le fichier ou le répertoire.
Optionnel. 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 d’objet blob sans valeur seront effacés.
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties
function setHttpHeaders(httpHeaders: PathHttpHeaders, options?: PathSetHttpHeadersOptions): Promise<PathSetHttpHeadersResponse>
Paramètres
- httpHeaders
- PathHttpHeaders
- options
- PathSetHttpHeadersOptions
Retours
Promise<PathSetHttpHeadersResponse>
héritée deDataLakePathClient.setHttpHeaders
setMetadata(Metadata, PathSetMetadataOptions)
Définit les métadonnées définies par l’utilisateur pour le chemin d’accès spécifié (répertoire de fichier) sous la forme d’une ou plusieurs paires nom-valeur.
Si aucune option n’est fournie ou aucune métadonnées définie dans le paramètre, les métadonnées de chemin d’accès sont supprimées.
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata
function setMetadata(metadata?: Metadata, options?: PathSetMetadataOptions): Promise<PathSetMetadataResponse>
Paramètres
- metadata
- Metadata
Optionnel. Remplacez les métadonnées existantes par cette valeur. Si aucune valeur n’est fournie, les métadonnées existantes seront supprimées.
- options
- PathSetMetadataOptions
Optionnel. Options lors de la définition des métadonnées de chemin d’accès.
Retours
Promise<PathSetMetadataResponse>
héritée deDataLakePathClient.setMetadata
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<PathSetPermissionsResponse>
Paramètres
- permissions
- PathPermissions
Autorisations d’accès POSIX pour le propriétaire du fichier, le groupe propriétaire de fichiers et d’autres utilisateurs.
- options
- PathSetPermissionsOptions
Optionnel. Options lors de la définition des autorisations de chemin d’accès.
Retours
Promise<PathSetPermissionsResponse>
héritée deDataLakePathClient.setPermissions
toDirectoryClient()
Convertissez dataLakePathClient actuel en DataLakeDirectoryClient si le chemin actuel est un répertoire.
function toDirectoryClient(): DataLakeDirectoryClient
Retours
héritée deDataLakePathClient.toDirectoryClient
toFileClient()
Convertissez dataLakePathClient actuel en DataLakeFileClient si le chemin actuel est un fichier.
function toFileClient(): DataLakeFileClient
Retours
héritée deDataLakePathClient.toFileClient
updateAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)
Modifie le contrôle d’accès sur un chemin d’accès et des sous-chemins.
Voir https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
function updateAccessControlRecursive(acl: PathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>
Paramètres
- acl
Liste de contrôle d’accès POSIX pour le fichier ou le répertoire.
Optionnel. Options