Configure CID permission

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

Description

OnsSubscribeUpdate interface sets the permission to read a message for a specified Consumer ID.

Usage

You can configure a switch of message reading for a Consumer ID determined by your specified MQ region and Consumer ID name. This is usually used for preventing a specific Consumer ID from reading messages.

Request parameters

Response parameters

Related APIs

• OnsSubcribeCreate: creates a subscription relation
• OnsSubcribeDelete: deletes a subscription relation
• OnsSubscribeGet: precisely queries a subscription relation

Example

As a reference, this example shows the process of accessing from the end point China East, and disabling the message reading permission of the Consumer ID “CID_001”.

    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);
        OnsSubscriptionUpdateRequest request = new OnsSubscriptionUpdateRequest();
        request.setAcceptFormat(FormatType.JSON);
        request.setConsumerId("CID_001");
            /**
            *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.setReadEnable(false);//2 indicates "write-only"; 4 indicates "read-only"; 6 indicates "read/write supported".
        try {
            OnsSubscriptionUpdateResponse response = IAcsClient.getAcsResponse(request);
            System.out.println(response.getRequestId());
        }
        catch (ServerException e) {
            e.printStackTrace();
        }
        catch (ClientException e) {
            e.printStackTrace();
        }
        catch (Exception e) {
            e.printStackTrace();
        }
    }