备案控制台
文档
产品文档
输入文档关键字查找
首页 无影云应用 开发参考 API参考 API参考（云应用管控） API目录 交付组 CreateAppInstanceGroup - 创建交付组

CreateAppInstanceGroup - 创建交付组

更新时间：
一键部署
提交缺陷
产品详情
相关技术圈
我的收藏

创建交付组。

接口说明

请确保在使用该接口前，已充分了解无影云应用的计费方式和价格。

交付组是向终端用户交付云应用的逻辑分组，包括底层依赖的云应用资源、包含云应用的镜像、资源管理策略以及用户分配设置等。详情参见发布交付组。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用背景高亮的方式表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
appstreaming:CreateAppInstanceGroupWrite
  • 全部资源
    acs:appstreaming:*:{#accountId}:*
    无
无

请求参数

名称类型必填描述示例值
AppCenterImageIdstring是

应用镜像 ID，可从无影云应用控制台的镜像管理页面获取。

img-8z4nztpaqvay4****
ProductTypestring是

产品类型。

枚举值：
  • CloudApp：无影云应用。
CloudApp
AppInstanceGroupNamestring是

交付组名称。

办公应用
Usersarray否

需添加到交付组分配用户的一组用户。

string否

需添加到交付组分配用户的用户名。格式为 Users.N=<用户名>。

Users.1=username1 Users.2=username2
UserInfoobject否

需添加到交付组分配用户的用户信息。如果填写了Users参数，则该字段为必需。

Typestring否

用户账号类型。

枚举值：
  • Simple：便捷账号。
Simple
ChargeTypestring是

付费方式。

枚举值：
  • PostPaid：按量付费。
  • PrePaid：包年包月。
PrePaid
PromotionIdstring否

优惠 ID。可通过 GetResourcePrice 接口获取。

17440009****
AutoPayboolean否

是否自动付费。

枚举值：
  • true：自动付费。
  • false：手动付费 [默认值]。
false
AutoRenewboolean否

是否自动续费。

枚举值：
  • true：自动续费。
  • false：手动续费 [默认值]。
false
Periodinteger是

资源购买时长的数量部分，与PeriodUnit一起表示完整的购买时长。

说明 PostPaid（后付费模式）下填写固定值 1
1
PeriodUnitstring是

资源购买时长的单位部分，与Period一起表示完整的购买时长。可使用的Period与PeriodUnit的搭配如下：

  • 1 Week（1 周）
  • 1 Month（1 个月）
  • 2 Month（2 个月）
  • 3 Month（3 个月）
  • 6 Month（6 个月）
  • 1 Year（1 年）
  • 2 Year（2 年）
  • 3 Year（3 年）
说明 该参数区分大小写。例如，Week是有效的，week是无效的。另外，如果请求参数不符合上述搭配，例如2 Week，虽然调用本接口会成功，但最终在下单阶段会出错。PostPaid（后付费模式）下填写固定值Month。
Week
SessionTimeoutinteger是

应用回收时间，单位为分钟。终端用户将云应用断开连接一段时间后，云上应用进程即退出，这段时间就是应用回收时间。如果永不回收，则填写-1。取值范围：-1 和 3~300。默认值为15。

15
BizRegionIdstring是

交付组所属的地域 ID。关于支持的地域详情，请参见使用限制。

枚举值：
  • cn-shanghai：华东2（上海）。
  • cn-hangzhou：华东1（杭州）。
cn-hangzhou
ChargeResourceModestring是

售卖模式。

枚举值：
  • Node：按资源售卖。
Node
NodePoolobject否

节点池对象。

NodeInstanceTypestring否

购买资源的规格类型 ID，可通过 ListNodeInstanceType 接口获取。

枚举值：
  • appstreaming.vgpu.8c16g.4g：无影-图形型_8核16G 4G显存。
  • appstreaming.general.8c16g：无影-通用型_8核16G。
  • appstreaming.general.4c8g：无影-通用型_4核8G。
  • appstreaming.vgpu.14c93g.12g：无影-图形型_14核93G 12G显存。
  • appstreaming.vgpu.8c31g.16g：无影-图形型_8核31G 16G显存。
appstreaming.general.4c8g
NodeAmountinteger否

购买资源的数量。取值范围：1~100。

说明
  • 若为包年包月资源，则该参数必填。
  • 若为按量付费资源，则当弹性模式（StrategyType）为固定数量（NODE_FIXED）或自动扩缩容（NODE_SCALING_BY_USAGE）时该参数必填。
    •
    		1
    NodeCapacityinteger否

    并发会话数，即单个资源可同时连接的会话数。如果同时连接的会话数过多，可能导致应用的使用体验下降。取值范围因资源规格不同而不同。各资源规格对应的取值范围分别是：

    • appstreaming.general.4c8g：1~2；
    • appstreaming.general.8c16g：1~4；
    • appstreaming.vgpu.8c16g.4g：1~4；
    • appstreaming.vgpu.8c31g.16g：1~4；
    • appstreaming.vgpu.14c93g.12g：1~6；
    		2
    StrategyTypestring否

    弹性模式。

    说明
  • NODE_FIXED（固定数量）：适用于包年包月资源和按量付费资源。
  • NODE_SCALING_BY_USAGE（自动扩缩容）：适用于包年包月资源和按量付费资源。
  • NODE_SCALING_BY_SCHEDULE（定时扩缩容）：仅适用于按量付费资源。
    •
    		NODE_FIXED
    MaxScalingAmountinteger否

    扩容时最多创建资源的数量。StrategyType设为NODE_SCALING_BY_USAGE（使用弹性资源）时，该字段必填。

    		10
    ScalingStepinteger否

    扩容时每次创建资源的数量。取值范围：1~10。StrategyType设为NODE_SCALING_BY_USAGE（使用弹性资源）时，该字段必填。

    		2
    ScalingUsageThresholdstring否

    会话使用率上限阈值（%）。当会话使用率超过该阈值时，将触发自动扩容。会话使用率的计算公式为会话使用率=当前会话数÷(资源总数×资源并发会话数)×100%。StrategyType设为NODE_SCALING_BY_USAGE（使用弹性资源）时，该字段必填。取值范围：0~100。默认值：85。

    		85
    ScalingDownAfterIdleMinutesinteger否

    无会话连接的资源最多保留的时长（分钟）。当资源内无会话连接时，将按照此处设置的时长开始倒计时，倒计时结束时将完成缩容。取值范围：5~120。默认值：5。但有以下例外情况：

    • 若缩容后将导致重新触发自动扩容，则不会执行缩容，以免导致反复产生缩容、扩容。
    • 若此时间段内，因会话数增加而触发自动扩容，则该资源不会按原计划缩容，倒计时也将重新开始。
    		5
    StrategyEnableDatestring否

    策略生效日期。格式为：yyyy-MM-dd。该日期必须大于或等于当前日期。StrategyType（弹性模式）设为NODE_SCALING_BY_SCHEDULE（定时扩缩容）时，该字段必填。

    		2022-08-01
    StrategyDisableDatestring否

    策略失效日期。格式为：yyyy-MM-dd。失效日期与生效日期的间隔必须介于 7 天到 1 年之间（含 7 天和 1 年）。StrategyType（弹性模式）设为NODE_SCALING_BY_SCHEDULE（定时扩缩容）时，该字段必填。

    		2022-09-08
    WarmUpboolean否

    是否开启资源预热策略。StrategyType（弹性模式）设为NODE_SCALING_BY_SCHEDULE（定时扩缩容）时，该字段必填。

    		false
    RecurrenceSchedulesobject []否

    策略执行周期列表。StrategyType（弹性模式）设为NODE_SCALING_BY_SCHEDULE（定时扩缩容）时，该字段必填。

    RecurrenceTypestring否

    策略执行周期的类型。必须同时指定RecurrenceType和RecurrenceValues。

    枚举值：
    • weekly：周（每周指定几天重复执行一次定时任务）。
    		weekly
    RecurrenceValuesarray否

    策略执行周期的数值列表。

    integer否

    策略执行周期的数值。

    枚举值：
    • 1：周一。
    • 2：周二。
    • 3：周三。
    • 4：周四。
    • 5：周五。
    • 6：周六。
    • 7：周日。
    		1
    TimerPeriodsobject []否

    策略执行周期的时间段列表。时间段设置要求：

    • 最多可添加 3 个时间段。
    • 时间段之间不重叠。
    • 时间段之间的间隔大于或等于 5 分钟。
    • 单个时间段的时长大于或等于 15 分钟。
    • 所有时间段累计不跨天。
    StartTimestring否

    开始时间。格式为 HH:mm。

    		12:00
    EndTimestring否

    结束时间。格式为 HH:mm。

    		15:00
    Amountinteger否

    资源数量。

    		2
    Networkobject否

    网络配置。

    说明 如需使用该参数，请提交工单。
    StrategyTypestring否

    网络策略类型。

    枚举值：
    • Mixed：混合模式，单VPC、双网卡+独立公网IP。
    • Shared：共享模式，单网卡、NAT网管访问公网。
    		Shared
    Routesobject []否

    路由配置。仅当网络策略类型（StrategyType）的值为混合模式（Mixed）时可配置。

    Destinationstring否

    访问目标。CIDR 格式。

    		139.196.XX.XX/32
    Modestring否

    网络出口模式。

    枚举值：
    • Shared：通过NAT网管访问。
    		Shared
    IpExpireMinutesinteger否

    公网 IP 地址使用时长超过这个值时，在下次登录时就会触发 IP 地址更新。最小值为 60。单位为分钟。

    		60
    DomainRulesobject []否

    域名规则配置。

    Domainstring否

    域名。

    		www.example.com
    Policystring否

    策略值。

    枚举值：
    • allow：允许访问。
    • block：禁止访问。
    		block
    StoragePolicyobject否

    存储策略。

    StorageTypeListarray否

    存储类型列表。

    string否

    存储类型。

    枚举值：
    • OFF：关闭。
    • PDS：网盘与相册服务（Drive and Photo Service）。
    		PDS
    PreOpenAppIdstring否

    预开的 AppId。

    		cag-b2ronxxd****
    RuntimePolicyobject否

    运行时策略。

    SessionTypestring否

    会话类型。

    枚举值：
    • CONSOLE：Console会话。
    • NORMAL：RDP会话。
    		NORMAL
    DebugModestring否

    是否开启调试模式。如需调用GetDebugAppInstance和CreateImageFromAppInstanceGroup，则必须将此字段设为ON。

    枚举值：
    • OFF：关闭。
    • ON：开启。
    		OFF
    SecurityPolicyobject否

    安全策略。

    ResetAfterUnbindboolean否

    解绑后是否重置。

    枚举值：
    • true：重置。
    • false：不重置。
    		true
    SkipUserAuthCheckboolean否

    是否跳过用户授权校验。

    枚举值：
    • true：不校验。
    • false：校验 [默认值]。
    		false

    返回参数

    名称类型描述示例值
    object

    返回信息集合。

    RequestIdstring

    请求 ID。

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

    交付组。

    AppInstanceGroupIdstring

    交付组 ID。

    		aig-9ciijz60n4xsv****
    OrderIdstring

    订单 ID。

    		12345****
    NodePoolIdstring

    资源组 ID。如果同时创建了资源组，则返回该参数。

    		rg-ew7va2g1wl3vm****

    示例

    正常返回示例

    JSON格式

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

    错误码

    访问错误中心查看更多错误码。

    变更历史

    变更时间变更内容概要操作
    2023-08-21API 内部配置变更，不影响调用看变更集
    变更项变更内容
    API 内部配置变更，不影响调用。
    2023-04-28OpenAPI 入参发生变更看变更集
    变更项变更内容
    入参OpenAPI 入参发生变更。
      新增入参：StoragePolicy
    2023-04-14OpenAPI 入参发生变更看变更集
    变更项变更内容
    入参OpenAPI 入参发生变更。
      新增入参：SecurityPolicy
    2023-03-14OpenAPI 入参发生变更看变更集
    变更项变更内容
    入参OpenAPI 入参发生变更。
      新增入参：RuntimePolicy
    2022-08-01API 内部配置变更，不影响调用看变更集
    变更项变更内容
    API 内部配置变更，不影响调用。
    文档推荐
    • 本页导读 （0）
    文档反馈