最終更新日: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
なし
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