You need to enable JavaScript to run this app.
文档中心
负载均衡

负载均衡

复制全文
下载 pdf
安全策略
DescribeNLBSecurityPolicies - 查询满足指定条件的TLS自定义安全策略
复制全文
下载 pdf
DescribeNLBSecurityPolicies - 查询满足指定条件的TLS自定义安全策略
调用DescribeNLBSecurityPolicies 接口,查询满足指定条件的TLS自定义安全策略。​
使用说明​
本接口仅用于查询TLS自定义安全策略,查询系统安全策略请调用DescribeNLBSystemSecurityPolicies。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
Action String 必选 示例值:DescribeNLBSecurityPolicies​
要执行的操作,取值为 DescribeNLBSecurityPolicies。​
​
Version String 必选 示例值:2020-04-01​
API版本信息,当前版本为 2020-04-01。​
​
SecurityPolicyName String 可选 示例值:TLSCipherPolicy​
TLS 自定义安全策略的名称。​
​
SecurityPolicyIds.N String 可选 示例值:secp-wuytp9pa****​
TLS 自定义安全策略ID。​
  • 参数 - N:表示TLS自定义安全策略的序号,取值范围为1~20。​
  • 多个TLS自定义安全策略ID间使用&分隔。​
​
ProjectName String 可选 示例值:default​
TLS 安全策略所属项目的名称。​
​
TagFilters.N.Key String 可选 示例值:k1​
标签的标签键。指定多个标签键时,表示查询同时包含所有指定标签键的NLB实例。​
  • 参数 - N:表示标签键的序号,取值范围为1~10。​
  • 多个标签键之间使用&分隔。​
​
TagFilters.N.Values.N String 可选 示例值:v1​
标签的标签值。​
  • 第一个N:表示标签键的序号,取值范围 1~10。​
  • 第二个N:表示标签值的序号,取值范围 1~3。同一标签键多个标签值之间的关系为逻辑“或(OR)”,即查询同一标签键下添加其中一个标签值的资源。​
  • 多个标签值之间使用&分隔。​
说明​
  • 如果传入该参数,则必须先传入TagFilters.N.Key。​
  • 该参数传入空值时,表示查询指定标签键下标签值为空的资源。​
​
NextToken String 可选 示例值:caeba0bbb2be03f84eb48b699f0a****​
分页查询凭证,用于标记分页的位置。​
  • 不填则从头开始查询。​
  • 传入之前调用本API返回的NextToken,则从该次API调用标记分页的位置往后开始查询。​
​
MaxResults Integer 可选 示例值:50​
查询的数量,默认为 10,最大为100。​
​
​
​
返回参数​
RequestId String 示例值:20210811152539010225146063030****​
请求ID。​
​
NextToken String 示例值:caeba0bbb2be03f84eb48b699f0a****​
分页查询凭证,用于标记分页的位置,初次调用该接口时无需设置。下次查询时,取值为上一次API调用返回的NextToken参数值。​
​
SecurityPolicies Object[] 示例值:-​
符合条件的TLS 安全策略的详细信息。​
CreateTime String 示例值:2024-08-11T16:37:37Z​
TLS 安全策略的创建时间。​
​
UpdateTime String 示例值:2024-08-11T16:37:37Z​
TLS 安全策略的最近操作时间。​
​
SecurityPolicyId String 示例值:secp-wuytp9pa******​
请求ID。​
​
AccountId String 示例值:210012****​
TLS 安全策略所属的账号ID。​
​
ProjectName String 示例值:default​
TLS 安全策略所属项目的名称。​
​
Status String 示例值:Active​
TLS 安全策略状态​
​
SecurityPolicyName String 示例值:"test"​
TLS 安全策策略名称;​
​
TlsVersions String[] 示例值:["TLSv1.0", "TLSv1.1"]​
TLS 协议版本。​
​
Ciphers String[] 示例值:["ECDHE-ECDSA-AES128-SHA", "ECDHE-ECDSA-AES256-SHA"]​
支持的加密套件列表。​
​
RelatedListenerIds String[] 示例值:["lsn-2zeo05qre24nhrqpy****", "lsn-b2weev3esweer8mt****"]​
TLS 安全策略关联的监听器;​
​
Tags Object[] 示例值:--​
TLS 安全策略的标签信息。​
Key String 示例值:k1​
标签的标签键。​
​
Value String 示例值:v1​
标签的标签值。​
​
​
​
​
​
请求示例​
​
GET /?Action=DescribeNLBSecurityPolicies&Version=2020-04-01&SecurityPolicyName=TLSCipherPolicy&SecurityPolicyIds.1=secp-wuytp9pa****&ProjectName=default&TagFilters.1.Key=k1&TagFilters.1.Values.1=v1&NextToken=caeba0bbb2be03f84eb48b699f0a****&MaxResults=50 HTTP/1.1​
Host: clb.cn-beijing.volcengineapi.com​
Date: 20260310T094038Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/clb/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20230604110420****100232280022D31",​
"Action": "DescribeNLBSecurityPolicies",​
"Version": "2020-04-01",​
"Service": "clb",​
"Region": "cn-beijing"​
},​
"Result": {​
"NextToken": "caeba0bbb2be03f84eb48b699f0a****",​
"RequestId": "20210811152539010225146063030****",​
"SecurityPolicies": [​
{​
"Tags": [​
{​
"Key": "k1",​
"Value": "v1"​
}​
],​
"Status": "Active",​
"Ciphers": [​
"ECDHE-ECDSA-AES128-SHA",​
"ECDHE-ECDSA-AES256-SHA"​
],​
"AccountId": "210012****",​
"CreateTime": "2024-08-11T16:37:37Z",​
"UpdateTime": "2024-08-11T16:37:37Z",​
"ProjectName": "default",​
"TlsVersions": [​
"TLSv1.0",​
"TLSv1.1"​
],​
"SecurityPolicyId": "secp-wuytp9pa******",​
"RelatedListenerIds": [​
"lsn-2zeo05qre24nhrqpy****",​
"lsn-b2weev3esweer8mt****"​
],​
"SecurityPolicyName": "\"test\""​
}​
]​
}​
}​
​
错误码​
此处仅展示当前API的错误码,更多错误码请参见公共错误码。​
​
状态码​
错误码​
错误信息​
说明​
400​
DryRunOperation​
Exception raised to indicate a successfully authorized action when the DryRun flag is set to true.​
该请求设置为DryRun操作,操作授权已获得许可,但未被实际执行。​
400​
IdempotentParameterMismatch​
Arguments on this idempotent request are inconsistent with arguments used in previous request(s).​
此幂等请求的参数与前一个请求中使用的参数不一致。​
400​
InvalidClientToken.Malformed​
The specified ClientToken is malformed.​
指定的 ClientToken 参数格式不合法。​
400​
InvalidIncorrectOrder.Malformed​
The specified index order is malformed.​
指定的索引顺序参数格式不合法。​
400​
InvalidMaxResult.Malformed​
The specified MaxResult is malformed.​
指定的 MaxResult 参数格式不合法。​
400​
InvalidMaxResults.Malformed​
The specified MaxResults is malformed.​
指定的 MaxResults 参数格式不合法。​
400​
InvalidNextToken.Malformed​
The specified NextToken is malformed.​
指定的 NextToken 参数格式不合法。​
400​
InvalidPaging.Malformed​
The specified PageNumber or PageSize is malformed.​
指定的分页参数格式不合法。​
400​
InvalidSecurityPolicyName.Malformed​
The specified SecurityPolicyName is malformed.​
指定的 SecurityPolicyName 参数格式不合法。​
400​
InvalidTagKey.Malformed​
The specified TagKey is malformed.​
指定的 TagKey 参数格式不合法。​
400​
InvalidTagValue.Malformed​
The specified TagValue is malformed.​
指定的 TagValue 参数格式不合法。​
400​
LimitExceeded.SecurityPolicyId​
You've reached the limit on the number of SecurityPolicyId that you can operate.​
已达到单次可操作安全策略的资源数量上限。​
400​
LimitExceeded.TagFilterKey​
You've reached the limit on the number of tag keys that you can filter.​
已达到单次可指定过滤标签键数量的上限。​
400​
LimitExceeded.TagFilterValues​
You've reached the limit on the number of tag values that you can filter.​
已达到单次可指定过滤标签键值数量的上限。​
409​
InvalidOperation.Conflict​
The specified resource operation conflicts.​
指定的资源操作冲突。​
412​
IdempotentProcessing​
The request uses the same client token as a previous one that is still in process.​
幂等请求处理中。​
​
​
最近更新时间:2026.08.06 14:30:32
这个页面对您有帮助吗?
有用
有用
无用
无用