Skip to content

User Operation Related Models

class UserPermission(IntEnum)

User permission level

Enum ItemEnum ValueDescription
BANNED-1Banned user permission
USER1Regular user permission
ADMIN10Administrator permission

class UserInstances(BaseModel)

User instance information

Field NameTypeDescription
instanceUuidstrInstance UUID
daemonIdstrID of the owning node

class UserCreateResult(BaseModel)

User creation result

Field NameTypeDescription
uuidstrUser unique identifier (UUID)
userNamestrUsername
permissionUserPermissionUser permission level

class UserModel(BaseModel)

User information model

Field NameTypeDescription
uuidstrUser unique identifier (UUID)
userNamestrUsername
permissionUserPermissionUser permission level
registerTimestrUser registration time (YYYY/M/D hh:mm:ss)
loginTimestrUser last login time (YYYY/M/D hh:mm:ss)
apiKeystrUser API key
passWordstrUser password
open2FAboolWhether Two-Factor Authentication (2FA) is enabled
instanceslist[UserInstances]List of instances associated with the user
isInitboolWhether it is an initialized user (Deprecated)
secretstrUser security secret (Deprecated)
passWordTypeintPassword type (Deprecated)
saltstrPassword salt (Deprecated)

method delete(self)

Deletes this user.

Returns

  • bool: Returns True if the deletion is successful.

method update(self, config: dict[str, Any])

Updates this user's information.

Parameters

  • config: The new user information, provided as a dictionary. Missing information will be filled with the original user's information.

Returns

  • bool: Returns True if the update is successful.

class SearchUserModel(BaseModel)

User search results

Field NameTypeDescription
totalintTotal number of matching users
pageintCurrent page number
page_sizeintNumber of users returned per page
max_pageintMaximum available page number
datalist[UserModel]List of user information

Released under the MIT License.