Los buckets son contenedores de objetos en OSS. Ejecute el comando mb para crear un bucket antes de subir objetos.
Notas de uso
Para crear un bucket, necesita el permiso oss:PutBucket. Para obtener más información, consulte Grant a custom policy.
A partir de la versión 1.6.16, ossutil utiliza ossutil como nombre del binario en todos los sistemas operativos. Las versiones anteriores requieren nombres de binario específicos para cada sistema operativo. Para obtener más información, consulte ossutil command reference.
A partir de las 10:00:00 (UTC+8) del 13 de octubre de 2025, OSS habilitará gradualmente Block public access de forma predeterminada. Esto aplica a los buckets creados mediante llamadas a operaciones de API, SDK de OSS u ossutil en todas las regiones. Para conocer la fecha exacta de entrada en vigor en cada región, consulte Anuncio. Una vez habilitada esta función, no podrá otorgar permisos de acceso público. Esto incluye las ACL public-read o public-read-write y las políticas de bucket que permiten el acceso público. Si su negocio requiere acceso público, deshabilite el bloqueo de acceso público después de crear el bucket.
Crear un bucket con opciones de comando
Sintaxis del comando
ossutil mb oss://bucketname
[--acl <value>]
[--storage-class <value>]
[--redundancy-type <value>]
Parámetros y opciones:
|
Parámetro/Opción
|
Descripción
|
|
bucketname
|
Nombre del bucket. Debe ser único a nivel global en OSS y no se puede modificar después de su creación.
|
|
--acl
|
ACL del bucket. Valores válidos:
-
private (predeterminado): Solo el propietario del bucket puede leer y escribir objetos. Los demás usuarios no tienen acceso.
-
public-read: Solo el propietario del bucket puede escribir objetos. Todos los usuarios, incluidos los anónimos, pueden leerlos. Esta opción puede provocar accesos no autorizados y cargos inesperados. Úsela con precaución.
-
public-read-write: Todos los usuarios, incluidos los anónimos, pueden leer y escribir objetos. Esta opción puede causar accesos no autorizados, cargos inesperados y riesgos legales por subidas de contenido prohibido. No la utilice a menos que sea estrictamente necesario.
|
|
--storage-class
|
Clase de almacenamiento del bucket. Valores válidos:
-
Standard (predeterminado): Diseñada para datos con acceso frecuente.
-
IA: Acceso poco frecuente. Indicada para datos a los que se accede una o dos veces al mes. Periodo mínimo de almacenamiento: 30 días. Tamaño mínimo facturable: 64 KB. Admite acceso en tiempo real. Se aplican cargos por recuperación de datos.
-
Archive: Recomendada para almacenamiento a largo plazo. Periodo mínimo de almacenamiento: 60 días. Tamaño mínimo facturable: 64 KB. Requiere restauración previa al acceso (aproximadamente 1 minuto). Se aplican cargos por recuperación de datos.
-
ColdArchive: Más indicada para el almacenamiento a largo plazo de datos con acceso muy esporádico. Periodo mínimo de almacenamiento: 180 días. Tamaño mínimo facturable: 64 KB. Requiere restauración previa al acceso. El tiempo de restauración varía según el tamaño del objeto y el modo seleccionado. Se aplican cargos por recuperación de datos.
Nota Si utiliza OSS on CloudBox, solo es compatible la clase de almacenamiento Standard. Para obtener más información sobre las clases de almacenamiento, consulte 存储类型.
|
|
--redundancy-type
|
Tipo de redundancia del bucket. Valores válidos:
-
LRS (predeterminado): Almacenamiento con redundancia local. Almacena copias en distintos dispositivos dentro de la misma zona. Esto garantiza la fiabilidad de los datos incluso si dos dispositivos fallan simultáneamente.
-
ZRS: Almacenamiento con redundancia de zona. Almacena copias de los datos en varias zonas de la misma región. Los datos siguen accesibles aunque una zona deje de estar disponible.
Importante
-
ZRS está disponible en las siguientes regiones: China (Shenzhen), China (Beijing), China (Hangzhou), China (Shanghai), China (Hong Kong), Singapore e Indonesia (Jakarta). ZRS incrementa los costos de almacenamiento y no se puede deshabilitar una vez habilitada.
-
Este parámetro no es compatible si utiliza OSS on CloudBox.
|
Ejemplos
-
Cree un bucket llamado examplebucket:
ossutil mb oss://examplebucket
Si no especifica ninguna región, el bucket se crea en la región asociada al endpoint de su archivo de configuración de ossutil. Por ejemplo, si el endpoint es https://oss-cn-hangzhou.aliyuncs.com, el bucket se crea en la región China (Hangzhou).
-
Cree un bucket llamado examplebucket con la ACL establecida en private, la clase de almacenamiento en IA y el tipo de redundancia en ZRS:
ossutil mb oss://examplebucket --acl private --storage-class IA --redundancy-type ZRS
-
Si se devuelve a continuación el resultado mostrado, el bucket se creó correctamente:
Crear un bucket desde un archivo XML
Sintaxis del comando
ossutil mb oss://bucketname local_xml_file
Parámetros:
|
Parámetro
|
Descripción
|
|
bucketname
|
Nombre del bucket.
|
|
local_xml_file
|
Ruta al archivo XML local que contiene la configuración del bucket. Ejemplo: localfile.xml.
|
Ejemplos
-
Defina la configuración del bucket en el archivo localfile.xml.
<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>
<StorageClass>IA</StorageClass>
<DataRedundancyType>LRS</DataRedundancyType>
</CreateBucketConfiguration>
-
Cree un bucket mediante el archivo de configuración XML local:
ossutil mb oss://examplebucket localfile.xml
Opciones comunes
Para acceder a un bucket en otra región, use -e y especifique el endpoint correspondiente. Si necesita acceder a un bucket propiedad de otra cuenta de Alibaba Cloud, utilice -i para el AccessKey ID y -k para el AccessKey secret.
Por ejemplo, cree un bucket llamado examplebucket en la región China (Shanghai) bajo una cuenta distinta de Alibaba Cloud:
ossutil mb oss://examplebucket -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret
Common options.