调用ListTLSCipherPolicies查询TLS策略。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String ListTLSCipherPolicies

系统规定参数。取值:ListTLSCipherPolicies

RegionId String cn-hangzhou

负载均衡实例地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

TLSCipherPolicyId String tls-bp17elso1h323r****

TLS策略ID。

Name String TLSPolicy-test****

TLS策略名称。长度为2~128个英文或中文字符,必须以大小写字母或中文开头,可包含数字、半角句号(.)、下划线(_)和短划线(-)。

IncludeListener Boolean false

是否返回关联的监听信息。取值:

  • true:返回。
  • false(默认):不返回。
NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

是否拥有下一次查询的令牌(Token)。取值:

  • 第一次查询和没有下一次查询时,均无需填写。
  • 如果有下一次查询,取值为上一次API调用返回的NextToken值。
MaxItems Integer 20

本次读取的最大TLS策略数,取值:1~100。设置为空时,默认值为20

返回数据

名称 类型 示例值 描述
NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

是否拥有下一次查询的令牌(Token)。取值:

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值,该取值表示下一次查询开始的令牌。
RequestId String CEF72CEB-54B6-4AE8-B225-F876FF7BA984

请求ID。

TotalCount Integer 1000

本次请求条件下的TLS策略总数。

IsTruncated Boolean false

是否结束。取值:

  • true:表示当前页是最后一页。
  • false:表示还有下一页。
TLSCipherPolicies Array of TLSCipherPolicy

TLS策略列表。

Status String normal

TLS策略实例状态。取值:

  • configuring:配置中。
  • normal: 正常。
InstanceId String tls-bp17elso1h323r****

TLS策略实例ID。

Name String TLSPolicy-test****

TLS策略名称。

CreateTime Long 1608273800000

创建时间的时间戳。

RelateListeners Array of RelateListener

关联的监听。

Port Integer 80

监听端口。取值:1~65535

Protocol String HTTPS

监听协议。取值:

  • TCP
  • UDP
  • HTTP
  • HTTPS
LoadBalancerId String lb-bp1b6c719dfa08ex****

负载均衡实例ID。

TLSVersions Array of String TLSv1.0

支持的TLS协议版本。

Ciphers Array of String ECDHE-ECDSA-AES128-SHA

支持的加密套件,具体依赖TLSVersions的取值。

TLSv1.0和TLSv1.1 支持:

  • ECDHE-ECDSA-AES128-SHA
  • ECDHE-ECDSA-AES256-SHA
  • ECDHE-RSA-AES128-SHA
  • ECDHE-RSA-AES256-SHA
  • AES128-SHA AES256-SHA
  • DES-CBC3-SHA

TLSv1.2支持:

  • ECDHE-ECDSA-AES128-SHA
  • ECDHE-ECDSA-AES256-SHA
  • ECDHE-RSA-AES128-SHA
  • ECDHE-RSA-AES256-SHA
  • AES128-SHA AES256-SHA
  • DES-CBC3-SHA
  • ECDHE-ECDSA-AES128-GCM-SHA256
  • ECDHE-ECDSA-AES256-GCM-SHA384
  • ECDHE-ECDSA-AES128-SHA256
  • ECDHE-ECDSA-AES256-SHA384
  • ECDHE-RSA-AES128-GCM-SHA256
  • ECDHE-RSA-AES256-GCM-SHA384
  • ECDHE-RSA-AES128-SHA256
  • ECDHE-RSA-AES256-SHA384
  • AES128-GCM-SHA256
  • AES256-GCM-SHA384
  • AES128-SHA256 AES256-SHA256

TLSv1.3支持:

  • TLS_AES_128_GCM_SHA256
  • TLS_AES_256_GCM_SHA384
  • TLS_CHACHA20_POLY1305_SHA256
  • TLS_AES_128_CCM_SHA256
  • TLS_AES_128_CCM_8_SHA256

示例

请求示例

http(s)://[Endpoint]/?Action=ListTLSCipherPolicies
&RegionId=cn-hangzhou
&TLSCipherPolicyId=tls-bp17elso1h323r****
&Name=TLSPolicy-test****
&IncludeListener=false
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&MaxItems=20
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListTLSCipherPoliciesResponse>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
    <TotalCount>1000</TotalCount>
    <IsTruncated>false</IsTruncated>
    <TLSCipherPolicies>
        <Status>normal</Status>
        <InstanceId>tls-bp17elso1h323r****</InstanceId>
        <Name>TLSPolicy-test****</Name>
        <CreateTime>1608273800000</CreateTime>
        <RelateListeners>
            <Port>80</Port>
            <Protocol>HTTPS</Protocol>
            <LoadBalancerId>lb-bp1b6c719dfa08ex****</LoadBalancerId>
        </RelateListeners>
        <TLSVersions>TLSv1.0</TLSVersions>
        <Ciphers>ECDHE-ECDSA-AES128-SHA</Ciphers>
    </TLSCipherPolicies>
</ListTLSCipherPoliciesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId" : "CEF72CEB-54B6-4AE8-B225-F876FF7BA984",
  "TotalCount" : 1000,
  "IsTruncated" : false,
  "TLSCipherPolicies" : [ {
    "Status" : "normal",
    "InstanceId" : "tls-bp17elso1h323r****",
    "Name" : "TLSPolicy-test****",
    "CreateTime" : 1608273800000,
    "RelateListeners" : [ {
      "Port" : 80,
      "Protocol" : "HTTPS",
      "LoadBalancerId" : "lb-bp1b6c719dfa08ex****"
    } ],
    "TLSVersions" : [ "TLSv1.0" ],
    "Ciphers" : [ "ECDHE-ECDSA-AES128-SHA" ]
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 QueryTokenInvalid The specified token is invalid. 指定的Token无效。请检查参数约束,并在修改后重试。
400 QueryTokenNotExist The specified token is not exist. 指定的Token不存在。

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