AssignResourceItemToUserService( username, userServiceID, resourceItemID ) : void
Since: EngageIP v25.2
Assigns the specified ResourceItem to a UserService. If the UserService already has a ResourceItem assigned it will be released.
EngageIP's Resource Management feature lets you manage all your virtual assets such as DIDs, IP address blocks, IMSIs, etc. Resource items represent individual virtual assets and are allocated at the user service level. For more details please visit our KB article on Resource Management.
Parameters:
username (String) - The username of the in which to assign the resource. An exception is thrown if the username cannot be found.
userServiceID (Integer) - The ID of the service to assign the resource. An exception is thrown if the service ID cannot be found.
resourceItemID (Integer) - The ID of the resource to to assign. An exception is thrown if the resource ID cannot be found. If you wish to simply assign a skipped resource you should set resourceItemID = -1. If you wish to assign a back ordered resource then you should set resourceItemID = 0.
Possible Exceptions:
INVALID USERNAME
INVALID SERVICE
INVALID RESOURCE
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
POST /adminportal/webservice.asmx HTTP/1.1
Host: demo.logisense.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Header>
<AuthHeader xmlns="Logisense_EngageIP">
<Username>string</Username>
<Password>string</Password>
</AuthHeader>
</soap12:Header>
<soap12:Body>
<AssignResourceItemToUserService xmlns="Logisense_EngageIP">
<username>string</username>
<userServiceID>int</userServiceID>
<resourceItemID>int</resourceItemID>
</AssignResourceItemToUserService>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<AssignResourceItemToUserServiceResponse xmlns="Logisense_EngageIP" />
</soap12:Body>
</soap12:Envelope>
SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
POST /adminportal/webservice.asmx HTTP/1.1
Host: demo.logisense.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "Logisense_EngageIP/AssignResourceItemToUserService"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<AuthHeader xmlns="Logisense_EngageIP">
<Username>string</Username>
<Password>string</Password>
</AuthHeader>
</soap:Header>
<soap:Body>
<AssignResourceItemToUserService xmlns="Logisense_EngageIP">
<username>string</username>
<userServiceID>int</userServiceID>
<resourceItemID>int</resourceItemID>
</AssignResourceItemToUserService>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<AssignResourceItemToUserServiceResponse xmlns="Logisense_EngageIP" />
</soap:Body>
</soap:Envelope>