Un bucket es un contenedor que se usa para almacenar objetos en Object Storage Service (OSS). En este tema se describe cómo consultar la información de un bucket.
Notas
En este tema se usa 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, use 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 se obtienen a partir de variables de entorno. Para conocer el procedimiento de configuración de estas credenciales, consulte Configure access credentials using OSS SDK for Python 1.0.
Este tema muestra cómo crear una instancia de OSSClient con un endpoint de OSS. Para configuraciones alternativas, como usar un dominio personalizado o autenticarse con credenciales de Security Token Service (STS), consulte Initialization.
Para consultar la información de un bucket, es obligatorio contar con el permiso
oss:GetBucketInfo. Para obtener más información, consulte Grant a custom policy.
Ejemplos
A continuación se muestra un ejemplo de código para consultar la información de un bucket, incluida su región y fecha de creación:
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# Obtain access credentials from environment variables. Before you run the sample code, make sure that the environment variables are configured.
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# Specify the endpoint of the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com.
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# Specify the ID of the region that maps to the endpoint. Example: cn-hangzhou. This parameter is required if you use the signature algorithm V4.
region = "cn-hangzhou"
# Specify the name of the bucket.
bucket = oss2.Bucket(auth, endpoint, "yourBucketName", region=region)
# Query information about the bucket.
bucket_info = bucket.get_bucket_info()
# Query the name of the bucket.
print("name: " + bucket_info.name)
# Query the storage class of the bucket.
print("storage class: " + bucket_info.storage_class)
# Query the time when the bucket was created.
print("creation date: " + bucket_info.creation_date)
# Query the internal endpoint of the bucket.
print("intranet_endpoint: " + bucket_info.intranet_endpoint)
# Query the public endpoint of the bucket.
print("extranet_endpoint " + bucket_info.extranet_endpoint)
# Query the owner of the bucket.
print("owner: " + bucket_info.owner.id)
# Query the access control list (ACL) of the bucket.
print("grant: " + bucket_info.acl.grant)
# Query the redundancy type of the bucket.
print("data_redundancy_type:" + bucket_info.data_redundancy_type)
# Query the access tracking status of the bucket. Only OSS SDK for Python 2.16.1 and later allow you to query the access tracking status.
print("access_monitor:" + bucket_info.access_monitor)
Referencias
Para consultar el código de ejemplo completo que permite obtener la información de un bucket, visite GitHub.
Para obtener más información sobre la operación de API que permite consultar los datos de un bucket, consulte GetBucketInfo.