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

Object Storage Service:PutBucket

最終更新日:Mar 11, 2024

バケットを作成します。

使用上の注意

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

  • Alibaba Cloudアカウントを使用して、同じリージョンに最大100個のバケットを作成できます。

  • 各リージョンは、対応するエンドポイントを使用してアクセスできます。 詳細は、「リージョンとエンドポイント」をご参照ください。

  • 同じAlibaba Cloudアカウントから複数のPutBucket操作を呼び出して同じバケットを作成した場合、最初の操作でバケットが作成され、その後の操作でバケットのメタデータが変更されます。 同じバケットで複数のPutBucket操作を呼び出す場合は、誤ってデータが上書きされる可能性があるため、注意してください。

リクエスト構文

PUT / HTTP/1.1
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
x-oss-acl: 権限
権限付与: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>
    <StorageClass> 標準 </StorageClass>
</CreateBucketConfiguration> 

リクエストヘッダー

ヘッダー

データ型

必須

説明

x-oss-acl

String

任意

非公開

バケットのアクセス制御リスト (ACL) 。 有効な値:

  • public-read-write

  • パブリック読み取り

  • private (デフォルト)

バケットのACLの詳細については、「バケットACL」をご参照ください。

x-oss-resource-group-id

String

任意

rg-aek27tc ****

リソースグループの ID です。

  • リクエストにヘッダーを含め、リソースグループのIDを指定した場合、作成するバケットはリソースグループに属します。

    指定されたリソースグループIDがrg-default-idの場合、作成するバケットはデフォルトリソースグループに属します。

  • リクエストにヘッダーを含めない場合、作成するバケットはデフォルトのリソースグループに属します。

リソースグループのIDを取得するには、resource Managementコンソールを使用するか、ListResourceGroups操作を呼び出します。 詳細については、「リソースグループの基本情報の表示」および「ListResourceGroups」をご参照ください。

x-oss-hns-status

String

任意

disabled

バケットの階層名前空間機能を有効にするかどうかを指定します。

階層名前空間機能は、バケットを作成する場合にのみ有効にできます。 既存のバケットの階層名前空間機能を有効または無効にすることはできません。

  • enabled

    バケットの階層名前空間機能を有効にすると、バケット内のディレクトリを作成、削除、および名前変更できます。

  • 無効 (デフォルト)

PutBucketリクエストのリクエストヘッダーには、共通のリクエストヘッダーも含まれています。 共通リクエストヘッダーの詳細については、「共通HTTPヘッダー」をご参照ください。

リクエスト要素

要素

データ型

必須

説明

StorageClass

String

任意

標準

バケットのストレージクラス。 有効な値:

  • 標準 (デフォルト)

  • IA

  • アーカイブ

  • ColdArchive

  • DeepColdArchive

親ノード: CreateBucketConfiguration

子ノード: なし

DataRedundancyType

String

任意

LRS

バケットの冗長タイプ。 有効な値:

  • LRS (デフォルト)

    ローカル冗長ストレージ (LRS) は、同じゾーン内の異なるデバイス間で各オブジェクトのコピーを格納します。 これにより、2つのストレージデバイスが同時に損傷した場合でも、データの信頼性と可用性が保証されます。

  • ZRS

    Zone-redundant storage (ZRS) は、同じリージョンの複数のゾーンにデータを格納します。 ゾーンが使用できなくなっても、データにアクセスできます。

親ノード: CreateBucketConfiguration

子ノード: なし

レスポンスヘッダー

ヘッダー

データ型

説明

場所

String

/oss-例

バケットのURL。 ヘッダーは、スラッシュ (/) とバケットの名前で構成されます。

このヘッダーはデフォルトでは空です。

PutBucket要求に対する応答には、共通の応答ヘッダーが含まれます。 詳細については、「共通レスポンスヘッダー」をご参照ください。

  • デフォルトリソースグループにバケットを作成する

    PUT / HTTP/1.1
    ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
    日付: 2月24日金曜日2017 03:15:40 GMT
    x-oss-acl: プライベート
    承認: OSS qn6qrrqxo2oawuk53otfjbyc:77Dvh 5wQgIjWjwO/KyRt8dOP ****
    <?xml version="1.0" encoding="UTF-8"?>
    <CreateBucketConfiguration>
        <StorageClass>Standard</StorageClass>
        <DataRedundancyType>LRS</DataRedundancyType>
    </CreateBucketConfiguration> 
  • 通常のレスポンス例

    HTTP/1.1 200 OK
    x-oss-request-id: 534B371674E88A4D8906 ****
    日付: 2月24日金曜日2017 03:15:40 GMT
    コンテンツ長: 0
    接続: キープアライブ
    サーバー: AliyunOSS
    場所: /oss-example 
  • 特定のリソースグループにバケットを作成する

    リクエストの例

    PUT / HTTP/1.1
    ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
    日付: 2月24日金曜日2017 03:15:40 GMT
    x-oss-acl: プライベート
    x-oss-resource-group-id: rg-aek27tc ********
    承認: OSS qn6qrrqxo2oawuk53otfjbyc:77Dvh 5wQgIjWjwO/KyRt8dOP ****
    <?xml version="1.0" encoding="UTF-8"?>
    <CreateBucketConfiguration>
        <StorageClass> 標準 </StorageClass>
    </CreateBucketConfiguration> 

    通常のレスポンス例

    HTTP/1.1 200 OK
    x-oss-request-id: 534B371674E88A4D8906 ****
    日付: 2月24日金曜日2017 03:15:40 GMT
    コンテンツ長: 0
    接続: キープアライブ
    サーバー: AliyunOSS
    場所: /oss-example 

SDK

次のプログラミング言語のOSS SDKを使用して、PutBucketを呼び出すことができます。

エラーコード

エラーコード

HTTPステータスコード

説明

InvalidBucketName

400

バケット名が命名要件を満たしていません。

AccessDenied

403

考えられる原因:

  • PutBucketリクエストの開始時に、ユーザー認証に関する情報はインポートされません。

  • PutBucket操作を呼び出す権限がありません。

TooManyBuckets

400

作成されたバケットの数が上限を超えています。 Alibaba Cloudアカウントを使用して、同じリージョンに最大100個のバケットを作成できます。

BucketAlreadyExists

409

考えられる原因:

  • このバケットはすでに存在するか、別のユーザーによって占有されています。 命名要件を満たす新しいバケット名を使用します。

  • 既存のバケットの階層名前空間機能を有効または無効にすることはできません。 階層名前空間機能は、バケットを作成する場合にのみ有効にできます。