Establecer propiedades de archivo

Artículo
08/07/2024

La operación Set File Properties establece las propiedades del sistema en el archivo.

Disponibilidad del protocolo

Protocolo habilitado para recursos compartidos de archivos	Disponible
SMB
NFS

Pedir

La solicitud de Set File Properties se puede construir de la siguiente manera. Se recomienda usar HTTPS.

Método	URI de solicitud	Versión HTTP
PONER	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=properties`	HTTP/1.1

Reemplace los componentes de ruta de acceso que se muestran en el URI de solicitud por el suyo propio, como se indica a continuación:

Componente de ruta de acceso	Descripción
`myaccount`	Nombre de la cuenta de almacenamiento.
`myshare`	Nombre del recurso compartido de archivos.
`mydirectorypath`	Opcional. Ruta de acceso al directorio primario.
`myfile`	Nombre del archivo.

Para obtener información sobre las restricciones de nomenclatura de rutas de acceso, vea Recursos compartidos de nombres y referencia, directorios, archivos y metadatos.

Parámetros de URI

Puede especificar los siguientes parámetros adicionales en el URI de solicitud:

Parámetro	Descripción
`timeout`	Opcional. El parámetro `timeout` se expresa en segundos. Para obtener más información, consulte Establecer tiempos de espera para las operaciones del servicio de archivos.

Encabezados de solicitud

Los encabezados de solicitud obligatorios y opcionales se describen en la tabla siguiente:

Encabezado de solicitud	Descripción
`Authorization`	Obligatorio. Especifica el esquema de autorización, el nombre de la cuenta y la firma. Para más información, consulte Autorizar solicitudes a Azure Storage.
`Date` o `x-ms-date`	Obligatorio. Especifica la hora universal coordinada (UTC) de la solicitud. Para más información, consulte Autorizar solicitudes a Azure Storage.
`x-ms-version`	Necesario para todas las solicitudes autorizadas. Especifica la versión de la operación que se va a usar para esta solicitud. Para más información, consulte Control de versiones de para los servicios de Azure Storage.
`x-ms-cache-control`	Opcional. Modifica la cadena de control de caché para el archivo. Si no se especifica esta propiedad en la solicitud, la propiedad se borra para el archivo. Las llamadas posteriores a Obtener propiedades de archivo no devolverán esta propiedad, a menos que se establezca explícitamente en el archivo de nuevo.
`x-ms-content-type`	Opcional. Establece el tipo de contenido del archivo. Si no se especifica esta propiedad en la solicitud, la propiedad se borra para el archivo. Las llamadas posteriores a Obtener propiedades de archivo no devolverán esta propiedad, a menos que se establezca explícitamente en el archivo de nuevo.
`x-ms-content-md5`	Opcional. Establece el hash MD5 del archivo. Si no se especifica esta propiedad en la solicitud, la propiedad se borra para el archivo. Las llamadas posteriores a Obtener propiedades de archivo no devolverán esta propiedad, a menos que se establezca explícitamente en el archivo de nuevo.
`x-ms-content-encoding`	Opcional. Establece la codificación de contenido del archivo. Si no se especifica esta propiedad en la solicitud, la propiedad se borra para el archivo. Las llamadas posteriores a Obtener propiedades de archivo no devolverán esta propiedad, a menos que se establezca explícitamente en el archivo de nuevo.
`x-ms-content-language`	Opcional. Establece el idioma de contenido del archivo. Si no se especifica esta propiedad en la solicitud, la propiedad se borra para el archivo. Las llamadas posteriores a Obtener propiedades de archivo no devolverán esta propiedad, a menos que se establezca explícitamente en el archivo de nuevo.
`x-ms-content-disposition`	Opcional. Establece el encabezado `Content-Disposition` del archivo. Si no se especifica esta propiedad en la solicitud, la propiedad se borra para el archivo. Las llamadas posteriores a Obtener propiedades de archivo no devolverán esta propiedad, a menos que se establezca explícitamente en el archivo de nuevo.
`x-ms-content-length: bytes`	Opcional. Cambia el tamaño de un archivo al tamaño especificado. Si el valor de byte especificado es menor que el tamaño actual del archivo, se borran todos los intervalos por encima del valor de bytes especificado.
`x-ms-file-permission: { preserve ¦ <SDDL> ¦ <binary> }`	En las versiones 2019-02-02 a 2021-04-10, este encabezado es necesario si no se especifica `x-ms-file-permission-key`. A partir de la versión 2021-06-08, ambos encabezados son opcionales. Este permiso es el descriptor de seguridad del archivo especificado en la lenguaje de definición de descriptores de seguridad (SDDL) o (versión 2024-11-04 o posterior) en formato de descriptor de seguridad binario . Puede especificar el formato que se va a usar con el encabezado `x-ms-file-permission-format`. Puede usar este encabezado si el tamaño de los permisos es de 8 kibibytes (KiB) o menos. De lo contrario, puede usar `x-ms-file-permission-key`. Si se especifica, debe tener un propietario, grupo y lista de control de acceso discrecional (DACL). Se puede pasar un valor de `preserve` para mantener un valor existente sin cambios. Nota: puede especificar `x-ms-file-permission` o `x-ms-file-permission-key`. Si no se especifica ningún encabezado, se usa el valor predeterminado de `preserve`.
`x-ms-file-permission-format: { sddl ¦ binary }`	Opcional. Versión 2024-11-04 o posterior. Especifica si el valor pasado en `x-ms-file-permission` está en SDDL o en formato binario. Si `x-ms-file-permission-key` se establece en `preserve`, este encabezado no debe establecerse. Si `x-ms-file-permission-key` se establece en cualquier otro valor que no sea `preserve`y si no se establece este encabezado, se usa el valor predeterminado de `sddl`.
`x-ms-file-permission-key: <PermissionKey>`	En las versiones 2019-02-02 a 2021-04-10, este encabezado es necesario si no se especifica `x-ms-file-permission`. A partir de la versión 2021-06-08, ambos encabezados son opcionales. Clave del permiso que se va a establecer para el archivo. Esto se puede crear mediante la API de `Create-Permission`. Nota: puede especificar `x-ms-file-permission` o `x-ms-file-permission-key`. Si no se especifica ningún encabezado, se usa el valor predeterminado de `preserve` para el encabezado `x-ms-file-permission`.
`x-ms-file-attributes: { preserve ¦ <FileAttributeList> }`	Obligatorio, versión 2019-02-02 a 2021-04-10. Opcional, versión 2021-06-08 y posteriores. Atributos del sistema de archivos que se van a establecer en el archivo. Consulte la lista de atributos disponibles . Se puede pasar un valor de `preserve` para mantener un valor existente sin cambios. El valor predeterminado es `preserve`.
`x-ms-file-creation-time: { preserve ¦ <DateTime> }`	Obligatorio, versión 2019-02-02 a 2021-04-10. Opcional, versión 2021-06-08 y posteriores. Propiedad de hora universal coordinada (UTC) para un archivo. Se puede pasar un valor de `preserve` para mantener un valor existente sin cambios. El valor predeterminado es `preserve`.
`x-ms-file-last-write-time: { preserve ¦ <DateTime> }`	Obligatorio, versión 2019-02-02 a 2021-04-10. Opcional, versión 2021-06-08 y posteriores. La propiedad de última escritura de la hora universal coordinada (UTC) de un archivo. Se puede pasar un valor de `preserve` para mantener un valor existente sin cambios. Si se especifica `preserve` y se cambia el tamaño del archivo, la hora de última escritura se actualiza a la hora actual. Si se cambia el tamaño del archivo, pero se proporciona una marca de tiempo explícita, se usa la marca de tiempo explícita. El valor predeterminado es `preserve`.
`x-ms-lease-id: <ID>`	Obligatorio si el archivo tiene una concesión activa. Disponible para la versión 2019-02-02 y posteriores.
`x-ms-client-request-id`	Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 kibibyte (KiB) que se registra en los registros cuando se configura el registro. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes que recibe el servidor. Para más información, consulte Monitor Azure Files.
`x-ms-file-change-time: { now ¦ <DateTime> }`	Opcional. Versión 2021-06-08 y posteriores. La propiedad hora universal coordinada (UTC) cambia la propiedad de hora para el archivo, con formato ISO 8601. Puede usar un valor de `now` para indicar la hora de la solicitud. El valor predeterminado es `now`.
`x-ms-file-request-intent`	Obligatorio si `Authorization` encabezado especifica un token de OAuth. El valor aceptable es `backup`. Este encabezado especifica que se debe conceder el `Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action` o `Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action` si se incluyen en la directiva de RBAC asignada a la identidad autorizada mediante el encabezado `Authorization`. Disponible para la versión 2022-11-02 y posteriores.
`x-ms-allow-trailing-dot: { <Boolean> }`	Opcional. Versión 2022-11-02 y posteriores. El valor booleano especifica si se debe recortar o no un punto final presente en la dirección URL de solicitud. Para obtener más información, vea Asignar nombres y hacer referencia a recursos compartidos, directorios, archivos y metadatos.

Cuerpo de la solicitud

Ninguno.

Respuesta

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

Código de estado

Una operación correcta devuelve el código de estado 200 (Correcto).

Para obtener información sobre los códigos de estado, vea Códigos de estado y de error.

Encabezados de respuesta

La respuesta de esta operación incluye los siguientes encabezados. La respuesta también puede incluir encabezados HTTP estándar adicionales. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1 de .

Encabezado de respuesta	Descripción
`ETag`	Contiene un valor que representa la versión del archivo. El valor se incluye entre comillas.
`Last-Modified`	Devuelve la fecha y hora en que se modificó por última vez el archivo. El formato de fecha sigue a RFC 1123. Para obtener más información, vea Representar valores de fecha y hora en encabezados. Cualquier operación que modifique el directorio o sus propiedades actualiza la hora de última modificación. Las operaciones en archivos no afectan a la hora de la última modificación del directorio.
`x-ms-request-id`	Identifica de forma única la solicitud realizada y se puede usar para solucionar problemas de la solicitud. Para obtener más información, consulte Solución de problemas de operaciones de API.
`x-ms-version`	Indica la versión del servicio File usado para ejecutar la solicitud.
`Date` o `x-ms-date`	Valor de fecha y hora UTC generado por el servicio, que indica la hora en que se inició la respuesta.
`x-ms-request-server-encrypted: true/false`	Versión 2017-04-17 y posteriores. El valor de este encabezado se establece en `true` si el contenido de la solicitud se cifra correctamente mediante el algoritmo especificado. De lo contrario, el valor se establece en `false`.
`x-ms-file-permission-key`	Versión 2019-02-02 y posteriores. Clave del permiso del archivo.
`x-ms-file-attributes`	Versión 2019-02-02 y posteriores. Atributos del sistema de archivos en el archivo. Para obtener más información, consulte la lista de atributos disponibles.
`x-ms-file-creation-time`	Versión 2019-02-02 y posteriores. Valor de fecha y hora UTC que representa la propiedad de hora de creación del archivo.
`x-ms-file-last-write-time`	Versión 2019-02-02 y posteriores. Valor de fecha y hora UTC que representa la propiedad de hora de última escritura del archivo.
`x-ms-file-change-time`	Versión 2019-02-02 y posteriores. Valor de fecha y hora UTC que representa la propiedad de hora de cambio del archivo.
`x-ms-client-request-id`	Se puede usar para solucionar problemas de solicitudes y respuestas correspondientes. El valor de este encabezado es igual al valor del encabezado `x-ms-client-request-id` si está presente en la solicitud y el valor no contiene más de 1024 caracteres ASCII visibles. Si el encabezado `x-ms-client-request-id` no está presente en la solicitud, no estará presente en la respuesta.

Cuerpo de la respuesta

Ninguno.

Autorización

Solo el propietario de la cuenta puede llamar a esta operación.

Atributos del sistema de archivos

Atributo	Atributo de archivo Win32	Definición
ReadOnly	FILE_ATTRIBUTE_READONLY	Un archivo que es de solo lectura. Las aplicaciones pueden leer el archivo, pero no pueden escribir en él ni eliminarlo.
Escondido	FILE_ATTRIBUTE_HIDDEN	El archivo está oculto. No se incluye en una lista de directorios normal.
Sistema	FILE_ATTRIBUTE_SYSTEM	Un archivo del que el sistema operativo usa una parte de o usa exclusivamente.
Ninguno	FILE_ATTRIBUTE_NORMAL	Archivo que no tiene otros atributos establecidos. Este atributo solo es válido cuando se usa solo.
Archivo	FILE_ATTRIBUTE_ARCHIVE	Un archivo que es un archivo de archivo. Normalmente, las aplicaciones usan este atributo para marcar los archivos de copia de seguridad o eliminación.
Temporal	FILE_ATTRIBUTE_TEMPORARY	Un archivo que se usa para el almacenamiento temporal.
Sin conexión	FILE_ATTRIBUTE_OFFLINE	Los datos de un archivo no están disponibles inmediatamente. Este atributo del sistema de archivos se presenta principalmente para proporcionar compatibilidad con Windows. Azure Files no admite opciones de almacenamiento sin conexión.
NotContentIndexed	FILE_ATTRIBUTE_NOT_CONTENT_INDEXED	El servicio de indexación de contenido no indexa el archivo.
NoScrubData	FILE_ATTRIBUTE_NO_SCRUB_DATA	El analizador de integridad de datos en segundo plano no debe leer el flujo de datos de usuario. Este atributo del sistema de archivos se presenta principalmente para proporcionar compatibilidad con Windows.

Observaciones

La semántica para actualizar las propiedades de un archivo es la siguiente:

El tamaño de un archivo solo se modifica si la solicitud especifica un valor para el encabezado x-ms-content-length.
Si una solicitud establece solo x-ms-content-length y ninguna otra propiedad, no se modifican otras propiedades del archivo.
Si se establece una o varias de las siguientes propiedades en la solicitud, todas estas propiedades se establecen juntas. Si no se proporciona un valor para una propiedad especificada cuando se establece al menos una de las siguientes propiedades, esa propiedad se borra para el archivo.
- x-ms-cache-control
- x-ms-content-type
- x-ms-content-md5
- x-ms-content-encoding
- x-ms-content-language

Nota

Las propiedades de archivo anteriores son independientes de las propiedades del sistema de archivos que están disponibles para los clientes SMB. Los clientes SMB no pueden leer, escribir ni modificar estos valores de propiedad.

Set File properties no se admite en una instantánea de recurso compartido, que es una copia de solo lectura de un recurso compartido. Se produce un error en un intento de realizar esta operación en una instantánea de recurso compartido con 400 (InvalidQueryParameterValue).

Si el archivo tiene una concesión activa, el cliente debe especificar un identificador de concesión válido en la solicitud para escribir propiedades en el archivo. Si el cliente no especifica un identificador de concesión o especifica un identificador de concesión no válido, el servicio de archivos devuelve el código de estado 412 (error de condición previa). Si el cliente especifica un identificador de concesión pero el archivo no tiene una concesión activa, el servicio file también devuelve el código de estado 412 (error de condición previa).

Consulte también

Operaciones de en Azure Files

Compartir a través de