Gunakan API CreateInstance untuk membuat instans - Hologres - Alibaba Cloud - Hologres

Membuat instans Gudang Data Real-time di wilayah yang ditentukan.

Deskripsi operasi

Peringatan

This API operation incurs fees. Before you call this operation, make sure that you fully understand the billing methods and pricing of Hologres.

For more information about the billing of Hologres, see Billing overview.
When you create a Hologres instance, you must specify the region and zone for the instance. A region can contain multiple zones. The following list describes the zones that are available in each region:

   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	The region ID. For more information, see Endpoints.	cn-hangzhou
zoneId	string	Yes	The zone ID.	cn-hangzhou-h
vpcId	string	Yes	The ID of the virtual private cloud (VPC). The VPC must be in the same region as the instance.	vpc-t4netc3y5xxxx
vSwitchId	string	Yes	The ID of the vSwitch. The vSwitch must be in the same zone as the instance.	vsw-2vccsiymtxxxxxx
resourceGroupId	string	No	The resource group. If you leave this parameter empty, the default resource group for your account is used.	""
instanceName	string	Yes	The instance name. The name must be 2 to 64 characters in length. A letter is counted as one character.	my_holo
instanceType	string	Yes	The instance type. Valid values: Standard: General-purpose instance. Follower: Read-only secondary instance. Warehouse: Virtual warehouse instance. Shared: Shared instance. Serverless: Serverless instance. Valid values: Warehouse : Virtual warehouse instance. Follower : Read-only secondary instance. Standard : General-purpose instance. Serverless : Serverless instance. Shared : Shared instance.	Standard
cpu	integer	No	The instance type. Valid values: 32 vCPUs and 128 GB of memory (2 compute nodes) 64 vCPUs and 256 GB of memory (4 compute nodes) 96 vCPUs and 384 GB of memory (6 compute nodes) 128 vCPUs and 512 GB of memory (8 compute nodes) and so on. Catatan Specify the number of vCPUs. To purchase an instance with more than 1,024 vCPUs, submit a ticket. You do not need to specify the instance type for a shared instance.	64
storageSize	integer	No	The standard storage capacity of the instance. Unit: GB. Catatan This parameter is ignored for pay-as-you-go (PostPaid) instances.	500
coldStorageSize	integer	No	The cold storage capacity of the instance. Unit: GB. Catatan This parameter is ignored for pay-as-you-go (PostPaid) instances.	500
gatewayCount	integer	No	The number of gateways. Valid values: [2, 50]. Catatan You must specify this parameter only for virtual warehouse instances.	4
chargeType	string	Yes	The billing method. Valid values: PrePaid: Subscription. PostPaid: Pay-as-you-go. Catatan This parameter is ignored for shared instances. Shared instances use defined specifications and the default billing method is pay-as-you-go.. Valid values: PostPaid : Pay-as-you-go PrePaid : Subscription	PostPaid
autoPay	boolean	No	Specifies whether to enable automatic payment. Valid values: true (default): Automatic payment is enabled. false: An order is generated, but no payment is made. Catatan If your account balance is insufficient, set the `autoPay` parameter to `false`. When an unpaid order is generated, log on to the Expenses and Costs console to pay for the order.	true
pricingCycle	string	No	The billing cycle. Valid values: Month: The instance is billed on a monthly basis. Hour: The instance is billed on an hourly basis. Catatan Subscription instances support only `Month`. Pay-as-you-go instances support only `Hour`. For shared instances, the value is automatically set to `Hour`. Valid values: Month : The instance is billed on a monthly basis. Hour : The instance is billed on an hourly basis.	Month
duration	integer	No	The subscription duration, such as two months. Catatan Specify this parameter only for subscription instances.	2
autoRenew	boolean	No	Specifies whether to enable auto-renewal. Valid values: true: Auto-renewal is enabled. false (default): Auto-renewal is disabled.	false
leaderInstanceId	string	No	The ID of the primary instance. This parameter is required for secondary instances. Catatan The primary and secondary instances must meet the following conditions: The primary instance is in the Running state. The primary and secondary instances are in the same region and zone. They are in the same zone. The primary instance has less than 10 secondary instances. The primary and secondary instances belong to the same Alibaba Cloud account.	hgpostcn-cn-lbj3aworq112
initialDatabases	string	No	The initial database.	chatbot
enableServerlessComputing	boolean	No	Specifies whether to enable Serverless Computing. Valid values: true : Enable Serverless Computing. false : Disable Serverless Computing.	true
storageType	string	No	The storage class. Valid values: local : Locally redundant storage. redundant : Zone-redundant storage.	redundant

Elemen respons

Element	Type	Description	Example
	object	The response details.
RequestId	string	The request ID.	9CC37B9F-F4B4-5FF1-939B-AEE78DC70130
Data	object	The returned results.
InstanceId	string	The instance ID.	hgpostcn-cn-xxxxxx
OrderId	string	The order ID.	217523224780172
Code	string	The error code.	InvalidVpcOrVSwitch.NotAvailable
Message	string	The details of the error.	InvalidVpcOrVSwitch.NotAvailable
Success	string	Indicates whether the instance was created. true: The instance was created. false: The instance failed to be created.	true
HttpStatusCode	string	The HTTP status code.	200
ErrorMessage	string	The error message.	null
ErrorCode	string	The error code.	null

Catatan

Jika terjadi kesalahan verifikasi parameter, tanggapan Data tetap dikembalikan. Dalam hal ini, nilai parameter Success adalah false, dan parameter Code serta Message disertakan. Kecuali jika terjadi pengecualian, Anda dapat menentukan apakah panggilan berhasil berdasarkan nilai Data.Success.
Saat Anda menggunakan software development kit (SDK) terbaru untuk memanggil Operasi API ini, kesalahan timeout mungkin dikembalikan. Hal ini terjadi karena periode timeout default klien di SDK berbeda dengan server. Kesalahan ini dapat dikembalikan meskipun operasi berhasil dipanggil. Untuk mencegah masalah ini, Anda dapat menetapkan 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.