VENTAS: 1-800-867-1389

Set File Properties

Actualizado: abril de 2015

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

La solicitud Set File Properties se puede construir como sigue. Se recomienda 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

El nombre del archivo.

Para obtener información sobre las restricciones de nomenclatura de la ruta de acceso, vea Dar nombre y hacer referencia a recursos compartidos, directorios, archivos y metadatos.

Se pueden especificar los parámetros adicionales siguientes 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, vea Establecimiento de los tiempos de espera para las operaciones del servicio Archivo.

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

 

Encabezado de solicitud Descripción

Authorization

Requerido. Especifica el esquema de autenticación, el nombre de la cuenta y la firma. Para obtener más información, vea Autenticación para los servicios de almacenamiento de Azure.

Date o x-ms-date

Requerido. Especifica la hora universal coordinada (UTC) para la solicitud. Para obtener más información, vea Autenticación para los servicios de almacenamiento de Azure.

x-ms-version

Obligatorio para todas las solicitudes autenticadas. 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 Blob, Cola y Tabla de Windows Azure.

x-ms-cache-control

Opcional. Modifica la cadena de control de caché para el archivo.

Si esta propiedad no se especifica en la solicitud, se desactivará para el archivo. Las llamadas a Get Container Properties posteriores no devolverán esta propiedad, a menos que se vuelva a establecer en el archivo de forma explícita.

x-ms-content-type

Opcional. Establece el tipo de contenido del archivo.

Si esta propiedad no se especifica en la solicitud, se desactivará para el archivo. Las llamadas a Get Container Properties posteriores no devolverán esta propiedad, a menos que se vuelva a establecer en el archivo de forma explícita.

x-ms-content-md5

Opcional. Establece el hash MD5 del archivo.

Si esta propiedad no se especifica en la solicitud, se desactivará para el archivo. Las llamadas a Get Container Properties posteriores no devolverán esta propiedad, a menos que se vuelva a establecer en el archivo de forma explícita.

x-ms-content-encoding

Opcional. Establece la codificación del contenido del archivo.

Si esta propiedad no se especifica en la solicitud, se desactivará para el archivo. Las llamadas a Get Container Properties posteriores no devolverán esta propiedad, a menos que se vuelva a establecer en el archivo de forma explícita.

x-ms-content-language

Opcional. Establece el lenguaje del contenido del archivo.

Si esta propiedad no se especifica en la solicitud, se desactivará para el archivo. Las llamadas a Get Container Properties posteriores no devolverán esta propiedad, a menos que se vuelva a establecer en el archivo de forma explícita.

x-ms-content-disposition

Opcional. Establece el encabezado Content-Disposition del archivo.

Si esta propiedad no se especifica en la solicitud, se desactivará para el archivo. Las llamadas a Get Container Properties posteriores no devolverán esta propiedad, a menos que se vuelva a establecer en el archivo de forma explícita.

x-ms-content-length: bytes

Opcional. Cambia el tamaño de un archivo al tamaño especificado. Si el valor de bytes especificado es menor que el tamaño actual del archivo, se borran todos los intervalos cuyo valor de bytes sea mayor que el especificado.

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

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

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

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 cumplen la especificación del protocolo HTTP/1.1.

 

Encabezado de respuesta Descripción

ETag

La ETag contiene un valor que representa la versión del archivo, entre comillas.

Last-Modified

Devuelve la fecha y hora en que se modificó por última vez el directorio. El formato de la fecha sigue las convenciones de RFC 1123. Para obtener más información, vea Representación de valores de fecha u hora en encabezados. Cualquier operación que modifique el directorio o sus propiedades actualiza la hora de la última modificación. Las operaciones en los archivos no afectan a la hora de última modificación del directorio.

x-ms-request-id

Este encabezado identifica de forma única la solicitud que se realizó y se puede utilizar para solucionar problemas relacionados con esta. Para obtener más información, vea Solucionar problemas relacionados con las operaciones de la API.

x-ms-version

Indica la versión del servicio Archivo usada para ejecutar la solicitud.

Date

Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta.

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

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 solo establece x-ms-content-length y ninguna otra propiedad, no se modifica ninguna de las demás propiedades del archivo.

  • Si en la solicitud se establecen una o varias de las propiedades siguientes, todas se establecen de manera conjunta. Si no se proporciona un valor para una propiedad determinada cuando se ha establecido al menos una de las propiedades siguientes, dicha propiedad se borrará del archivo.

    • x-ms-cache-control

    • x-ms-content-type

    • x-ms-content-md5

    • x-ms-content-encoding

    • x-ms-content-language

noteNota
Las propiedades de archivo enumeradas anteriormente son diferentes de las propiedades del sistema de archivos disponibles para los clientes SMB. Los clientes SMB no se pueden leer, escribir o modificar estos valores de propiedad.

¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios
Mostrar:
© 2015 Microsoft