Modify a user
put
https://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/users/{userId}
The API modifies an existing user details like emails, department, location, contact, granted roles, granted privileges, etc.
Request
Path Parameters
-
userId(required): string
Id of a User.
Supported Media Types
- application/json
Root Schema : schema
Type:
object
Input for modifying an existing User
Show Source
-
expirePasswordNow: boolean
Flag to say whether User password should expire now, so that new password will be requested when the User login next timeExample:
true
-
name(required): string
Read Only:
true
Name of the UserExample:CLOUD_ADMIN
-
password: string
(password)
Password for the UserExample:
userNewPasscode56@
-
privilegeGrants: array
privilegeGrants
List of Privileges to be given to the User
-
roleGrants: array
roleGrants
List of Roles to be granted to the User
Match All
Show Source
-
object
UserCommonDetails
It represents some information of a User
Nested Schema : privilegeGrants
Type:
array
List of Privileges to be given to the User
Show Source
-
Array of:
object PrivilegeGrantDetails
Privilege Grant details for createing/modifying a User or a Role
Nested Schema : roleGrants
Type:
array
List of Roles to be granted to the User
Show Source
-
Array of:
object RoleGrantSummary
Info about Role granted to a User or to an another Role
Nested Schema : UserCommonDetails
Type:
object
It represents some information of a User
Show Source
-
authenticationType: array
authenticationType
Authentication Type of the User
-
contact: string
Minimum Length:
0
Maximum Length:128
Contact Number of a UserExample:21212221212
-
costCenter: string
Minimum Length:
0
Maximum Length:1024
Cost Center of a UserExample:TestCostCenter
-
department: string
Minimum Length:
0
Maximum Length:1024
Department of a UserExample:HumanResource
-
description: string
Minimum Length:
0
Maximum Length:4000
Description about a UserExample:This user is a Test User
-
emails: string
Minimum Length:
0
Maximum Length:128
Email ids of a User with comma as a separator. Each email can have max length of 128 letters.Example:test@oracle.com,abc@oracle.com
-
isPasswordChangeAllowed: boolean
Flag to say whether User is allowed to change his/her own passwordExample:
true
-
lineOfBusiness: string
Minimum Length:
0
Maximum Length:1024
Line-Of-Business of a UserExample:TestBusiness
-
location: string
Minimum Length:
0
Maximum Length:1024
Location of a UserExample:Bangalore
-
passwordProfile: string
Name of Password ProfileExample:
MGMT_ADMIN_USER_PROFILE
Nested Schema : PrivilegeGrantDetails
Type:
object
Privilege Grant details for createing/modifying a User or a Role
Show Source
-
name: string
Name of a PrivilegeExample:
VIEW_TARGET
-
secureResources: array
secureResources
List of SecureResources on which the Privilege is applicable
Nested Schema : secureResources
Type:
array
List of SecureResources on which the Privilege is applicable
Show Source
-
Array of:
object SecureResourceDetails
It represents Secure Resource details for creating/modifying a User or a Role.
Nested Schema : SecureResourceDetails
Type:
object
It represents Secure Resource details for creating/modifying a User or a Role.
Show Source
-
id: string
Id of the ResourceExample:
DE5CD14CE9D0C0EBEFFFDDEBAA83DA33
-
propagationPolicy: array
propagationPolicy
Scope where the privilege is applicable to. This is applicable only for Secure Resource Type called TARGET.
Nested Schema : propagationPolicy
Type:
array
Scope where the privilege is applicable to. This is applicable only for Secure Resource Type called TARGET.
Show Source
-
Array of:
string
Allowed Values:
[ "ALL", "SELF", "MEMBERS" ]
This gives type where a privilege is applicable to which part of composite resource. - ALL means the privilege is given for composite resource and its members. - SELF means the privilege is given only for composite resource. - MEMBERS means the privilege is given only for members of composite resource.
Example:
MEMBERS
Nested Schema : RoleGrantSummary
Type:
object
Info about Role granted to a User or to an another Role
Show Source
-
description: string
Read Only:
true
Description about the RoleExample:This Role is an Test Role
-
id: string
Read Only:
true
Unique identifier for a Role GrantExample:B0F9D83F6E313B03E0537013790ACA39
-
isPrivate: boolean
Read Only:
true
Flag says whether grant Role is a private role or not.Example:true
-
isWithAdmin: boolean
Read Only:
true
Flag says whether Private Role is granted as WITH_ADMIN, This is shown if the Role is a private roleExample:true
-
links: object
links
Read Only:
true
The Role related links -
name: string
Name of a RoleExample:
EM_ALL_ADMINISTRATOR
-
owner: string
Read Only:
true
Owner / Creator of the RoleExample:SYSMAN
-
type: string
Read Only:
true
Type of Role like EM Role, Oracle Defined Role, External RoleExample:Oracle Defined Role
Nested Schema : links
Type:
object
Read Only:
true
The Role related links
Show Source
-
roleLink: object
Link
Represents a link(could be self, previous or next)
Nested Schema : Link
Type:
object
Represents a link(could be self, previous or next)
Show Source
-
href: string
URL for LinkExample:
/em/api/<resources>?page=b2Zmc2V0OjA&limit=0
Nested Schema : authenticationType
Type:
array
Authentication Type of the User
Show Source
-
Array of:
string
Allowed Values:
[ "Repository", "SSO", "Enterprise" ]
This is the representation of Authentication type of User.
Example:
Repository
Response
Supported Media Types
- application/json
200 Response
User details modifed successfully
Root Schema : User
Type:
object
This is the representation of a User.
Show Source
-
privilegeGrants: array
privilegeGrants
List of Privileges to be given to the User
-
roleGrants: array
roleGrants
List of Roles to be granted to the User
Match All
Show Source
-
object
allOf
UserDetails
This is the representation of a User.
Nested Schema : privilegeGrants
Type:
array
List of Privileges to be given to the User
Show Source
-
Array of:
object PrivilegeGrantSummary
Privilege Grant to a User or to a Role
Nested Schema : roleGrants
Type:
array
List of Roles to be granted to the User
Show Source
-
Array of:
object RoleGrantSummary
Info about Role granted to a User or to an another Role
Nested Schema : UserDetails
Type:
object
This is the representation of a User.
Show Source
-
category: string
User category like Administrator / Super Administrator / Repository OwnerExample:
Super Administrator
-
externalId: string
External User Name of the User as mentioned in Identity Provider (like LDAP)Example:
CLOUD_MANAGER
-
id: string
Unique identifier for a UserExample:
B0FBBE587FD201E2E0537013790A7D03
-
isLocked: boolean
Flag that says whether the User is locked or notExample:
false
-
lifecycleStatus: string
User is Active status or BeingDeleted statusExample:
Active
-
links: object
links
the User related links
-
name: string
Name for a UserExample:
CLOUD_MANAGER
Match All
Show Source
-
object
UserCommonDetails
It represents some information of a User
Nested Schema : UserCommonDetails
Type:
object
It represents some information of a User
Show Source
-
authenticationType: array
authenticationType
Authentication Type of the User
-
contact: string
Minimum Length:
0
Maximum Length:128
Contact Number of a UserExample:21212221212
-
costCenter: string
Minimum Length:
0
Maximum Length:1024
Cost Center of a UserExample:TestCostCenter
-
department: string
Minimum Length:
0
Maximum Length:1024
Department of a UserExample:HumanResource
-
description: string
Minimum Length:
0
Maximum Length:4000
Description about a UserExample:This user is a Test User
-
emails: string
Minimum Length:
0
Maximum Length:128
Email ids of a User with comma as a separator. Each email can have max length of 128 letters.Example:test@oracle.com,abc@oracle.com
-
isPasswordChangeAllowed: boolean
Flag to say whether User is allowed to change his/her own passwordExample:
true
-
lineOfBusiness: string
Minimum Length:
0
Maximum Length:1024
Line-Of-Business of a UserExample:TestBusiness
-
location: string
Minimum Length:
0
Maximum Length:1024
Location of a UserExample:Bangalore
-
passwordProfile: string
Name of Password ProfileExample:
MGMT_ADMIN_USER_PROFILE
Nested Schema : PrivilegeGrantSummary
Type:
object
Privilege Grant to a User or to a Role
Show Source
-
description: string
Read Only:
true
Description about the PrivilegeExample:Ability to view Jobs
-
displayName: string
Read Only:
true
Display name of the PrivilegeExample:View Report
-
links: object
links
links related to the privilege grant
-
name: string
Name of a PrivilegeExample:
VIEW_TARGET
-
scope: array
scope
Read Only:
true
Scope of the Privilege -
secureResourceType: string
Read Only:
true
SecureResource Type of the PrivilegeExample:JOB
Nested Schema : links
Type:
object
links related to the privilege grant
Show Source
-
privilege: object
Link
Represents a link(could be self, previous or next)
-
secureResources: object
Link
Represents a link(could be self, previous or next)
Nested Schema : scope
Type:
array
Read Only:
true
Scope of the Privilege
Show Source
-
Array of:
string
Allowed Values:
[ "INSTANCE", "CLASS", "SYSTEM", "SET" ]
This is the representation of scopes of privileges.
Example:
INSTANCE
Nested Schema : Link
Type:
object
Represents a link(could be self, previous or next)
Show Source
-
href: string
URL for LinkExample:
/em/api/<resources>?page=b2Zmc2V0OjA&limit=0
Nested Schema : RoleGrantSummary
Type:
object
Info about Role granted to a User or to an another Role
Show Source
-
description: string
Read Only:
true
Description about the RoleExample:This Role is an Test Role
-
id: string
Read Only:
true
Unique identifier for a Role GrantExample:B0F9D83F6E313B03E0537013790ACA39
-
isPrivate: boolean
Read Only:
true
Flag says whether grant Role is a private role or not.Example:true
-
isWithAdmin: boolean
Read Only:
true
Flag says whether Private Role is granted as WITH_ADMIN, This is shown if the Role is a private roleExample:true
-
links: object
links
Read Only:
true
The Role related links -
name: string
Name of a RoleExample:
EM_ALL_ADMINISTRATOR
-
owner: string
Read Only:
true
Owner / Creator of the RoleExample:SYSMAN
-
type: string
Read Only:
true
Type of Role like EM Role, Oracle Defined Role, External RoleExample:Oracle Defined Role
Nested Schema : links
Type:
object
Read Only:
true
The Role related links
Show Source
-
roleLink: object
Link
Represents a link(could be self, previous or next)
Nested Schema : authenticationType
Type:
array
Authentication Type of the User
Show Source
-
Array of:
string
Allowed Values:
[ "Repository", "SSO", "Enterprise" ]
This is the representation of Authentication type of User.
Example:
Repository
400 Response
Bad Request
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
401 Response
Unauthorized
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
403 Response
Forbidden
Root Schema : MissingPrivErrorResponse
Type:
object
Response sent back as an Error in case required privileges are missing
Show Source
-
missingPrivileges: array
missingPrivileges
Privileges which are missing due to that the Error is occurred. This will have privilege internal name and display name only in the Privilege object
Match All
Show Source
-
object
ErrorResponse
Error response
Nested Schema : missingPrivileges
Type:
array
Privileges which are missing due to that the Error is occurred. This will have privilege internal name and display name only in the Privilege object
Show Source
-
Array of:
object MissingPrivilegeSummary
It represents a Privilege which is missing on a Resource to view or manage it.
Nested Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
Nested Schema : MissingPrivilegeSummary
Type:
object
It represents a Privilege which is missing on a Resource to view or manage it.
Show Source
-
displayName: string
Display Name of PrivilegeExample:
Manage
-
name: string
Name of PrivilegeExample:
MANAGE_JOB
404 Response
Not Found
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
500 Response
Internal Server Error
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
503 Response
Service Unavailable
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
Default Response
Unexpected Error
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string