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

ModifyTopicAccessPolicies

最近更新时间：2024.03.06 16:49:22

首次发布时间：2023.07.12 16:22:34

我的收藏

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

注意事项

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

使用说明

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

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

请求参数

参数

参数类型

是否必选

示例值

说明

InstanceId

String

是

rocketmq-cnai1f0c29ca****

实例 ID。

TopicName

String

是

my_topic

Topic 名称。

AccessPolicies

Array of AccessPolicyForTopicObject

是

/

每个 RocketMQ 密钥对于当前 Topic 的权限，支持批量设置权限。若未设置，每个密钥对于当前 Topic 维持密钥的默认权限。详细信息请参考AccessPolicyForTopicObject。

响应参数

无

示例

请求示例

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

{
  "InstanceId": "rocketmq-cnai1f0c29ca****",
  "TopicName": "rocketmq123",
  "AccessPolicies": [
      {
        "AccessKey":"2QdEgrGc97AL1p38Fq13****",
        "Authority": "PUB"
      }
  ]
}

响应示例

{
    "ResponseMetadata": {
        "RequestId": "202305081944169754C8F072E2F0492D43",
        "Action": "ModifyTopicAccessPolicies",
        "Version": "2023-01-01",
        "Service": "RocketMQ",
        "Region": "cn-shanghai"
    },
    "Result": {}
}