All Products
Search

This Product

    App Streaming:CreateAppInstanceGroup

    Document Center

    App Streaming:CreateAppInstanceGroup

    Last Updated:Jul 05, 2026

    Buat kelompok pengiriman.

    Deskripsi operasi

    Sebelum memanggil operasi ini, pastikan Anda memahami metode penagihan dan harga untuk Wuying App Service.

    Delivery group adalah pengelompokan logis yang digunakan untuk mengirimkan aplikasi cloud kepada pengguna akhir. Delivery group mencakup resource aplikasi cloud, image yang berisi aplikasi tersebut, kebijakan manajemen resource, serta pengaturan penugasan pengguna. Untuk informasi selengkapnya, lihat Publish a delivery group.

    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
    AppCenterImageId

    string

    Yes

    ID image aplikasi. Anda dapat memperoleh ID tersebut dari halaman Custom Images atau System Images di bawah Operations di Wuying App Service console.

    img-8z4nztpaqvay4****
    ProductType

    string

    Yes

    Tipe produk.

    Valid values:

    • CloudApp :

      Wuying App Service

    CloudApp
    AppInstanceGroupName

    string

    No

    Nama app instance group.

    办公应用
    Users

    array

    No

    Username yang akan ditambahkan ke app instance group.

    string

    No

    Username yang akan ditambahkan ke app instance group. Formatnya adalah Users.N=<username>, dengan N adalah bilangan bulat lebih besar dari 0.

    Users.1=username1 Users.2=username2
    UserInfo

    object

    No

    Detail tentang pengguna yang akan ditambahkan ke app instance group. Parameter ini wajib jika Anda menentukan parameter Users.

    Type

    string

    No

    Tipe akun pengguna.

    Valid values:

    • Simple :

      convenience account

    Simple
    ChargeType

    string

    Yes

    Metode penagihan.

    Valid values:

    • PostPaid :

      pay-as-you-go

    • PrePaid :

      subscription

    PrePaid
    PromotionId

    string

    No

    ID promosi. Anda dapat memperoleh ID promosi dengan memanggil operasi GetResourcePrice.

    17440009****
    AutoPay

    boolean

    No

    Menentukan apakah pembayaran otomatis diaktifkan.

    Valid values:

    • true :

      Pembayaran otomatis diaktifkan.

    • false :

      Pembayaran otomatis dinonaktifkan. [Default]

    false
    AutoRenew

    boolean

    No

    Menentukan apakah perpanjangan otomatis diaktifkan.

    Valid values:

    • true :

      Perpanjangan otomatis diaktifkan.

    • false :

      Perpanjangan otomatis dinonaktifkan. [Default]

    false
    Period

    integer

    Yes

    Durasi langganan. Parameter ini wajib ketika ChargeType diatur ke PrePaid. Satuan durasi ditentukan oleh PeriodUnit.

    • Jika PeriodUnit diatur ke Week, nilai yang valid adalah:

      • 1

    • Jika PeriodUnit diatur ke Month, nilai yang valid adalah:

      • 1

      • 2

      • 3

      • 6

    • Jika PeriodUnit diatur ke Year, nilai yang valid adalah:

      • 1

      • 2

      • 3

    Catatan

    Jika ChargeType diatur ke PostPaid, atur parameter ini ke 1.

    1
    PeriodUnit

    string

    Yes

    Satuan durasi langganan. Parameter ini wajib ketika ChargeType diatur ke PrePaid.

    Catatan

    Parameter ini bersifat case-sensitive. Misalnya, Week adalah nilai yang valid, tetapi week tidak valid. Jika Anda menentukan kombinasi Period dan PeriodUnit yang tidak valid (misalnya, Period bernilai 2 dan PeriodUnit bernilai Week), panggilan API mungkin berhasil, tetapi pesanan akan gagal.

    Catatan

    Jika ChargeType diatur ke PostPaid, atur parameter ini ke Month.

    Valid values:

    • Month :

      Month

    • Year :

      Year

    • Week :

      Week

    Week
    SessionTimeout

    integer

    Yes

    Waktu idle dalam menit sebelum sesi timeout. Setelah pengguna terputus, proses aplikasi akan dihentikan setelah periode ini. Untuk menonaktifkan timeout, atur nilai ini ke -1. Nilai yang valid adalah -1 dan bilangan bulat dari 3 hingga 300. Nilai default adalah 15.

    15
    BizRegionId

    string

    Yes

    ID wilayah app instance group. Untuk informasi selengkapnya tentang wilayah yang didukung, lihat Usage notes.

    Valid values:

    • cn-shanghai :

      China (Shanghai)

    • cn-hangzhou :

      China (Hangzhou)

    cn-hangzhou
    ChargeResourceMode

    string

    Yes

    Unit resource yang akan ditagih.

    Valid values:

    • Node :

      Ditagih per node

    Node
    NodePool

    object

    No

    Konfigurasi kelompok node.

    NodeInstanceType

    string

    No

    Tipe instans resource yang akan dibeli. Anda dapat memanggil operasi ListNodeInstanceType untuk memperoleh nilai yang valid.

    Valid values:

    • appstreaming.vgpu.8c16g.4g :

      Wuying - Graphics: 8 vCPU, 16 GiB memory, 4 GiB GPU memory

    • appstreaming.general.8c16g :

      Wuying - General-purpose: 8 vCPU, 16 GiB memory

    • appstreaming.general.4c8g :

      Wuying - General-purpose: 4 vCPU, 8 GiB memory

    • appstreaming.vgpu.14c93g.12g :

      Wuying - Graphics: 14 vCPU, 93 GiB memory, 12 GiB GPU memory

    • appstreaming.vgpu.8c31g.16g :

      Wuying - Graphics: 8 vCPU, 31 GiB memory, 16 GiB GPU memory

    appstreaming.general.4c8g
    NodeAmount

    integer

    No

    Jumlah resource yang akan dibeli. Nilai yang valid: 1 hingga 100.

    Catatan

    • Parameter ini wajib untuk resource subscription.

    • Parameter ini wajib untuk resource pay-as-you-go jika mode penskalaan (StrategyType) diatur ke Fixed Number of Nodes (NODE_FIXED) atau Usage-based Auto Scaling (NODE_SCALING_BY_USAGE).

    1
    NodeCapacity

    integer

    No

    Jumlah maksimum sesi konkuren per resource. Melebihi batas ini dapat menurunkan pengalaman pengguna. Nilai yang valid bergantung pada spesifikasi resource. Anda dapat menanyakan nilai yang valid dengan memanggil operasi ListNodeInstanceType.

    2
    StrategyType

    string

    No

    Mode penskalaan.

    Catatan

    • NODE_FIXED (Fixed Number of Nodes): berlaku untuk resource subscription maupun pay-as-you-go.

    • NODE_SCALING_BY_USAGE (Usage-based Auto Scaling): berlaku untuk resource subscription maupun pay-as-you-go.

    • NODE_SCALING_BY_SCHEDULE (Scheduled Scaling): hanya berlaku untuk resource pay-as-you-go.

    Valid values:

    • NODE_FIXED :

      Fixed number of nodes (auto scaling tidak digunakan)

    • NODE_SCALING_BY_SCHEDULE :

      scheduled scaling

    • NODE_SCALING_BY_USAGE :

      auto scaling

    NODE_FIXED
    MaxScalingAmount

    integer

    No

    Jumlah maksimum resource yang akan dibuat saat skala keluar. Parameter ini wajib ketika StrategyType diatur ke NODE_SCALING_BY_USAGE (auto scaling).

    10
    MaxIdleAppInstanceAmount

    integer

    No

    Jumlah maksimum sesi idle. Jika Anda menentukan parameter ini, event auto scaling hanya dipicu ketika penggunaan sesi melebihi ScalingUsageThreshold dan jumlah sesi idle dalam app instance group kurang dari MaxIdleAppInstanceAmount. Jika tidak, resource baru tidak akan dibuat. Parameter ini memungkinkan Anda mengontrol perilaku auto scaling dan mengurangi biaya.

    3
    ScalingStep

    integer

    No

    Jumlah resource yang ditambahkan dalam setiap skala keluar. Nilai yang valid: 1 hingga 10. Parameter ini wajib ketika StrategyType diatur ke NODE_SCALING_BY_USAGE (auto scaling).

    2
    ScalingUsageThreshold

    string

    No

    Persentase penggunaan sesi yang memicu skala keluar. Event auto scaling dipicu ketika penggunaan sesi melebihi ambang batas ini. Penggunaan sesi dihitung menggunakan rumus berikut: Penggunaan Sesi = (Jumlah Sesi Aktif) / (Jumlah Total Resource × Jumlah Sesi Konkuren per Resource) × 100%. Parameter ini wajib jika StrategyType diatur ke NODE_SCALING_BY_USAGE (auto scaling). Nilai yang valid: 0 hingga 100. Nilai default: 85.

    85
    ScalingDownAfterIdleMinutes

    integer

    No

    Jumlah menit resource dapat menganggur sebelum dilepas. Resource dianggap menganggur jika tidak memiliki sesi aktif, dan akan dilepas setelah periode ini berakhir. Pengecualian berikut mungkin berlaku:

    • Skala-masuk dicegah jika tindakan tersebut akan langsung memicu skala keluar, sehingga menghindari loop penskalaan.

    • Jika skala keluar dipicu oleh peningkatan jumlah sesi selama periode ini, penghitungan mundur skala-masuk awal dibatalkan dan diatur ulang.

    5
    StrategyEnableDate

    string

    No

    Tanggal penerapan kebijakan. Tanggal harus dalam format yyyy-MM-dd dan harus sama dengan atau setelah tanggal saat ini. Parameter ini wajib jika StrategyType diatur ke NODE_SCALING_BY_SCHEDULE (scheduled scaling).

    2022-08-01
    StrategyDisableDate

    string

    No

    Tanggal kedaluwarsa kebijakan. Tanggal harus dalam format yyyy-MM-dd. Interval antara tanggal efektif dan tanggal kedaluwarsa harus antara 7 hingga 365 hari, inklusif. Parameter ini wajib jika StrategyType diatur ke NODE_SCALING_BY_SCHEDULE (scheduled scaling).

    2022-09-08
    WarmUp

    boolean

    No

    Menentukan apakah warming resource diaktifkan. Parameter ini wajib jika StrategyType diatur ke NODE_SCALING_BY_SCHEDULE (scheduled scaling).

    false
    RecurrenceSchedules

    array<object>

    No

    Jadwal berulang untuk kebijakan. Parameter ini wajib jika StrategyType diatur ke NODE_SCALING_BY_SCHEDULE (scheduled scaling).

    array<object>

    No

    Jadwal berulang.

    RecurrenceType

    string

    No

    Tipe pengulangan untuk tugas terjadwal. Anda harus menentukan RecurrenceType dan RecurrenceValues secara bersamaan.

    Valid values:

    • weekly :

      Tugas terjadwal diulang pada hari tertentu dalam seminggu.

    weekly
    RecurrenceValues

    array

    No

    Daftar nilai pengulangan.

    integer

    No

    Nilai untuk pengulangan.

    Valid values:

    • 1 :

      Senin

    • 2 :

      Selasa

    • 3 :

      Rabu

    • 4 :

      Kamis

    • 5 :

      Jumat

    • 6 :

      Sabtu

    • 7 :

      Minggu

    1
    TimerPeriods

    array<object>

    No

    Periode waktu dalam pengulangan. Periode waktu harus memenuhi persyaratan berikut:

    • Maksimal tiga periode waktu diperbolehkan.

    • Periode waktu tidak boleh tumpang tindih.

    • Interval antara dua periode waktu berturut-turut minimal 5 menit.

    • Durasi satu periode waktu minimal 15 menit.

    • Semua periode waktu harus berada dalam hari yang sama.

    object

    No

    Periode waktu dalam pengulangan.

    StartTime

    string

    No

    Waktu mulai. Waktu dalam format HH:mm.

    12:00
    EndTime

    string

    No

    Waktu selesai. Waktu dalam format HH:mm.

    15:00
    Amount

    integer

    No

    Jumlah resource.

    2
    Network

    object

    No

    Konfigurasi jaringan.

    Catatan

    Parameter ini hanya tersedia untuk pengguna yang masuk daftar allowlist. Untuk menggunakannya, kirimkan tiket.

    StrategyType

    string

    No

    Tipe kebijakan jaringan.

    Valid values:

    • Mixed :

      Mixed mode: satu VPC dengan dual NIC dan Alamat IP publik khusus

    • Shared :

      Shared mode: satu NIC yang mengakses internet melalui gerbang NAT

    Shared
    Routes

    array<object>

    No

    Konfigurasi entri rute. Parameter ini hanya dapat dikonfigurasi jika StrategyType diatur ke Mixed.

    object

    No

    Konfigurasi entri rute.

    Destination

    string

    No

    Blok CIDR tujuan.

    139.196.XX.XX/32
    Mode

    string

    No

    Mode egress jaringan.

    Valid values:

    • Shared :

      Akses melalui gerbang NAT

    Shared
    IpExpireMinutes

    integer

    No

    Durasi dalam menit setelah Alamat IP publik diputar pada login berikutnya. Nilai minimum adalah 60.

    60
    OfficeSiteId

    string

    No

    ID ruang kerja.

    cn-hongkong+dir-842567****
    VSwitchIds

    array

    No

    Daftar ID vSwitch.

    • Parameter ini hanya berlaku untuk ruang kerja kustom.

    string

    No

    ID vSwitch.

    vsw-m5ef1sjhf7bbvqvvy****
    DomainRules

    array<object>

    No

    Aturan kontrol akses berbasis nama domain.

    object

    No

    Aturan kontrol akses berbasis nama domain.

    Domain

    string

    No

    Nama domain.

    www.example.com
    Policy

    string

    No

    Aksi kebijakan.

    Valid values:

    • allow :

      mengizinkan akses

    • block :

      memblokir akses

    block
    StoragePolicy

    object

    No

    Kebijakan penyimpanan.

    StorageTypeList

    array

    No

    Daftar tipe penyimpanan.

    string

    No

    Tipe penyimpanan.

    Valid values:

    • OFF :

      Nonaktif

    • PDS :

      Drive and Photo Service

    PDS
    UserProfile

    object

    No

    Konfigurasi roaming data pengguna.

    UserProfileSwitch

    boolean

    No

    Menentukan apakah roaming data pengguna diaktifkan.

    Valid values:

    • false :

      Nonaktif

    • true :

      Aktif

    false
    RemoteStorageType

    string

    No

    Tipe penyimpanan remote yang digunakan untuk roaming data pengguna.

    Valid values:

    • NAS :

      Apsara File Storage NAS

    NAS
    RemoteStoragePath

    string

    No

    Jalur penyimpanan remote untuk roaming data pengguna.

    • Jika parameter ini dibiarkan kosong, ID app instance group digunakan secara default.

    • Untuk berbagi data roaming di beberapa app instance group dalam VPC yang sama, gunakan jalur yang sama untuk semua grup.

    ID20250101
    PreOpenAppId

    string

    No

    ID aplikasi yang akan dibuka sebelumnya.

    cag-b2ronxxd****
    VideoPolicy

    object

    No

    Kebijakan tampilan.

    FrameRate

    integer

    No

    Laju frame, dalam frame per detik (FPS).

    Valid values:

    • 30 :

      30 FPS

    • 60 :

      60 FPS

    60
    TerminalResolutionAdaptive

    boolean

    No

    Menentukan apakah resolusi adaptif diaktifkan.

    • true: Resolusi sesi menyesuaikan ukuran layar klien. Dalam hal ini, SessionResolutionWidth dan SessionResolutionHeight menentukan resolusi maksimum.

    • false: Resolusi sesi tetap. Dalam hal ini, resolusi ditetapkan ke nilai SessionResolutionWidth dan SessionResolutionHeight.

    Valid values:

    • true :

      true

    • false :

      false

    false
    SessionResolutionWidth

    integer

    No

    Lebar resolusi, dalam piksel.

    1920
    SessionResolutionHeight

    integer

    No

    Tinggi resolusi, dalam piksel.

    1080
    StreamingMode

    string

    No

    Mode streaming. Parameter ini, dikombinasikan dengan parameter Webrtc, menentukan protokol streaming.

    • Ketika Webrtc bernilai true dan StreamingMode bernilai video, protokolnya adalah WebRTC streaming.

    • Ketika Webrtc bernilai false dan StreamingMode bernilai video, protokolnya adalah video streaming.

    • Ketika Webrtc bernilai false dan StreamingMode bernilai mix, protokolnya adalah mixed streaming.

    Valid values:

    • video :

      aliran video

    • mix :

      aliran campuran

    video
    Webrtc

    boolean

    No

    Menentukan apakah WebRTC diaktifkan. Parameter ini, dikombinasikan dengan parameter StreamingMode, menentukan protokol streaming.

    • Ketika Webrtc bernilai true dan StreamingMode bernilai video, protokolnya adalah WebRTC streaming.

    • Ketika Webrtc bernilai false dan StreamingMode bernilai video, protokolnya adalah video streaming.

    • Ketika Webrtc bernilai false dan StreamingMode bernilai mix, protokolnya adalah mixed streaming.

    Valid values:

    • true :

      true

    • false :

      false

    true
    RuntimePolicy

    object

    No

    Kebijakan waktu proses.

    SessionType

    string

    No

    Tipe sesi.

    Valid values:

    • CONSOLE :

      Sesi konsol

    • NORMAL :

      Sesi RDP

    NORMAL
    DebugMode

    string

    No

    Menentukan apakah mode debug diaktifkan. Untuk memanggil operasi GetDebugAppInstance dan CreateImageFromAppInstanceGroup, Anda harus mengatur parameter ini ke ON.

    Valid values:

    • OFF :

      Nonaktif

    • ON :

      Aktif

    OFF
    SessionUserGenerationMode

    string

    No

    Mode generasi pengguna sesi.

    • Jika Anda mengatur nilai ini ke wyid, Anda harus mengatur SessionPreOpen ke false.

    Valid values:

    • wyid :

      wyid

    wyid
    SessionPreOpen

    string

    No

    Menentukan apakah pre-opening sesi diaktifkan.

    • Jika Anda tidak menentukan parameter ini, fitur ini diaktifkan secara default.

    Valid values:

    • true :

      Aktif

    • false :

      Nonaktif

    false
    PerSessionPerApp

    boolean

    No

    Menentukan apakah sesi baru dibuat untuk setiap aplikasi.

    • Jika Anda mengaktifkan fitur ini, membuka beberapa aplikasi dalam app instance group akan membuat sesi terpisah untuk setiap aplikasi, yang mengonsumsi lebih banyak resource sesi.

    Valid values:

    • true :

      Aktif

    • false :

      Nonaktif

    false
    PersistentAppInstanceScheduleMode

    string

    No

    Mode penjadwalan untuk sesi persisten.

    Valid values:

    • DYNAMIC :

      Penjadwalan dinamis - sesi persisten dapat dijadwalkan ke node berbeda.

    • FIX_NODE :

      Penjadwalan node tetap - sesi persisten hanya dapat dijadwalkan ke node tertentu.

    DYNAMIC
    SecurityPolicy

    object

    No

    Kebijakan keamanan.

    ResetAfterUnbind

    boolean

    No

    Menentukan apakah instans direset setelah unbinding.

    Valid values:

    • true :

      Reset

    • false :

      Jangan reset

    true
    SkipUserAuthCheck

    boolean

    No

    Menentukan apakah pemeriksaan otorisasi pengguna dilewati.

    Valid values:

    • true :

      Jangan periksa

    • false :

      Periksa [Default]

    false
    UserDefinePolicy

    object

    No

    Kebijakan kustom

    CustomConfig

    string

    No

    Konten kebijakan kustom. Konten harus mematuhi spesifikasi versi gambar. Untuk menggunakan parameter ini, kirimkan tiket agar ditambahkan ke daftar allowlist.

    [{"target":"agent","config":{"abc":"xxx"}}]
    AppPolicyId

    string

    No

    ID kebijakan.

    pg-0clfzcy0adpcf****
    ClusterId

    string

    No

    ID cluster

    cls-d39iq73l5c0a8****
    SubPayType

    string

    No

    Subtipe metode penagihan.

    Valid values:

    • postPaid :

      Pay-as-you-go

    • monthPackage :

      Package (hanya didukung oleh Cloud Browser)

    • prePaid :

      Subscription

    postPaid
    AppPackageType

    string

    No

    Tipe paket.

    browser.package.5.250.appstreaming.general.basic
    AuthMode

    string

    No

    Mode otorisasi delivery group.

    Valid values:

    • App :

      Otorisasi aplikasi

    • AppInstanceGroup :

      Otorisasi Delivery Group

    • Session :

      Otorisasi Sesi Persisten

    App
    UserGroupIds

    array

    No

    Daftar ID grup pengguna yang diotorisasi.

    string

    No

    ID grup pengguna yang diotorisasi.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Data respons.

    RequestId

    string

    ID permintaan.

    1CBAFFAB-B697-4049-A9B1-67E1FC5F****
    AppInstanceGroupModel

    object

    Detail app instance group.

    AppInstanceGroupId

    string

    ID app instance group.

    aig-9ciijz60n4xsv****
    OrderId

    string

    ID pesanan.

    12345****
    NodePoolId

    string

    ID kelompok node. Parameter ini hanya dikembalikan jika kelompok node juga dibuat.

    rg-ew7va2g1wl3vm****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
  "AppInstanceGroupModel": {
    "AppInstanceGroupId": "aig-9ciijz60n4xsv****",
    "OrderId": "12345****",
    "NodePoolId": "rg-ew7va2g1wl3vm****"
  }
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 StockError.NoStock The selected specification is out of stock. Please try again later or select other specifications.
    500 StockError.InvalidResourceRequest Your request cannot be processed currently due to an error. Please try again later.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.