バケットを作成します。
使用上の注意
バケットを作成するには、
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) 。 有効な値：
バケットのACLの詳細については、「バケットACL」をご参照ください。 |
x-oss-resource-group-id | String | 任意 | rg-aek27tc **** | リソースグループの ID です。
リソースグループのIDを取得するには、resource Managementコンソールを使用するか、ListResourceGroups操作を呼び出します。 詳細については、「リソースグループの基本情報の表示」および「ListResourceGroups」をご参照ください。 |
x-oss-hns-status | String | 任意 | disabled | バケットの階層名前空間機能を有効にするかどうかを指定します。 階層名前空間機能は、バケットを作成する場合にのみ有効にできます。 既存のバケットの階層名前空間機能を有効または無効にすることはできません。
|
PutBucketリクエストのリクエストヘッダーには、共通のリクエストヘッダーも含まれています。 共通リクエストヘッダーの詳細については、「共通HTTPヘッダー」をご参照ください。
リクエスト要素
要素 | データ型 | 必須 | 例 | 説明 |
StorageClass | String | 任意 | 標準 | バケットのストレージクラス。 有効な値：
親ノード: CreateBucketConfiguration 子ノード: なし |
DataRedundancyType | String | 任意 | LRS | バケットの冗長タイプ。 有効な値：
親ノード: 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 | 考えられる原因：
|
TooManyBuckets | 400 | 作成されたバケットの数が上限を超えています。 Alibaba Cloudアカウントを使用して、同じリージョンに最大100個のバケットを作成できます。 |
BucketAlreadyExists | 409 | 考えられる原因:
|