Gunakan API CreateInstance untuk membuat instans - Hologres

Membuat sebuah instans.

Deskripsi operasi

Peringatan

Operasi API ini dikenai biaya. Sebelum memanggil operasi ini, pastikan Anda telah memahami sepenuhnya metode penagihan dan harga Hologres.

Untuk informasi selengkapnya mengenai penagihan Hologres, lihat Billing overview.
Saat membuat instans Hologres, Anda harus menentukan wilayah dan zona untuk instans tersebut. Satu wilayah dapat mencakup beberapa zona. Daftar berikut menjelaskan zona yang tersedia di setiap wilayah:

   cn-hangzhou (Hangzhou): cn-hangzhou-h, cn-hangzhou-j, cn-hangzhou-k
   cn-hangzhou (Hangzhou): cn-hangzhou-h, cn-hangzhou-j, cn-hangzhou-k
   cn-shanghai (Shanghai): cn-shanghai-e, cn-shanghai-f, cn-shanghai-l
   cn-beijing (Beijing): cn-beijing-i, cn-beijing-g, cn-beijing-l
   cn-zhangjiakou (Zhangjiakou): cn-zhangjiakou-b
   cn-shenzhen (Shenzhen): cn-shenzhen-d, cn-shenzhen-f, cn-shenzhen-e
   cn-wulanchabu (Ulanqab): cn-wulanchabu-a
   cn-hongkong (Hong Kong): cn-hongkong-b, cn-hongkong-d
   cn-shanghai-finance-1 (Shanghai Finance Cloud): cn-shanghai-finance-1z, cn-shanghai-finance-1f
   cn-hangzhou-finance (Hangzhou Finance Cloud): cn-hangzhou-finance-k
   cn-shenzhen-finance-1 (Shenzhen Finance Cloud): cn-shenzhen-finance-1d
   ap-northeast-1 (Tokyo): ap-northeast-1a
   ap-southeast-1 (Singapore): ap-southeast-1c, ap-southeast-1a
   ap-southeast-3 (Kuala Lumpur): ap-southeast-3b
   ap-southeast-5 (Jakarta): ap-southeast-5b
   eu-central-1 (Frankfurt): eu-central-1a
   us-east-1 (Virginia): us-east-1a
   us-west-1 (Silicon Valley): us-west-1b

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

hologram:CreateInstance

create

*All Resource

*

None

Sintaks permintaan

POST /api/v1/instances/create HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
body	object	No	Badan permintaan.
regionId	string	Yes	ID wilayah. Untuk informasi selengkapnya, lihat Endpoints.	cn-hangzhou
zoneId	string	Yes	ID zona.	cn-hangzhou-h
vpcId	string	Yes	ID virtual private cloud (VPC). VPC harus berada di wilayah yang sama dengan instans.	vpc-t4netc3y5xxxx
vSwitchId	string	Yes	ID vSwitch. vSwitch harus berada di zona yang sama dengan instans.	vsw-2vccsiymtxxxxxx
resourceGroupId	string	No	Kelompok sumber daya. Jika Anda tidak mengisi parameter ini, kelompok sumber daya default akun Anda akan digunakan.	""
instanceName	string	Yes	Nama instans. Nama harus terdiri dari 2 hingga 64 karakter. Satu huruf dihitung sebagai satu karakter.	my_holo
instanceType	string	Yes	Tipe instans. Valid values: Warehouse : Instans gudang virtual. Follower : Instans secondary read-only. Standard : Instans tujuan umum. Serverless : Instans serverless. Shared : Instans bersama.	Standard
cpu	integer	No	Tipe instans. Nilai yang valid: 32 vCPU dan memori 128 GB (2 node komputasi) 64 vCPU dan memori 256 GB (4 node komputasi) 96 vCPU dan memori 384 GB (6 node komputasi) 128 vCPU dan memori 512 GB (8 node komputasi) dan seterusnya. Catatan Tentukan jumlah vCPU. Untuk membeli instans dengan lebih dari 1.024 vCPU, kirimkan tiket. Anda tidak perlu menentukan tipe instans untuk instans bersama.	64
storageSize	integer	No	Kapasitas penyimpanan standar instans. Satuan: GB. Catatan Parameter ini diabaikan untuk instans pay-as-you-go (PostPaid).	500
coldStorageSize	integer	No	Kapasitas penyimpanan dingin instans. Satuan: GB. Catatan Parameter ini diabaikan untuk instans pay-as-you-go (PostPaid).	500
gatewayCount	integer	No	Jumlah gerbang. Nilai yang valid: [2, 50]. Catatan Anda hanya perlu menentukan parameter ini untuk instans gudang virtual.	4
chargeType	string	Yes	Catatan Parameter ini diabaikan untuk instans bersama. Instans bersama menggunakan spesifikasi yang ditentukan dan metode penagihan default-nya adalah pay-as-you-go. Valid values: PostPaid : Pay-as-you-go PrePaid : Subscription	PostPaid
autoPay	boolean	No	Menentukan apakah pembayaran otomatis diaktifkan. Nilai yang valid: true (default): Pembayaran otomatis diaktifkan. false: Pesanan dibuat, tetapi tidak dilakukan pembayaran. Catatan Jika saldo akun Anda tidak mencukupi, atur parameter `autoPay` ke `false`. Saat pesanan yang belum dibayar dibuat, login ke Konsol Biaya dan Pengeluaran untuk membayar pesanan tersebut.	true
pricingCycle	string	No	Catatan Instans subscription hanya mendukung `Month`. Instans pay-as-you-go hanya mendukung `Hour`. Untuk instans bersama, nilainya secara otomatis diatur ke `Hour`. Valid values: Month : Instans ditagih per bulan. Hour : Instans ditagih per jam.	Month
duration	integer	No	Durasi langganan, misalnya dua bulan. Catatan Tentukan parameter ini hanya untuk instans subscription.	2
autoRenew	boolean	No	Menentukan apakah perpanjangan otomatis diaktifkan. Nilai yang valid: true: Perpanjangan otomatis diaktifkan. false (default): Perpanjangan otomatis dinonaktifkan.	false
leaderInstanceId	string	No	ID instans utama. Parameter ini wajib diisi untuk instans secondary. Catatan Instans utama dan secondary harus memenuhi kondisi berikut: Instans utama berada dalam status Running. Instans utama dan secondary berada di wilayah dan zona yang sama. Instans utama memiliki kurang dari 10 instans secondary. Instans utama dan secondary dimiliki oleh Akun Alibaba Cloud yang sama.	hgpostcn-cn-lbj3aworq112
initialDatabases	string	No	Database awal.	chatbot
enableServerlessComputing	boolean	No	Menentukan apakah Serverless Computing diaktifkan. Valid values: true : Aktifkan Serverless Computing. false : Nonaktifkan Serverless Computing.	true
storageType	string	No	Kelas penyimpanan. Valid values: local : Penyimpanan redundansi lokal. redundant : Penyimpanan redundansi antar zona.	redundant

Elemen respons

Element	Type	Description	Example
	object	Detail respons.
RequestId	string	ID permintaan.	9CC37B9F-F4B4-5FF1-939B-AEE78DC70130
Data	object	Hasil yang dikembalikan.
InstanceId	string	ID instans.	hgpostcn-cn-xxxxxx
OrderId	string	ID pesanan.	217523224780172
Code	string	Kode kesalahan.	InvalidVpcOrVSwitch.NotAvailable
Message	string	Detail kesalahan.	InvalidVpcOrVSwitch.NotAvailable
Success	string	Menunjukkan apakah instans berhasil dibuat. true: Instans berhasil dibuat. false: Instans gagal dibuat.	true
HttpStatusCode	string	Kode status HTTP.	200
ErrorMessage	string	Pesan kesalahan.	null
ErrorCode	string	Kode kesalahan.	null

Catatan

Jika terjadi kesalahan verifikasi parameter, respons Data tetap dikembalikan. Dalam kasus ini, nilai parameter Success adalah false, dan parameter Code serta Message disertakan. Kecuali jika terjadi pengecualian, keberhasilan panggilan dapat ditentukan berdasarkan nilai Data.Success.
Saat menggunakan kit pengembangan perangkat lunak (SDK) terbaru untuk memanggil operasi API ini, mungkin terjadi kesalahan timeout. Hal ini terjadi karena periode timeout default klien dalam SDK berbeda dengan server. Kesalahan ini dapat muncul meskipun operasi berhasil dipanggil. Untuk mencegah masalah ini, atur parameter ReadTimeout ke 20000 sebelum melakukan panggilan.

Contoh

Respons sukses

JSONformat

{
  "RequestId": "9CC37B9F-F4B4-5FF1-939B-AEE78DC70130",
  "Data": {
    "InstanceId": "hgpostcn-cn-xxxxxx",
    "OrderId": "217523224780172",
    "Code": "InvalidVpcOrVSwitch.NotAvailable",
    "Message": "InvalidVpcOrVSwitch.NotAvailable\n",
    "Success": "true"
  },
  "HttpStatusCode": "200",
  "ErrorMessage": "null",
  "ErrorCode": "null"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.