Establecer propiedades de directorio

Artículo
08/07/2024

La operación Set Directory Properties establece las propiedades del sistema para el directorio especificado. Esta API está disponible a partir de la versión 2019-02-02.

Disponibilidad del protocolo

Protocolo habilitado para recursos compartidos de archivos	Disponible
SMB
NFS

Pedir

La solicitud de Set Directory 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/mydirectory?restype=directory&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.
`mydirectory`	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-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 directorio especificado en el lenguaje de definición de descriptores de seguridad (SDDL) o (versión 2024-11-04 o posterior) en formato de descriptor de seguridad binario codificado en base64. 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). Para mantener un valor existente sin cambios, puede pasar un valor de `preserve`. 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-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 para las versiones 2019-02-02 a 2021-04-10. Opcional para la 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 para las versiones 2019-02-02 a 2021-04-10. Opcional para la versión 2021-06-08 y posteriores. Propiedad de hora universal coordinada (UTC) para un directorio. 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 para las versiones 2019-02-02 a 2021-04-10. Opcional para la versión 2021-06-08 y posteriores. Propiedad de última escritura de la hora universal coordinada (UTC) de un directorio. Se puede pasar un valor de `preserve` para mantener un valor existente sin cambios. El valor predeterminado es `preserve`.
`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 directorio, con el 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 más 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 directorio. 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 que se realizó 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 que se usó 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 directorio.
`x-ms-file-attributes`	Versión 2019-02-02 y posteriores. Atributos del sistema de archivos en el directorio. 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 directorio.
`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 directorio.
`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 directorio.
`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	Directorio que es de solo lectura.
Escondido	FILE_ATTRIBUTE_HIDDEN	El directorio está oculto. No se incluye en una lista de directorios normal.
Sistema	FILE_ATTRIBUTE_SYSTEM	Directorio del que el sistema operativo usa una parte o usa exclusivamente.
Ninguno	FILE_ATTRIBUTE_NORMAL	Directorio que no tiene otros atributos establecidos. Este atributo solo es válido cuando se usa solo.
Directorio	FILE_ATTRIBUTE_DIRECTORY	Identificador que identifica un directorio.
Archivo	FILE_ATTRIBUTE_ARCHIVE	Directorio que es un directorio de archivo. Las aplicaciones suelen usar este atributo para marcar los archivos de copia de seguridad o eliminación.
Sin conexión	FILE_ATTRIBUTE_OFFLINE	Los datos de un directorio 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 directorio.
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

Set Directory 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).

Las propiedades que se establecen en un directorio con Set Directory Properties no se propagan a ningún subdirectorio debajo de ese directorio. Debe llamar a Set Directory Properties para cada directorio para el que desea actualizar las propiedades.

Consulte también

Operaciones de en directorios

Compartir a través de