全部产品
Search

搜索本产品

    Cloud Phone：CreateAndroidInstanceGroup

    文档中心

    Cloud Phone：CreateAndroidInstanceGroup

    更新时间：Dec 21, 2025

    Membuat grup instans Cloud Phone dengan metode penagihan pay-as-you-go atau subscription. Grup instans dapat mengelola beberapa instans. Anda dapat menambahkan instans yang memiliki fitur serupa ke dalam grup yang sama untuk menyederhanakan manajemen.

    Deskripsi operasi

    Perhatikan bahwa pembuatan grup instans akan dikenai biaya. Pastikan Anda memahami aturan penagihan untuk grup instans Cloud Phone sebelum melanjutkan.

    • Jika metode penagihan untuk grup instans adalah subscription (PrePaid), parameter AutoPay secara default diatur ke false. Setelah memanggil API, buka Alibaba Cloud Expenses and Costs untuk membayar pesanan secara manual.

    • Untuk mengaktifkan pembayaran otomatis, atur AutoPay ke 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. Panggil DescribeRegions untuk mengkueri daftar wilayah tempat Anda dapat membeli Cloud Phone.

    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 grup instans.

    Catatan

    Nama tidak boleh lebih dari 30 karakter. Nama harus dimulai dengan huruf, dan tidak boleh diawali dengan http:// atau https://. Nama hanya boleh berisi huruf, angka, titik dua (:), garis bawah (_), titik (.), dan tanda hubung (-).

    云手机A
    NumberOfInstances

    integer

    No

    Jumlah instans dalam grup instans. Nilai maksimum adalah 100.

    1
    ChargeType

    string

    No

    Metode penagihan.

    Valid values:

    • PostPaid :

      pay-as-you-go

    • PrePaid :

      subscription

    PostPaid
    Period

    integer

    No

    Durasi langganan resource. Satuan ditentukan oleh parameter `PeriodUnit`.

    1
    PeriodUnit

    string

    No

    Satuan durasi langganan.

    Valid values:

    • Month :

      Month

    • Year :

      Year

    • Hour :

      Hour. Satuan ini hanya dapat digunakan untuk metode penagihan pay-as-you-go.

    Month
    InstanceGroupSpec

    string

    Yes

    Spesifikasi grup instans. Panggil DescribeSpec untuk mengkueri spesifikasi yang tersedia untuk pembelian.

    Valid values:

    • acp.perf.large :

      compute-optimized (8 vCPU, 16 GiB memory, 32 GiB storage)

    • acp.basic.small :

      lightweight (2 vCPU, 4 GiB memory, 32 GiB storage)

    • acp.std.large :

      standard (4 vCPU, 8 GiB memory, 32 GiB storage)

    acp.basic.small
    AutoPay

    boolean

    No

    Menentukan apakah pembayaran otomatis diaktifkan. Nilai default adalah false.

    Valid values:

    • true :

      Mengaktifkan pembayaran otomatis. Pastikan saldo akun Anda mencukupi.

    • false :

      Mengaktifkan pembayaran manual.

    false
    AutoRenew

    boolean

    No

    Menentukan apakah perpanjangan otomatis diaktifkan. Nilai default adalah false.

    Valid values:

    • true :

      Resource subscription diperpanjang secara otomatis setelah masa berlakunya habis.

    • false :

      Resource subscription harus diperpanjang secara manual setelah masa berlakunya habis.

    false
    OfficeSiteId

    string

    No

    ID jaringan.

    • Untuk membuat instans di jaringan bersama (shared network): Parameter ini opsional. Masukkan ID jaringan bertipe Shared Network dari halaman Cloud Phone console > Network. Jika tidak ada shared network di konsol, Anda dapat mengosongkan parameter ini. Shared network akan dibuat secara otomatis saat grup instans dibuat.

    • Untuk membuat instans di VPC: Parameter ini wajib diisi. Masukkan ID jaringan bertipe VPC dari halaman Cloud Phone console > Network. Jika belum ada VPC di konsol, buat terlebih dahulu.

    cn-hangzhou+dir-745976****
    VSwitchId

    string

    No

    ID vSwitch. Panggil DescribeVSwitches untuk mengkueri daftar vSwitch.

    • Untuk instans di shared network: Kosongkan parameter ini.

    • Untuk instans di VPC: Parameter ini wajib diisi. Instans akan dibuat di vSwitch yang ditentukan.

    vsw-uf61uvzhz8ejaw776****
    PolicyGroupId

    string

    No

    ID kebijakan. Panggil ListPolicyGroups untuk mengkueri daftar kebijakan.

    pg-b7bxrrwxkijjh****
    ImageId

    string

    Yes

    ID citra. Panggil DescribeImageList untuk mengkueri daftar citra untuk Cloud Phone.

    imgc-06zyt9m93zwax****
    Amount

    integer

    No

    Jumlah grup instans. Nilai default adalah 1, dan nilai maksimum adalah 100.

    8
    GpuAcceleration

    boolean

    No

    Menentukan apakah akselerasi GPU diaktifkan.

    Valid values:

    • true :

      Diaktifkan

    • false :

      Nonaktif [Default]

    false
    KeyPairId

    string

    No

    ID pasangan kunci. Jika Anda menentukan ID pasangan kunci yang valid saat membuat grup instans, pasangan kunci tersebut akan disambungkan ke semua instans yang berhasil dibuat. Anda tidak perlu memanggil operasi API lain untuk menyambungkan pasangan kunci tersebut.

    Catatan

    Menyambungkan pasangan kunci selama operasi scale-out tidak didukung.

    kp-7o9xywwfutc1l****
    ClientToken

    string

    No

    Token client untuk memastikan idempotensi permintaan. Ini mencegah Anda mengirimkan permintaan duplikat. Token dapat memiliki panjang hingga 100 karakter.

    asadbuvwiabdbvchj****
    EnableIpv6

    boolean

    No

    Catatan

    Parameter ini belum tersedia untuk penggunaan publik.

    null
    Ipv6Bandwidth

    integer

    No

    Catatan

    Parameter ini belum tersedia untuk penggunaan publik.

    null
    Tag

    array<object>

    No

    Tag resource.

    object

    No

    Tag resource.

    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

    BandwidthPackageType

    string

    No

    BandwidthPackageId

    string

    No

    NetworkType

    string

    No

    PromotionId

    string

    No

    StreamMode

    integer

    No

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter respons.

    RequestId

    string

    ID permintaan.

    1A923337-44D9-5CAD-9A53-95084BD4****
    InstanceGroupInfos

    array<object>

    Informasi tentang grup instans.

    object

    InstanceGroupId

    string

    ID grup instans.

    ag-cuv4scs4obxch****
    InstanceIds

    array

    Daftar ID instans.

    string

    ID instans.

    acp-g40b9at5nhjo9****
    OrderId

    string

    ID pesanan.

    22365781890****
    InstanceGroupIds

    array

    Daftar ID grup instans.

    string

    ID grup 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.