すべてのプロダクト
Search

このプロダクト

    App Streaming:CreateAppInstanceGroup

    ドキュメントセンター

    App Streaming:CreateAppInstanceGroup

    最終更新日:Sep 15, 2026

    配信グループを作成します。

    操作説明

    この操作を呼び出す前に、WUYING CloudApp の課金と料金を十分に理解していることをご確認ください。

    配信グループは、エンドユーザーにクラウドアプリケーションを配信するための論理グループです。これには、基盤となるクラウドアプリケーションリソース、クラウドアプリケーションを含むイメージ、リソース管理ポリシー、およびユーザー割り当て設定が含まれます。詳細については、「配信グループの公開」を参照してください。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    appstreaming:CreateAppInstanceGroup

    create

    *すべてのリソース。

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    AppCenterImageId

    string

    必須

    アプリケーションイメージの ID。この ID は、WUYING CloudApp コンソール の [O&M] > [カスタムイメージ] または [システムイメージ] ページから取得できます。

    img-8z4nztpaqvay4****
    ProductType

    string

    必須

    プロダクトタイプ。

    列挙値:

    • CloudApp :

      WUYING CloudApp。

    CloudApp
    AppInstanceGroupName

    string

    任意

    配信グループの名前。

    OfficeApp
    Users

    array

    任意

    配信グループの割り当てユーザーとして追加するユーザー名のリスト。

    string

    任意

    配信グループの割り当てユーザーとして追加するユーザー名。フォーマット: Users.N=<username>。N は正の整数です。

    Users.1=ユーザー名1 Users.2=ユーザー名2
    UserInfo

    object

    任意

    配信グループの割り当てユーザーとして追加するユーザーの情報。Users パラメーターが指定されている場合、このパラメーターは必須です。

    Type

    string

    任意

    ユーザーアカウントのタイプ。

    列挙値:

    • Simple :

      簡易アカウント。

    Simple
    ChargeType

    string

    必須

    課金方法。

    列挙値:

    • PostPaid :

      従量課金。

    • PrePaid :

      サブスクリプション。

    PrePaid
    PromotionId

    string

    任意

    プロモーション ID。この ID は、 GetResourcePrice 操作の呼び出しにより取得できます。

    17440009****
    AutoPay

    boolean

    任意

    自動支払いを有効にするかどうかを指定します。

    列挙値:

    • true :

      自動支払いが有効です。

    • false :

      手動支払いが使用されます。[デフォルト値]

    false
    AutoRenew

    boolean

    任意

    自動更新を有効にするかどうかを指定します。

    列挙値:

    • true :

      自動更新が有効です。

    • false :

      手動更新が使用されます。[デフォルト値]

    false
    Period

    integer

    必須

    ChargeType が PrePaid にセットされている場合のリソースを購入する持続時間。この場合、このパラメーターは必須です。単位は PeriodUnit で指定します。

    • PeriodUnit が Week にセットされている場合の、このパラメーターの有効な値:

      • 1

    • PeriodUnit が Month にセットされている場合の、このパラメーターの有効な値:

      • 1

      • 2

      • 3

      • 6

    • PeriodUnit が Year にセットされている場合の、このパラメーターの有効な値:

      • 1

      • 2

      • 3

    説明

    ChargeType が PostPaid にセットされている場合は、このパラメーターを固定値 1 にセットします。

    1
    PeriodUnit

    string

    必須

    ChargeType が PrePaid にセットされている場合のサブスクリプション期間の単位。

    説明

    このパラメーターでは大文字と小文字が区別されます。たとえば、Week は有効ですが、week は無効です。 また、2 Week のようにリクエストパラメーターが有効な組み合わせと一致しない場合、API 呼び出しは成功しますが、注文の位相でエラーが発生します。

    説明

    ChargeType が PostPaid にセットされている場合は、このパラメーターを固定値 Month にセットします。

    列挙値:

    • Month :

      月。

    • Year :

      年。

    • Week :

      週。

    Week
    SessionTimeout

    integer

    必須

    アプリケーションの回収時間 (分単位)。エンドユーザーがクラウドアプリケーションから切断されてから一定時間経過すると、クラウドアプリケーションのプロセスが終了します。この期間がアプリケーションの回収時間です。アプリケーションを回収しない場合は、このパラメーターを -1 に設定します。有効な値: -1、および 3 ～ 300 (整数)。デフォルト値: 15。

    15
    BizRegionId

    string

    必須

    配信グループのリージョン ID。サポートされているリージョンのフォーマットと詳細については、「使用制限」を参照してください。

    列挙値:

    • cn-shanghai :

      中国 (上海)

    • cn-hangzhou :

      中国 (杭州)

    cn-hangzhou
    ChargeResourceMode

    string

    必須

    販売モード。

    列挙値:

    • Node :

      リソース単位で販売。

    Node
    NodePool

    object

    任意

    ノードプールオブジェクト。

    NodeInstanceType

    string

    任意

    購入するリソースのインスタンスタイプ ID。この ID は、 ListNodeInstanceType 操作の呼び出しにより取得できます。

    列挙値:

    • appstreaming.vgpu.8c16g.4g :

      WUYING-Graphics_8 vCPU 16 GiB 4 GiB GPU メモリ。

    • appstreaming.general.8c16g :

      WUYING-General-purpose_8 vCPU 16 GiB。

    • appstreaming.general.4c8g :

      WUYING-General-purpose_4 vCPU 8 GiB。

    • appstreaming.vgpu.14c93g.12g :

      WUYING-Graphics_14 vCPU 93 GiB 12 GiB GPU メモリ。

    • appstreaming.vgpu.8c31g.16g :

      WUYING-Graphics_8 vCPU 31 GiB 16 GiB GPU メモリ。

    appstreaming.general.4c8g
    NodeAmount

    integer

    任意

    購入するリソース数。有効な値: 1～100。

    • サブスクリプションリソースの場合、このパラメーターは必須です。

    • 従量課金レートリソースの場合、スケーリングモード (StrategyType) が固定数量 (NODE_FIXED) または自動スケーリング (NODE_SCALING_BY_USAGE) に設定されている場合、このパラメーターは必須です。

    1
    NodeCapacity

    integer

    任意

    同時会話数。これは、1 つのリソースが同時にハンドルできる会話数です。同時会話数が多すぎると、アプリケーションの操作性が低下する可能性があります。有効な値はリソース仕様によって異なります。各リソース仕様の有効な値は、ListNodeInstanceType 操作の呼び出しにより取得できます。

    2
    StrategyType

    string

    任意

    スケーリングモード。

    説明

    • NODE_FIXED (固定数量): サブスクリプションリソースおよび従量課金リソースに適用されます。

    • NODE_SCALING_BY_USAGE (自動スケーリング): サブスクリプションリソースおよび従量課金リソースに適用されます。

    • NODE_SCALING_BY_SCHEDULE (スケジュールされたスケーリング): 従量課金リソースにのみ適用されます。

    列挙値:

    • NODE_FIXED :

      固定数量 (弾力的スケーリングなし)

    • NODE_SCALING_BY_SCHEDULE :

      スケジュールされたスケーリング。

    • NODE_SCALING_BY_USAGE :

      自動スケーリング。

    NODE_FIXED
    MaxScalingAmount

    integer

    任意

    スケールアウト時に作成できるリソースの最大数。StrategyType が NODE_SCALING_BY_USAGE (弾力的レートリソース) に設定されている場合、このパラメーターは必須です。

    10
    MaxIdleAppInstanceAmount

    integer

    任意

    アイドル会話の最大数。この値を指定すると、会話使用量が ScalingUsageThreshold を超え、かつ現在の配信グループのアイドル会話数が MaxIdleAppInstanceAmount 未満の場合にのみ、自動スケールアウトがトリガーされます。それ以外の場合、配信グループのアイドル会話は十分であると見なされ、自動スケールアウトは実行されません。このパラメーターにより、弾力的スケーリングの動作を柔軟に制御し、コストを削減できます。

    3
    ScalingStep

    integer

    任意

    スケールアウト操作ごとに作成されるリソース数。有効な値: 1～10。StrategyType が NODE_SCALING_BY_USAGE (弾力的レートリソース) に設定されている場合、このパラメーターは必須です。

    2
    ScalingUsageThreshold

    string

    任意

    会話使用量 (%) の上限しきい値。会話使用量がこのしきい値を超えると、自動スケールアウトがトリガーされます。会話使用量は次のように計算されます: 会話使用量 = 現在の会話数 ÷ (合計リソース数 × リソースあたりの同時会話数) × 100%。StrategyType が NODE_SCALING_BY_USAGE (弾力的レートリソース) に設定されている場合、このパラメーターは必須です。有効な値: 0～100。デフォルト値: 85。

    85
    ScalingDownAfterIdleMinutes

    integer

    任意

    会話が接続されていないリソースが保持される最大持続時間 (分)。リソースに会話が接続されていない場合、ここで指定された期間に基づいてカウントダウンが開始されます。カウントダウンが終了すると、リソースはリリースされます。有効な値: 5～120。デフォルト値: 5。以下の例外が適用されます。

    • スケールインによって再度自動スケールアウトがトリガーされる場合、スケールインとスケールアウトの操作の繰り返しを避けるため、スケールインは実行されません。

    • この期間中に会話数の増加により自動スケールアウトがトリガーされた場合、リソースは当初の予定に従ってリリースされず、カウントダウンが再開されます。

    5
    StrategyEnableDate

    string

    任意

    ポリシーが有効になる日付。フォーマット: yyyy-MM-dd。日付は現在の日付と同じかそれ以降である必要があります。StrategyType (スケーリングモードレート) が NODE_SCALING_BY_SCHEDULE (スケジュールされたスケーリング) に設定されている場合、このパラメーターは必須です。

    2022-08-01
    StrategyDisableDate

    string

    任意

    ポリシーが失効する日付。フォーマット: yyyy-MM-dd。失効日と有効になる日の間隔は、7 日以上 1 年以下である必要があります。StrategyType (スケーリングモードレート) が NODE_SCALING_BY_SCHEDULE (スケジュールされたスケーリング) に設定されている場合、このパラメーターは必須です。

    2022-09-08
    WarmUp

    boolean

    任意

    リソースプリフェッチポリシーを有効にするかどうかを指定します。StrategyType (スケーリングモードレート) が NODE_SCALING_BY_SCHEDULE (スケジュールされたスケーリング) に設定されている場合、このパラメーターは必須です。

    false
    RecurrenceSchedules

    array<object>

    任意

    ポリシー実行スケジュールのリスト。StrategyType (スケーリングモードレート) が NODE_SCALING_BY_SCHEDULE (スケジュールされたスケーリング) に設定されている場合、このパラメーターは必須です。

    array<object>

    任意

    ポリシー実行スケジュール。

    RecurrenceType

    string

    任意

    ポリシー実行スケジュールのタイプ。RecurrenceType と RecurrenceValues の両方を指定する必要があります。

    列挙値:

    • weekly :

      毎週 (スケジュールされたタスクは毎週指定された曜日に実行されます)

    weekly
    RecurrenceValues

    array

    任意

    ポリシー実行スケジュールの値のリスト。

    integer

    任意

    ポリシー実行スケジュールの値。

    列挙値:

    • 1 :

      月曜日。

    • 2 :

      火曜日。

    • 3 :

      水曜日。

    • 4 :

      木曜日。

    • 5 :

      金曜日。

    • 6 :

      土曜日。

    • 7 :

      日曜日。

    1
    TimerPeriods

    array<object>

    任意

    ポリシー実行スケジュールの時間のリスト。時間設定の要件は以下のとおりです。

    • 最大 3 つの時間を追加できます。

    • 時間は重複できません。

    • 時間の間隔は 5 分以上である必要があります。

    • 各時間は 15 分以上である必要があります。

    • すべての時間を合わせても日をまたいではいけません。

    object

    任意

    ポリシー実行スケジュールの時間帯。

    StartTime

    string

    任意

    開始時刻。フォーマット: HH:mm。

    12:00
    EndTime

    string

    任意

    終了時刻。フォーマット: HH:mm。

    15:00
    Amount

    integer

    任意

    リソース数。

    2
    Network

    object

    任意

    ネットワーク構成。

    説明

    このパラメーターを使用するには、チケットを起票してください。

    StrategyType

    string

    任意

    ネットワークポリシーのタイプ。

    列挙値:

    • Mixed :

      混在モード: 単一 VPC、独立したパブリック IP アドレスを持つデュアル ENI。

    • Shared :

      共有モード: 単一 ENI、NAT ゲートウェイ経由のパブリックネットワークアクセス。

    Shared
    Routes

    array<object>

    任意

    ルート構成。このパラメーターは、ネットワークポリシーレート (StrategyType) が混在モード (Mixed) に設定されている場合にのみ構成できます。

    object

    任意

    ルート構成。

    Destination

    string

    任意

    CIDR フォーマットのアクセス送信先。

    139.196.XX.XX/32
    Mode

    string

    任意

    ネットワークエグレスモード。

    列挙値:

    • Shared :

      NAT ゲートウェイ経由のアクセス。

    Shared
    IpExpireMinutes

    integer

    任意

    次回のログイン時にパブリック IP アドレスの更新がトリガーされるまでの持続時間 (分)。最小値: 60。単位: 分。

    60
    OfficeSiteId

    string

    任意

    オフィスネットワーク ID。

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

    array

    任意

    vSwitch ID のリスト。

    • カスタムオフィスネットワークに対してのみ有効です。

    string

    任意

    vSwitch ID。

    vsw-m5ef1sjhf7bbvqvvy****
    DomainRules

    array<object>

    任意

    ドメイン名ルール構成。

    object

    任意

    ドメイン名ルール。

    Domain

    string

    任意

    ドメイン名。

    www.example.com
    Policy

    string

    任意

    ポリシー値。

    列挙値:

    • allow :

      アクセスを許可。

    • block :

      アクセスをブロック。

    block
    StoragePolicy

    object

    任意

    ストレージポリシー。

    StorageTypeList

    array

    任意

    ストレージタイプのリスト。

    string

    任意

    ストレージタイプ。

    列挙値:

    • OFF :

      無効。

    • PDS :

      Drive and Photo Service。

    PDS
    UserProfile

    object

    任意

    ユーザーデータローミング構成。

    UserProfileSwitch

    boolean

    任意

    ユーザーデータローミングを有効にするかどうかを指定します。

    列挙値:

    • false :

      無効。

    • true :

      有効。

    false
    RemoteStorageType

    string

    任意

    ユーザーデータローミングに使用されるリモートストレージタイプ。

    列挙値:

    • NAS :

      NAS。

    NAS
    RemoteStoragePath

    string

    任意

    ユーザーデータローミング用のリモートストレージパス。

    • このパラメーターが指定されていない場合、デフォルト値は配信グループ ID です。

    • 同じ VPC 内の配信グループ間でユーザーデータローミングを有効にするには、関連するすべての配信グループに対してこのパラメーターを同じ値に設定します。

    ID20250101
    PreOpenAppId

    string

    任意

    事前起動アプリケーション ID。

    cag-b2ronxxd****
    VideoPolicy

    object

    任意

    表示ポリシー。

    FrameRate

    integer

    任意

    フレームレート (FPS)。

    列挙値:

    • 30 :

      30 FPS。

    • 60 :

      60 FPS。

    60
    TerminalResolutionAdaptive

    boolean

    任意

    適応型解像度を使用するかどうかを指定します。

    • true: 会話の解像度は端末の表示エリアの変化をフォローします。この場合、SessionResolutionWidth と SessionResolutionHeight は解像度の最大値を指定します。

    • false: 会話の解像度は端末の表示エリアの変化をフォローしません。この場合、解像度は SessionResolutionWidth と SessionResolutionHeight の値に固定されます。

    列挙値:

    • true :

      true。

    • false :

      false。

    false
    SessionResolutionWidth

    integer

    任意

    解像度の幅。単位: ピクセル。

    1920
    SessionResolutionHeight

    integer

    任意

    解像度の高さ。単位: ピクセル。

    1080
    StreamingMode

    string

    任意

    ストリーミングモード。このパラメーターは、Webrtc パラメーターと組み合わせてプロトコルの種類を指定するために使用されます。

    • Webrtc=true および StreamingMode=video: WebRTC ストリーミング。

    • Webrtc=false および StreamingMode=video: ビデオストリーミング。

    • Webrtc=false および StreamingMode=mix: ハイブリッドストリーミング。

    列挙値:

    • video :

      ビデオストリーミング。

    • mix :

      ハイブリッドストリーミング。

    video
    Webrtc

    boolean

    任意

    WebRTC を有効にするかどうかを指定します。このパラメーターは、StreamingMode パラメーターと組み合わせてプロトコルの種類を指定するために使用されます。

    • Webrtc=true および StreamingMode=video: WebRTC ストリーミング。

    • Webrtc=false および StreamingMode=video: ビデオストリーミング。

    • Webrtc=false および StreamingMode=mix: ハイブリッドストリーミング。

    列挙値:

    • true :

      true。

    • false :

      false。

    true
    RuntimePolicy

    object

    任意

    ランタイムポリシー。

    SessionType

    string

    任意

    会話タイプ。

    列挙値:

    • CONSOLE :

      コンソール会話。

    • NORMAL :

      RDP 会話。

    NORMAL
    DebugMode

    string

    任意

    デバッグモードを有効にするかどうかを指定します。GetDebugAppInstance および CreateImageFromAppInstanceGroup 操作を呼び出すには、このパラメーターを ON に設定します。

    列挙値:

    • OFF :

      無効。

    • ON :

      有効。

    OFF
    SessionUserGenerationMode

    string

    任意

    会話ユーザーの生成モード。

    • wyid: このモードでは、会話の事前オープンパラメーター SessionPreOpen を false に設定する必要があります。

    列挙値:

    • wyid :

      wyid。

    wyid
    SessionPreOpen

    string

    任意

    会話の事前オープンを有効にするかどうかを指定します。

    • このパラメーターが指定されていない場合、デフォルト値は true です。

    列挙値:

    • true :

      有効。

    • false :

      無効。

    false
    PerSessionPerApp

    boolean

    任意

    会話ごとに 1 つのアプリケーションのみを許可するかどうかを指定します。

    • 有効にすると、配信グループ内で複数のアプリケーションを開いた場合、各アプリケーションに個別の会話が割り当てられ、より多くの会話が消費されます。

    列挙値:

    • true :

      有効。

    • false :

      無効。

    false
    PersistentAppInstanceScheduleMode

    string

    任意

    永続会話スケジューリングモード。

    列挙値:

    • DYNAMIC :

      動的スケジューリング - 同じ永続会話を異なるノードにスケジュールできます。

    • FIX_NODE :

      固定ノードスケジューリング - 同じ永続会話は固定ノードにのみスケジュールできます。

    DYNAMIC
    SecurityPolicy

    object

    任意

    セキュリティポリシー。

    ResetAfterUnbind

    boolean

    任意

    バインド解除後にリセットするかどうかを指定します。

    列挙値:

    • true :

      リセット。

    • false :

      リセットしない。

    true
    SkipUserAuthCheck

    boolean

    任意

    ユーザー権限付与の検証をスキップするかどうかを指定します。

    列挙値:

    • true :

      検証をスキップ。

    • false :

      検証 [デフォルト]

    false
    UserDefinePolicy

    object

    任意

    ユーザー定義ポリシー。

    CustomConfig

    string

    任意

    カスタムポリシーの内容。内容はイメージバージョンの仕様に準拠している必要があります。このパラメーターを使用するには、チケットを提出してホワイトリストアクセスをリクエストしてください。

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

    string

    任意

    ポリシー ID。

    pg-0clfzcy0adpcf****
    ClusterId

    string

    任意

    クラスター ID。

    cls-d39iq73l5c0a8****
    SubPayType

    string

    任意

    課金方法のサブタイプ。

    列挙値:

    • postPaid :

      従量課金。

    • monthPackage :

      月額プラン [Cloud Browser のみサポート]

    • prePaid :

      サブスクリプション。

    postPaid
    AppPackageType

    string

    任意

    パッケージタイプ。

    browser.パッケージ.5.250.appstreaming.general.basic
    AuthMode

    string

    任意

    配信グループの権限付与モード。

    列挙値:

    • App :

      アプリケーションレベルの権限付与。

    • AppInstanceGroup :

      配信グループレベルの権限付与。

    • Session :

      永続会話レベルの権限付与。

    App
    UserGroupIds

    array

    任意

    許可されるユーザーグループの ID のリスト。

    string

    任意

    許可されるユーザーグループの ID。

    user-グループ-001

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスのスキーマ。

    RequestId

    string

    リクエストの ID。

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

    object

    配信グループ。

    AppInstanceGroupId

    string

    配信グループの ID。

    aig-9ciijz60n4xsv****
    OrderId

    string

    注文の ID。

    12345****
    NodePoolId

    string

    リソースグループの ID。リソースグループが同時に作成された場合、このパラメーターが返されます。

    rg-ew7va2g1wl3vm****

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    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.

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。