Docs
api
Load Balance(ULB)
DescribeSecurityPolicies

Obtain information on security policy - DescribeSecurityPolicies

Overview

Obtain information of the security policy, the binding relationship can only obtain the binding relationship between the security policy and the traditional load balancer listener.

Definition

Public Parameters

Parameter NameTypeDescription InformationRequired
ActionstringCorresponding API command name, the current API is DescribeSecurityPolicies.Yes
PublicKeystringThe user's public key can be obtained from Console (opens in a new tab)Yes
SignaturestringUser signature generated based on public key and API command, see Signature AlgorithmYes

Request Parameters

Parameter NameTypeDescription InformationRequired
RegionstringRegion. See List of Regions and Availability ZonesYes
ProjectIdstringProject ID. If not filled in, the default project is used, sub-accounts must be filled in. Please refer to the GetProjectList interface.Yes
SecurityPolicyIdstringSecurity Policy IDNo
LimitintData Pagination ValueNo
OffsetintData OffsetNo

Response Field

Field NameTypeDescription InformationRequired
RetCodeintReturn status code. If it is 0, it means successful return. If it is not 0, it means failure.Yes
ActionstringOperation command name.Yes
MessagestringReturns an error message, providing detailed description when RetCode is non-zero.No
DataSetarray[SecurityPolicy]Security policy list, each parameter is detailed in SecurityPolicy.No
TotalCountintTotal number of security policies that meet the conditionsNo

Data Model

SecurityPolicy

Field NameTypeDescription InformationRequired
SecurityPolicyIdstringSecurity Policy IDYes
SecurityPolicyNamestringSecurity Policy NameYes
TLSVersionstringMinimum TLS VersionYes
SSLCiphersarray[string]Encryption SuiteYes
SecurityPolicyTypeintSecurity policy type 0: Predefined 1: CustomYes
VServerSetarray[BindVServerInfo]Associated ListenerYes

BindVServerInfo

Field NameTypeDescription InformationRequired
VServerIdstringBound VServerIdYes
VServerNamestringBound VServer NameYes
PortintVServer PortYes
ULBIdstringID of ULBYes

Example

Request Example

https://api.ucloud-global.com/?Action=DescribeSecurityPolicies
&Region=cn-bj2
&ProjectId=project-XXXXX
&SecurityPolicyId=security-XXXXX
&Limit=2
&Offset=8

Response Example

{
  "Action": "DescribeSecurityPoliciesResponse",
  "DataSet": [
    {
      "SSLCiphers": [
        "ECDHE-ECDSA-AES128-SHA256"
      ],
      "SecurityPolicyId": "security-XXXXX",
      "SecurityPolicyName": "new-security",
      "SecurityPolicyType": 1,
      "TLSVersion": "TLSv1.2",
      "VServerSet": [
        {
          "Port": 443,
          "ULBId": "ulb-XXXXX",
          "VServerId": "vserver-XXXXX",
          "VServerName": "443"
        }
      ]
    }
  ],
  "RetCode": 0,
  "TotalCount": 1
}