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

:バケット

最終更新日:Dec 22, 2023

バケット

OSS ではユーザーファイルのネームスペースとしてバケットを使用して、課金、権限制御、ログ記録などの高度な機能の管理オブジェクトとしても使用します。バケット名は OSS 全体でグローバルに一意である必要があり、変更することはできません。OSS に格納されているすべてのオブジェクトはバケットに含める必要があります。イメージ共有 Web サイトなどの 1 つのアプリケーションは、1 つ以上のバケットに対応できます。最大 10 個のバケットを作成できますが、各バケット内のオブジェクト数には制限がありません。各バケットには最大 2 PB のデータを格納できます。

命名規則

バケットの命名規則は次のとおりです。

  • バケット名はグローバルに一意でなければならず、他のユーザーのバケット名と一致してはいけません。
  • 小文字のアルファベット、数字、ハイフン (-) のみを使用できます。
  • 先頭の文字は小文字のアルファベットまたは数字である必要があります。
  • 長さは 3 ~ 63 バイトでなければなりません。

バケットの作成

説明

注: バケットに名前を付けるときは、命名規則に従わなければなりません。

以下のコードを使用してバケットを作成できます。

String bucketName = "my-bucket-name";

// Initializes an OSSClient
OSSClient client = ...;

// Creates a Bucket
client.createBucket(bucketName);

ユーザーのすべてのバケットのリスト

以下のコードで、ユーザーのすべてのバケットがリストされます。

// Retrieves the user's bucket list
List<Bucket> buckets = client.listBuckets();

// Traverses buckets
for (Bucket bucket : buckets) {
    System.out.println(bucket.getName());
}

CNAME アクセス

独自のドメイン名の CNAME を 1 つのバケットのドメイン名に対応付けた後、ドメイン名を通じて OSS にアクセスできます。

// For example, your domain name is "http://cname.com" and you direct the CNAME to your bucket domain name "mybucket.oss-cn-hangzhou.aliyuncs.com"
OSSClient client = new OSSClient("http://cname.com/", /* accessKeyId */, /* accessKeySecret */);

PutObjectResult result = client.putObject("mybucket", /* key */, /* input */, /* metadata */);

OSSClient インスタンスを作成するときに、当初バケットへのアクセスに使用する予定だったエンドポイントを post-CNAME ドメイン名に変更するだけです。同時に、その後の操作でこの OSSClient インスタンスを使用するときにバケット名に入力できるのは、指定されたバケット名のみです。

説明

VPC ユーザーが、aliyuncs.com で終わらないドメイン名を通じて OSS にアクセスする場合は、ClientConfiguration で setCnameExcludeList を使用してエンドポイントを設定すると、OSS へのアクセスに CNAME メソッドを使用するのを回避できます。

バケットの有無の確認

バケットの有無を確認するには、次のコードを使用できます。

String bucketName = "your-bucket-name";

// Gets information on existing buckets
boolean exists = client.doesBucketExist(bucketName);

// Outputs results
if (exists) {
    System.out.println("Bucket exists");
} else {
    System.out.println("Bucket not exists");
}

バケット ACL の設定

バケット ACL を設定するには、次のコードを使用できます。

String bucketName = "your-bucket-name";

//Uses a bucket with private permission as an example
client.setBucketAcl(bucketName,CannedAccessControlList.Private);

バケット ACL の取得

バケット ACL を取得するには、次のコードを使用できます。

String bucketName = "your-bucket-name";
AccessControlList accessControlList = client.getBucketAcl(bucketName);

//You can print the results or confirm them on the console
System.out.println(accessControlList.toString());

バケットアドレスの取得

バケットアドレスを取得するには、次のコードを使用できます。

String bucketName = "your-bucket-name";

// Retrieves the bucket address
String location = client.getBucketLocation(bucketName);
System.out.println(location);

バケットの削除

次のコードでバケットは削除されます。

String bucketName = "your-bucket-name";

// Deletes the bucket
client.deleteBucket(bucketName)
説明

Note: バケットが空でない (バケットにオブジェクトが含まれる) 場合、バケットは削除できません。バケットを削除する前に、バケット内のすべてのオブジェクトを削除する必要があります。