Establecer propiedades de recurso compartido

La operación Set Share Properties establece las propiedades del recurso compartido de archivos de Azure especificado. Aunque esta operación es totalmente compatible, es una operación de administración heredada. Se recomienda usar la operación Recursos compartidos de archivos: actualizar proporcionada por el proveedor de recursos de almacenamiento (Microsoft.Storage) en su lugar. Para obtener más información sobre la interacción mediante programación con los recursos de FileShare mediante el proveedor de recursos de almacenamiento, consulte Operations on FileShare resources.

Disponibilidad del protocolo

Protocolo habilitado para recursos compartidos de archivos	Disponible
SMB
NFS

Pedir

Puede construir la solicitud Set Share Properties de la siguiente manera. Se recomienda HTTPS. Reemplace myaccount por el nombre de la cuenta de almacenamiento.

Método	URI de solicitud	Versión HTTP
PUT	https://myaccount.file.core.windows.net/myshare?restype=share&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.

Para más información sobre las restricciones de nomenclatura de rutas de acceso, consulte Nomenclatura y referencia a recursos compartidos, 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. Expresado en segundos. Para más información, consulte Establecer tiempos de espera para las operaciones de Azure Files.

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud obligatorios y opcionales:

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-share-quota	Opcional. Compatible con la versión 2015-02-21 y posteriores. Especifica el tamaño máximo del recurso compartido, en gibibytes (GiB).
x-ms-access-tier	Opcional. Compatible con la versión 2019-12-12 y posteriores. Especifica el nivel de acceso del recurso compartido. Los valores válidos son TransactionOptimized, Hoty Cool. Para obtener información detallada sobre la creación de niveles de recursos compartidos de archivos, consulte niveles de almacenamiento de Azure Files.
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash>	Opcional. Compatible con la versión 2020-02-10 y posteriores. Especifica el comportamiento de squash raíz en el recurso compartido cuando nfs está habilitado. NoRootSquash: desactive la squash raíz. RootSquash: asigne solicitudes de UID/GID 0 al UID/GID anónimo. AllSquash: asigne todos los UID y GID al usuario anónimo.
x-ms-enable-snapshot-virtual-directory-access: <true \| false>	Opcional. Compatible con la versión 2024-08-04 y posteriores. Especifica si el directorio virtual de instantáneas debe ser accesible en la raíz del punto de montaje del recurso compartido cuando NFS está habilitado.
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 de Storage Analytics 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 Blob Storage.
x-ms-lease-id:<ID>	Obligatorio si el recurso compartido de archivos de destino tiene una concesión activa. Disponible para la versión 2020-02-10 y posteriores. Si la solicitud no incluye el identificador de concesión o no es válido, se produce un error en la operación con el código de estado 412 (error de condición previa). Si se especifica este encabezado y el recurso compartido de archivos de destino no tiene actualmente una concesión activa, se produce un error en la operación con el código de estado 412 (error de condición previa).
x-ms-share-paid-bursting-enabled: <true \| false>	Opcional. Compatible con la versión 2024-11-04 y posteriores. Solo se permite para recursos compartidos de archivos Premium (recursos compartidos de archivos dentro del tipo de cuenta de almacenamiento FileStorage). Esta propiedad se puede usar para habilitar o deshabilitar la expansión de pago. Si no se especifica la propiedad , el recurso compartido conservará su estado de habilitación de expansión de pago existente.
x-ms-share-paid-bursting-max-iops	Opcional. Compatible con la versión 2024-11-04 y posteriores. Solo se permite para recursos compartidos de archivos Premium. Entero que representa el máximo de operaciones de entrada y salida de expansión de pago por segundo (IOPS) permitidas para el recurso compartido. Si la expansión de pago aún no está habilitada en el recurso compartido: el comportamiento es idéntico al encabezado x-ms-share-paid-bursting-max-iops en Crear recurso compartido. El valor predeterminado si no se especifica es la IOPS máxima permitida para un recurso compartido. Si se establece este encabezado, x-ms-share-paid-bursting-enabled también debe establecerse en true. Si la expansión de pago ya está habilitada en el recurso compartido: x-ms-share-paid-bursting-max-iops se puede usar para actualizar el número máximo de IOPS de expansión de pago para el recurso compartido. x-ms-share-paid-bursting-enabled no es necesario establecer en este caso. Si x-ms-share-paid-bursting-enabled se establece en true pero no se establece x-ms-share-paid-bursting-max-iops, el número máximo de IOPS de expansión de pago permanecerá sin cambios.
x-ms-share-paid-bursting-max-bandwidth-mibps	Opcional. Compatible con la versión 2024-11-04 y posteriores. Solo se permite para recursos compartidos de archivos Premium. Entero que representa el máximo de mebibytes de expansión de pago por segundo (MiB/s) permitido para el recurso compartido. Si la expansión de pago aún no está habilitada en el recurso compartido: el comportamiento es idéntico al encabezado x-ms-share-paid-bursting-max-bandwidth-mibps en Crear recurso compartido. El valor predeterminado si no se especifica es el valor máximo permitido de MiB/s para un recurso compartido. Si se establece este encabezado, x-ms-share-paid-bursting-enabled también debe establecerse en true. Si la expansión de pago ya está habilitada en el recurso compartido: x-ms-share-paid-bursting-max-bandwidth-mibps se puede usar para actualizar el máximo de expansión de pago MiB/s para el recurso compartido. x-ms-share-paid-bursting-enabled no es necesario establecer en este caso. Si x-ms-share-paid-bursting-enabled se establece en true pero no se establece x-ms-share-paid-bursting-max-bandwidth-mibps, el ancho de banda de expansión de pago máximo permanecerá sin cambios.

Cuerpo de la solicitud

Ninguno.

Solicitud de ejemplo

PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=properties  
  
Request Headers:  
x-ms-version: 2020-02-10  
x-ms-date: <date>  
Authorization: SharedKey myaccount: Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00Jdjid0Q=  
x-ms-share-quota: 55  
x-ms-root-squash: RootSquash

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
Last-Modified	Devuelve la fecha y hora en que se modificó por última vez el recurso compartido. El formato de fecha sigue a RFC 1123. Para obtener más información, vea Representación de valores de fecha y hora en encabezados. Cualquier operación que modifique el recurso compartido o sus propiedades actualiza la hora de la última modificación. Las operaciones en archivos no afectan a la hora de la última modificación del recurso compartido.
ETag	Contiene un valor que representa la versión del recurso compartido, como una cadena entre comillas.
x-ms-request-id	Identifica de forma única la solicitud que se realizó. También puede usarlo 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 de Azure Files que se usa para ejecutar la solicitud.
Date o x-ms-date	Valor de fecha y hora UTC que indica la hora a la que el servicio envió la respuesta.
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 es como máximo 1024 caracteres ASCII visibles. Si el encabezado x-ms-client-request-id no está presente en la solicitud, este encabezado 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.

Observaciones

Para obtener más información sobre cómo establecer la cuota de recursos compartidos, vea Crear recurso compartido.

Si establece que la cuota de recursos compartidos sea menor que el tamaño de los datos del recurso compartido, la operación se realizará correctamente. Sin embargo, no podrá agregar más datos al recurso compartido hasta que la cantidad de datos del recurso compartido se reduzca por debajo de la cuota. Puede reducir la cantidad de datos mediante la eliminación o compresión de archivos.

Set Share Properties no se admite para una instantánea de recurso compartido. Se producirá un error al intentar realizar esta operación en una instantánea de recurso compartido con el código de estado 400 (InvalidQueryParameterValue).

Si establece el encabezado x-ms-enable-snapshot-virtual-directory-access para recursos compartidos NFS, vuelva a montar el recurso compartido para observar el comportamiento actualizado.

Consulte también

Operaciones de en recursos de FileShare (Azure Files)