Set File Properties

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

Disponibilidad del protocolo

Protocolo de recurso compartido de archivos habilitado Disponible
SMB Sí
NFS No

Solicitud

La solicitud Set File Properties se puede construir como sigue. Se recomienda usar HTTPS.

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

Reemplace los componentes de la ruta de acceso que se muestran en el URI de solicitud por los suyos de la siguiente manera:

Componente de ruta de acceso Descripción
myaccount El nombre de la cuenta de almacenamiento.
myshare El nombre del recurso compartido de archivos.
mydirectorypath Opcional. La ruta de acceso al directorio principal.
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 del identificador 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 Establecimiento de 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 Necesario. Especifica el esquema de autorización, el nombre de cuenta y la firma. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
Date o x-ms-date Necesario. Especifica la hora universal coordinada (UTC) de la solicitud. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
x-ms-version Necesario para todas las solicitudes autorizadas. Especifica la versión de la operación que se utiliza para esta solicitud. Para obtener más información, vea Versiones de 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 Get File Properties 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 Get File Properties 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 Get File Properties 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 del contenido del archivo.

Si no se especifica esta propiedad en la solicitud, la propiedad se borra para el archivo. Las llamadas posteriores a Get File Properties no devolverán esta propiedad, a menos que se establezca explícitamente en el archivo de nuevo.
x-ms-content-language Opcional. Establece el lenguaje del contenido del archivo.

Si no se especifica esta propiedad en la solicitud, la propiedad se borra para el archivo. Las llamadas posteriores a Get File Properties 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 del Content-Disposition archivo.

Si no se especifica esta propiedad en la solicitud, la propiedad se borra para el archivo. Las llamadas posteriores a Get File Properties 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 byte especificado.
x-ms-file-permission: { preserve ¦ <SDDL> } En las versiones 2019-02-02 a 2021-04-10, este encabezado es necesario si x-ms-file-permission-key no se especifica. A partir de la versión 2021-06-08, ambos encabezados son opcionales. Este permiso es el descriptor de seguridad del archivo especificado en el Lenguaje de definición de descriptores de seguridad (SDDL). 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, un grupo y una 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 ninguno de los encabezados, se usa el valor predeterminado de preserve .
x-ms-file-permission-key: <PermissionKey> En las versiones 2019-02-02 a 2021-04-10, este encabezado es necesario si x-ms-file-permission no se especifica. 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 Create-Permission API.

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 x-ms-file-permission encabezado.
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 preserve se especifica y se cambia el tamaño del archivo, la hora de la ú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> Requerido 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 obtener más información, consulte Supervisión de 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 del 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 el encabezado especifica un token de OAuth. El valor aceptable es backup. Este encabezado especifica que se debe conceder o Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/actionMicrosoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action si se incluyen en la directiva de RBAC asignada a la identidad autorizada mediante el Authorization encabezado . 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, consulte Nomenclatura y referencia a recursos compartidos, directorios, archivos y metadatos.

Cuerpo de la solicitud

Ninguno.

Response

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

status code

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

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

Encabezados de respuesta

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

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 la fecha sigue las convenciones de 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 que se realizó y se puede usar para solucionar problemas de la solicitud. Para más información, consulte Solución de problemas de operaciones de API.
x-ms-version Indica la versión del servicio Archivo usada 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 true en 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 última propiedad de hora de 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 x-ms-client-request-id encabezado si está presente en la solicitud y el valor no contiene más de 1024 caracteres ASCII visibles. Si el x-ms-client-request-id encabezado no está presente en la solicitud, no estará presente en la respuesta.

Response body

Ninguno.

Authorization

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 Archivo que es de solo lectura. Las aplicaciones pueden leer el archivo, pero no pueden escribir en él ni eliminarlo.
Hidden 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 utiliza exclusivamente.
None FILE_ATTRIBUTE_NORMAL Archivo que no tiene otros atributos establecidos. Este atributo solo es válido cuando se usa solo.
Archivar 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.
Temporales FILE_ATTRIBUTE_TEMPORARY 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.

Comentarios

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

  • El tamaño de un archivo únicamente 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 al intentar 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 file 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 de archivos también devuelve el código de estado 412 (error de condición previa).

Consulte también

Operaciones en Azure Files