DataLakeDirectoryClient class

Paquete:

@azure/storage-file-datalake

DataLakeDirectoryClient representa una dirección URL al directorio de Azure Storage.

Extends

DataLakePathClient

Constructores

DataLakeDirectoryClient(string, Pipeline)	Crea una instancia de DataLakePathClient a partir de la dirección URL y la canalización.
DataLakeDirectoryClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)	Crea una instancia de DataLakePathClient a partir de la dirección URL y las credenciales.

Propiedades

fileSystemName	Nombre del sistema de archivos actual.
name	Nombre de la ruta de acceso actual (directorio o archivo).

Propiedades heredadas

accountName
credential	Por ejemplo, AnonymousCredential, StorageSharedKeyCredential o cualquier credencial del @azure/identity paquete para autenticar las solicitudes en el servicio. También puede proporcionar un objeto que implemente la interfaz TokenCredential. Si no se especifica, se usa AnonymousCredential.
url	Valor de cadena de dirección URL codificada.

Métodos

create(DirectoryCreateOptions)	Cree un directorio. Consulta https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create.
create(PathResourceTypeModel, PathCreateOptions)	Cree un directorio. Consulta https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create.
createIfNotExists(DirectoryCreateIfNotExistsOptions)	Cree un directorio si aún no existe. Consulta https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create.
createIfNotExists(PathResourceTypeModel, PathCreateIfNotExistsOptions)	Cree un directorio si aún no existe. Consulta https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create.
generateSasUrl(DirectoryGenerateSasUrlOptions)	Solo está disponible para los clientes construidos con una credencial de clave compartida. Genera un URI de firma de acceso compartido (SAS) de servicio basado en las propiedades y parámetros del cliente pasados. La SAS está firmada por la credencial de clave compartida del cliente. Consulta https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas.
getFileClient(string)	Crea un objeto DataLakeFileClient en el directorio actual.
getSubdirectoryClient(string)	Crea un objeto DataLakeDirectoryClient en el directorio actual.

Métodos heredados

delete(boolean, PathDeleteOptions)	Elimine la ruta de acceso actual (directorio o archivo). Consulta https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete.
deleteIfExists(boolean, PathDeleteOptions)	Elimine la ruta de acceso actual (directorio o archivo) si existe. Consulta https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete.
exists(PathExistsOptions)	Devuelve true si el archivo de Data Lake representado por este cliente existe; False en caso contrario. NOTA: Use esta función con cuidado, ya que otros clientes o aplicaciones pueden eliminar un archivo existente. Viceversa, otros clientes o aplicaciones pueden agregar archivos nuevos después de que se complete esta función.
getAccessControl(PathGetAccessControlOptions)	Devuelve los datos de control de acceso para una ruta de acceso (directorio de archivo). Consulta https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/getproperties.
getDataLakeLeaseClient(string)	Obtenga un DataLakeLeaseClient que administre concesiones en la ruta de acceso (directorio o archivo).
getProperties(PathGetPropertiesOptions)	Devuelve todos los metadatos definidos por el usuario, las propiedades HTTP estándar y las propiedades del sistema para la ruta de acceso (directorio o archivo). ADVERTENCIA: El metadata objeto devuelto en la respuesta tendrá sus claves en minúsculas, incluso si contenían caracteres en mayúsculas originalmente. Esto difiere de las claves de metadatos devueltas por los métodos de DataLakeFileSystemClient que enumeran las rutas de acceso mediante la includeMetadata opción , que conservarán su mayúscula y minúscula original. Consulta https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob-properties.
move(string, PathMoveOptions)	Mueva el directorio o el archivo dentro del mismo sistema de archivos. Consulta https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create.
move(string, string, PathMoveOptions)	Mueva el directorio o el archivo a otro sistema de archivos. Consulta https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create.
removeAccessControlRecursive(RemovePathAccessControlItem[], PathChangeAccessControlRecursiveOptions)	Quita el Access Control en una ruta de acceso y subrutas. Consulta https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update.
setAccessControl(PathAccessControlItem[], PathSetAccessControlOptions)	Establezca los datos de control de acceso para una ruta de acceso (directorio de archivo). Consulta https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update.
setAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)	Establece el Access Control en una ruta de acceso y subrutas. Consulta https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update.
setHttpHeaders(PathHttpHeaders, PathSetHttpHeadersOptions)	Establece las propiedades del sistema en la ruta de acceso (directorio o archivo). Si no se proporciona ningún valor o no se proporciona ningún valor para los encabezados HTTP de blob especificados, estos encabezados HTTP de blob sin un valor se borrarán. Consulta https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties.
setMetadata(Metadata, PathSetMetadataOptions)	Establece los metadatos definidos por el usuario para la ruta de acceso especificada (directorio de archivo) como uno o varios pares nombre-valor. Si no se proporciona ninguna opción o ningún metadato definido en el parámetro , se quitarán los metadatos de la ruta de acceso. Consulta https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata.
setPermissions(PathPermissions, PathSetPermissionsOptions)	Establece los permisos de archivo en una ruta de acceso. Consulta https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update.
toDirectoryClient()	Convierta dataLakePathClient actual en DataLakeDirectoryClient si la ruta de acceso actual es un directorio.
toFileClient()	Convierta dataLakePathClient actual en DataLakeFileClient si la ruta de acceso actual es un archivo.
updateAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)	Modifica el Access Control en una ruta de acceso y subrutas. Consulta https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update.

Detalles del constructor

DataLakeDirectoryClient(string, Pipeline)

Crea una instancia de DataLakePathClient a partir de la dirección URL y la canalización.

new DataLakeDirectoryClient(url: string, pipeline: Pipeline)

Parámetros

url

string

Cadena de cliente que apunta a la ruta de acceso del lago de datos de Azure Storage (directorio o archivo), como "https://myaccount.dfs.core.windows.net/filesystem/directory" o "https://myaccount.dfs.core.windows.net/filesystem/file". Puede anexar una SAS si usa AnonymousCredential, como "https://myaccount.dfs.core.windows.net/filesystem/directory?sasString".

pipeline

Pipeline

Llame a newPipeline() para crear una canalización predeterminada o proporcione una canalización personalizada.

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

Crea una instancia de DataLakePathClient a partir de la dirección URL y las credenciales.

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

Parámetros

url

string

Cadena de cliente que apunta a la ruta de acceso del lago de datos de Azure Storage (directorio o archivo), como "https://myaccount.dfs.core.windows.net/filesystem/directory" o "https://myaccount.dfs.core.windows.net/filesystem/file". Puede anexar una SAS si usa AnonymousCredential, como "https://myaccount.dfs.core.windows.net/filesystem/directory?sasString".

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Por ejemplo, AnonymousCredential, StorageSharedKeyCredential o cualquier credencial del @azure/identity paquete para autenticar las solicitudes en el servicio. También puede proporcionar un objeto que implemente la interfaz TokenCredential. Si no se especifica, se usa AnonymousCredential.

options

StoragePipelineOptions

Opcional. Opciones para configurar la canalización HTTP.

Detalles de las propiedades

fileSystemName

Nombre del sistema de archivos actual.

string fileSystemName

Valor de propiedad

string

name

Nombre de la ruta de acceso actual (directorio o archivo).

string name

Valor de propiedad

string

Detalles de las propiedades heredadas

accountName

accountName: string

Valor de propiedad

string

Heredado deDataLakePathClient.accountName

credential

Por ejemplo, AnonymousCredential, StorageSharedKeyCredential o cualquier credencial del @azure/identity paquete para autenticar las solicitudes en el servicio. También puede proporcionar un objeto que implemente la interfaz TokenCredential. Si no se especifica, se usa AnonymousCredential.

credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Valor de propiedad

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Heredado deDataLakePathClient.credential

url

Valor de cadena de dirección URL codificada.

url: string

Valor de propiedad

string

Heredado deDataLakePathClient.url

Detalles del método

create(DirectoryCreateOptions)

Cree un directorio.

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

function create(options?: DirectoryCreateOptions): Promise<DirectoryCreateResponse>

Parámetros

options

DirectoryCreateOptions

Opcional. Opciones al crear el directorio.

Devoluciones

Promise<DirectoryCreateResponse>

create(PathResourceTypeModel, PathCreateOptions)

Cree un directorio.

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

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

Parámetros

resourceType

PathResourceTypeModel

El tipo de recurso debe ser "directory" para DataLakeDirectoryClient.

options

PathCreateOptions

Opcional. Opciones al crear el directorio.

Devoluciones

Promise<PathCreateResponse>

createIfNotExists(DirectoryCreateIfNotExistsOptions)

Cree un directorio si aún no existe.

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

function createIfNotExists(options?: DirectoryCreateIfNotExistsOptions): Promise<DirectoryCreateIfNotExistsResponse>

Parámetros

options

DirectoryCreateIfNotExistsOptions

Devoluciones

Promise<DirectoryCreateIfNotExistsResponse>

createIfNotExists(PathResourceTypeModel, PathCreateIfNotExistsOptions)

Cree un directorio si aún no existe.

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

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

Parámetros

resourceType

PathResourceTypeModel

El tipo de recurso debe ser "directory" para DataLakeDirectoryClient.

options

PathCreateIfNotExistsOptions

Devoluciones

Promise<PathCreateIfNotExistsResponse>

generateSasUrl(DirectoryGenerateSasUrlOptions)

Solo está disponible para los clientes construidos con una credencial de clave compartida.

Genera un URI de firma de acceso compartido (SAS) de servicio basado en las propiedades y parámetros del cliente pasados. La SAS está firmada por la credencial de clave compartida del cliente.

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

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

Parámetros

options

DirectoryGenerateSasUrlOptions

Parámetros opcionales.

Devoluciones

Promise<string>

El URI de SAS que consta del URI al recurso representado por este cliente, seguido del token de SAS generado.

getFileClient(string)

Crea un objeto DataLakeFileClient en el directorio actual.

function getFileClient(fileName: string): DataLakeFileClient

Parámetros

fileName

string

Devoluciones

DataLakeFileClient

getSubdirectoryClient(string)

Crea un objeto DataLakeDirectoryClient en el directorio actual.

function getSubdirectoryClient(subdirectoryName: string): DataLakeDirectoryClient

Parámetros

subdirectoryName

string

Nombre del subdirectorio.

Devoluciones

DataLakeDirectoryClient

Detalles de los métodos heredados

delete(boolean, PathDeleteOptions)

Elimine la ruta de acceso actual (directorio o archivo).

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

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

Parámetros

recursive

boolean

Obligatorio y válido solo cuando el recurso es un directorio. Si es "true", se eliminarán todas las rutas de acceso debajo del directorio.

options

PathDeleteOptions

Opcional. Opciones al eliminar la ruta de acceso.

Devoluciones

Promise<PathDeleteResponse>

Heredado deDataLakePathClient.delete

deleteIfExists(boolean, PathDeleteOptions)

Elimine la ruta de acceso actual (directorio o archivo) si existe.

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

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

Parámetros

recursive

boolean

Obligatorio y válido solo cuando el recurso es un directorio. Si es "true", se eliminarán todas las rutas de acceso debajo del directorio.

options

PathDeleteOptions

Devoluciones

Promise<PathDeleteIfExistsResponse>

Heredado deDataLakePathClient.deleteIfExists

exists(PathExistsOptions)

Devuelve true si el archivo de Data Lake representado por este cliente existe; False en caso contrario.

NOTA: Use esta función con cuidado, ya que otros clientes o aplicaciones pueden eliminar un archivo existente. Viceversa, otros clientes o aplicaciones pueden agregar archivos nuevos después de que se complete esta función.

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

Parámetros

options

PathExistsOptions

opciones para la operación Exists.

Devoluciones

Promise<boolean>

Heredado deDataLakePathClient.exists

getAccessControl(PathGetAccessControlOptions)

Devuelve los datos de control de acceso para una ruta de acceso (directorio de archivo).

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

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

Parámetros

options

PathGetAccessControlOptions

Opcional. Opciones al obtener el control de acceso a archivos.

Devoluciones

Promise<PathGetAccessControlResponse>

Heredado deDataLakePathClient.getAccessControl

getDataLakeLeaseClient(string)

Obtenga un DataLakeLeaseClient que administre concesiones en la ruta de acceso (directorio o archivo).

function getDataLakeLeaseClient(proposeLeaseId?: string): DataLakeLeaseClient

Parámetros

proposeLeaseId

string

Opcional. Identificador de concesión propuesto inicial.

Devoluciones

DataLakeLeaseClient

Heredado deDataLakePathClient.getDataLakeLeaseClient

getProperties(PathGetPropertiesOptions)

Devuelve todos los metadatos definidos por el usuario, las propiedades HTTP estándar y las propiedades del sistema para la ruta de acceso (directorio o archivo).

ADVERTENCIA: El metadata objeto devuelto en la respuesta tendrá sus claves en minúsculas, incluso si contenían caracteres en mayúsculas originalmente. Esto difiere de las claves de metadatos devueltas por los métodos de DataLakeFileSystemClient que enumeran las rutas de acceso mediante la includeMetadata opción , que conservarán su mayúscula y minúscula original.

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

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

Parámetros

options

PathGetPropertiesOptions

Opcional. Opciones al obtener propiedades de ruta de acceso.

Devoluciones

Promise<PathGetPropertiesResponse>

Heredado deDataLakePathClient.getProperties

move(string, PathMoveOptions)

Mueva el directorio o el archivo dentro del mismo sistema de archivos.

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

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

Parámetros

destinationPath

string

Ruta de acceso del directorio de destino, como "directorio" o ruta de acceso de archivo "directorio/archivo". Si destinationPath se autentica con SAS, agregue la SAS a la ruta de acceso de destino como "directory/file?sasToken".

options

PathMoveOptions

Opcional. Opciones al mover el directorio o el archivo.

Devoluciones

Promise<PathMoveResponse>

Heredado deDataLakePathClient.move

move(string, string, PathMoveOptions)

Mueva el directorio o el archivo a otro sistema de archivos.

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

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

Parámetros

destinationFileSystem

string

Sistema de archivos de destino como "sistema de archivos".

destinationPath

string

Ruta de acceso del directorio de destino como "directorio" o ruta de acceso de archivo "directorio/archivo" Si destinationPath se autentica con SAS, agregue la SAS a la ruta de acceso de destino como "directory/file?sasToken".

options

PathMoveOptions

Opcional. Opciones al mover el directorio o el archivo.

Devoluciones

Promise<PathMoveResponse>

Heredado deDataLakePathClient.move

removeAccessControlRecursive(RemovePathAccessControlItem[], PathChangeAccessControlRecursiveOptions)

Quita el Access Control en una ruta de acceso y subrutas.

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

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

Parámetros

acl

RemovePathAccessControlItem[]

Lista de control de acceso POSIX para el archivo o directorio.

options

PathChangeAccessControlRecursiveOptions

Opcional. Opciones

Devoluciones

Promise<PathChangeAccessControlRecursiveResponse>

Heredado deDataLakePathClient.removeAccessControlRecursive

setAccessControl(PathAccessControlItem[], PathSetAccessControlOptions)

Establezca los datos de control de acceso para una ruta de acceso (directorio de archivo).

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

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

Parámetros

acl

PathAccessControlItem[]

Lista de control de acceso POSIX para el archivo o directorio.

options

PathSetAccessControlOptions

Opcional. Opciones al establecer el control de acceso de ruta de acceso.

Devoluciones

Promise<PathSetAccessControlResponse>

Heredado deDataLakePathClient.setAccessControl

setAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)

Establece el Access Control en una ruta de acceso y subrutas.

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

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

Parámetros

acl

PathAccessControlItem[]

Lista de control de acceso POSIX para el archivo o directorio.

options

PathChangeAccessControlRecursiveOptions

Opcional. Opciones

Devoluciones

Promise<PathChangeAccessControlRecursiveResponse>

Heredado deDataLakePathClient.setAccessControlRecursive

setHttpHeaders(PathHttpHeaders, PathSetHttpHeadersOptions)

Establece las propiedades del sistema en la ruta de acceso (directorio o archivo).

Si no se proporciona ningún valor o no se proporciona ningún valor para los encabezados HTTP de blob especificados, estos encabezados HTTP de blob sin un valor se borrarán.

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

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

Parámetros

httpHeaders

PathHttpHeaders

options

PathSetHttpHeadersOptions

Devoluciones

Promise<PathSetHttpHeadersResponse>

Heredado deDataLakePathClient.setHttpHeaders

setMetadata(Metadata, PathSetMetadataOptions)

Establece los metadatos definidos por el usuario para la ruta de acceso especificada (directorio de archivo) como uno o varios pares nombre-valor.

Si no se proporciona ninguna opción o ningún metadato definido en el parámetro , se quitarán los metadatos de la ruta de acceso.

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

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

Parámetros

metadata

Metadata

Opcional. Reemplace los metadatos existentes por este valor. Si no se quitará ningún valor proporcionado, se quitarán los metadatos existentes.

options

PathSetMetadataOptions

Opcional. Opciones al establecer metadatos de ruta de acceso.

Devoluciones

Promise<PathSetMetadataResponse>

Heredado deDataLakePathClient.setMetadata

setPermissions(PathPermissions, PathSetPermissionsOptions)

Establece los permisos de archivo en una ruta de acceso.

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

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

Parámetros

permissions

PathPermissions

Los permisos de acceso POSIX para el propietario del archivo, el grupo propietario de archivos y otros.

options

PathSetPermissionsOptions

Opcional. Opciones al establecer permisos de ruta de acceso.

Devoluciones

Promise<PathSetPermissionsResponse>

Heredado deDataLakePathClient.setPermissions

toDirectoryClient()

Convierta dataLakePathClient actual en DataLakeDirectoryClient si la ruta de acceso actual es un directorio.

function toDirectoryClient(): DataLakeDirectoryClient

Devoluciones

DataLakeDirectoryClient

Heredado deDataLakePathClient.toDirectoryClient

toFileClient()

Convierta dataLakePathClient actual en DataLakeFileClient si la ruta de acceso actual es un archivo.

function toFileClient(): DataLakeFileClient

Devoluciones

DataLakeFileClient

Heredado deDataLakePathClient.toFileClient

updateAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)

Modifica el Access Control en una ruta de acceso y subrutas.

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

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

Parámetros

acl

PathAccessControlItem[]

Lista de control de acceso POSIX para el archivo o directorio.

options

PathChangeAccessControlRecursiveOptions

Opcional. Opciones

Devoluciones

Promise<PathChangeAccessControlRecursiveResponse>

Heredado deDataLakePathClient.updateAccessControlRecursive