Configure Topic permission

This interface is exclusive for MQ Platinum edition users. For more information, go to Platinum Edition Purchase Page.

Usage

This interface is used for configuring read/write switches of the Topic based on the specified MQ region and the Topic name. It’s usually used for write-only or read-only scenarios.

Restrictions on primary accounts and sub-accounts

This interface is exclusively available for primary accounts by default, and cannot be used by RAM sub-accounts unless they are granted related permission.

Request parameters

Response parameters

Related APIs

• OnsTopicCreate: creates a Topic
• OnsTopicList: views the list of Topics

Example

As a reference, this example shows the process of accessing from the end point China East, and setting the Topic “MingduanTest” to write-only mode.

    public static void main(String[] args) {
        String regionId = "cn-hangzhou";
        String accessKey = "XXXXXXXXXXXXXXXXX";
        String secretKey = "XXXXXXXXXXXXXXXXX";
        String endPointName ="cn-hangzhou";
        String productName ="Ons";
        String domain ="ons.cn-hangzhou.aliyuncs.com";
        /**
        *Select Region based on the region you will access, and set the corresponding access point.
        */
        try {
            DefaultProfile.addEndpoint(endPointName，regionId，productName，domain);
        } catch (ClientException e) {
            e.printStackTrace();
        }
        IClientProfile profile= DefaultProfile.getProfile(regionId，accessKey，secretKey);
        IAcsClient IAcsClient= new DefaultAcsClient(profile);
        OnsTopicUpdateRequest request = new OnsTopicUpdateRequest();
        request.setAcceptFormat(FormatType.JSON);
        request.setTopic("MingduanTest");
            /**
            *OnsRegionId refers to the resource of the region of MQ required to be accessed by API.
            *This value must be selected and configured by the list obtained through the OnsRegionList method because OnsRegionId is changing, and cannot be written as a fixed value.
            */
        request.setOnsRegionId("daily");
        request.setPreventCache(System.currentTimeMillis());
        request.setPerm(4);//2 indicates "write-only"; 4 indicates "read-only"; 6 indicates "read/write supported".
        try {
            OnsTopicUpdateResponse response = IAcsClient.getAcsResponse(request);
            System.out.println(response.getRequestId());
        }
        catch (ServerException e) {
            e.printStackTrace();
        }
        catch (ClientException e) {
            e.printStackTrace();
        }
        catch (Exception e) {
            e.printStackTrace();
        }
    }