You need to enable JavaScript to run this app.
导航
ModifyTopicAccessPolicies
最近更新时间:2024.03.07 20:25:47首次发布时间:2023.03.30 19:59:26

调用 ModifyTopicAccessPolicies 接口接口更改指定 Topic 的用户权限。

使用说明

该接口用于修改 Topic 的用户权限,可以调整 Topic 对所有用户的默认权限,也可以自定义设置某些用户对于此 Topic 的权限。关于权限设置的详细说明,请参考创建 ACL

请求参数

参数

参数类型

是否必选

示例值

说明

InstanceId

String

kafka-cnngbnntswg1****

Topic 对应的实例 ID。

TopicName

String

my_topic

Topic 的名称。

AllAuthority

Boolean

true

待创建的 Topic 默认是否对所有用户都开启读写权限。

  • true:所有用户都具备此 Topic 的读写权限。
  • false:并非所有用户都具备此 Topic 的读写权限。默认情况下,用户对于此 Topic 的权限沿用用户的默认权限,如果默认权限不满足需求,您也可以通过 AccessPolicies 指定某个用户对于此 Topic 的自定义权限。

AccessPolicies

Array of
AccessPolicyObject

/

自定义权限配置,即为某些用户设置对于此 Topic 的自定义权限。仅在AllAuthority 为 False 时需要设置。详细信息请参考数据结构中的 AccessPolicyObject 部分。

DeletePolicies

Array of String

["user1","user2"]

待删除 Topic 权限的用户列表,其中应指定用户名称。

响应参数


示例

请求示例

POST /?Action=ModifyTopicAccessPolicies&Version=2022-05-01 HTTP/1.1
Content-Type: application/json
Host: kafka.volcengineapi.com
X-Date: 20210328T100802Z
Authorization: HMAC-SHA256 Credential=AK********/20210328/cn-beijing/kafka/request, SignedHeaders=x-date, Signature=********

{
  "InstanceId": "kafka-cnngbnntswg1****",
  "TopicName":"123",
  "AllAuthority":false,
  "AccessPolicies":[{"UserName":"user123","AccessPolicy":"PubSub"}]
}

响应示例

{
    "ResponseMetadata": {
        "RequestId": "202302272036532B034FE726F55372A619",
        "Action": "ModifyTopicAccessPolicies",
        "Version": "2022-05-01",
        "Service": "Kafka",
        "Region": "cn-beijing"
    },
    "Result": null
}