Buat folder dengan memanggil API CreateFolder - Resource Management - Alibaba Cloud - Resource Management

Deskripsi operasi

Anda dapat membuat hingga lima tingkat folder sumber daya.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

resourcemanager:CreateFolder

create

*Folder

acs:resourcemanager::{#accountId}:folder/{#ResourceDirectoryPath}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ParentFolderId	string	No	ID folder sumber daya induk.	r-b1****
FolderName	string	Yes	Nama folder sumber daya. Panjang nama harus 1 hingga 24 karakter dan dapat berisi huruf, digit, garis bawah (_), titik (.), dan tanda hubung (-).	rdFolder
Tag	array<object>	No	Tag folder sumber daya.
	object	No	Tag folder sumber daya.
Key	string	No	Kunci tag.	k1
Value	string	No	Nilai tag.	v1

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
Folder	object	Informasi folder sumber daya.
CreateTime	string	Waktu pembuatan folder sumber daya. Waktu ditampilkan dalam format ISO 8601, dalam UTC.	2019-02-19T09:34:50.757Z
FolderId	string	ID folder sumber daya.	fd-u8B321****
FolderName	string	Nama folder sumber daya.	rdFolder
ParentFolderId	string	ID folder sumber daya induk.	r-b1****
RequestId	string	ID permintaan.	C2CBCA30-C8DD-423E-B4AD-4FB694C9180C

Contoh

Respons sukses

JSONformat

{
  "Folder": {
    "CreateTime": "2019-02-19T09:34:50.757Z",
    "FolderId": "fd-u8B321****",
    "FolderName": "rdFolder",
    "ParentFolderId": "r-b1****"
  },
  "RequestId": "C2CBCA30-C8DD-423E-B4AD-4FB694C9180C"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	InvalidParameter.ParentFolderId	The ParentFolderId is invalid.
400	MissingParameter.Folder.Name	You must specify the resource folder name.
400	InvalidParameter.Folder.Name	The Name of folder is invalid.
400	InvalidParameter.Folder.Name.Length	The Name of folder exceeds the length limit.
400	InvalidParameter.Folder.Name.AlreadyUsed	The name already exists under the same parent. Please change to another name.
404	EntityNotExists.ResourceDirectory	The resource directory for the account is not enabled. We recommend that you first enable the resource directory for the account.
404	EntityNotExists.Folder	The resource directory folder does not exist.
409	LimitExceeded.Folder.Depth	The folder depth exceeds the limit of 5.
409	QuotaExceeded.Folder.Count	The number of folders exceeds the quota.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.