Method: getMatchingBulkEnts

Description

The getMatchingBulkEnts operation returns bulk entitlements suitable to receive the web register keys from a splitBulkEntitlement operation. The getMatchingBulkEnts operation searches for bulk entitlements with the target account in the target tier that match the bulk entitlement you want to split. Any bulk entitlement returned by this operation can receive the web register keys as the result of the split operation.

To be considered a match, the bulk entitlement that is the target of the split must share the following attributes with the bulk entitlement that is the source of the split:

• Orderable

• License model

• License term (permanent, expiration date, duration)

• Version date details (options, date, duration)

• Line item state

• License model policies

• License model attributes

Parameters

Name	Type	Direction	Description
msgparameters	getMatchingBulkEntsRequestType	Input

Returns

A getMatchingBulkEntsResponse element having the structure defined by the following table.

Name	Type	Description
statusInfo	StatusInfoType	Element  Data Type  Description  status StatusType Returns one of the following: SUCCESS—All items in the request were processed. PARTIAL_FAILURE—Some, but not all items in the request were processed. The getCount and getQuery operations never return PARTIAL_FAILURE. FAILURE—None of the items in the request were processed. reason string Gives reason for partial failure or failure.
responseData	getMatchingBulkEntsResponseListType	Information about bulk entitlements in the target account that match the bulk entitlement you plan to split is listed in the responseData element. See getMatchingBulkEntsResponseListType.
failedData	failedMatchingBulkEntsListType	Information about the bulk entitlement that could not be matched to bulk entitlements in the target account is in the failedData element. See failedMatchingBulkEntsListType.