Topik ini menjelaskan istilah dasar yang digunakan dalam Cloud Control API.
Metadata sumber daya
Metadata sumber daya mencakup atribut, tipe, hubungan, dan perilaku sumber daya. Semua manajemen sumber daya dilaksanakan berdasarkan metadata sumber daya. GetResourceType membantu Anda memperoleh metadata dari sumber daya tertentu dan menafsirkan metadata tersebut dalam parameter respons.
Informasi dalam metadata sumber daya dapat dibagi menjadi tiga bagian: informasi dasar, atribut, dan informasi tambahan dari sumber daya tertentu.
Informasi dasar mencakup nama, layanan terkait, deskripsi, tingkat penyebaran, dan metode penagihan sumber daya.
Atribut mencakup deskripsi atribut sumber daya spesifik, kumpulan parameter operasi pribadi, dan kumpulan atribut sensitif.
Informasi tambahan mencakup informasi otorisasi dan kapasitas sumber daya, seperti kebijakan otorisasi, kebijakan pembatasan laju, dan kuota.
Sumber daya induk dan sumber daya anak
Sumber daya induk dan anak adalah konsep logis yang menggambarkan dependensi antara sumber daya dalam produk yang sama. Sumber daya induk mencakup sumber daya anak, sedangkan sumber daya anak termasuk dalam sumber daya induk. Hubungan logis antara hierarki sumber daya membantu Anda melaksanakan manajemen sumber daya pada sumber daya anak.
Cara menentukan apakah suatu sumber daya termasuk dalam sumber daya induk
Jika resourceType dari metadata sumber daya berada dalam format ****/****, maka sumber daya tersebut termasuk dalam sumber daya induk. Sebagai contoh, ApsaraDB for Redis berisi instance ApsaraDB for Redis bernama DBInstance dan akun database bernama DBInstance/Account. Jika resourceType dari akun database adalah DBInstance/Account, maka akun database tersebut termasuk dalam sumber daya induk. ResourceType dari sumber daya induk adalah DBInstance, yaitu sebuah instance ApsaraDB for Redis.
Cara melakukan manajemen sumber daya pada sumber daya yang termasuk dalam sumber daya induk
Ketika Anda memanggil operasi API untuk melakukan manajemen sumber daya pada sumber daya yang termasuk dalam sumber daya induk, Anda harus menambahkan informasi sumber daya induk ke jalur permintaan. Untuk informasi lebih lanjut, lihat requestPath dari parameter permintaan API di Direktori API.
Operasi sinkron dan asinkron
Operasi sinkron dan asinkron adalah dua mode eksekusi tugas. Operasi sinkron mengembalikan hasil setelah tugas selesai, sedangkan operasi asinkron mengembalikan hasil tanpa menunggu tugas selesai.
Dalam kebanyakan kasus, operasi Cloud Control API seperti pengecekan sumber daya, pencatatan atau pembaruan, serta pengecekan metadata diproses secara sinkron. Tugas yang memakan waktu, seperti pembuatan dan penghapusan sumber daya, diproses secara asinkron untuk meningkatkan stabilitas layanan.
Jika kode status "202" dikembalikan ketika Anda memanggil operasi Cloud Control API untuk membuat tugas asinkron, Anda dapat memanggil operasi GetTask untuk memeriksa status tugas asinkron tersebut.