You need to enable JavaScript to run this app.
导航
消息队列 Kafka版
  • 文档首页
    • /
  • 消息队列 Kafka版

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
}