Bangun Grup Instans Android dalam Skala melalui API-Cloud Phone-Alibaba Cloud - Cloud Phone

Anda dapat membuat kelompok instans cloud phone dengan metode penagihan pay-as-you-go atau subscription. Kelompok instans mengelola beberapa instans sekaligus, memungkinkan Anda mengelompokkan instans yang memiliki tujuan sama untuk manajemen terpusat.

Deskripsi operasi

Pembuatan kelompok instans akan dikenai biaya. Kami menyarankan Anda meninjau metode penagihan untuk kelompok instans cloud phone sebelum melanjutkan.

Jika metode penagihan untuk kelompok instans adalah subscription (PrePaid), parameter AutoPay secara default bernilai false. Setelah Anda memanggil API, Anda harus membuka Alibaba Cloud Expenses and Costs untuk membayar pesanan secara manual.
Untuk mengaktifkan pembayaran otomatis, atur AutoPay menjadi true.

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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter	Type	Required	Description	Example
BizRegionId	string	Yes	ID wilayah. Anda dapat memanggil operasi DescribeRegions untuk menanyakan wilayah tempat cloud phone tersedia. Valid values: cn-shenzhen : China (Shenzhen) cn-beijing : China (Beijing) cn-shanghai : China (Shanghai) cn-hongkong : China (Hong Kong) ap-southeast-1 : Singapore cn-hangzhou : China (Hangzhou)	cn-hangzhou
InstanceGroupName	string	No	Nama kelompok instans. Catatan Nama dapat terdiri dari maksimal 30 karakter. Nama harus diawali dengan huruf atau karakter Tionghoa, dan tidak boleh diawali dengan `http://` atau `https://`. Nama dapat berisi huruf, angka, karakter Tionghoa, serta karakter khusus berikut: titik dua (:), garis bawah (_), titik (.), dan tanda hubung (-).	云手机A
NumberOfInstances	integer	No	Jumlah instans yang akan dibuat dalam kelompok instans. Nilai valid: 1 hingga 100.	1
ChargeType	string	No	Metode penagihan. Valid values: PostPaid : pay-as-you-go PrePaid : subscription	PostPaid
Period	integer	No	Durasi langganan. Satuan ditentukan oleh parameter `PeriodUnit`.	1
PeriodUnit	string	No	Satuan durasi langganan. Parameter ini hanya berlaku jika `ChargeType` diatur ke `PrePaid`. Valid values: Month : Month Year : Year Hour :	Month
InstanceGroupSpec	string	Yes	Spesifikasi kelompok instans. Anda dapat memanggil operasi DescribeSpec untuk menanyakan spesifikasi cloud phone yang tersedia. Valid values: acp.perf.large : Performance-optimized (8 vCPUs, 16 GiB memory, dan 32 GiB storage) acp.basic.small : Lightweight (2 vCPUs, 4 GiB memory, dan 32 GiB storage) acp.std.large : Standard (4 vCPUs, 8 GiB memory, dan 32 GiB storage)	acp.basic.small
AutoPay	boolean	No	Menentukan apakah pembayaran otomatis diaktifkan. Default: false. Valid values: true : Pembayaran otomatis diaktifkan. Pastikan saldo akun Anda mencukupi. false : Diperlukan pembayaran manual.	false
AutoRenew	boolean	No	Menentukan apakah perpanjangan otomatis diaktifkan. Parameter ini hanya berlaku jika `ChargeType` diatur ke `PrePaid`. Default: false. Valid values: true : Kelompok instans diperpanjang secara otomatis saat masa berlaku habis. false : Anda harus memperpanjang kelompok instans secara manual saat masa berlaku habis.	false
OfficeSiteId	string	No	ID jaringan. Untuk instans dalam shared network, parameter ini opsional. Jika Anda tidak menentukan ID, shared network akan dibuat secara otomatis bersama kelompok instans. Untuk menggunakan shared network yang sudah ada, tentukan ID-nya. Untuk instans dalam VPC, parameter ini wajib diisi. Tentukan ID VPC yang sudah ada. Jika Anda belum memiliki VPC, buat terlebih dahulu.	cn-hangzhou+dir-745976****
VSwitchId	string	No	ID vSwitch. Anda dapat memanggil operasi DescribeVSwitches untuk menanyakan daftar vSwitch yang tersedia. Untuk instans dalam shared network: Jangan tentukan parameter ini. Untuk instans dalam VPC: Parameter ini wajib diisi. Instans akan dibuat di vSwitch yang ditentukan.	vsw-uf61uvzhz8ejaw776****
PolicyGroupId	string	No	ID kelompok kebijakan. Anda dapat memanggil operasi ListPolicyGroups untuk menanyakan daftar kelompok kebijakan yang tersedia.	pg-b7bxrrwxkijjh****
ImageId	string	Yes	ID image. Anda dapat memanggil operasi DescribeImageList untuk menanyakan daftar image cloud phone yang tersedia.	imgc-06zyt9m93zwax****
Amount	integer	No	Jumlah kelompok instans yang akan dibuat. Nilai valid: 1 hingga 100. Default: 1.	8
GpuAcceleration	boolean	No	Menentukan apakah akselerasi GPU diaktifkan. Valid values: true : Diaktifkan false : Dimatikan (default)	false
KeyPairId	string	No	ID pasangan kunci. Jika Anda menentukan ID pasangan kunci yang valid saat membuat kelompok instans, pasangan kunci tersebut akan disambungkan ke semua instans yang berhasil dibuat. Anda tidak perlu melakukan panggilan API terpisah untuk menyambungkan pasangan kunci tersebut. Catatan Anda tidak dapat menyambungkan pasangan kunci saat melakukan scale out pada kelompok instans.	kp-7o9xywwfutc1l****
ClientToken	string	No	Token yang dihasilkan client untuk memastikan idempotensi permintaan. Token dapat terdiri dari maksimal 100 karakter.	asadbuvwiabdbvchj****
EnableIpv6	boolean	No	Catatan Parameter ini tidak tersedia untuk umum.	null
Ipv6Bandwidth	integer	No	Catatan Parameter ini tidak tersedia untuk umum.	null
Tag	array<object>	No	Tag yang akan ditambahkan ke kelompok instans.
	object	No	Tag yang akan ditambahkan ke kelompok instans.
Value	string	No	Nilai tag.	value
Key	string	No	Kunci tag.	key
NetworkInfo	object	No
BandwidthPackageName	string	No
CidrBlock	string	No
LimitedBandwidth	integer	No
InternetChargeType	string	No
IpRatio	integer	No
Isp	string	No
PayType	string	No
Period	integer	No
PeriodUnit	string	No
AutoPay	boolean	No
AutoRenew	boolean	No
VisibleType	string	No
PromotionId	string	No
PaidCallbackUrl	string	No
BandwidthPackageType	string	No
BandwidthPackageId	string	No
NetworkType	string	No
PromotionId	string	No
StreamMode	integer	No
PaidCallBackUrl	string	No		wya.wuying.aliyun.com/instanceGroup

Elemen respons

Element	Type	Description	Example
	object	Data yang dikembalikan.
RequestId	string	ID permintaan.	1A923337-44D9-5CAD-9A53-95084BD4****
InstanceGroupInfos	array<object>	Daftar kelompok instans.
	object
InstanceGroupId	string	ID kelompok instans.	ag-cuv4scs4obxch****
InstanceIds	array	ID instans.
	string	ID instans.	acp-g40b9at5nhjo9****
OrderId	string	ID pesanan.	22365781890****
InstanceGroupIds	array	ID kelompok instans.
	string	ID kelompok instans.	ag-cuv4scs4obxch****
NetworkPackageOrderModel	object
BandwidthPackageOrderId	string
BandwidthPackageId	string

Contoh

Respons sukses

JSONformat

{
  "RequestId": "1A923337-44D9-5CAD-9A53-95084BD4****",
  "InstanceGroupInfos": [
    {
      "InstanceGroupId": "ag-cuv4scs4obxch****",
      "InstanceIds": [
        "acp-g40b9at5nhjo9****"
      ]
    }
  ],
  "OrderId": "22365781890****",
  "InstanceGroupIds": [
    "ag-cuv4scs4obxch****"
  ],
  "NetworkPackageOrderModel": {
    "BandwidthPackageOrderId": "",
    "BandwidthPackageId": ""
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.