查询多条HTTPS应用配置。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
esa:ListHttpsApplicationConfigurations |
list |
*Site
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| SiteId |
integer |
是 |
站点 ID,可通过调用 ListSites 接口获取。 |
123456**** |
| ConfigId |
integer |
否 |
配置 ID。 |
3528160969**** |
| ConfigType |
string |
否 |
配置类型,可以根据此参数查全局配置或者规则配置,取值范围:
该参数可以不传,不传时不区分全局或者规则配置。 |
global |
| RuleName |
string |
否 |
规则名,可以查出规则名为所传字段的那条规则。 |
rule_example |
| PageNumber |
integer |
否 |
第几页,不传时默认为 1。 |
1 |
| PageSize |
integer |
否 |
每页几条,最大 500,不传时默认 500。 |
20 |
| SiteVersion |
integer |
否 |
站点的版本号。开启了版本管理的站点,可以通过该参数指定配置生效的站点版本,默认为版本 0。 |
1 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID。 |
0AEDAF20-4DDF-4165-8750-47FF9C1929C9 |
| Configs |
array<object> |
返回体配置。 |
|
|
object |
|||
| ConfigId |
integer |
配置 ID。 |
395386449776640 |
| SiteVersion |
integer |
站点配置的版本号。开启了配置版本管理的站点,可以通过该参数指定配置生效的站点版本,默认为版本 0。 |
1 |
| Sequence |
integer |
规则执行顺序。数值越小越优先执行。 |
1 |
| RuleEnable |
string |
规则开关。添加全局配置的时候不需要设置该参数。取值范围:
|
on |
| Rule |
string |
规则内容,使用条件表达式来匹配用户请求。添加全局配置的时候不需要设置该参数。存在两种使用场景:
|
(http.host eq \"video.example.com\") |
| RuleName |
string |
规则名称。添加全局配置的时候不需要设置该参数。 |
rule_example |
| ConfigType |
string |
配置类型,可以根据此参数查全局配置或者规则配置,取值范围:
|
global |
| HttpsForce |
string |
是否开启强制 HTTPS,默认关闭。取值范围:
|
on |
| HttpsForceCode |
string |
强制 HTTPS 跳转状态码,取值范围:
|
301 |
| AltSvc |
string |
Alt-Svc 功能开关,默认关闭。取值范围:
|
on |
| AltSvcClear |
string |
Alt-Svc 头是否包含 clear 参数,默认关闭。取值:
|
on |
| AltSvcPersist |
string |
Alt-Svc 头包是否含 persist 参数,默认关闭。取值:
|
on |
| AltSvcMa |
string |
Alt-Svc 有效时间,单位是秒,默认为 86400 秒。 |
86400 |
| Hsts |
string |
是否开启 HSTS,默认关闭。取值范围:
|
on |
| HstsMaxAge |
string |
HSTS 过期时间,单位是秒。 |
3600 |
| HstsIncludeSubdomains |
string |
是否在 HSTS 中包括子域,默认关闭。取值范围:
|
on |
| HstsPreload |
string |
是否开启 HSTS 预加载,默认关闭。取值范围:
|
on |
| HttpsSniVerify |
string |
是否开启 SNI 校验,默认关闭。取值范围:
|
on |
| HttpsNoSniDeny |
string |
是否开启拒绝无 SNI 的 TLS 握手请求,默认关闭。取值范围:
|
on |
| HttpsSniWhitelist |
string |
指定允许的 SNI 白名单列表,多个以空格分隔。 |
abc edf |
| PageNumber |
integer |
当前页码。 |
1 |
| PageSize |
integer |
分页大小。 |
10 |
| TotalCount |
integer |
记录总数。 |
16 |
| TotalPage |
integer |
总页数。 |
2 |
示例
正常返回示例
JSON格式
{
"RequestId": "0AEDAF20-4DDF-4165-8750-47FF9C1929C9",
"Configs": [
{
"ConfigId": 395386449776640,
"SiteVersion": 1,
"Sequence": 1,
"RuleEnable": "on",
"Rule": "(http.host eq \\\"video.example.com\\\")\n",
"RuleName": "rule_example",
"ConfigType": "global",
"HttpsForce": "on",
"HttpsForceCode": "301",
"AltSvc": "on",
"AltSvcClear": "on",
"AltSvcPersist": "on",
"AltSvcMa": "86400",
"Hsts": "on",
"HstsMaxAge": "3600",
"HstsIncludeSubdomains": "on",
"HstsPreload": "on",
"HttpsSniVerify": "on",
"HttpsNoSniDeny": "on",
"HttpsSniWhitelist": "abc edf"
}
],
"PageNumber": 1,
"PageSize": 10,
"TotalCount": 16,
"TotalPage": 2
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InternalException | Failed to call the service. Try again later or contact technical support. | 调用服务失败,请稍后重试或联系客服咨询详情。 |
| 400 | InvalidParameter.FunctionName | The specified feature does not exist. Specify a valid feature name based on the related documentation. | 您所输入的功能名称不存在,请参照功能配置文档选择正确的功能名进行操作。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。