调用 ModifyAccessKeyAuthority 接口设置 RocketMQ 密钥的自定义权限。
请求频率:该接口请求频率限制为 20 次/秒;单用户请求频率限制为 4 次/秒。
如果您需要更为精细的权限粒度管控,推荐通过此接口为密钥添加自定义权限,设置该密钥对于指定 Topic 的权限策略。为密钥添加自定义权限之后,密钥的默认权限仅对自定义权限之外的 Topic 生效。例如某密钥的默认权限为发布,对于指定 Topic 的自定义权限为发布、订阅,则密钥对于此 Topic 实际权限为发布、订阅,对于实例中的其他 Topic 的权限为发布。
参数 | 参数类型 | 是否必选 | 示例值 | 说明 |
---|---|---|---|---|
InstanceId | String | 是 | rocketmq-cnai1f0c29ca**** | 实例 ID。 |
AccessKey | String | 是 | 2QdEgrGc97AL1p38Fq13**** | 待设置自定义权限的 RocketMQ 密钥 AccessKey ID。 |
AccessPolicies | Array of AccessPolicyForTopicObject | 是 | [ { "TopicName": "rocketmq123", "Authority": "ALL" } | 自定义权限配置,即该 RocketMQ 密钥对哪些 Topic 有何种权限。详细信息请参考 AccessPolicyForTopicObject。 |
无
POST /?Action=ModifyAccessKeyAuthority&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****", "AccessKey": "2QdEgrGc97AL1p38Fq13****", "AccessPolicies": [ { "TopicName": "rocketmq123", "Authority": "ALL" } ] }
{ "ResponseMetadata": { "RequestId": "2023050820590571951661E6B1324A7FB7", "Action": "ModifyAccessKeyAuthority", "Version": "2023-01-01", "Service": "RocketMQ", "Region": "cn-shanghai" }, "Result": {} }