DataLakeDirectoryClient class
DataLakeDirectoryClient representa una dirección URL al directorio de Azure Storage.
- Extends
Constructores
Data |
Crea una instancia de DataLakePathClient a partir de la dirección URL y la canalización. |
Data |
Crea una instancia de DataLakePathClient a partir de la dirección URL y las credenciales. |
Propiedades
file |
Nombre del sistema de archivos actual. |
name | Nombre de la ruta de acceso actual (directorio o archivo). |
Propiedades heredadas
account |
|
credential | Por ejemplo, AnonymousCredential, StorageSharedKeyCredential o cualquier credencial del paquete de |
url | Valor de cadena de dirección URL codificada. |
Métodos
Métodos heredados
delete(boolean, Path |
Elimine la ruta de acceso actual (directorio o archivo). Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete |
delete |
Elimine la ruta de acceso actual (directorio o archivo) si existe. Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete |
exists(Path |
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 viceversa una vez completada esta función. |
get |
Devuelve los datos de control de acceso de una ruta de acceso (directorio de archivo). Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/getproperties |
get |
Obtenga un dataLakeLeaseClient de |
get |
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 objeto Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob-properties |
move(string, Path |
Mueva el directorio o el archivo dentro del mismo sistema de archivos. Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create |
move(string, string, Path |
Mueva el directorio o el archivo a otro sistema de archivos. Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create |
remove |
Quita el control de acceso en una ruta de acceso y subrutas. Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update |
set |
Establezca los datos de control de acceso para una ruta de acceso (directorio del archivo). Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update |
set |
Establece el Control de acceso en una ruta de acceso y subrutas. Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update |
set |
Establece las propiedades del sistema en la ruta de acceso (directorio o archivo). Si no se proporciona ningún valor o ningún valor proporcionado para los encabezados HTTP de blob especificados, estos encabezados HTTP de blob sin un valor se borrarán. Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties |
set |
Establece los metadatos definidos por el usuario para la ruta de acceso especificada (directorio del 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. Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata |
set |
Establece los permisos de archivo en una ruta de acceso. Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update |
to |
Convierta dataLakePathClient actual en DataLakeDirectoryClient si la ruta de acceso actual es un directorio. |
to |
Convierta dataLakePathClient actual en DataLakeFileClient si la ruta de acceso actual es un archivo. |
update |
Modifica el Control de acceso en una ruta de acceso y subrutas. Consulte 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 proporcionar 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 paquete de @azure/identity
para autenticar las solicitudes al 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
credential
Por ejemplo, AnonymousCredential, StorageSharedKeyCredential o cualquier credencial del paquete de @azure/identity
para autenticar las solicitudes al 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
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.
Consulte 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 un directorio.
Devoluciones
Promise<DirectoryCreateResponse>
create(PathResourceTypeModel, PathCreateOptions)
Cree un directorio.
Consulte 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 un directorio.
Devoluciones
Promise<PathCreateResponse>
createIfNotExists(DirectoryCreateIfNotExistsOptions)
Cree un directorio si aún no existe.
Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create
function createIfNotExists(options?: DirectoryCreateIfNotExistsOptions): Promise<DirectoryCreateIfNotExistsResponse>
Parámetros
Devoluciones
Promise<DirectoryCreateIfNotExistsResponse>
createIfNotExists(PathResourceTypeModel, PathCreateIfNotExistsOptions)
Cree un directorio si aún no existe.
Consulte 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>
generateSasStringToSign(DirectoryGenerateSasUrlOptions)
Genera una cadena para firmar un URI de firma de acceso compartido (SAS) de servicio en función de las propiedades y parámetros del cliente pasados.
Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
function generateSasStringToSign(options: DirectoryGenerateSasUrlOptions): string
Parámetros
- options
- DirectoryGenerateSasUrlOptions
Parámetros opcionales.
Devoluciones
string
El URI de SAS que consta del URI del recurso representado por este cliente, seguido del token de SAS generado.
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.
Consulte 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 del recurso representado por este cliente, seguido del token de SAS generado.
generateUserDelegationSasStringToSign(DirectoryGenerateSasUrlOptions, UserDelegationKey)
Genera una cadena para firmar un URI de firma de acceso compartido (SAS) de servicio en función de las propiedades y parámetros de cliente pasados en La SAS está firmada por la clave de delegación de usuario de entrada.
Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
function generateUserDelegationSasStringToSign(options: DirectoryGenerateSasUrlOptions, userDelegationKey: UserDelegationKey): string
Parámetros
- options
- DirectoryGenerateSasUrlOptions
Parámetros opcionales.
- userDelegationKey
- UserDelegationKey
Valor devuelto de blobServiceClient.getUserDelegationKey()
Devoluciones
string
El URI de SAS que consta del URI del recurso representado por este cliente, seguido del token de SAS generado.
generateUserDelegationSasUrl(DirectoryGenerateSasUrlOptions, UserDelegationKey)
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 clave de delegación de usuario de entrada.
Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
function generateUserDelegationSasUrl(options: DirectoryGenerateSasUrlOptions, userDelegationKey: UserDelegationKey): Promise<string>
Parámetros
- options
- DirectoryGenerateSasUrlOptions
Parámetros opcionales.
- userDelegationKey
- UserDelegationKey
Valor devuelto de blobServiceClient.getUserDelegationKey()
Devoluciones
Promise<string>
El URI de SAS que consta del URI del 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
getSubdirectoryClient(string)
Crea un objeto
function getSubdirectoryClient(subdirectoryName: string): DataLakeDirectoryClient
Parámetros
- subdirectoryName
-
string
Nombre del subdirectorio.
Devoluciones
Detalles de los métodos heredados
delete(boolean, PathDeleteOptions)
Elimine la ruta de acceso actual (directorio o archivo).
Consulte 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.
Consulte 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 viceversa una vez completada 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 de una ruta de acceso (directorio de archivo).
Consulte 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 de
function getDataLakeLeaseClient(proposeLeaseId?: string): DataLakeLeaseClient
Parámetros
- proposeLeaseId
-
string
Opcional. Identificador de concesión propuesto inicial.
Devoluciones
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 objeto metadata
devuelto en la respuesta tendrá sus claves en minúsculas, incluso si originalmente contenían caracteres en mayúsculas. Esto difiere de las claves de metadatos devueltas por los métodos de DataLakeFileSystemClient que enumeran las rutas de acceso mediante la opción includeMetadata
, que conservarán su mayúscula y minúscula original.
Consulte 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.
Consulte 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.
Consulte 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 "filesystem".
- 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 control de acceso en una ruta de acceso y subrutas.
Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
function removeAccessControlRecursive(acl: RemovePathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>
Parámetros
Lista de control de acceso POSIX para el archivo o directorio.
Opcional. Opciones
Devoluciones
setAccessControl(PathAccessControlItem[], PathSetAccessControlOptions)
Establezca los datos de control de acceso para una ruta de acceso (directorio del archivo).
Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
function setAccessControl(acl: PathAccessControlItem[], options?: PathSetAccessControlOptions): Promise<PathSetAccessControlResponse>
Parámetros
- acl
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>
Heredar deDataLakePathClient.setAccessControl
setAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)
Establece el Control de acceso en una ruta de acceso y subrutas.
Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
function setAccessControlRecursive(acl: PathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>
Parámetros
- acl
Lista de control de acceso POSIX para el archivo o directorio.
Opcional. Opciones
Devoluciones
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 ningún valor proporcionado para los encabezados HTTP de blob especificados, estos encabezados HTTP de blob sin un valor se borrarán.
Consulte 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>
Heredar deDataLakePathClient.setHttpHeaders
setMetadata(Metadata, PathSetMetadataOptions)
Establece los metadatos definidos por el usuario para la ruta de acceso especificada (directorio del 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.
Consulte 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 proporciona ningún valor, 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.
Consulte 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 del archivo 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
heredado deDataLakePathClient.toDirectoryClient
toFileClient()
Convierta dataLakePathClient actual en DataLakeFileClient si la ruta de acceso actual es un archivo.
function toFileClient(): DataLakeFileClient
Devoluciones
heredado deDataLakePathClient.toFileClient
updateAccessControlRecursive(PathAccessControlItem[], PathChangeAccessControlRecursiveOptions)
Modifica el Control de acceso en una ruta de acceso y subrutas.
Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
function updateAccessControlRecursive(acl: PathAccessControlItem[], options?: PathChangeAccessControlRecursiveOptions): Promise<PathChangeAccessControlRecursiveResponse>
Parámetros
- acl
Lista de control de acceso POSIX para el archivo o directorio.
Opcional. Opciones