CreateActivation - Elastic Compute Service - Alibaba Cloud Documentation Center

Membuat kode aktivasi (kode dinamis) yang digunakan untuk mendaftarkan server selain Elastic Compute Service sebagai instans terkelola Alibaba Cloud.

Deskripsi operasi

Setelah Anda mendaftarkan server selain Elastic Compute Service sebagai instans terkelola Asisten Cloud menggunakan kode aktivasi (kode dinamis), Anda dapat menggunakan berbagai layanan daring yang disediakan oleh Asisten Cloud, seperti Cloud Assistant, manajemen operasi, dan Apsara DevOps, pada instans terkelola tersebut.

Sistem operasi server non-Asisten Cloud harus memenuhi persyaratan versi berikut, dan server harus memiliki akses ke Internet sebelum dapat didaftarkan sebagai instans terkelola Asisten Cloud.

Asisten Cloud Linux 2, 3, atau yang lebih baru
CentOS 6, 7, 8, atau yang lebih baru
Debian 8, 9, 10, atau yang lebih baru
Ubuntu 12, 14, 16, 18, atau yang lebih baru
CoreOS
OpenSUSE
Red Hat 5, 6, 7, atau yang lebih baru
SUSE Linux Enterprise Server 11, 12, 15, atau yang lebih baru
Windows Server 2012, 2016, 2019, atau yang lebih baru

Di satu wilayah Asisten Cloud, Anda dapat memiliki hingga 10 kode aktivasi untuk instans terkelola. Satu kode aktivasi dapat digunakan untuk mengaktifkan hingga 10 instans, dan periode validitas maksimum satu kode aktivasi adalah 4 jam.

Catatan

Anda dapat membuka tab Instans Terkelola pada halaman Cloud Assistant dan klik Daftarkan Instans Baru untuk mendapatkan kode aktivasi (kode dinamis) dan data penggunaannya.

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

ecs:CreateActivation

create

*Activation

acs:ecs:{#regionId}:{#accountId}:activation/*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah. Wilayah yang didukung: Tiongkok (Qingdao), Tiongkok (Beijing), Tiongkok (Zhangjiakou), Tiongkok (Hohhot), Tiongkok (Ulanqab), Tiongkok (Hangzhou), Tiongkok (Shanghai), Tiongkok (Shenzhen), Tiongkok (Heyuan), Tiongkok (Guangzhou), Tiongkok (Chengdu), Hong Kong (Tiongkok), Singapura, Jepang (Tokyo), AS (Silicon Valley), dan AS (Virginia). Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
InstanceName	string	No	Awalan default nama instans. Panjang awalan harus 2 hingga 50 karakter. Harus diawali dengan huruf dan tidak boleh diawali dengan karakter khusus atau digit. Hanya dapat berisi titik (.), garis bawah (_), tanda hubung (-), dan titik dua (:). Tidak boleh diawali dengan `http://` atau `https://`. Instans yang didaftarkan menggunakan kode aktivasi yang dibuat oleh operasi ini menggunakan nama ini sebagai awalan untuk menghasilkan nama instans berurutan. Anda juga dapat menentukan nama instans baru untuk mengganti nilai default ini saat mendaftarkan instans terkelola. Saat mendaftarkan instans terkelola, jika Anda menentukan parameter InstanceName, nama instans dalam format -001 akan dihasilkan. Jumlah digit pada nomor seri 001 bergantung pada jumlah digit pada nilai parameter InstanceCount. Jika Anda tidak menentukan parameter InstanceName, hostname host akan digunakan sebagai nama instans.	test-InstanceName
Description	string	No	Deskripsi kode aktivasi. Panjang deskripsi harus 1 hingga 100 karakter.	This is description.
InstanceCount	integer	No	Jumlah maksimum penggunaan kode aktivasi untuk mendaftarkan instans terkelola. Nilai valid: 1 hingga 1000. Nilai default: 10.	10
TimeToLiveInHours	integer	No	Periode validitas kode aktivasi. Setelah kode aktivasi kedaluwarsa, kode tersebut tidak dapat digunakan untuk mendaftarkan instans baru. Unit: jam. Nilai valid: 1 hingga 4. Nilai default: 4.	4
IpAddressRange	string	No	Alamat IP host yang diizinkan menggunakan kode aktivasi. Atur nilai ke alamat IPv4, alamat IPv6, atau blok CIDR.	0.0.0.0/0
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan token tersebut unik di antara permintaan yang berbeda. Parameter ClientToken hanya dapat berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.	123e4567-e89b-12d3-a456-426655440000
ResourceGroupId	string	No	ID kelompok sumber daya tempat kode aktivasi berada.	rg-123******
Tag	array<object>	No	Daftar tag.
	object	No	Daftar tag.
Key	string	No	Kunci tag N dari kode aktivasi instans terkelola (kode dinamis). Nilai valid N: 1 hingga 20. Jika Anda menentukan parameter ini, nilainya tidak boleh berupa string kosong. Jika Anda menggunakan satu tag untuk memfilter resource, jumlah resource yang dikembalikan tidak boleh melebihi 1.000. Jika Anda menggunakan beberapa tag untuk memfilter resource, jumlah resource yang dilampirkan ke semua tag yang ditentukan tidak boleh melebihi 1.000. Jika jumlah resource melebihi 1.000, Anda harus memanggil operasi ListTagResources untuk mengkueri resource. Panjang kunci tag dapat mencapai 64 karakter. Tidak boleh diawali dengan `aliyun` atau `acs:` dan tidak boleh mengandung `http://` atau `https://`.	TestKey
Value	string	No	Nilai tag N dari kode aktivasi instans terkelola. Nilai valid N: 1 hingga 20. Nilai tag dapat berupa string kosong. Panjang nilai tag dapat mencapai 128 karakter dan tidak boleh mengandung `http://` atau `https://`.	TestValue

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	4ECEEE12-56F1-4FBC-9AB1-890F1234****
ActivationCode	string	Kode aktivasi. Kode ini hanya dikembalikan satu kali saat operasi dipanggil dan tidak dapat dikueri nanti. Pastikan Anda menyimpan nilai kembali dengan aman.	a-hz0ch3SwhOlE1234+Xo32lAZC****
ActivationId	string	ID kode aktivasi.	4ECEEE12-56F1-4FBC-9AB1-890F1234****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "4ECEEE12-56F1-4FBC-9AB1-890F1234****",
  "ActivationCode": "a-hz0ch3SwhOlE1234+Xo32lAZC****",
  "ActivationId": "4ECEEE12-56F1-4FBC-9AB1-890F1234****"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	RegionId.ApiNotSupported	The api is not supported in this region.	Pemanggilan API tidak didukung di wilayah yang ditentukan. Periksa apakah nilai parameter RegionId sudah benar.
400	InstanceName.ExceedLimit	Default instance name prefix length exceeds.	Panjang awalan nama instans melebihi batas atas.
400	InstanceName.InvalidPattern	Default instance name prefix pattern invalid.	Awalan nama instans tidak valid.
400	ActivationDesc.ExceedLimit	Activation description length exceeds.	Panjang deskripsi untuk kode aktivasi melebihi batas atas.
400	ActivationLimitation.Invalid	The specified parameter InstanceCount exceeds the limit of %s.	Jumlah kali kode aktivasi dapat digunakan untuk mendaftarkan instans terkelola melebihi batas.
400	AddressRange.InvalidPattern	Address range should be ipv4 address or cidr.	Alamat IP host yang diizinkan menggunakan kode aktivasi ini harus berupa alamat IPv4, alamat IPv6, atau blok CIDR yang valid.
400	ActivationCount.ExceedLimit	The count of activation in current region exceeds the limit of %s.	Jumlah kode aktivasi yang dapat dibuat melebihi batas atas.
400	ActivationTTL.ExceedLimit	The specified parameter TimeToLiveInHours exceeds the limit of %s.	Periode validitas kode aktivasi melebihi batas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Parameter kunci tag yang ditentukan tidak valid.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Parameter nilai tag yang ditentukan tidak valid.
400	NumberExceed.Tags	The Tags parameter number is exceed.	Jumlah tag melebihi batas maksimum. Anda dapat menentukan hingga 20 tag untuk operasi ini.
400	MissingParameter.TagKey	You must specify Tag.N.Key.	Tentukan kunci tag.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Terdapat kunci duplikat pada tag. Pastikan semua kunci unik.
400	InvalidClientToken.Malformed	The specified parameter clientToken is not valid.	Parameter idempoten yang ditentukan tidak valid.
500	InternalError.Dispatch	An error occurred when dispatch the request.	Terjadi kesalahan saat mengirim permintaan. Coba lagi nanti.
403	InvalidParameterCharacter	The specified parameter %s contains illegal characters.
403	Operation.Forbidden	The operation is not permitted.	Operasi tidak diizinkan.
403	InvalidStatus.ResourceGroup	You cannot perform an operation on a resource group that is being created or deleted.	Operasi tidak diizinkan saat kelompok sumber daya sedang dibuat atau dihapus.
403	RealNameAuthenticationError	Your account has not passed the real-name authentication yet.	Akun Alibaba Cloud Anda belum menyelesaikan registrasi nama asli. Selesaikan registrasi nama asli sebelum melakukan operasi ini.
403	ManagedInstanceCountExceedLimit	The count of managed instance in current region exceeds the limit of %s.	Jumlah instans terkelola di wilayah saat ini telah melebihi batas %s.
403	IdempotentParameterMismatch	The specified parameter has changed while using an already used clientToken.	Parameter permintaan tidak cocok dengan permintaan yang memiliki ClientToken yang sama.
403	IdempotentProcessing	The previous idempotent request(s) is still processing.	Permintaan idempoten sebelumnya masih diproses. Coba lagi nanti.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	RegionId yang ditentukan tidak ada. Periksa apakah produk ini tersedia di wilayah yang ditentukan.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	Kelompok sumber daya tidak ditemukan dalam catatan.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.