Crear directorio
La operación de Create Directory crea un nuevo directorio bajo el recurso compartido o directorio primario especificados. El recurso de directorio incluye las propiedades de ese directorio. No incluye una lista de los archivos o subdirectorios contenidos en el directorio.
Disponibilidad del protocolo
| Protocolo habilitado para recursos compartidos de archivos | Disponible |
|---|---|
| SMB |
|
| NFS |
|
Pedir
Puede construir la solicitud Create Directory de la siguiente manera. Se recomienda usar HTTPS.
| Método | URI de solicitud | Versión HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory |
HTTP/1.1 |
Reemplace los componentes de ruta de acceso del URI de solicitud por los suyos propios, como se muestra en la tabla siguiente:
| Componente de ruta de acceso | Descripción |
|---|---|
myaccount |
Nombre de la cuenta de almacenamiento. |
myshare |
Nombre del recurso compartido de archivos. |
myparentdirectorypath |
Opcional. Ruta de acceso al directorio primario donde se va a crear mydirectory. Si se omite la ruta de acceso del directorio principal, el directorio se creará dentro del recurso compartido especificado. Si se especifica el directorio primario, ya debe existir en el recurso compartido para poder crear mydirectory. |
mydirectory |
Nombre del directorio que se va a crear. |
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. |
Cuerpo de la solicitud
Ninguno.
Encabezados de solicitud
Los encabezados de solicitud obligatorios y opcionales se describen en la tabla siguiente:
| Parámetro | 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. Versión 2015-02-21 o posterior. Par nombre-valor que se va a asociar al directorio como metadatos. Los nombres de metadatos deben cumplir las reglas de nomenclatura de los identificadores de C# . |
x-ms-file-permission: { inherit ¦ <SDDL> ¦ <binary> } |
En la versión 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. Este encabezado se puede usar si el tamaño de los permisos es superior a 8 kibibytes (KiB). 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). Puede pasar un valor de inherit para heredar del directorio primario.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 inherit. |
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 inherit, este encabezado no debe establecerse. Si x-ms-file-permission-key se establece en cualquier otro valor que no sea inherity si no se establece este encabezado, se usa el valor predeterminado de sddl. |
x-ms-file-permission-key: <PermissionKey> |
Clave del permiso que se va a establecer para el directorio. En la versión 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. Puede crear esta clave 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 inherit para el encabezado x-ms-file-permission. |
x-ms-file-attributes |
Obligatorio: versión 2019-02-02 a 2021-04-10. Opcional: versión 2021-06-08 y posteriores. Atributos del sistema de archivos que se van a establecer en el directorio. Consulte la lista de atributos disponibles . El valor predeterminado es Directory. |
x-ms-file-creation-time: { now ¦ <DateTime> } |
Obligatorio: versión 2019-02-02 a 2021-04-10. Opcional: versión 2021-06-08 y versiones posteriores. Propiedad de hora universal coordinada (UTC) para el directorio. Puede usar un valor de now para indicar la hora de la solicitud. El valor predeterminado es now. |
x-ms-file-last-write-time: { now ¦ <DateTime> } |
Obligatorio: versión 2019-02-02 a 2021-04-10. Opcional: versión 2021-06-08 o posterior. Propiedad de última escritura de la hora universal coordinada (UTC) del directorio. Puede usar un valor de now para indicar la hora de la solicitud. El valor predeterminado es now. |
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. La propiedad Hora universal coordinada (UTC) cambia la propiedad de hora para el directorio, en el formato ISO 8601. Versión 2021-06-08 y posteriores. 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. |
Solicitud de ejemplo
PUT https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory? restype=directory HTTP/1.1
Request headers:
x-ms-version: 2014-02-14
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT
x-ms-meta-Category: Images
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 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 encabezados que se describen en la tabla siguiente. 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 directorio, 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 la ú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 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-request-server-encrypted: true/false |
Versión 2017-04-17 o posterior. El valor de este encabezado se establece en true si el contenido de la solicitud se cifra correctamente mediante el algoritmo especificado y false de lo contrario. |
x-ms-file-permission-key |
Clave del permiso del directorio. |
x-ms-file-attributes |
Atributos del sistema de archivos en el directorio. Consulte la lista de atributos disponibles . |
x-ms-file-creation-time |
Valor de fecha y hora UTC que representa la propiedad de hora de creación del directorio. |
x-ms-file-last-write-time |
Valor de fecha y hora UTC que representa la propiedad de hora de última escritura del directorio. |
x-ms-file-change-time |
Fecha y hora UTC que representa la propiedad de hora de cambio del directorio. |
x-ms-file-file-id |
Identificador de archivo del directorio. |
x-ms-file-parent-id |
Identificador de archivo primario 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, este encabezado 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: Mon, 27 Jan 2014 23:00:12 GMT
ETag: "0x8CB14C3E29B7E82"
Last-Modified: Mon, 27 Jan 2014 23:00:06 GMT
x-ms-version: 2014-02-14
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
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. Normalmente, las aplicaciones usan 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 lo admite con 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 | Flujo de datos de usuario que no leer el analizador de integridad de datos en segundo plano. Este atributo del sistema de archivos se presenta principalmente para proporcionar compatibilidad con Windows. |
Observaciones
Si se elimina un directorio con el mismo nombre cuando se llama a Create Directory, el servidor devuelve el código de estado 409 (conflicto) y proporciona información de error adicional que indica que se está eliminando el directorio.
Si ya existe un directorio o archivo con el mismo nombre, se produce un error en la operación con el código de estado 409 (Conflicto). Si el directorio primario no existe, se produce un error en la operación con el código de estado 412 (error de condición previa).
No es posible crear una jerarquía de directorios con una sola operación de Create Directory. Solo puede crear el directorio si ya existe su elemento primario inmediato, tal como se especifica en la ruta de acceso. Si el directorio primario no existe, se produce un error en la operación con el código de estado 412 (error de condición previa).
Create Directory no se admite en una instantánea de recurso compartido, que es una copia de solo lectura de un recurso compartido. Se producirá un error al intentar realizar esta operación en una instantánea de recurso compartido con 400 (InvalidQueryParameterValue)
Consulte también
Operaciones de en directorios