Gunakan API EnableResourceDirectory untuk mengaktifkan direktori resource - Resource Management - Alibaba Cloud - Resource Management

Mengaktifkan Direktori sumber daya.

Deskripsi operasi

Anda dapat mengaktifkan Direktori sumber daya dengan menggunakan akun login saat ini atau dengan membuat akun manajemen baru. Untuk informasi selengkapnya, lihat Mengaktifkan Direktori 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:EnableResourceDirectory

create

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
MAName	string	No	Nama akun manajemen baru. Format: `<Prefix>@rdadmin.aliyunid.com`. dapat berisi huruf, digit, dan karakter khusus `_.-`. Harus diawali dan diakhiri dengan huruf atau digit, serta tidak boleh mengandung karakter khusus yang berurutan. Panjang adalah 2 hingga 50 karakter.	user01@rdadmin.aliyunid.com
MASecureMobilePhone	string	No	Nomor telepon aman akun manajemen baru. Jika Anda mengosongkan parameter ini, nomor telepon aman akun login saat ini akan digunakan. Nomor telepon ini harus sama dengan yang digunakan untuk mendapatkan kode verifikasi di SendVerificationCodeForEnableRD. Format: `<Kode negara>-<Nomor telepon>`. Catatan Nomor ponsel di Tiongkok Daratan dengan format `86-<Nomor telepon>` tidak didukung.	xx-13900001234
VerificationCode	string	No	Kode verifikasi. Anda dapat memanggil SendVerificationCodeForEnableRD untuk mendapatkan kode verifikasi.	123456
EnableMode	string	Yes	Metode yang digunakan untuk mengaktifkan Direktori sumber daya. Nilai valid: CurrentAccount: menggunakan akun login saat ini untuk mengaktifkan Direktori sumber daya. NewManagementAccount: membuat akun manajemen baru untuk mengaktifkan Direktori sumber daya. Jika Anda memilih metode ini, Anda harus mengonfigurasi `MAName`, `MASecureMobilePhone`, dan `VerificationCode`.	CurrentAccount
DryRun	boolean	No	Apakah akan menjalankan dry run saja untuk permintaan. Nilai valid: true: menjalankan dry run untuk mengaktifkan Direktori sumber daya tanpa benar-benar mengaktifkannya. false (default): mengaktifkan Direktori sumber daya.	false

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
ResourceDirectory	object	Informasi tentang Direktori sumber daya.
ResourceDirectoryId	string	ID Direktori sumber daya.	rd-54****
MasterAccountId	string	ID akun manajemen.	507408460615****
MasterAccountName	string	Nama akun manajemen.	alice@example.com
RootFolderId	string	ID Folder Root.	r-G9****
CreateTime	string	Waktu saat Direktori sumber daya diaktifkan. Waktu ditampilkan dalam format ISO 8601, dalam UTC.	2021-12-08T02:15:31.744Z
RequestId	string	ID permintaan.	EC2FE94D-A4A2-51A1-A493-5C273A36C46A

Contoh

Respons sukses

JSONformat

{
  "ResourceDirectory": {
    "ResourceDirectoryId": "rd-54****",
    "MasterAccountId": "507408460615****",
    "MasterAccountName": "alice@example.com",
    "RootFolderId": "r-G9****",
    "CreateTime": "2021-12-08T02:15:31.744Z"
  },
  "RequestId": "EC2FE94D-A4A2-51A1-A493-5C273A36C46A"
}

Kode kesalahan

HTTP status code	Error code	Error message
409	NotSupport.AccountInAnotherResourceDirectory	The specified account is an Alibaba Cloud account or already exists in another resource directory.
409	Invalid.EnterpriseName	You must specify the enterprise name.
409	EnterpriseRealNameVerificationError	The specified account does not pass enterprise real-name verification. We recommend you first complete enterprise real-name verification for the account.
409	EntityAlreadyExists.ResourceDirectory	The resource directory for the account is already enabled. We recommend that you do not enable the resource directory again.
409	InvalidParameter.ManagementAccountName.AlreadyUsed	The ManagementAccountName has been used.
409	Invalid.VerificationCode	The verification code is invalid.
409	InvalidParameter.ManagementAccountName	The management account name is in the wrong format.
409	InvalidParameter.ManagementAccountSecurityInfo	The parameter management account secure mobile phone is invalid.
409	MissingSecureMobilePhone	Secure mobile phone is missing.
409	MissingSecurityInfo	Security info is missing.
409	NotSupport.Account.Site	The caller is not a China site account, which is not supported.
409	Invalid.AccountType	The specified profile type of account is invalid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.