すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:OSS SDK for Python 2.0 を使用してバケットが存在するかどうかを確認する

最終更新日:Aug 26, 2025

このトピックでは、OSS SDK for Python 2.0 を使用してバケットが存在するかどうかを確認する方法について説明します。

使用上の注意

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

  • このトピックでは、アクセス認証情報は環境変数から取得されます。アクセス認証情報の構成方法の詳細については、「アクセス認証情報を構成する」をご参照ください。

  • バケットが存在するかどうかを確認するには、oss:GetBucketAcl 権限が必要です。詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。

メソッド

is_bucket_exist(bucket: str, request_payer: str | None = None, **kwargs) → bool

リクエストパラメーター

パラメーター

タイプ

説明

bucket

str

バケットの名前。

レスポンスパラメーター

タイプ

説明

bool

戻り値。

バケットが存在するかどうかを確認する方法の詳細については、「is_bucket_exist」を参照してください。

サンプルコード

バケットが存在するかどうかを確認するためのサンプルコードを以下に示します。

import argparse
import alibabacloud_oss_v2 as oss

# コマンドラインパラメータパーサーを作成し、スクリプトの目的を記述します。
parser = argparse.ArgumentParser(description="Check if a specified OSS bucket exists.")

# --region パラメータを指定して、バケットが配置されているリージョンを示します。このパラメータは必須です。
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)

# --bucket パラメータを指定して、確認するバケットの名前を示します。このコマンドラインパラメータは必須です。
parser.add_argument('--bucket', help='The name of the bucket to check for existence.', required=True)

# --endpoint パラメータを指定して、バケットが配置されているリージョンのエンドポイントを示します。このパラメータはオプションです。
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS.')

def main():
    """
    コマンドラインパラメータを解析し、指定されたバケットが存在するかどうかを確認するために使用されるメイン関数。
    """

    args = parser.parse_args()  # コマンドラインパラメータを解析します。

    # 認証のために環境変数からアクセス認証情報を取得します。
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # SDK のデフォルト構成を使用し、認証情報プロバイダーとリージョンを指定します。
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider
    cfg.region = args.region

    # エンドポイントが指定されている場合は、構成オブジェクトでエンドポイントを指定します。
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # 前述の構成を使用して、OSSClient インスタンスを作成します。
    client = oss.Client(cfg)

    # 指定されたバケットが存在するかどうかを確認します。
    result = client.is_bucket_exist(bucket=args.bucket)

    # 結果を表示します。
    print(f'Bucket {args.bucket} exists: {result}')

if __name__ == "__main__":
    main()  # スクリプトのエントリポイント。スクリプトが直接実行されると、main 関数が呼び出されます。

参照

  • バケットが存在するかどうかを確認するために使用される完全なサンプルコードについては、is_bucket_exist.py にアクセスしてください。