Establecer propiedades de archivo
La operación Set File Properties establece las propiedades del sistema en el archivo. Esta operación se admite en la versión 2025-05-05 y posteriores para recursos compartidos de archivos con el protocolo NFS habilitado.
Disponibilidad del protocolo
| Protocolo habilitado para recursos compartidos de archivos | Disponible |
|---|---|
| SMB |
|
| NFS |
|
Pedir
La solicitud Set File Properties se construye 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 las tablas siguientes:
Encabezados de solicitud comunes
| 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. Esta operación se admite en la versión 2025-05-05 y posteriores para recursos compartidos de archivos con el protocolo NFS habilitado. 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-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. Este encabezado se omite si el archivo se encuentra en un recurso compartido de archivos con el protocolo NFS habilitado, que no admite concesiones de archivos. |
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-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. Este encabezado se omite si el destino se encuentra en un recurso compartido de archivos con el protocolo NFS habilitado, que admite el punto final de forma predeterminada. Para obtener más información, vea Asignar nombres y hacer referencia a recursos compartidos, directorios, archivos y metadatos. |
Encabezados de solicitud solo SMB
| Encabezado de solicitud | Descripción |
|---|---|
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-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 se establece en preserve, no se debe establecer este encabezado. Si x-ms-file-permission se establece en cualquier otro valor que no sea preservey, 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. |
Encabezados de solicitud solo NFS
| Encabezado de solicitud | Descripción |
|---|---|
x-ms-mode |
Versión 2025-05-05 y posteriores. Bits de modo que se van a establecer en el archivo. El modo se representa en el formato octal numérico de 12 bits o en el formato simbólico "rwx". Consulte permisos de archivo POSIX (modo). |
x-ms-owner |
Versión 2025-05-05 y posteriores. Identificador de usuario (UID) del propietario del archivo que se va a establecer en el archivo. |
x-ms-group |
Versión 2025-05-05 y posteriores. Identificador de grupo (GID) del propietario del archivo que se va a establecer en el archivo. |
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. 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 encabezados de las tablas siguientes. 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 .
Encabezados de respuesta comunes
| 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-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. |
Encabezados de respuesta solo SMB
| Encabezado de respuesta | Descripción |
|---|---|
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 del archivo. Para obtener más información, consulte la lista de atributos disponibles. |
Encabezados de respuesta solo NFS
| Encabezado de respuesta | Descripción |
|---|---|
x-ms-mode |
Versión 2025-05-05 y posteriores. Modo del archivo. Consulte permisos de archivo POSIX (modo). |
x-ms-owner |
Versión 2025-05-05 y posteriores. Identificador de usuario (UID) del propietario del archivo. |
x-ms-group |
Versión 2025-05-05 y posteriores. Identificador de grupo (GID) del propietario del archivo. |
x-ms-link-count |
Versión 2025-05-05 y posteriores. Recuento de vínculos del archivo. |
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. |
Permisos de archivo POSIX (modo)
Los permisos de archivo POSIX se pueden especificar numéricamente en un formato octal numérico de 12 bits o en un formato simbólico "rwx". Ejemplos:
- "0644" o "rw-r--r--": el usuario (propietario del archivo) tiene permiso de lectura y escritura. El grupo tiene permiso de lectura. Otros tienen permiso de lectura.
- "0755" o "rwxr-xr-x": el usuario (propietario del archivo) tiene permiso de lectura, escritura y ejecución. El grupo tiene permiso de lectura y ejecución. Otros tienen permiso de lectura y ejecución.
Formato octal numérico
Los tres números octales de orden más bajo representan los permisos para propietario/usuario, grupo y otros, y se indica mediante un número octal (0-7), formado mediante una combinación bit a bit de '4' (Lectura), '2' (Escritura), '1' (Ejecutar). El número octal de orden más alto (0-7) se usa para indicar una combinación de '4' (SetUID), '2' (SetGID), '1' (StickyBit) permisos.
| Formato | Permiso |
|---|---|
| 0700 | El usuario (propietario del archivo) tiene permiso de lectura, escritura y ejecución. |
| 0400 | El usuario tiene permiso de lectura. |
| 0200 | El usuario tiene permiso de escritura. |
| 0100 | El usuario tiene permiso de ejecución. |
| 0070 | El grupo tiene permiso de lectura, escritura y ejecución. |
| 0040 | El grupo tiene permiso de lectura. |
| 0020 | El grupo tiene permiso de escritura. |
| 0010 | El grupo tiene permiso de ejecución. |
| 0007 | Otros tienen permiso de lectura, escritura y ejecución. |
| 0004 | Otros tienen permiso de lectura. |
| 0002 | Otros tienen permiso de escritura. |
| 0001 | Otros tienen permiso de ejecución. |
| 4000 | Establezca el identificador de usuario efectivo en el archivo. |
| 2000 | Establezca el identificador de grupo efectivo en el archivo. |
| 1000 | Establézcalo para indicar que el archivo solo se puede eliminar o cambiar el nombre por el propietario del archivo, el propietario del directorio o el usuario raíz. |
Formato simbólico "rwx"
Los permisos de propietario/usuario, grupo y otros se indican mediante una combinación de caracteres "r" (Lectura), "w" (Escritura) y "x" (Ejecutar).
| Formato | Permiso |
|---|---|
| rwx------ | El usuario (propietario del archivo) tiene permiso de lectura, escritura y ejecución. |
| r-------- | El usuario tiene permiso de lectura. |
| -w------- | El usuario tiene permiso de escritura. |
| --x------ | El usuario tiene permiso de ejecución. |
| ---rwx--- | El grupo tiene permiso de lectura, escritura y ejecución. |
| ---r----- | El grupo tiene permiso de lectura. |
| ----w---- | El grupo tiene permiso de escritura. |
| -----x--- | El grupo tiene permiso de ejecución. |
| ------rwx | Otros tienen permiso de lectura, escritura y ejecución. |
| ------r- | Otros tienen permiso de lectura. |
| -------w- | Otros tienen permiso de escritura. |
| --------x | Otros tienen permiso de ejecución. |
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-lengthy ninguna otra propiedad:- Si el archivo se encuentra en un recurso compartido de archivos con el protocolo SMB habilitado, no se modifica ninguna de las otras propiedades del archivo.
- Si el archivo se encuentra en un recurso compartido de archivos con el protocolo NFS habilitado, se modifica la hora de cambio del archivo y la hora de última escritura.
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-controlx-ms-content-typex-ms-content-md5x-ms-content-encodingx-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 archivos