Crear recurso compartido

La operación de Create Share crea un nuevo recurso compartido de Azure Files en la cuenta especificada. Aunque esta API es totalmente compatible, se trata de una API de administración heredada. Se recomienda usar en su lugar recursos compartidos de archivos: crear, que proporciona el proveedor de recursos de Azure Storage (Microsoft.Storage). Para más información sobre cómo interactuar mediante programación con FileShare recursos mediante el proveedor de recursos de Azure Storage, consulte Operations on FileShares.

Si ya existe un recurso compartido con el mismo nombre, se produce un error en la operación. El recurso compartido incluye metadatos y propiedades para ese recurso compartido. No incluye una lista de los archivos contenidos en el recurso compartido.

Disponibilidad del protocolo

Protocolo habilitado para recursos compartidos de archivos	Disponible
Bloque de mensajes del servidor (SMB)
Sistema de archivos de red (NFS)

Pedir

Puede construir la solicitud de Create Share como se muestra aquí. Se recomienda usar HTTPS.

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

Reemplace los componentes de ruta de acceso que se muestran en el URI de solicitud por los suyos propios, 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. El nombre solo puede contener caracteres en minúsculas.

Para obtener más 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-meta-name:value	Opcional. Par nombre-valor que se va a asociar al recurso compartido como metadatos. Los nombres de metadatos deben cumplir las reglas de nomenclatura de los identificadores de C# .
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 los niveles de recurso compartido de archivos, consulte niveles de almacenamiento de Azure Files.
x-ms-enabled-protocols: <SMB \| NFS>	Opcional. Compatible con la versión 2019-07-07 y posteriores. Especifica los protocolos habilitados en el recurso compartido. Si no se especifican, el valor predeterminado es SMB. - SMB: SMBv3.0, SMBv2.1 y REST pueden acceder al recurso compartido. - NFS: NFSv4.1 puede acceder al recurso compartido. Se requiere una cuenta Premium para esta opción.
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash>	Opcional. Solo NFS. Compatible con la versión 2019-07-07 y posteriores. Especifica el comportamiento de squash raíz en el recurso compartido cuando nfs está habilitado. Si no se especifica, el valor predeterminado es NoRootSquash. - NoRootSquash: desactive la squash raíz. - RootSquash: asigne solicitudes de uid/gid 0 al uid/gid anónimo. - AllSquash: asigne todos los uids y gids 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. Si no se especifica, el valor predeterminado es true.
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-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 habilita la expansión de pago. Si no se especifica la propiedad , el valor predeterminado es false.
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. 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.
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. 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.

Cuerpo de la solicitud

Ninguno.

Solicitud de ejemplo

PUT https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1  
  
Request Headers:  
x-ms-version: 2020-02-10  
x-ms-date: <date>  
x-ms-meta-Name: StorageSample  
x-ms-enabled-protocols: NFS
x-ms-root-squash: RootSquash
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=  

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 201 (creado).

Para obtener más información, consulte códigos de error y estado.

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 recurso compartido, entre comillas.
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 Representar valores de fecha y hora en encabezados. Cualquier operación que modifique el recurso compartido o sus propiedades o metadatos 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.
x-ms-request-id	Identifica de forma única la solicitud y puede usarla 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 usó para ejecutar la solicitud.
Date	Valor de fecha y hora UTC generado por el servicio, que indica la hora en que se inició 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 no contiene más de 1024 caracteres ASCII visibles. Si el encabezado x-ms-client-request-id no está presente en la solicitud, no está presente en la respuesta.

Cuerpo de la respuesta

Ninguno.

Respuesta de ejemplo

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Date: <date>  
ETag: "0x8CB14C3E29B7E82"  
Last-Modified: <date>  
x-ms-version: 2020-02-10  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  

Autorización

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

Observaciones

Los recursos compartidos se crean inmediatamente dentro de la cuenta de almacenamiento. No es posible anidar un recurso compartido dentro de otro.

Puede especificar metadatos para un recurso compartido al crearlo mediante la inclusión de uno o varios encabezados de metadatos en la solicitud. El formato del encabezado de metadatos es x-ms-meta-name:value.

Si se elimina un recurso compartido con el mismo nombre al llamar a Create Share, el servidor devuelve el código de estado 409 (conflicto) y la información de error adicional indica que se está eliminando el recurso compartido.

Puede usar la cuota de tamaño de recurso compartido para limitar el tamaño de los archivos almacenados en el recurso compartido. La cuota no limita el tamaño de las instantáneas. La sobrecarga asociada a los archivos y que se usa para calcular el tamaño de facturación de la cuenta de almacenamiento no se tiene en cuenta en la cuota.

Cuando la suma de los tamaños de los archivos del recurso compartido supera la cuota establecida en el recurso compartido, se producirá un error al intentar aumentar el tamaño de un archivo y se producirá un error al crear nuevos archivos no vacíos (a través de REST). Todavía podrá crear archivos vacíos.

Cambiar o establecer la cuota no tiene ningún efecto en la facturación. Todavía se le factura el tamaño de los archivos más la sobrecarga.

Consulte también

Operaciones de en recursos compartidos de Azure Files