Path - Get Properties

Referencia

Servicio:: Storage Services

Versión de la API:: 2023-08-03

Obtener propiedades | Obtener estado | Obtener Access Control lista | Comprobación del acceso
Get Properties devuelve todas las propiedades definidas por el usuario y del sistema para una ruta de acceso. Get Status devuelve todas las propiedades definidas por el sistema para una ruta de acceso. Obtener Access Control Lista devuelve la lista de control de acceso de una ruta de acceso. Esta operación admite solicitudes HTTP condicionales. Para obtener más información, consulte Especificación de encabezados condicionales para las operaciones de Blob Service.

HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}

Con parámetros opcionales:

HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&upn={upn}&fsAction={fsAction}&timeout={timeout}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
accountName	path	True	string	Nombre de la cuenta de Azure Storage.
dnsSuffix	path	True	string	Sufijo DNS para el punto de conexión de Azure Data Lake Storage.
filesystem	path	True	string	Identificador del sistema de archivos. Patrón de Regex: `^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$`
path	path	True	string	Ruta de acceso del archivo o directorio.
action	query		PathGetPropertiesAction	Opcional. Si el valor es "getStatus" solo se devuelven las propiedades definidas por el sistema para la ruta de acceso. Si el valor es "getAccessControl", la lista de control de acceso se devuelve en los encabezados de respuesta (el espacio de nombres jerárquico debe estar habilitado para la cuenta), de lo contrario, se devuelven las propiedades.
fsAction	query		string	Solo se requiere para comprobar la acción de acceso. Válido solo cuando el espacio de nombres jerárquico está habilitado para la cuenta. Operación del sistema de archivos de lectura, escritura y ejecución en forma de cadena, patrón regex coincidente '[rwx-]{3}'
timeout	query		integer int32	Valor de tiempo de espera de operación opcional en segundos. El período comienza cuando el servicio recibe la solicitud. Si el valor de tiempo de espera transcurre antes de que se complete la operación, se produce un error en la operación.
upn	query		boolean	Opcional. Válido solo cuando el espacio de nombres jerárquico está habilitado para la cuenta. Si es "true", los valores de identidad de usuario devueltos en los encabezados de respuesta x-ms-owner, x-ms-group y x-ms-acl se transformarán de identificadores de objeto de Azure Active Directory a nombres principales de usuario. Si es "false", los valores se devolverán como identificadores de objeto de Azure Active Directory. El valor predeterminado es false. Tenga en cuenta que los identificadores de objeto de grupo y aplicación no se traducen porque no tienen nombres descriptivos únicos.

Encabezado de la solicitud

Nombre	Tipo	Description
x-ms-lease-id	string	Opcional. Si se especifica este encabezado, la operación solo se realizará si se cumplen las dos condiciones siguientes: i) la concesión de la ruta de acceso está activa actualmente y ii) el identificador de concesión especificado en la solicitud coincide con el de la ruta de acceso. Patrón de Regex: `^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$`
If-Match	string	Opcional. Valor ETag. Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado. La ETag debe especificarse entre comillas.
If-None-Match	string	Opcional. Un valor ETag o el valor comodín especial ("*"). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. La ETag debe especificarse entre comillas.
If-Modified-Since	string	Opcional. Valor de fecha y hora. Especifique este encabezado para realizar la operación solo si el recurso se ha modificado desde la fecha y hora especificadas.
If-Unmodified-Since	string	Opcional. Valor de fecha y hora. Especifique este encabezado para realizar la operación solo si el recurso no se ha modificado desde la fecha y hora especificadas.
x-ms-encryption-key	string	Opcional. La clave de cifrado AES-256 codificada en Base64.
x-ms-encryption-key-sha256	string	Opcional. Hash SHA256 codificado en Base64 de la clave de cifrado.
x-ms-encryption-algorithm: AES256	string	Opcional. Especifica el algoritmo que se va a usar para el cifrado. El valor de este encabezado debe ser AES256.
x-ms-client-request-id	string	UuID registrado en los registros de análisis para solucionar problemas y correlación. Patrón de Regex: `^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$`
x-ms-date	string	Especifica la hora universal coordinada (UTC) de la solicitud. Esto es necesario cuando se usa la autorización de clave compartida.
x-ms-version	string	Especifica la versión del protocolo REST que se usa para procesar la solicitud. Esto es necesario cuando se usa la autorización de clave compartida.

Respuestas

Nombre	Tipo	Description
200 OK		Devuelve todas las propiedades del archivo o directorio. Encabezados Accept-Ranges: string Cache-Control: string Content-Disposition: string Content-Encoding: string Content-Language: string Content-Length: integer Content-Range: string Content-Type: string Content-MD5: string Date: string ETag: string Last-Modified: string x-ms-request-id: string x-ms-version: string x-ms-resource-type: string x-ms-properties: string x-ms-owner: string x-ms-group: string x-ms-permissions: string x-ms-acl: string x-ms-lease-duration: string x-ms-lease-state: string x-ms-lease-status: string x-ms-server-encrypted: true/false: boolean x-ms-encryption-key-sha256: string x-ms-encryption-context: string x-ms-encryption-scope: string x-ms-creation-time: string x-ms-expiry-time: string
Other Status Codes	DataLakeStorageError	Se produjo un error. A continuación se enumeran los posibles estados HTTP, código y cadenas de mensaje: 400 Solicitud incorrecta, ContentLengthMustBeZero, "El encabezado de solicitud Content-Length debe ser cero". 400 Solicitud incorrecta, InvalidAuthenticationInfo, "La información de autenticación no se proporciona en el formato correcto. Compruebe el valor del encabezado Authorization". 400 Solicitud incorrecta, InvalidFlushPosition, "Los datos cargados no son contiguos o el valor del parámetro de consulta de posición no es igual a la longitud del archivo después de anexar los datos cargados". 400 Solicitud incorrecta, InvalidHeaderValue, "El valor de uno de los encabezados HTTP no está en el formato correcto". 400 Solicitud incorrecta, InvalidHttpVerb, "El verbo HTTP especificado no es válido; el servidor no lo reconoce". 400 Solicitud incorrecta, InvalidInput, "Una de las entradas de solicitud no es válida". 400 Solicitud incorrecta, InvalidPropertyName, "Un nombre de propiedad no puede estar vacío". 400 Solicitud incorrecta, InvalidPropertyName, "El nombre de la propiedad contiene caracteres no válidos". 400 Solicitud incorrecta, InvalidQueryParameterValue, "El valor de uno de los parámetros de consulta especificados en el URI de solicitud no es válido". 400 Solicitud incorrecta, InvalidResourceName, "El nombre del recurso especificado contiene caracteres no válidos". 400 Solicitud incorrecta, InvalidSourceUri, "El URI de origen no es válido". 400 Solicitud incorrecta, InvalidUri, "El URI de solicitud no es válido". 400 Solicitud incorrecta, MissingRequiredHeader, "No se especifica un encabezado HTTP que sea obligatorio para esta solicitud". 400 Solicitud incorrecta, MissingRequiredQueryParameter, "No se especifica un parámetro de consulta obligatorio para esta solicitud". 400 Solicitud incorrecta, MultipleConditionHeadersNotSupported, "No se admiten varios encabezados de condición". 400 Solicitud incorrecta, OutOfRangeInput, "Una de las entradas de solicitud está fuera del intervalo". 400 Solicitud incorrecta, OutOfRangeQueryParameterValue, "Uno de los parámetros de consulta especificados en el URI de solicitud está fuera del intervalo permitido". 400 Solicitud incorrecta, UnsupportedHeader, "No se admite uno de los encabezados especificados en la solicitud". 400 Solicitud incorrecta, UnsupportedQueryParameter, "No se admite uno de los parámetros de consulta especificados en el URI de solicitud". 400 Solicitud incorrecta, NosupportedRestVersion, "La versión rest especificada no es compatible". 403 Prohibido, AccountIsDisabled, "La cuenta especificada está deshabilitada". 403 Prohibido, AuthorizationFailure, "Esta solicitud no está autorizada para realizar esta operación". 403 Prohibido, InsufficientAccountPermissions, "La cuenta a la que se accede no tiene permisos suficientes para ejecutar esta operación". 404 No encontrado, FilesystemNotFound, "El sistema de archivos especificado no existe". 404 No encontrado, PathNotFound, "La ruta de acceso especificada no existe". 404 No encontrado, RenameDestinationParentPathNotFound, "El directorio primario de la ruta de acceso de destino no existe". 404 No encontrado, ResourceNotFound, "El recurso especificado no existe". 404 No encontrado, SourcePathNotFound, "La ruta de acceso de origen para una operación de cambio de nombre no existe". 405 Método no permitido, UnsupportedHttpVerb, "El recurso no admite el verbo HTTP especificado". 409 Conflicto, DestinationPathIsBeingDeleted, "La ruta de acceso de destino especificada está marcada para eliminarse". 409 Conflicto, DirectoryNotEmpty, "El valor del parámetro de consulta recursivo debe ser true para eliminar un directorio no vacío". 409 Conflicto, FilesystemAlreadyExists, "El sistema de archivos especificado ya existe". 409 Conflicto, FilesystemBeingDeleted, "Se está eliminando el sistema de archivos especificado". 409 Conflicto, InvalidDestinationPath, "La ruta de acceso especificada o un elemento de la ruta de acceso, existe y su tipo de recurso no es válido para esta operación". * 409 Conflicto, InvalidFlushOperation, "La API de Blob Service creó o modificó el recurso y no se puede escribir en la API de servicio de Data Lake Storage". 409 Conflicto, InvalidRenameSourcePath, "El directorio de origen no puede ser el mismo que el directorio de destino, ni el destino puede ser un subdirectorio del directorio de origen". 409 Conflicto, InvalidSourceOrDestinationResourceType, "El tipo de recurso de origen y destino debe ser idéntico". 409 Conflicto, LeaseAlreadyPresent, "Ya hay una concesión presente". 409 Conflicto, LeaseIdMismatchWithLeaseOperation, "El identificador de concesión especificado no coincide con el identificador de concesión del recurso con la operación de concesión especificada". 409 Conflicto, LeaseIsAlreadyBroken, "La concesión ya se ha roto y no se puede romper de nuevo". 409 Conflicto, LeaseIsBreakingAndCannotBeAcquired, "El identificador de concesión coincide, pero la concesión está actualmente en estado de interrupción y no se puede adquirir hasta que se interrumpe". 409 Conflicto, LeaseIsBreakingAndCannotBeChanged, "El identificador de concesión coincide, pero la concesión está actualmente en estado importante y no se puede cambiar". 409 Conflicto, LeaseIsBrokenAndCannotBeRenewed, "El identificador de concesión coincide, pero la concesión se ha roto explícitamente y no se puede renovar". 409 Conflicto, LeaseNameMismatch, "El nombre de concesión especificado no coincide con el nombre de concesión existente". 409 Conflicto, LeaseNotPresentWithLeaseOperation, "El identificador de concesión no está presente con la operación de concesión especificada". 409 Conflicto, PathAlreadyExists, "La ruta de acceso especificada ya existe". 409 Conflicto, PathConflict, "La ruta de acceso especificada o un elemento de la ruta de acceso, existe y su tipo de recurso no es válido para esta operación". 409 Conflicto, SourcePathIsBeingDeleted, "La ruta de acceso de origen especificada está marcada para eliminarse". 409 Conflicto, ResourceTypeMismatch, "El tipo de recurso especificado en la solicitud no coincide con el tipo del recurso". 412 Error de condición previa, ConditionNotMet, "No se cumple la condición especificada mediante encabezados condicionales HTTP". 412 Error de condición previa, LeaseIdMismatch, "El identificador de concesión especificado no coincide con el identificador de concesión del recurso". 412 Error de condición previa, LeaseIdMissing, "Actualmente hay una concesión en el recurso y no se especificó ningún identificador de concesión en la solicitud". 412 Error de condición previa, LeaseNotPresent, "Actualmente no hay ninguna concesión en el recurso". 412 Error de condición previa, LeaseLost, "Se especificó un identificador de concesión, pero la concesión del recurso ha expirado". 412 Error de condición previa, SourceConditionNotMet, "No se cumple la condición de origen especificada mediante encabezados condicionales HTTP". 413 Solicitar entidad demasiado grande, RequestBodyTooLarge, "El cuerpo de la solicitud es demasiado grande y supera el límite máximo permitido". 416 Intervalo solicitado no satisfiable, InvalidRange, "El intervalo especificado no es válido para el tamaño actual del recurso". 500 Error interno del servidor, InternalError, "El servidor encontró un error interno. Vuelva a intentar realizar la solicitud" 500 Error interno del servidor, OperationTimedOut, "No se pudo completar la operación dentro del tiempo permitido". 503 Servicio no disponible, ServerBusy, "La salida supera el límite de la cuenta". 503 Servicio no disponible, ServerBusy, "La entrada supera el límite de la cuenta". 503 Servicio no disponible, ServerBusy, "Las operaciones por segundo superan el límite de la cuenta". 503 Servicio no disponible, ServerBusy, "El servidor no puede recibir solicitudes actualmente. Please retry your request". (El programa de instalación del clúster no pudo instalar los componentes en uno o más hosts. Vuelva a intentar realizar la solicitud) Encabezados x-ms-request-id: string x-ms-version: string

Nombre

Tipo

Description

200 OK

Devuelve todas las propiedades del archivo o directorio.

Encabezados

Accept-Ranges: string
Cache-Control: string
Content-Disposition: string
Content-Encoding: string
Content-Language: string
Content-Length: integer
Content-Range: string
Content-Type: string
Content-MD5: string
Date: string
ETag: string
Last-Modified: string
x-ms-request-id: string
x-ms-version: string
x-ms-resource-type: string
x-ms-properties: string
x-ms-owner: string
x-ms-group: string
x-ms-permissions: string
x-ms-acl: string
x-ms-lease-duration: string
x-ms-lease-state: string
x-ms-lease-status: string
x-ms-server-encrypted: true/false: boolean
x-ms-encryption-key-sha256: string
x-ms-encryption-context: string
x-ms-encryption-scope: string
x-ms-creation-time: string
x-ms-expiry-time: string

Other Status Codes

DataLakeStorageError

Se produjo un error. A continuación se enumeran los posibles estados HTTP, código y cadenas de mensaje:

400 Solicitud incorrecta, ContentLengthMustBeZero, "El encabezado de solicitud Content-Length debe ser cero".
400 Solicitud incorrecta, InvalidAuthenticationInfo, "La información de autenticación no se proporciona en el formato correcto. Compruebe el valor del encabezado Authorization".
400 Solicitud incorrecta, InvalidFlushPosition, "Los datos cargados no son contiguos o el valor del parámetro de consulta de posición no es igual a la longitud del archivo después de anexar los datos cargados".
400 Solicitud incorrecta, InvalidHeaderValue, "El valor de uno de los encabezados HTTP no está en el formato correcto".
400 Solicitud incorrecta, InvalidHttpVerb, "El verbo HTTP especificado no es válido; el servidor no lo reconoce".
400 Solicitud incorrecta, InvalidInput, "Una de las entradas de solicitud no es válida".
400 Solicitud incorrecta, InvalidPropertyName, "Un nombre de propiedad no puede estar vacío".
400 Solicitud incorrecta, InvalidPropertyName, "El nombre de la propiedad contiene caracteres no válidos".
400 Solicitud incorrecta, InvalidQueryParameterValue, "El valor de uno de los parámetros de consulta especificados en el URI de solicitud no es válido".
400 Solicitud incorrecta, InvalidResourceName, "El nombre del recurso especificado contiene caracteres no válidos".
400 Solicitud incorrecta, InvalidSourceUri, "El URI de origen no es válido".
400 Solicitud incorrecta, InvalidUri, "El URI de solicitud no es válido".
400 Solicitud incorrecta, MissingRequiredHeader, "No se especifica un encabezado HTTP que sea obligatorio para esta solicitud".
400 Solicitud incorrecta, MissingRequiredQueryParameter, "No se especifica un parámetro de consulta obligatorio para esta solicitud".
400 Solicitud incorrecta, MultipleConditionHeadersNotSupported, "No se admiten varios encabezados de condición".
400 Solicitud incorrecta, OutOfRangeInput, "Una de las entradas de solicitud está fuera del intervalo".
400 Solicitud incorrecta, OutOfRangeQueryParameterValue, "Uno de los parámetros de consulta especificados en el URI de solicitud está fuera del intervalo permitido".
400 Solicitud incorrecta, UnsupportedHeader, "No se admite uno de los encabezados especificados en la solicitud".
400 Solicitud incorrecta, UnsupportedQueryParameter, "No se admite uno de los parámetros de consulta especificados en el URI de solicitud".
400 Solicitud incorrecta, NosupportedRestVersion, "La versión rest especificada no es compatible".
403 Prohibido, AccountIsDisabled, "La cuenta especificada está deshabilitada".
403 Prohibido, AuthorizationFailure, "Esta solicitud no está autorizada para realizar esta operación".
403 Prohibido, InsufficientAccountPermissions, "La cuenta a la que se accede no tiene permisos suficientes para ejecutar esta operación".
404 No encontrado, FilesystemNotFound, "El sistema de archivos especificado no existe".
404 No encontrado, PathNotFound, "La ruta de acceso especificada no existe".
404 No encontrado, RenameDestinationParentPathNotFound, "El directorio primario de la ruta de acceso de destino no existe".
404 No encontrado, ResourceNotFound, "El recurso especificado no existe".
404 No encontrado, SourcePathNotFound, "La ruta de acceso de origen para una operación de cambio de nombre no existe".
405 Método no permitido, UnsupportedHttpVerb, "El recurso no admite el verbo HTTP especificado".
409 Conflicto, DestinationPathIsBeingDeleted, "La ruta de acceso de destino especificada está marcada para eliminarse".
409 Conflicto, DirectoryNotEmpty, "El valor del parámetro de consulta recursivo debe ser true para eliminar un directorio no vacío".
409 Conflicto, FilesystemAlreadyExists, "El sistema de archivos especificado ya existe".
409 Conflicto, FilesystemBeingDeleted, "Se está eliminando el sistema de archivos especificado".
409 Conflicto, InvalidDestinationPath, "La ruta de acceso especificada o un elemento de la ruta de acceso, existe y su tipo de recurso no es válido para esta operación". * 409 Conflicto, InvalidFlushOperation, "La API de Blob Service creó o modificó el recurso y no se puede escribir en la API de servicio de Data Lake Storage".
409 Conflicto, InvalidRenameSourcePath, "El directorio de origen no puede ser el mismo que el directorio de destino, ni el destino puede ser un subdirectorio del directorio de origen".
409 Conflicto, InvalidSourceOrDestinationResourceType, "El tipo de recurso de origen y destino debe ser idéntico".
409 Conflicto, LeaseAlreadyPresent, "Ya hay una concesión presente".
409 Conflicto, LeaseIdMismatchWithLeaseOperation, "El identificador de concesión especificado no coincide con el identificador de concesión del recurso con la operación de concesión especificada".
409 Conflicto, LeaseIsAlreadyBroken, "La concesión ya se ha roto y no se puede romper de nuevo".
409 Conflicto, LeaseIsBreakingAndCannotBeAcquired, "El identificador de concesión coincide, pero la concesión está actualmente en estado de interrupción y no se puede adquirir hasta que se interrumpe".
409 Conflicto, LeaseIsBreakingAndCannotBeChanged, "El identificador de concesión coincide, pero la concesión está actualmente en estado importante y no se puede cambiar".
409 Conflicto, LeaseIsBrokenAndCannotBeRenewed, "El identificador de concesión coincide, pero la concesión se ha roto explícitamente y no se puede renovar".
409 Conflicto, LeaseNameMismatch, "El nombre de concesión especificado no coincide con el nombre de concesión existente".
409 Conflicto, LeaseNotPresentWithLeaseOperation, "El identificador de concesión no está presente con la operación de concesión especificada".
409 Conflicto, PathAlreadyExists, "La ruta de acceso especificada ya existe".
409 Conflicto, PathConflict, "La ruta de acceso especificada o un elemento de la ruta de acceso, existe y su tipo de recurso no es válido para esta operación".
409 Conflicto, SourcePathIsBeingDeleted, "La ruta de acceso de origen especificada está marcada para eliminarse".
409 Conflicto, ResourceTypeMismatch, "El tipo de recurso especificado en la solicitud no coincide con el tipo del recurso".
412 Error de condición previa, ConditionNotMet, "No se cumple la condición especificada mediante encabezados condicionales HTTP".
412 Error de condición previa, LeaseIdMismatch, "El identificador de concesión especificado no coincide con el identificador de concesión del recurso".
412 Error de condición previa, LeaseIdMissing, "Actualmente hay una concesión en el recurso y no se especificó ningún identificador de concesión en la solicitud".
412 Error de condición previa, LeaseNotPresent, "Actualmente no hay ninguna concesión en el recurso".
412 Error de condición previa, LeaseLost, "Se especificó un identificador de concesión, pero la concesión del recurso ha expirado".
412 Error de condición previa, SourceConditionNotMet, "No se cumple la condición de origen especificada mediante encabezados condicionales HTTP".
413 Solicitar entidad demasiado grande, RequestBodyTooLarge, "El cuerpo de la solicitud es demasiado grande y supera el límite máximo permitido".
416 Intervalo solicitado no satisfiable, InvalidRange, "El intervalo especificado no es válido para el tamaño actual del recurso".
500 Error interno del servidor, InternalError, "El servidor encontró un error interno. Vuelva a intentar realizar la solicitud"
500 Error interno del servidor, OperationTimedOut, "No se pudo completar la operación dentro del tiempo permitido".
503 Servicio no disponible, ServerBusy, "La salida supera el límite de la cuenta".
503 Servicio no disponible, ServerBusy, "La entrada supera el límite de la cuenta".
503 Servicio no disponible, ServerBusy, "Las operaciones por segundo superan el límite de la cuenta".
503 Servicio no disponible, ServerBusy, "El servidor no puede recibir solicitudes actualmente. Please retry your request". (El programa de instalación del clúster no pudo instalar los componentes en uno o más hosts. Vuelva a intentar realizar la solicitud)

Encabezados

x-ms-request-id: string
x-ms-version: string

Definiciones

Nombre	Description
DataLakeStorageError
Error	Objeto de respuesta de error del servicio.
PathGetPropertiesAction	Opcional. Si el valor es "getStatus" solo se devuelven las propiedades definidas por el sistema para la ruta de acceso. Si el valor es "getAccessControl", la lista de control de acceso se devuelve en los encabezados de respuesta (el espacio de nombres jerárquico debe estar habilitado para la cuenta), de lo contrario, se devuelven las propiedades.

DataLakeStorageError

Nombre	Tipo	Description
error	Error	Objeto de respuesta de error del servicio.

Error

Objeto de respuesta de error del servicio.

Nombre	Tipo	Description
code	string	Código de error del servicio.
message	string	Mensaje de error del servicio.