Gestión de permisos de acceso a archivos (Go SDK V1) - Object Storage Service

Con OSS SDK for Go V1, puede establecer y consultar las listas de control de acceso (ACL) de los objetos en OSS.

Notas

En este tema se utiliza el endpoint público de la región China (Hangzhou). Si necesita acceder a OSS desde otros servicios de Alibaba Cloud ubicados en la misma región, utilice un endpoint interno. Para obtener más información sobre las regiones y los endpoints de OSS, consulte Regions and endpoints.
Las credenciales de acceso de este tema se obtienen a partir de variables de entorno. Para conocer cómo configurar estas credenciales, consulte Configure access credentials.
Este tema muestra cómo crear una instancia de OSSClient con un endpoint de OSS. Para otras configuraciones, como usar un dominio personalizado o autenticarse con credenciales de Security Token Service (STS), consulte Configure a client (Go SDK V1).
Para configurar la ACL de un objeto, requiere el permiso oss:PutObjectAcl. Para consultar las ACL de los objetos, requiere el permiso oss:GetObjectAcl. Para obtener más información, consulte Grant a custom policy.

Tipos de permisos de lectura y escritura

Los objetos admiten a continuación cuatro tipos de ACL:

Permiso de acceso	Descripción	Valor de ACL
Heredar del bucket	El objeto hereda la ACL del bucket.	oss.ACLDefault
Privado	Solo el propietario del objeto y los usuarios autorizados tienen permisos de lectura y escritura sobre él. Los demás usuarios no pueden acceder al objeto.	oss.ACLPrivate
Lectura pública	El propietario del objeto y los usuarios autorizados tienen permisos de lectura y escritura. Los demás usuarios solo cuentan con permisos de lectura. Utilice este permiso con precaución.	oss.ACLPublicRead
Lectura y escritura públicas	Todos los usuarios tienen permisos de lectura y escritura sobre el objeto. Utilice este permiso con precaución.	oss.PublicReadWrite

Las ACL de los objetos tienen prioridad sobre las ACL de los buckets. Por ejemplo, si la ACL de un bucket es privada pero la de un objeto es de lectura y escritura públicas, todos los usuarios tendrán permisos de lectura y escritura sobre dicho objeto. Cuando un objeto no tiene una ACL configurada, hereda la ACL del bucket.

Código de ejemplo

A continuación se muestra el código de ejemplo para establecer y consultar las ACL de los objetos:

package main

import (
	"log"

	"github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func main() {
	// Obtain access credentials from environment variables. Before you run this sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		log.Fatalf("Failed to create credentials provider: %v", err)
	}

	// Create an OSSClient instance.
	// Set yourEndpoint to the Endpoint of the bucket. For example, for the China (Hangzhou) region, set the Endpoint to https://oss-cn-hangzhou.aliyuncs.com. For other regions, set the Endpoint as needed.
	// Set yourRegion to the region where the bucket is located. For example, for the China (Hangzhou) region, set the value to cn-hangzhou. For other regions, set the value as needed.
	clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
	clientOptions = append(clientOptions, oss.Region("yourRegion"))
	// Set the signature version.
	clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
	client, err := oss.New("yourEndpoint", "", "", clientOptions...)
	if err != nil {
		log.Fatalf("Failed to create OSS client: %v", err)
	}

	// Set yourBucketName to the name of the bucket.
	bucketName := "yourBucketName"
	bucket, err := client.Bucket(bucketName)
	if err != nil {
		log.Fatalf("Failed to get bucket '%s': %v", bucketName, err)
	}

	// Set the ACL of the object.
	// Set yourObjectName to the full path of the object. Do not include the bucket name.
	objectName := "yourObjectName"
	err = bucket.SetObjectACL(objectName, oss.ACLPublicReadWrite)
	if err != nil {
		log.Fatalf("Failed to set object ACL for '%s': %v", objectName, err)
	}

	// Get the ACL of the object.
	aclRes, err := bucket.GetObjectACL(objectName)
	if err != nil {
		log.Fatalf("Failed to get object ACL for '%s': %v", objectName, err)
	}

	log.Printf("Object ACL for '%s': %s", objectName, aclRes.ACL)
}

Referencias

Para consultar el código de ejemplo completo, visite el ejemplo en GitHub.
Para obtener más información sobre la operación de API que establece las ACL de los objetos, consulte SetObjectACL.
Si desea conocer más detalles sobre la operación de API que consulta las ACL de los objetos, consulte GetObjectACL.