すべてのプロダクト
Search

このプロダクト

    App Streaming:CreateAppInstanceGroup

    ドキュメントセンター

    App Streaming:CreateAppInstanceGroup

    最終更新日:Jul 21, 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

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    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_8 vCPU 16 GiB。

    • appstreaming.general.4c8g :

      WUYING-General_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) または auto scaling (NODE_SCALING_BY_USAGE) にセットされている場合、従量課金リソースではこのパラメーターが必須です。

    1
    NodeCapacity

    integer

    任意

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

    2
    StrategyType

    string

    任意

    スケーリングモード。

    説明

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

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

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

    列挙値:

    • NODE_FIXED :

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

    • NODE_SCALING_BY_SCHEDULE :

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

    • NODE_SCALING_BY_USAGE :

      auto scaling。

    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、デュアル NIC + 独立したパブリック IP アドレス。

    • Shared :

      共有モード: 単一 NIC、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

    任意

    事前オープン AppId。

    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 :

      月額パッケージ [クラウドブラウザのみサポート]

    • prePaid :

      サブスクリプション。

    postPaid。
    AppPackageType

    string

    任意

    パッケージタイプ。

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

    string

    任意

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

    列挙値:

    • App :

      アプリケーション権限付与。

    • AppInstanceGroup :

      配信グループ権限付与。

    • Session :

      永続セッション権限付与。

    App。
    UserGroupIds

    array

    任意

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

    string

    任意

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

    レスポンスフィールド

    フィールド

    型

    説明

    例

    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.

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

    変更履歴

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