PutBucket

最終更新日:2025-08-18 15:50:16

このAPIはストレージバケットを作成するために使用されます。この操作を実行するには、wos:PutBucket 権限が必要です。

リクエスト構文

PUT / HTTP/1.1
Host: BucketName.s3-cn-south-6.wcsapi.com
Date: GMT Date
Authorization: SignatureValue

URIリクエストパラメータ

なし

リクエストヘッダー

common request headers のみ必要です。

リクエストボディ

リクエストボディは、以下の要素を含むXML形式である必要があります。

要素名 説明 必須
CreateBucketConfiguration バケット設定リストの定義。
型: XML
子ノード: Rule
親ノード: なし
Yes
StorageClass バケットのストレージクラスを指定します。サポート値:
Standard、IA、Archive(デフォルトはユーザー設定値)。
型: XML
親ノード: CreateBucketConfiguration
No

レスポンス構文

HTTP/1.1 200 OK
x-wos-request-id: request id
Content-Type: type
Date: date
Content-Length: length
Server: WS-web-server

レスポンスヘッダー

common response headers のみ必要です。

レスポンス要素

なし

例外シナリオ

原因 HTTPステータスコード エラーコード
バケット名が無効 400 InvalidBucketName
バケットが既に存在 409 BucketAlreadyExists
IAM認証失敗 403 AccessDenied
無効なストレージクラス 400 InvalidStorageClass
指定リージョンでストレージサービスが有効でない 403 Standard storage service in XX not enabled.
ストレージクラスが存在しない(大文字小文字区別有) 400 InvalidStorageClass

次の例では、x-amz-storage-class ヘッダーを指定するか、またはXMLボディ内で StorageClass 要素を指定してストレージクラスを指定する方法を示します。

PUT / HTTP/1.1
Host: BucketName.s3-cn-south-6.wcsapi.com
Date: GMT Date
Authorization: SignatureValue
x-amz-storage-class: Standard, IA, Archive 
<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>
    <StorageClass>Standard</StorageClass>
</CreateBucketConfiguration>

HTTP/1.1 200 OK
x-amz-request-id: 534B371674E88A4D8906****
Date: Fri, 24 Feb 2017 03:15:40 GMT
Content-Length: 0
Connection: keep-alive
Server: WCS-Web-Server
Location: /bucketName