Help Center/ ROMA Connect/ API Reference/ Message Integration APIs/ Application Permission Management/ Querying a Topic Permission
Updated on 2025-07-18 GMT+08:00
View PDF

Querying a Topic Permission

Function

This API is used to query the permission of a topic.

URI

GET /v2/{project_id}/mqs/instances/{instance_id}/topics/{topic_name}/accesspolicy

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. For details about how to obtain a project ID, see "Appendix" > "Obtaining a Project ID" in this document.

instance_id

Yes

String

Instance ID.

topic_name

Yes

String

Topic name.
Table 2 Query Parameters

Parameter

Mandatory

Type

Description

offset

No

String

Offset of the pagination query.

limit

No

String

Maximum number of records to be displayed on a page.

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token, which can be obtained by calling the IAM API (value of X-Subject-Token in the response header).

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

name

String

Topic name.

policies

Array of policies objects

Policy list.

total

Integer

Total number of policies.

size

Integer

Number of policies queried.

operation

String

Topic name.
Table 5 policies

Parameter

Type

Description

owner

Boolean

Whether the application is the one selected during topic creation.

user_name

String

Application key.

access_policy

String

Permission type.

  • all: publish+subscribe

  • pub: publish

  • sub: subscribe

app_name

String

Application name.

tag

String

Tag corresponding to the permission type.

Status code: 400

Table 6 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Status code: 403

Table 7 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Example Requests

GET https://{endpoint}/v2/{project_id}/mqs/instances/{instance_id}/topics/{topic_name}/accesspolicy

Example Responses

Status code: 200

OK

{
  "name" : "topic-test",
  "policies" : [ {
    "owner" : true,
    "user_name" : "c5abd910-02b1-4bc4-b587-c3fe4c49dab9",
    "access_policy" : "pub",
    "app_name" : "topic test",
    "tag" : "11 || 22 || aa || bb"
  } ],
  "total" : 1,
  "size" : 1,
  "operation" : "topic-test"
}

Status code: 400

Bad Request

{
  "error_code" : 400,
  "error_msg" : "Bad Request"
}

Status code: 403

Forbidden

{
  "error_code" : 403,
  "error_msg" : "Forbidden"
}

Status Codes

Status Code

Description

200

OK

400

Bad Request

403

Forbidden

Error Codes

See Error Codes.