本文档主要介绍如何使用 Open API 来完成指定 Topic 资源的授权操作。
资源授权
新建授权:将自己当前所拥有的指定 Topic 授权给目标用户,可以是主账号或者子账户。
查看授权:查看目标 Topic 已经被授权的用户列表以及权限数据。
删除授权:删除某个 Topic 对目标账号的授权。
相关 API
新建授权: OnsEmpowerCreate
查看授权: OnsEmpowerList
删除授权: OnsEmpowerDelete
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
您提到的操作是关于阿里云消息服务(ONS)中Topic资源的授权管理,这涉及到通过Open API来实现资源访问控制。下面我将基于您给出的API简要说明如何使用这些接口完成相应的授权操作。
功能描述: 该API用于将自己的某个Topic权限授权给其他用户(可以是主账号或子账户),允许他们按指定权限级别访问和使用该Topic。
请求参数示例: - InstanceId
:您的实例ID。 - Topic
:需要授权的Topic名称。 - Role
:目标用户的类型,如USER
表示主账号,ROLE
表示角色,具体值根据实际情况填写。 - TargetName
:目标账号的用户名或角色名。 - PermissionType
:授权的权限类型,比如读权限(READ
)、写权限(WRITE
)或者读写权限(READ_WRITE
)。
调用示例:
curl -X POST \
'https://ons.cn-hangzhou.aliyuncs.com/?Action=OnsEmpowerCreate\
&InstanceId=INSTANCE_ID\
&Topic=TOPIC_NAME\
&Role=USER\
&TargetName=TARGET_USERNAME\
&PermissionType=READ_WRITE\
&<公共请求参数>'
功能描述: 此API用于查询指定Topic已被授权的用户列表及其对应的权限数据,帮助您了解当前Topic的授权状态。
请求参数示例: - InstanceId
:您的实例ID。 - Topic
:需要查询授权信息的Topic名称。
调用示例:
curl -X GET \
'https://ons.cn-hangzhou.aliyuncs.com/?Action=OnsEmpowerList\
&InstanceId=INSTANCE_ID\
&Topic=TOPIC_NAME\
&<公共请求参数>'
功能描述: 当不再需要某用户对特定Topic的访问权限时,使用此API删除对该用户的授权。
请求参数示例: - InstanceId
:您的实例ID。 - Topic
:需要撤销授权的Topic名称。 - Role
:被撤销授权的目标用户类型。 - TargetName
:被撤销授权的目标用户名或角色名。 - PermissionType
:之前授予的权限类型,虽然在删除时通常不需要指定,但某些情况下可能需要明确指出。
调用示例:
curl -X POST \
'https://ons.cn-hangzhou.aliyuncs.com/?Action=OnsEmpowerDelete\
&InstanceId=INSTANCE_ID\
&Topic=TOPIC_NAME\
&Role=USER\
&TargetName=TARGET_USERNAME\
&PermissionType=READ\
&<公共请求参数>'
请注意,上述示例中的<公共请求参数>
包括了阿里云API调用必要的认证信息,如AccessKeyId、SignatureMethod、SignatureVersion、Signature、Timestamp等,确保在实际调用时正确填充这些参数。具体的参数详情和调用规则,请参考阿里云官方文档。