Configure CID permission

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