Object Storage Service:バケット情報の照会

使用上の注意

• このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。 OSSと同じリージョンにある他のAlibaba CloudサービスからOSSにアクセスする場合は、内部エンドポイントを使用します。 OSSリージョンとエンドポイントの詳細については、「リージョン、エンドポイント、オープンポート」をご参照ください。

• このトピックでは、アクセス資格情報は環境変数から取得します。 アクセス資格情報の設定方法の詳細については、「アクセス資格情報の設定」をご参照ください。

• このトピックでは、OSSエンドポイントを使用してOSSClientインスタンスを作成します。 カスタムドメイン名またはSTS (Security Token Service) を使用してOSSClientインスタンスを作成する場合は、「初期化」をご参照ください。

• バケットに関する情報を照会するには、oss:GetBucketInfo権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

例

次のコードは、バケットのリージョンや作成日など、バケットに関する情報を照会する方法の例を示しています。

# -*- 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)

関連ドキュメント

• バケットに関する情報のクエリに使用される完全なサンプルコードについては、GitHubをご覧ください。

• バケットに関する情報を照会するために呼び出すことができるAPI操作の詳細については、「GetBucketInfo」をご参照ください。