You need to enable JavaScript to run this app.
导航
ModifyTopicAccessPolicies - 修改Topic权限
最近更新时间:2024.11.18 10:27:31首次发布时间:2023.07.12 16:22:34

调用 ModifyTopicAccessPolicies 接口设置 Topic 的权限策略。

使用说明

此接口从 Topic 的角度设置权限策略,即设置实例中哪些密钥对于此 Topic 分别具备怎样的权限策略。

  • 关于配置密钥权限的详细信息,请参考配置密钥权限
  • 如果需要取消某个密钥的发布或者订阅的权限,请确认没有正在运行的应用使用了此密钥,以免影响线上业务的正常运行。

注意事项

请求频率:该接口请求频率限制为 20 次/秒;单用户请求频率限制为 4 次/秒。

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

参数
类型
是否必填
示例值
描述
Action
String

ModifyTopicAccessPolicies

要执行的操作,取值:ModifyTopicAccessPolicies。

Version
String

2023-01-01

API的版本,取值:2023-01-01。

InstanceId
String

rocketmq-cnoeb5df57dc28**

实例 ID。

TopicName
String

test-topic

Topic 名称。

AccessPolicies
Array of Object

{"AccessPolicies":[{"AccessKey":"test","Authority":"Pub"}]}

每个 RocketMQ 密钥对于当前 Topic 的权限,支持批量设置权限。若未设置,每个密钥对于当前 Topic 维持密钥的默认权限。

返回参数

本接口无特有的返回参数。更多信息请见返回结构

请求示例

{
	"InstanceId": "rocketmq-****",
	"TopicName": "my_topic",
	"AccessPolicies": [{
		"AccessKey": "test",
		"Authority": "PUB"
	}]
}

返回示例

{}

错误码

公共错误码请参见公共错误码文档。