Crear directorio
La operación Create Directory
crea un nuevo directorio en el directorio primario o el recurso compartido especificado. 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 de recurso compartido de archivos habilitado | Disponible |
---|---|
SMB | |
NFS |
Solicitud
Puede construir la Create Directory
solicitud como se indica a continuación. Se recomienda usar HTTPS.
Método | URI de solicitud | Versión de 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 |
El nombre de la cuenta de almacenamiento. |
myshare |
El 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 primario, se creará el directorio en el recurso compartido especificado. Si se especifica el directorio primario, ya debe existir dentro del recurso compartido para poder crear mydirectory. |
mydirectory |
El nombre del directorio que se 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 del identificador 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 Establecimiento de 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 |
Necesario. Especifica el esquema de autorización, el nombre de la 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 |
Obligatorio para todas las solicitudes autorizadas. 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 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> } |
En la versión 2019-02-02 a 2021-04-10, este encabezado es necesario si x-ms-file-permission-key no se especifica. 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 descriptor de seguridad (SDDL). 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, un grupo y una lista de control de acceso discrecional (DACL). Puede pasar un valor de inherit para heredar del directorio primario.Nota: Puede especificar o x-ms-file-permission x-ms-file-permission-key . Si no se especifica ningún encabezado, se usa el valor predeterminado de inherit . |
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 x-ms-file-permission no se especifica. A partir de la versión 2021-06-08, ambos encabezados son opcionales. Puede crear esta clave mediante la Create-Permission API.Nota: Puede especificar o x-ms-file-permission x-ms-file-permission-key . Si no se especifica ningún encabezado, se usa el valor predeterminado de inherit para el x-ms-file-permission encabezado. |
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 posterior. Propiedad de 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-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 obtener más información, vea Supervisar Azure Files. |
x-ms-file-change-time: { now ¦ <DateTime> } |
Opcional. La propiedad hora universal coordinada (UTC) cambia la hora del 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 el encabezado especifica un token de OAuth. El valor aceptable es backup . Este encabezado especifica que se debe conceder o Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action si se incluyen en la directiva de RBAC asignada a la identidad autorizada mediante el Authorization encabezado . 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, consulte Nomenclatura y 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=
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 sobre los códigos de estado, consulte Códigos de estado y 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 otros encabezados HTTP estándar. 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 directorio, 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 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 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 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 true en 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 última propiedad de hora de 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 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, este encabezado 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: 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
Authorization
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 | Un directorio que es de solo lectura. |
Hidden | 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 de o usa exclusivamente. |
None | 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 | Un 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 el analizador de integridad de datos en segundo plano no va a leer. Este atributo del sistema de archivos se presenta principalmente para proporcionar compatibilidad con Windows. |
Observaciones
Si se elimina un directorio por el mismo nombre cuando Create Directory
se llama a , el servidor devuelve el código de estado 409 (conflicto) y proporciona información adicional de error que indica que se está eliminando el directorio.
Si ya existe un directorio o un archivo con el mismo nombre, la operación generará un error 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 Create Directory
operación. Solo puede crear el directorio si su elemento primario inmediato ya existe, 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)