CreateDirectory - Object Storage Service

Operasi ini digunakan untuk membuat direktori dan hanya berlaku untuk bucket dengan fitur namespace hierarkis diaktifkan.

Catatan

Untuk membuat direktori, Anda memerlukan izin PutObject.
Jika nama direktori yang ingin dibuat sudah ada dan Anda memiliki akses ke direktori tersebut, OSS akan mengembalikan respons 200 OK tanpa melakukan operasi pembuatan ulang.
Direktori yang dibuat tidak dapat menyimpan data. Nilai Content-Length harus disetel ke 0.
Nilai Content-Type direktori harus disetel ke application/x-directory dan tidak dapat diubah.
Jalur absolut direktori tidak boleh mengandung garis miring (/) berturut-turut.

Sintaks

POST /objectName?x-oss-dir HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Header permintaan

Header

Tipe

Diperlukan

Deskripsi

Authorization

String

Tidak

Menentukan bahwa permintaan telah diotorisasi. Untuk informasi lebih lanjut, lihat RFC 2616.

Header Authorization diperlukan dalam sebagian besar kasus. Namun, jika Anda menggunakan URL yang ditandatangani dalam permintaan, header ini tidak diperlukan. Untuk informasi lebih lanjut, lihat Hasilkan URL yang ditandatangani.

Nilai default: null

Operasi API ini mencakup header permintaan umum seperti Host dan Date. Untuk detail lebih lanjut tentang header permintaan umum, lihat Header Permintaan Umum.

Header respons

Header respons dalam operasi API ini hanya mencakup header respons umum. Informasi lebih lanjut dapat ditemukan di Header Respons Umum.

Contoh

Contoh Permintaan

POST /desktop/oss?x-oss-dir HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 29 Apr 2021 05:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Contoh Respons Sukses

HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A64485981
Date: Thu, 29 Apr 2021 05:21:12 GMT
Last-Modified: Wed, 24 Feb 2021 06:07:48 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

SDK OSS

Anda dapat menggunakan SDK OSS untuk bahasa pemrograman berikut guna memanggil operasi CreateDirectory:

Kode kesalahan

Kode kesalahan

Kode status HTTP

Deskripsi

AccessDenied

403

Penyebab yang mungkin:

Saat Anda membuat direktori, Anda tidak memiliki izin untuk mengakses bucket yang ditentukan.
Saat Anda membuat direktori, direktori yang ingin Anda buat memiliki nama yang sama dengan direktori yang sudah ada, tetapi Anda tidak memiliki izin untuk mengakses direktori yang sudah ada tersebut.

FileAlreadyExists

409

Pesan kesalahan dikembalikan karena objek yang sudah ada pada tingkat direktori yang sama memiliki nama yang sama. Contohnya: Direktori desktop berisi objek bernama osstest. Anda tidak dapat membuat direktori bernama osstest di direktori desktop.