この API を呼び出すと、ディレクトリを作成できます。 この操作は、階層的な名前空間機能が有効になっているバケットにのみ適用できます。
使用上の注意
- ディレクトリを作成するには、PutObject権限が必要です。
- ディレクトリを作成すると、作成するディレクトリの名前が既存のディレクトリと同じで、既存のディレクトリにアクセスする権限がある場合、OSSはOK 200を返します。 ただし、OSSは作成操作を実行しません。
- ディレクトリを作成すると、ディレクトリにデータをインポートできません。 ディレクトリのContent-Length値は0にのみ設定できます。
- ディレクトリのContent-Type値はapplication/x-directoryにのみ設定でき、変更できません。
- ディレクトリを作成するとき、ディレクトリの絶対パスに連続したスラッシュ (/) を含めることはできません。
リクエストの構造
POST /objectName?x-oss-dir HTTP/1.1
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue
リクエストヘッダー
ヘッダー | データ型 | 必須 | 説明 |
承認 | String | 任意 | リクエストが許可されることを指定します。 詳細については、「RFC 2616」をご参照ください。 ほとんどの場合、Authorizationヘッダーが必要です。 ただし、リクエストで署名付きURLを使用する場合、このヘッダーは必要ありません。 詳細については、「署名付きURLの生成」をご参照ください。 既定値 : null 。 |
このAPI操作には、HostやDateなどの一般的なリクエストヘッダーも含める必要があります。 共通リクエストヘッダーの詳細については、「共通リクエストヘッダー」をご参照ください。
レスポンスヘッダー
このAPI操作に含まれるレスポンスヘッダーには、共通のレスポンスヘッダーのみが含まれます。 詳細については、「共通レスポンスヘッダー」をご参照ください。
例
POST /desktop/oss?x-oss-dir HTTP/1.1のサンプルリクエスト
ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
日付: 4月29日木曜日05:21:12 GMT 2021
承認: OSS qn6qrrqxo2oawuk53otfjbyc:CTkuxpLAi4XZ + WwIfNm0Fmgb ****
成功応答
のサンプルHTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A64485981
日付: 4月29日木曜日05:21:12 GMT 2021
最終変更: 2月24日水曜日2021 06:07:48 GMT
コンテンツ長: 0
接続: キープアライブ
サーバー: AliyunOSS
SDK
OSS SDK for Java: ディレクトリの作成
エラーコード
エラーコード | HTTPステータスコード | 説明 |
AccessDenied | 403 | 考えられる原因:
|
FileAlreadyExists | 409 | 同じディレクトリレベルの既存のオブジェクトの名前が同じである場合に返されるエラーメッセージ。 例: デスクトップディレクトリには、osstestという名前のオブジェクトが含まれます。 デスクトップディレクトリにosstestという名前のディレクトリを作成することはできません。 |