You need to enable JavaScript to run this app.
导航
负载均衡
  • 文档首页
    • /
  • 负载均衡

DescribeAclAttributes

最近更新时间：2024.01.12 10:21:38

首次发布时间：2021.08.31 10:37:28

我的收藏

调用 DescribeAclAttributes 接口查询指定访问策略控制组的详细信息。

调试

API Explorer
您可以通过API Explorer在线发起调用，无需关注签名生成过程，快速获取调用结果。
去调试

请求参数

名称类型是否必填示例值
描述
ActionString是DescribeAclAttributes要执行的操作，取值为DescribeAclAttributes
VersionString是2020-04-01API版本信息，当前版本为：2020-04-01。
AclIdString是acl-3cj44nv0jhhxc6c6rrtet****访问控制策略组ID。您可以调用DescribeAcls接口获取访问控制策略组ID。

返回参数

字段类型示例值
描述
RequestIdString20210811152539010225146063030****请求ID。
AclIdStringacl-3cj44nv0jhhxc6c6rrtet****访问控制策略组的ID。
AclNameStringmyacl访问控制策略组的名称。

Status

String

Active

访问控制策略组的状态。

  • Creating：创建中
  • Active：正常可用
  • Configuring：配置中
  • Deleting：删除中
CreateTimeString2021-08-11T16:37:37Z访问控制策略组的创建时间。
UpdateTimeString2021-08-11T16:37:37Z访问控制策略组的最近操作时间。
AclEntriesArray of Struct-访问控制策略组中IP条目的详细信息。具体请参见“ AclEntry ”。
ListenersArray of Struct-访问控制策略组关联的监听器的详细信息。具体请参见“ Listener ”。
DescriptionStringtest访问控制策略组的描述。
ProjectNameStringdefault访问控制策略组所属项目的名称。

ServiceManaged

Boolean

false

是否为托管资源。

  • true：托管资源。
  • false：非托管资源。
TagsArray of Struct-访问控制策略组标签的详细信息。具体请参见“ Tags”。

AclEntry

字段类型示例值
描述
EntryString192.XX.XX.7/16IP条目的地址段。
DescriptionStringentry1IP条目的描述。

Listener

字段类型示例值
描述

AclType

String

white

监听器对本访问控制策略组的控制方式。

  • white ： 白名单方式。表示监听器仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求。
    如果所选策略组中没有添加任何IP，则监听器不会转发任何请求。
  • black：黑名单方式。表示仅拒绝来自所选访问控制策略组中设置的IP地址或地址段的请求。
    如果所选策略组中没有添加任何IP，则监听器会转发全部请求。
ListenerIdStringlsn-2fek3rgsxhrsw5oxruwec****监听器的ID。
ListenerNameStringmylistener监听器的名称。

Protocol

String

TCP

监听器的协议。

  • TCP
  • UDP
  • HTTP
  • HTTPS
PortInteger88监听器的端口。

Tags

名称类型示例值描述
KeyStringk1标签键。
ValueStringv1标签值。

请求示例

GET /?Action=DescribeAclAttributes&Version=2020-04-01&AclId=acl-3cj44nv0jhhxc6c6rrtet**** HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
Service: clb

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20210811152539010225146063030****",
        "Action": "DescribeAclAttributes",
        "Version": "2020-04-01",
        "Service": "clb",
        "Region": "cn-beijing"
    },
    "Result": {
        "RequestId": "20210811152539010225146063030****",
        "CreateTime": "2021-08-11T16:37:37Z",
        "UpdateTime": "2021-08-11T16:37:37Z",
        "AclId": "acl-3cj44nv0jhhxc6c6rrtet****",
        "AclName": "myacl",
        "Status": "Active",
        "Description": "test",
        "ProjectName": "default",
        "AclEntries": [
            {
                "Entry": "192.XX.XX.1/32",
                "Description": ""
            },
            {
                "Entry": "192.XX.XX.1/32",
                "Description": ""
            }
        ],
        "Listeners": [
            {
                "AclType": "black",
                "ListenerId": "lsn-2fek3rgsxhrsw5oxruwec****",
                "ListenerName": "mylistener",
                "Protocol": "HTTP",
                "Port": 22
            }
        ],
        "ServiceManaged": false,
        "Tags": [
            {
                "Key": "k1",
                "Value": "v1"
            }
        ]
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

HttpCode错误码错误信息描述

400

MissingParameter

The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the 'XXX'.

该请求缺少必要参数。请确保发起请求已提供全部必要参数，比如XXX。

说明

其中，XXX表示缺少的参数名称。

404InvalidAcl.NotFoundThe specified ACL does not exist.指定的 ACL 不存在。