View a markdown version of this page

CreateBucket (SOAP API) - Amazon Simple Storage Service
要素アクセスコントロール関連リソース

CreateBucket (SOAP API)

注記

SOAP API for Amazon S3 は新規顧客には利用できず、2025 年 8 月 31 日にサポート終了 (EOL) となります。REST API か AWS SDK を使用することをお勧めします。

CreateBucket オペレーションは、バケットを作成します。すべての文字列がバケット名として使用できるわけではありません。バケットの命名に関する制限については、「Amazon S3 バケットの使用」を参照してください。

注記

バケット名が存在するかどうかを判断するには、ListBucket を使用し、MaxKeys を 0 に設定します。NoSuchBucket レスポンスは、バケットが使用可能であることを示します。AccessDenied レスポンスは、他のユーザーがバケットを所有していることを示します。Success レスポンスは、自分がバケットを所有しているか、バケットへのアクセス許可を持っていることを示します。

例「quotes」という名前のバケットを作成する

Sample Request

<CreateBucket xmlns="https://doc.s3.amazonaws.com/2006-03-01">
  <Bucket>quotes</Bucket>
  <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
  <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
  <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
</CreateBucket>

Sample Response

<CreateBucketResponse xmlns="https://s3.amazonaws.com/doc/2006-03-01">
  <CreateBucketResponse>
    <Bucket>quotes</Bucket>
  </CreateBucketResponse>
</CreateBucketResponse>

要素

  • Bucket: 作成しようとしているバケットの名前。

  • AccessControlList: 新しいバケットのアクセスコントロールリスト。この要素はオプションです。指定しない場合、バケットはリクエスタに FULL_CONTROL アクセスを許可するアクセスポリシーで作成されます。

アクセスコントロール

有効な AWS アクセスキー ID で認証する必要があります。匿名リクエストでバケットを作成することは一切許可されていません。

関連リソース