创建站点等候室。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| esa:CreateWaitingRoom | create | *Site acs:esa:{#regionId}:{#accountId}:site/{#SiteId} |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| SiteId | long | 是 | 站点 ID，可通过调用 ListSites 接口获取。 | 1234567890123 |
| Enable | string | 是 | 等候室开关。取值：
| on |
| Name | string | 是 | 等候室名称。 | waitingroom_example |
| QueueAllEnable | string | 否 | 全部排队。取值：
| on |
| HostNameAndPath | array<object> | 是 | 主机名和路径。 | |
| object | 是 | 主机名和路径详情。 | ||
| Subdomain | string | 是 | 子域名。 | test. |
| Domain | string | 是 | 域名。 | example.com |
| Path | string | 是 | 路径。 | /test |
| CookieName | string | 是 | 自定义 Cookie 名称。 | __aliwaitingroom_example |
| TotalActiveUsers | string | 是 | 活跃用户总数。 | 300 |
| NewUsersPerMinute | string | 是 | 每分钟新用户数。 | 200 |
| SessionDuration | string | 是 | 会话持续时间，单位是分钟。 | 5 |
| DisableSessionRenewalEnable | string | 否 | 禁用会话续订。取值：
| on |
| QueuingMethod | string | 是 | 排队方式。取值：
| fifo |
| QueuingStatusCode | string | 是 | 等候室状态码。取值：
| 200 |
| JsonResponseEnable | string | 否 | JSON 响应。开启后 accept 请求头包含"application/json"会返回 JSON 数据。取值：
| on |
| Description | string | 否 | 等候室描述。 | 测试 |
| WaitingRoomType | string | 是 | 等候室类型。支持以下类型：
| default |
| CustomPageHtml | string | 否 | 用户自定义等候室页面内容，当等候室类型为自定义类型时，需要传入。传入的内容需要经过 base64 编码。 | SGVsbG8gd29ybGQ= |
| Language | string | 否 | 等候室页面的语言，当等候室类型为默认类型时，需要传入。支持以下类型：
| enus |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "85H66C7B-671A-4297-9187-2C4477247A74"
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InternalException | Failed to call the service. Try again later or contact technical support. | 调用服务失败，请稍后重试或联系客服咨询详情。 |
| 400 | InvalidParameter.ArgName | Invalid ArgName. Check your website configuration parameters and make sure that they match the supported features and parameter names listed in the official documentation. | 传入的ArgName无效，请检查您提供的站点配置参数，确保它们与官方文档中列出的支持功能及参数名称相匹配。 |
| 400 | InvalidParameter.ArgValue | Invalid parameter value. Check whether the value format and length meet the requirements. | 参数值无效，请检查输入是否符合规定格式及长度限制。 |
| 400 | MissingParameter | The specified ArgName is required for this function. | 配置特定功能时，缺少必传参数。 |
| 400 | CompileRuleError | Rule compilation failed, please check the rule information passed in to ensure that the rule is written according to the syntax described in the document. | 规则编译失败，请检查传入的规则配置，请参考接口文档中描述的规则配置格式。 |
| 400 | SiteConfigLengthExceedLimit | The overall configuration size of the site exceeds the limit, and the total size of all functional configurations of the site cannot exceed 512K. | 站点功能配置大小超出限制，总大小不能超过512K。 |
| 400 | ConfigConflicts | Configuration conflicts, usually when multiple configurations are configured under the same function of the same site, such as duplicate rule names between multiple configurations. | 参数唯一性校验失败，请检查重复的参数值。 |
| 400 | FunctionConflict | The feature configuration conflicts. Sites with version management enabled cannot configure this feature. | 当前配置的功能与其它功能存在冲突，如需要配置请先删除冲突的功能配置。 |
| 400 | RuleRegexQuotaCheckFailed | When configuring rules, rules with regular expressions are not allowed in this plan. Please check the relevant documentation of the plan or upgrade the plan. | 当前套餐不支持配置带有正则的规则引擎，请查看套餐描述，并升级您的套餐。 |
| 400 | NestedRuleQuotaCheckFailed | The nesting level of rules allowed by the plan failed to be verified. Please modify the nesting level of rules or upgrade the plan. | 规则内嵌子条件数量超过套餐上限，请查看套餐描述，并升级您的套餐。 |
| 400 | ArgQuotaCheckFailed | The passed-in parameter value failed to verify the validity of the plan. Please check the plan document to obtain the range of parameters that can be configured for the site plan. | 当前套餐不支持配置受限参数，请检查输入的参数。 |
| 400 | FunctionQuotaCheckFailed | The quota verification for this function fails. It may be that the configuration of this function exceeds the limit of the site plan. Please check the plan introduction document corresponding to this site. | 当前套餐不支持配置受限功能，请检查套餐相关的功能描述。 |
| 400 | ConfExceedLimit | The number of function configurations exceeds the limit. Please check the interface document to see the number of configurations that can be supported by a single function. | 当前功能的配置项数量已经超过系统设定的上限。 |
| 400 | ServiceInvokeFailed | The call to the internal service failed. The engineer is resolving the problem. Please wait a moment before trying, or contact customer service for details. | 调用服务失败，请稍后重试或联系客服咨询详情。 |
| 400 | Instance.NotOnline | Your plan is unavailable due to an overdue payment. Complete the payment first. | 您的套餐实例因欠费当前处于非上线状态，请先完成续费操作以继续使用。 |
| 400 | InstanceNotExist | The instance does not exist. Check whether the specified instance ID is correct or whether the instance belongs to your account. | 实例不存在，请检查提供的实例ID是否正确或该实例是否属于您的账户。 |
| 400 | LockFailed | The system is handling requests you previously submitted. Try again later. | 您有其他请求正在处理中，请稍后再进行重试。 |
| 404 | SiteNotFound | The website does not exist or does not belong to you. | 站点不存在，或者不属于你。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|
暂无变更历史