汎用バケットの命名規則

汎用バケットを作成するときは、バケット名の長さ、有効な文字、形式、一意性を考慮してください。以下のセクションでは、命名規則やベストプラクティスなどの汎用バケットの命名に関する情報を提供し、アカウントのリージョン名前空間でバケットを作成する方法の例と、グローバル一意識別子 (GUID) を含む名前を使用して汎用バケットを作成する例を示します。

オブジェクトキー名の詳細については、「オブジェクトキー名の作成」を参照してください。

汎用バケットを作成する方法については、「汎用バケットの作成」を参照してください。

汎用バケットの命名規則

汎用バケットの命名については、次の命名規則が適用されます。

アカウントのリージョン名前空間の命名規則

Amazon S3 汎用バケットは共有グローバル名前空間に存在しますが、オプションでアカウントのリージョン名前空間にバケットを作成できます。アカウントのリージョン名前空間は、アカウントのみが汎用バケットを作成できるグローバルバケット名前空間の予約済みサブディビジョンです。アカウントのリージョン名前空間で作成された新しい汎用バケットは、ご使用のアカウントに固有であり、別のアカウントで再作成することはできません。これらのバケットは、共有グローバル名前空間の汎用バケットが既にサポートしているすべての S3 機能と AWS のサービスをサポートしています。アプリケーションは、アカウントのリージョン名前空間のバケットとやり取りするために変更する必要はありません。

アカウントのリージョン名前空間の汎用バケットは、特定の命名規則に従う必要があります。バケット名は、作成するバケット名のプレフィックスと、12 桁の AWS アカウント ID、AWS リージョン コードを含むサフィックスで構成され、末尾は -an となります。

bucket-name-prefix-accountId-region-an

例えば、us-west-2 リージョンの AWS アカウント 111122223333 のアカウントのリージョン名前空間には、次の汎用バケットがあります。

amzn-s3-demo-bucket-111122223333-us-west-2-an

アカウントのリージョン名前空間にバケットを作成するには、CreateBucket リクエストを行い、値を account-regional に設定して x-amz-bucket-namespace リクエストヘッダーを指定し、アカウントのリージョン名前空間形式のバケット名 customer-chosen-name-AWS-Account-ID-AWS-Region-an を指定します。例えば、amzn-s3-demo-bucket-111122223333-us-east-1-an という名前でバケットを作成できます。アカウントリージョンのサフィックスは -111122223333-us-east-1-an です。アカウントのリージョン名前空間の詳細については、「汎用バケットの名前空間」を参照してください。

汎用バケット名の例

次のバケット名は、汎用バケット名で許可される文字の例を示しています: a～z、0～9、およびハイフン (-)。amzn-s3-demo- 予約済みプレフィックスは、ここでは説明のためにのみ使用されます。予約済みプレフィックスであるため、amzn-s3-demo- で始まるバケット名を作成することはできません。

次の例は、アカウントのリージョン名前空間のバケット名を示しています。これらのバケットは、特定のアカウントのリージョン名前空間命名規則 (customer-chosen-name-AWS-Account-ID-AWS-Region-an) に従う必要があります。

次の例に示すバケット名は有効ですが、ピリオドを含んでいるため (.)、静的ウェブサイトホスティング以外の用途には推奨されません。

次の例に示すバケット名は無効です。

ベストプラクティス

汎用バケットに名前を付けるときは、以下のバケット命名のベストプラクティスを考慮してください。

アカウントのリージョン名前空間にバケットを作成する

ご使用のアカウントのみがこれらのバケット名を所有できるように、アカウントのリージョン名前空間にバケットを作成することをお勧めします。アカウントのリージョン名前空間を使用すると、他のアカウントが名前空間にバケット名を作成できないことが保証されるので、複数の AWS リージョンにまたがって予測可能なバケット名を作成できます。

命名の競合を引き起こす可能性が低いバケット命名スキームを選択する

アプリケーションが自動的にバットを作成する場合は、命名の衝突が起きないようなバケット命名スキームを使用してください。特定のバケット名が既に使用されている場合は、異なるバケット名をアプリケーションロジックが選択するようにしてください。

バケット名にグローバル一意識別子 (GUID) を追加する

予測不可能なバケット名を作成することをお勧めします。バケットを既に作成していない限り、選択したバケット名を使用できるものと見なしてコードを記述しないでください。予測不可能なバケット名を作成する方法の 1 つは、バケット名にグローバル一意識別子 (GUID) を追加することです (例: amzn-s3-demo-bucket-a1b2c3d4-5678-90ab-cdef-example11111)。詳細については、「バケット名で GUID を使用するバケットの作成」を参照してください。

バケット名にピリオド (.) を使用しない

互換性を最も高くするには、静的ウェブサイトホスティング専用のバケットを除き、バケット名にピリオド (.) を使用しないことをお勧めします。バケット名にピリオドを含めると、証明書の検証を独自に実行しない限り、HTTPS 経由の仮想ホスト形式のアドレス指定は使用できません。バケット名にピリオドが含まれていると、バケットの仮想ホスティング用のセキュリティ証明書は機能しません。

静的ウェブサイトホスティングは HTTP 経由でのみ使用されるため、この制限は静的ウェブサイトホスティング用のバケットには影響しません。仮想ホスティング形式のアドレス指定の詳細については、「汎用バケットの仮想ホスティング」を参照してください。静的ウェブサイトホスティングの詳細については、「Amazon S3 を使用して静的ウェブサイトをホスティングする」を参照してください。

関連する名前を選択する

バケットに名前を付けるときは、ユーザーやユーザーのビジネスに関連する名前を選択します。他のユーザーに関連付けられている名前は使用しないでください。例えば、バケット名に AWS や Amazon を使用することを避けます。

バケット名を再利用するためにバケットを削除しないでください。

バケットが空の場合は削除できます。バケットが削除されると、その名前は再利用できるようになります。ただし、すぐに名前を再利用できる保証がないか、あるいはまったくありません。共有グローバル名前空間のバケットを削除した後、その名前が再利用可能になるまでに、しばらく時間がかかる場合もあります。さらに、その名前を再利用できるようになる前に、別の AWS アカウントが同じ名前のバケットを作成する場合があります。

共有グローバル名前空間の汎用バケットの削除後は、同じパーティション内の別の AWS アカウントが新しいバケットに同じ汎用バケット名を使用する場合があるため、削除した汎用バケットへのリクエストを受け取る可能性があることに注意してください。これを防ぐ場合、または同じ汎用バケット名を使い続ける場合は、汎用バケットを削除しないでください。バケットを空にして保持し、代わりに必要に応じてバケットリクエストをブロックすることをお勧めします。

バケット名で GUID を使用するバケットの作成

以下の例は、バケット名の最後に GUID を使用する汎用バケットの作成方法を示しています。

aws s3api create-bucket \
    --bucket amzn-s3-demo-bucket1$(uuidgen | tr -d - | tr '[:upper:]' '[:lower:]' ) \
    --region us-west-1 \
    --create-bucket-configuration LocationConstraint=us-west-1

import com.amazonaws.regions.Regions;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;
import com.amazonaws.services.s3.model.Bucket;
import com.amazonaws.services.s3.model.CreateBucketRequest;

import java.util.List;
import java.util.UUID;

public class CreateBucketWithUUID {
    public static void main(String[] args) {
        final AmazonS3 s3 = AmazonS3ClientBuilder.standard().withRegion(Regions.US_EAST_1).build();
        String bucketName = "amzn-s3-demo-bucket" +  UUID.randomUUID().toString().replace("-", "");
        CreateBucketRequest createRequest = new CreateBucketRequest(bucketName);
        System.out.println(bucketName);
        s3.createBucket(createRequest);
    }
}                

アカウントのリージョン名前空間にバケットを作成する

次の例は、アカウントのリージョン名前空間に汎用バケットを作成する方法を示しています。

aws s3api create-bucket \
    --bucket amzn-s3-demo-bucket-012345678910-us-west-1-an \
    --bucket-namespace account-regional
    --region us-west-1 \
    --create-bucket-configuration LocationConstraint=us-west-1