You are here: Entitlement Management > Entitlement License Model Attributes > setEntFeatureLMAttributes

Update License Model Attributes for a Line Item

Description

Update values of license model attributes of the features associated with a line item. The corresponding entitlement should be in 'draft' or 'reconfigure' state. The input of this Web service is the output XML of getEntFeatureLMAttributes.xml.

In the input XML, only the attributes with "overridable" property set to "true" can be modified, and the remaining information is treated as read-only.

Default Protocol Method Type URI
HTTPS POST setEntFeatureLMAttributes.xml

Post Parameters

Parameter Description Valid Values Optional
entFeatureLMAttributes XML string containing attributes to be updated String No

Sample Code

import java.io.IOException;
//..............................
//..............................
//..............................
import org.apache.http.params.HttpParams;
public class EMSSample {
        private static DefaultHttpClient httpclient = new DefaultHttpClient();
        private static Principal principal = null;
        //..............................
        //..............................
        //..............................
        public static String setEntFeatureLMAttributes.xml()throws Exception {
                if(!verifyLogin()){
                        return "login failed";
                }
                HttpContext context = new BasicHttpContext();
                context.setAttribute(ClientContext.USER_TOKEN, principal);
                HttpPost post = new HttpPost("https://localhost:8080/ems/3.6/setEntFeatureLMAttributes.xml");
                List<NameValuePair> nvps = new ArrayList<NameValuePair>();
                nvps.add(new BasicNameValuePair("entFeatureLMAttributes", ""));
                post.setEntity(new UrlEncodedFormEntity(nvps, HTTP.UTF_8));
                HttpResponse response = httpclient.execute(post, context);
                HttpEntity entity = response.getEntity();
                byte[] b = null;
                if (entity != null) {
                        long l = entity.getContentLength();
                        b = new byte[(int) l];
                        entity.getContent().read(b);
                        entity.consumeContent();
                }
                return new String(b);
        }
}

Sample Response

<emsResponse>
  <stat>ok</stat>
</emsResponse>
See Also:

Output Format for Failure

Error Codes

Error Code Description
100 Invalid request parameter.
101 You are not authorized to use this service.
102 Invalid data entered.
118 {field} should be of data type integer. [Note: This error code is applicable for the fields - featureId, License modelId, entId, ftrId, customerId, lmId, templateType, lineItemId, CustomerId, stationCount, status, and granularity.]
128 You should log on first.
132 The URL address does not exist.
618 Could not find the entitlement line item.
668 Could not find the entitlement license model for id={actual value}.
679 License model does not exist in given feature.
692 Entitlement already in Complete state and cannot be Updated/Deleted.
1031 The entitlement item does not have this product.
1033 The product does not have this feature.
1040 Invalid attribute value.
1043 XML schema Validation Failed.
1074 Only Per Login counting type is allowed in concurrent license model for On-Premise(Entitlement level) entitlement.
1081 Invalid Web service version provided
1084 No Web service version provided
1088 The EMS system is running on HTTPS. Please provide the correct Web service URL.
1100 Invalid max usage limit. Max usage limit between 1 - 2147483647 is allowed.
1190 The start date cannot be equal to the end date.