Access User View - Access User Management

Query Services Assigned to User

Query the services assigned to an access user.

Interface URI

/uam/acmUser/userServiceTemplate/{userName}

Access Method

HTTP
GET
Parameters
Path parameters
userName Account name.
String type. Required. No default value. The string cannot exceed 32 characters.

Return Values

Status codes
  • 200 (OK): Success.
  • 204 (No Content): No access user is found with the specified account name. The message body is empty.
  • 409 (Conflict): Failure.
Error codes
Error codes
62401 The value of parameter "{0}" is invalid.
62858 User "{0}" does not have an account.
Message header
HTTP/1.1 200 OK
Message body
<list>
 <appliedService>
  <serviceTemplateId>3</serviceTemplateId>
  serviceTemplateName>Disable IP Allocating</serviceTemplateName>
  <serviceSuffix>no</serviceSuffix>
  <feeStrategyId>3</feeStrategyId>
  <feeStrategyName>No Accounting</feeStrategyName> 
  <curCycleStartTime></curCycleStartTime>
  <curCycleEndTime></curCycleEndTime>
 </appliedService>
 ...
</list>				
Element description
appliedService subelements
serviceTemplateId Service template ID.
Long integer type.
serviceTemplateName Service name.
String type.
serviceSuffix Service suffix.
String type.
feeStrategyId ID of the accounting policy.
Long integer type. This element is returned only when the accounting component is installed.
feeStrategyName Accounting policy name.
String type. This element is returned only when the accounting component is installed.
curCycleStartTime Start time of the current billing cycle.
Date type. This element is returned only when the accounting component is installed.
curCycleEndTime End time of the current billing cycle.
Date type. This element is returned only when the accounting component is installed.
userIp Support for allocating IP address to access users.
String type.

Example

Query services assigned to access user pre01.

Request
GET http://inc_host:8080/imcrs/uam/acmUser/userServiceTemplate/pre01
accept: application/xml
...        
Response
HTTP/1.1 200 OK 
Content-Type: application/xml  
... 
<list>
 <appliedService>
  <serviceTemplateId>3</serviceTemplateId>
  serviceTemplateName>Disable IP Allocating</serviceTemplateName>
  <serviceSuffix>no</serviceSuffix>
  <feeStrategyId>3</feeStrategyId>
  <feeStrategyName>No Accounting</feeStrategyName> 
  <curCycleStartTime></curCycleStartTime>
  <curCycleEndTime></curCycleEndTime>
 </appliedService>
 ...
</list>