5.1 主题操作
5.1.5 查询主题策略
状态码
状态码 描述
200 OK
400 Bad Request 403 Unauthorized 404 Not Found
500 Internal Server Error
错误码
请参见错误码。
5.1.5 查询主题策略
功能介绍
查询主题的策略信息。
调试
您可以在API Explorer中调试该接口。
URI
GET /v2/{project_id}/notifications/topics/{topic_urn}/attributes
表5-33 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目ID。
获取项目ID请参考获取项目ID。
参数 是否必选 参数类型 描述
topic_urn 是 String Topic的唯一的资源标识，可通 过查询主题列表获取该标识。
表5-34 Query 参数
参数 是否必选 参数类型 描述
name 是 String 主题策略名称。
只支持特定的策略名称，请参见 Topic属性表。
请求参数
表5-35 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。
通过调用IAM服务获取用户 Token接口获取（响应消息头中 X-Subject-Token的值）。
响应参数
状态码： 200
表5-36 响应 Body 参数
参数 参数类型 描述
request_id String 请求的唯一标识ID。
attributes TopicAttribut
e object 属性的键值对。access_policy：设置topic的方法 的访问策略。introduction：设置topic的简介。
表5-37 TopicAttribute
参数 参数类型 描述
Version String 访问策略规范版本。目前只支持
“2016-09-07”。
Id String 策略的唯一标识。不能为空。
参数 参数类型 描述 Statement Array of
Statement objects
访问策略是通过Statement语句来定义的。一个 访问策略可包含一条或多条Statement语句。通 过Statement语句向其他用户或云服务授权对主 题的操作。
表5-38 Statement
参数 参数类型 描述
Sid String Statement语句的ID。 Statement语句ID必须是 唯一的，例如statement01、statement02。
Effect String Statement语句的效果。“Allow”或者
“Deny”。
Principal String Statement语句作用的对象。 目前支持“CSP”
和“Service”两类对象。
“CSP”对象指的是其他用户，可以作用于多个 用户。
“Service”对象指的是云服务，可以作用于多个 云服务。
Principal元素和NotPrincipal元素两者任选其一。
选定后， “CSP”对象填写内容的格式为
urn:csp:iam::domainId:root，其中domainId为其 他用户的“帐号ID”。
“Service”对象填写内容的格式为小写的云服务 名称缩写。
NotPrincipal String NotPrincipal：Statement语句排除作用的对象。
目前支持“CSP”和“Service”两类对象。
“CSP”对象指的是其他用户，可以作用于多个 用户。
“Service”对象指的是云服务，可以作用于多个 云服务。
Principal元素和NotPrincipal元素两者任选其一。
选定后， “CSP”对象填写内容的格式为
urn:csp:iam::domainId:root，其中domainId为其 他用户的“帐号ID”。
“Service”对象填写内容的格式为小写的云服务 名称缩写。
参数 参数类型 描述
Action String Statement语句作用的操作。
允许使用通配符来表示一类操作，例如：
SMN:UpdateTopic SMN:DeleteTopic
SMN:QueryTopicDetail SMN:ListTopicAttributes SMN:UpdateTopicAttribute
SMN:DeleteTopicAttributes
SMN:DeleteTopicAttributeByName
SMN:ListSubscriptionsByTopic SMN:Subscribe SMN:Unsubscribe SMN:Publish
NotAction String Statement语句排除作用的操作。
允许使用通配符来表示一类操作，例如：
Resource String Statement语句作用的主题。
Resource和NotResource两者任选其一。选定 后，填写内容为主题URN。
NotResource String Statement语句排除作用的主题。
Resource和NotResource两者任选其一。选定 后，填写内容为主题URN。
状态码： 400
表5-39 响应 Body 参数
参数 参数类型 描述
request_id String 请求的唯一标识ID。
code String 服务异常错误信息编码。
message String 服务异常错误信息描述。
状态码： 403
表5-40 响应 Body 参数
参数 参数类型 描述
request_id String 请求的唯一标识ID。
code String 服务异常错误信息编码。
message String 服务异常错误信息描述。
状态码： 404
表5-41 响应 Body 参数
参数 参数类型 描述
request_id String 请求的唯一标识ID。
code String 服务异常错误信息编码。
message String 服务异常错误信息描述。
状态码： 500
表5-42 响应 Body 参数
参数 参数类型 描述
request_id String 请求的唯一标识ID。
code String 服务异常错误信息编码。
message String 服务异常错误信息描述。
请求示例
查询主题策略
GET https://{SMN_Endpoint}/v2/{project_id}/notifications/topics/urn:smn:regionId:
{ "request_id" : "6837531fd3f54550927b930180a706bf", "attributes" : {
"access_policy" : { "version" : "2016-09-07", "Id" : "__default_policy_ID", "Statement" : [ {
"Sid" : "__user_pub_0", "Effect" : "Allow", "Principal" : [ {
"CSP" : [ "urn:csp:iam::93dc1b4697ac493d9b7d089569f86b32:root" ] } ],
"Action" : [ "SMN:Publish", "SMN:QueryTopicDetail" ],
"Resource" : "urn:smn:regionId:8bad8a40e0f7462f8c1676e3f93a8183:aaa"
}, {
"Action" : [ "SMN:Publish", "SMN:QueryTopicDetail" ],
"Resource" : "urn:smn:regionId:8bad8a40e0f7462f8c1676e3f93a8183:aaa"
} ]
400 Bad Request 403 Unauthorized 404 Not Found
500 Internal Server Error
错误码
请参见错误码。