API网关 APIGAPI网关 APIG

更新时间:2021/09/29 GMT+08:00
分享

修改ACL策略

功能介绍

修改指定的ACL策略,其中可修改的属性为:acl_name、acl_type、acl_value,其它属性不可修改。

URI

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

表1 HTTPS请求方法以及URI

请求方法

URI

PUT

/v1/{project_id}/apigw/instances/{instance_id}/acls/{id}

URI中的参数说明如下表所示。

表2 参数说明

名称

是否必选

类型

说明

project_id

String

项目ID。可从控制台“我的凭证”中获取region下项目ID,管理员权限可查询。

instance_id

String

实例ID,可从API网关控制台的专享版实例信息中获取。

id

String

ACL策略的编号。可通过查询ACL信息获取该ID。

请求消息

表3 参数说明

参数

类型

说明

acl_name

String

ACL策略名称。

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

说明:

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

acl_type

String

类型

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

acl_value

String

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

entity_type

String

ACL策略约束对象。取值范围:

  • IP
  • DOMAIN (租户名称)

请求消息样例:

{
"acl_name": "string",
	"acl_type": "PERMIT",
	"acl_value": "19asdfaf-adfadf",
	"entity_type": "IP"
}

响应消息

表4 参数说明

名称

类型

说明

id

String

编号

acl_name

String

名称

entity_type

String

ACL策略约束对象。取值范围:

  • IP
  • DOMAIN (租户名称)

acl_type

String

类型

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

acl_value

String

ACL策略的值

update_time

Timestamp

更新时间

响应消息样例:

{
	"id": "d402b35e-1054-4280-b1c5-0d741a28c995",
	"acl_name": "goodone",
	"entity_type": "IP",
	"acl_type": "PERMIT",
	"acl_value": "19asdfaf-adfadf",
	"update_time": "2017-11-18T14:27:36.918578+08:00"
}

状态码

表5 返回消息说明

状态码

说明

200

OK

400

Bad Request

403

Forbidden

404

Not Found

分享:

    相关文档

    相关产品