CreateActivation - Elastic Compute Service - Alibaba Cloud Documentation Center

Membuat kode aktivasi yang digunakan untuk mendaftarkan server non-Alibaba Cloud sebagai instans terkelola Alibaba Cloud.

Deskripsi operasi

Setelah Anda menggunakan kode aktivasi untuk mendaftarkan server non-Alibaba Cloud sebagai instans terkelola Alibaba Cloud, Anda dapat menggunakan berbagai layanan daring yang disediakan oleh Alibaba Cloud di instans terkelola, seperti Asisten Cloud, manajemen operasi, dan Alibaba Cloud DevOps.

Sistem operasi server non-Elastic Compute Service harus memenuhi persyaratan versi berikut, dan server harus memiliki akses Internet sebelum dapat didaftarkan sebagai instans terkelola Alibaba Cloud.

Alibaba Cloud Linux 2/3 dan versi lebih baru
CentOS 6/7/8 dan versi lebih baru
Debian 8/9/10 dan versi lebih baru
Ubuntu 12/14/16/18 dan versi lebih baru
CoreOS
OpenSUSE
RedHat 5/6/7 dan versi lebih baru
SUSE Linux Enterprise Server 11/12/15 dan versi lebih baru
Window Server 2012/2016/2019 dan versi lebih baru

Dalam satu wilayah Alibaba Cloud, Anda dapat memiliki hingga 10 kode aktivasi instans terkelola. Setiap kode aktivasi dapat digunakan untuk mengaktifkan hingga 10 instans. Periode validitas maksimum untuk satu kode aktivasi adalah 4 jam.

Catatan

Pada halaman Asisten Cloud ECS, klik tab Instans Terkelola, lalu klik Daftarkan Instans Baru untuk Tampilan data penggunaan kode aktivasi.

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 berikut 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 DescribeRegions untuk mengkueri ID wilayah dan informasi lainnya.	cn-hangzhou
InstanceName	string	No	Awalan nama instans default. Awalan harus memiliki panjang 2 hingga 50 karakter dan harus diawali dengan huruf. Tidak dapat diawali dengan karakter khusus atau digit. Hanya dapat berisi periode (.), garis bawah (_), tanda hubung (-), dan titik dua (:). Tidak dapat diawali dengan `http://` atau `https://`. Instans yang didaftarkan dengan kode aktivasi yang dibuat oleh operasi ini menggunakan nama ini sebagai awalan untuk menghasilkan nama instans berurutan. Anda juga dapat menentukan nama instans baru saat mendaftarkan instans terkelola untuk mengganti nilai default ini. Saat mendaftarkan instans terkelola, jika nilai ditentukan untuk InstanceName, nama `<InstanceName>-001` akan dihasilkan, di mana jumlah digit pada `001` bergantung pada jumlah digit pada nilai `InstanceCount`. Jika tidak ada nilai yang ditentukan untuk InstanceName, hostname host digunakan sebagai nama instans.	test-InstanceName
Description	string	No	Deskripsi kode aktivasi. Deskripsi harus memiliki panjang 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 periode validitas berakhir, kode aktivasi tidak dapat digunakan untuk mendaftarkan instans baru. Unit: hours. Nilai valid: 1 hingga 4. Nilai default: 4.	4
IpAddressRange	string	No	Alamat IP host yang diizinkan menggunakan kode aktivasi. Nilai dapat berupa 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 pastikan token tersebut unik di antara permintaan yang berbeda. ClientToken hanya dapat berisi karakter ASCII dan 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	Tag.
	object	No	Tag.
Key	string	No	Kunci tag kode aktivasi instans terkelola. Nilai valid untuk N: 1 hingga 20. Kunci tag tidak boleh berupa string kosong. Jika Anda menggunakan satu tag untuk memfilter Sumber daya, jumlah Sumber daya dengan tag tersebut tidak boleh melebihi 1000. Jika Anda menggunakan beberapa tag untuk memfilter Sumber daya, jumlah Sumber daya dengan semua tag yang ditentukan terpasang tidak boleh melebihi 1000. Jika jumlah Sumber daya melebihi 1000, gunakan operasi ListTagResources untuk mengkueri Sumber daya. Kunci tag dapat memiliki panjang hingga 64 karakter dan tidak dapat diawali dengan `aliyun` atau `acs:`. Tidak dapat berisi `http://` atau `https://`.	TestKey
Value	string	No	Nilai tag kode aktivasi instans terkelola. Nilai valid untuk N: 1 hingga 20. Nilai tag dapat berupa string kosong. Nilai tag dapat memiliki panjang hingga 128 karakter dan tidak dapat berisi `http://` atau `https://`.	TestValue

Elemen respons

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

Contoh

Respons sukses

JSONformat

{
  "ActivationCode": "a-hz0ch3SwhOlE1234+Xo32lAZC****",
  "ActivationId": "4ECEEE12-56F1-4FBC-9AB1-890F1234****",
  "RequestId": "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 tertentu. Periksa apakah nilai parameter RegionId 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 penggunaan kode aktivasi untuk mendaftarkan instans terkelola melebihi batas pengatur waktu.
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 dalam 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 tersedia di wilayah ini.
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.