Crear un recurso compartido
La Create Share
operación crea un nuevo recurso compartido Azure Files en la cuenta especificada. Aunque esta API es totalmente compatible, se trata de una API de administración heredada. En su lugar, se recomienda usar 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
los recursos mediante el proveedor de recursos de Azure Storage, consulte Operaciones en FileShares.
Si ya existe un recurso compartido con el mismo nombre, se produce un error en la operación. El recurso de recurso compartido incluye los metadatos y las propiedades del recurso compartido. No incluye una lista de los archivos contenidos en el recurso compartido.
Disponibilidad del protocolo
Protocolo de recurso compartido de archivos habilitado | Disponible |
---|---|
Bloque de mensajes del servidor (SMB) | |
Network File System (NFS) |
Solicitud
Puede construir la Create Share
solicitud como se muestra aquí. Se recomienda usar HTTPS.
Método | URI de solicitud | Versión de 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 |
El nombre de la cuenta de almacenamiento. |
myshare |
El 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 del identificador URI
Puedes especificar los siguientes parámetros adicionales en el URI de la solicitud:
Parámetro | Descripción |
---|---|
timeout |
Opcional. El parámetro de tiempo de espera 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) para 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 más información, consulte Control de versiones 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. Valores válidos son TransactionOptimized , Hot y Cool . Para obtener información detallada sobre los niveles de recurso compartido de archivos, consulte Azure Files niveles de almacenamiento. |
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 el squash de raíz.- RootSquash : asigna solicitudes de uid/gid 0 a la interfaz de usuario/gid anónima.- AllSquash : asigne todos los uids y gids al usuario anónimo. |
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. |
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=
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 201 (Creado).
Para obtener más información, vea 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 encabezados HTTP estándar adicionales. 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 recurso compartido, entre comillas. |
Last-Modified |
Devuelve la fecha y hora en que se modificó por última vez el recurso compartido. 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 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 más información, consulte Solución de problemas de operaciones de API. |
x-ms-version |
Indica la versión Azure Files que se usó 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. |
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 está presente en la respuesta. |
Response body
Ninguno.
Respuesta de muestra
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
Authorization
Solo el propietario de la cuenta puede llamar a esta operación.
Comentarios
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 del 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 sobre la facturación. Todavía se le factura el tamaño de los archivos más la sobrecarga.