Object Storage Service:set-acl (Establecer o modificar ACL)

Notas de uso

• Para establecer o modificar la ACL de un bucket, debe tener el permiso oss:PutBucketAcl. Para establecer o modificar la ACL de un objeto, necesita el permiso oss:PutObjectAcl. Si desea modificar las ACL de varios objetos por lotes, requiere los permisos oss:PutObjectAcl y oss:ListObjects. Para obtener más información, consulte Grant custom permissions to a RAM user.

• A partir de ossutil v1.6.16, puede usar ossutil directamente como nombre del binario en la línea de comandos. No es necesario cambiar el nombre del binario según su sistema operativo. Si usa una versión de ossutil anterior a la 1.6.16, cambie el nombre del binario de acuerdo con su sistema operativo. Para obtener más información, consulte ossutil command reference.

Establecer o modificar la ACL de un bucket

• Sintaxis del comando

  ossutil set-acl oss://bucketname acl -b [--retry-times <value>]

  A continuación se describen los parámetros y las opciones.

  Elemento de configuración	Descripción
  bucketname	El nombre del bucket cuya ACL desea establecer o modificar.
  acl	La ACL del bucket. Valores válidos: private (predeterminado): solo el propietario del bucket puede leer y escribir los objetos del bucket. Los demás usuarios no pueden acceder a dichos objetos. public-read: solo el propietario del bucket puede escribir en los objetos del bucket. Los demás usuarios, incluidos los anónimos, únicamente pueden leerlos. Esto podría provocar fugas de datos y cargos inesperadamente altos. Si un usuario carga datos o información prohibida, sus derechos legales podrían verse afectados. No establezca la ACL en public-read a menos que sea necesario. public-read-write: todos los usuarios, incluidos los anónimos, pueden leer y escribir los objetos del bucket. Esta situación puede generar fugas de datos y costos elevados imprevistos. Tenga precaución al establecer la ACL en public-read-write.
  -b	De forma predeterminada, este comando establece la ACL de un objeto. Para establecer la ACL de un bucket, debe incluir esta opción.
  --retry-times	El número de reintentos si ocurre un error. Valor predeterminado: 10. Rango de valores: de 1 a 500.

• Ejemplo

  Establezca la ACL del bucket examplebucket en private.

  ossutil set-acl oss://examplebucket private -b   

Establecer o modificar la ACL de un objeto

• Sintaxis del comando

  ossutil set-acl oss://bucketname[/prefix] acl
  [-r]
  [--include <value>] 
  [--exclude <value>]
  [--version-id <value>]
  [--job <value>] 
  [--retry-times <value>]
  [--encoding-type <value>]

  A continuación se describen los parámetros y las opciones.

  Elemento de configuración	Descripción
  bucketname	El nombre del bucket.
  prefix	El recurso dentro del bucket, como una carpeta o un archivo.
  acl	La ACL del objeto. Valores válidos: default: el objeto hereda la ACL del bucket. private (predeterminado): solo el propietario del bucket puede leer y escribir el objeto. Los demás usuarios no pueden acceder a él. public-read: solo el propietario del bucket puede escribir en el objeto. Los demás usuarios, incluidos los anónimos, únicamente pueden leerlo. Esto podría provocar fugas de datos y cargos inesperadamente altos. Si un usuario carga datos o información prohibida, sus derechos legales podrían verse afectados. No establezca la ACL en public-read a menos que sea necesario. public-read-write: todos los usuarios, incluidos los anónimos, pueden leer y escribir el objeto. Esta situación puede generar fugas de datos y costos elevados imprevistos. Tenga precaución al establecer la ACL en public-read-write.
  -r	Establece de forma recursiva la ACL de todos los objetos que coinciden con el prefijo especificado. Si no incluye esta opción, ossutil establece la ACL únicamente del objeto indicado en la URL de la nube.
  --include	Incluye solo los objetos que cumplen con las condiciones especificadas. Para obtener más información, consulte --include and --exclude options.
  --exclude	Excluye los objetos que cumplen con las condiciones especificadas. Para obtener más información, consulte --include and --exclude options.
  --version-id	El ID de la versión del objeto. Esta opción aplica únicamente a los objetos de buckets que tienen el control de versiones habilitado o suspendido.
  --job	El número de tareas simultáneas para las operaciones por lotes. Valor predeterminado: 3. Rango de valores: de 1 a 10000.
  --retry-times	El número de reintentos si ocurre un error. Valor predeterminado: 10. Rango de valores: de 1 a 500.
  --encoding-type	El tipo de codificación del prefijo que sigue a oss://bucket_name. Establezca el valor en url. Si no especifica esta opción, el prefijo no se codifica.

• Ejemplos

  • Establezca la ACL del objeto exampleobject.txt, ubicado en el bucket examplebucket, en private.

    ossutil set-acl oss://examplebucket/exampleobject.txt private

  • Establezca la ACL de una versión específica (CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3****) del objeto exampleobject.txt, en el bucket examplebucket, en private.

    ossutil set-acl oss://examplebucket/exampleobject.txt private --version-id CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3****

  • Establezca la ACL en default para todos los objetos que tengan el prefijo test en el bucket examplebucket.

    ossutil set-acl oss://examplebucket/test default -r

  • Establezca la ACL en private para todos los objetos con extensión .jpg en el bucket examplebucket.

    ossutil set-acl oss://examplebucket private --include "*.jpg" -r

  • Establezca la ACL en default para todos los objetos del bucket examplebucket cuyo nombre contenga abc, pero que no tengan la extensión .png ni .txt.

    ossutil set-acl oss://examplebucket default --include "*abc*" --exclude "*.png" --exclude "*.txt" -r

Opciones comunes

Para acceder a un bucket en otra región, use -e para especificar el endpoint. 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.

ossutil set-acl oss://testbucket private -b -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret

Common options.