更新时间:2022-08-30 GMT+08:00
分享

创建ACL策略

功能介绍

增加一个ACL策略,策略类型通过字段acl_type来确定(permit或者deny),限制的对象的类型可以为IP或者DOMAIN,这里的DOMAIN对应的acl_value的值为您的租户名称, 而非“www.exampleDomain.com”之类的网络域名。

URI

HTTP/HTTPS请求方法以及URI如下表所示。

表1 HTTP/HTTPS请求方法以及URI

请求方法

URI

POST

/v1.0/apigw/acls

请求消息

表2 参数说明

参数

类型

说明

acl_name

String

ACL策略名称。

支持汉字,英文,数字,下划线,且只能以英文和汉字开头,3 ~ 64字符。

说明:

中文字符必须为UTF-8或者unicode编码。

acl_type

String

类型

  • PERMIT (白名单类型)
  • DENY (黑名单类型)

acl_value

String

ACL策略值,支持一个或多个值,使用英文半角逗号分隔

entity_type

String

对象类型:

  • IP
  • DOMAIN

请求消息样例:

{
        "acl_name": "test001",
	"acl_type": "PERMIT",
        "acl_value": "192.168.1.5,192.168.10.0/24,192.168.12.12-192.168.12.19",
        "entity_type": "IP"
}

响应消息

表3 参数说明

名称

类型

说明

id

String

编号

acl_name

String

名称

acl_type

String

类型

  • PERMIT(白名单类型)
  • DENY(黑名单类型)

acl_value

String

ACL策略值

entity_type

String

对象类型:

  • IP
  • DOMAIN

update_time

Timestamp

更新时间

响应消息样例:

{
	"id": "d402b35e-1054-4280-b1c5-0d741a28c995",
        "acl_name": "test",
        "entity_type": "IP",
	"acl_type": "PERMIT",
        "acl_value": "192.168.1.5,192.168.10.0/24,192.168.12.12-192.168.12.19",
	"update_time": "2017-11-18T14:27:36.918578+08:00"
}

状态码

表4 返回消息说明

状态码

说明

201

Created

400

Bad Request

500

Server Internal Error

相关文档