Configure Topic permission

This interface is exclusive for MQ Enterprise Platinum edition users. For more information, go to Enterprise 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();
        }
    }