Todos los productos
Search
Centro de documentos

Object Storage Service:mkdir (crear un directorio)

Última actualización: Sep 03, 2026

Use el comando mkdir para crear directorios y organizar objetos en un bucket.

Notas de uso

  • Para crear un directorio, debe tener los permisos oss:GetObject y oss:PutObject. Attach a custom access policy to a RAM user.

  • En ossutil 1.6.16 y versiones posteriores, use ossutil como nombre del binario en los comandos. No es necesario cambiar el nombre del binario según su sistema operativo. En versiones anteriores a la 1.6.16, debe usar el nombre del binario específico del sistema. Para obtener más información, consulte ossutil command reference.

Sintaxis del comando

ossutil mkdir oss://bucketname/dirname [--encoding-type <value>]

Los parámetros y las opciones son a continuación:

Parámetro

Descripción

bucketname

Nombre del bucket de destino.

dirname

Nombre del directorio. Debe terminar con una barra diagonal (/). Si no agrega la barra diagonal (/), ossutil la añade automáticamente.

--encoding-type

Tipo de codificación para la clave, que corresponde al nombre del directorio después de oss://bucket_name. Valor válido: url. Valor predeterminado: sin codificación.

Ejemplos

Cree un directorio y cargue un objeto en él.

  1. Cree un directorio.

    • Crear un directorio de un solo nivel

      ossutil mkdir oss://examplebucket/dir/

      La siguiente salida indica que se creó el directorio dir/ en el bucket examplebucket.

      0.385877(s) elapsed
    • Crear un directorio de varios niveles

      Cree directorios de varios niveles para clasificar mejor los objetos. Por ejemplo, cree un directorio Photo/2021/ en examplebucket:

      ossutil mkdir oss://examplebucket/Photo/2021/ 

      Si elimina 2021/ y Photo/ no contiene otros objetos, también se eliminará Photo/.

  2. Cargar un objeto en el directorio de destino

    Cargue exampleobject.txt en el directorio dir/ dentro de examplebucket:

    ossutil cp exampleobject.txt oss://examplebucket/dir/

    La siguiente salida indica que el archivo se cargó en el directorio de destino.

    Succeed: Total num: 1, size: 0. OK num: 1(upload 1 files).
    
    average speed 0(byte/s)

Opciones comunes

Para acceder a un bucket en otra región, use -e para especificar el endpoint. Para acceder a un bucket propiedad de otra cuenta de Alibaba Cloud, use -i para el AccessKey ID y -k para el AccessKey secret.

Ejemplo: cree el directorio dir/ en examplebucket, ubicado en la región China (Hangzhou) bajo una cuenta distinta de Alibaba Cloud:

ossutil mkdir oss://examplebucket/dir/ -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret

Common options.