调用 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" }] }
{}
公共错误码请参见公共错误码文档。