parthp2107 794cf64787
updated schema docs (#3329)
* updated schema docs

* addressing ingestion-core version bump
2022-03-10 12:55:35 +05:30

82 lines
3.2 KiB
Markdown

# User
This schema defines the User entity. A user can be part of 0 or more teams. A special type of user called Bot is used for automation. A user can be an owner of zero or more data assets. A user can also follow zero or more data assets.
**$id:**[**https://open-metadata.org/schema/entity/teams/user.json**](https://open-metadata.org/schema/entity/teams/user.json)
Type: `object`
This schema <u>does not</u> accept additional properties.
## Properties
- **id** `required`
- Unique identifier that identifies a user entity instance.
- $ref: [../../type/basic.json#/definitions/uuid](../types/basic.md#uuid)
- **name** `required`
- $ref: [#/definitions/userName](#username)
- **description**
- Used for user biography.
- Type: `string`
- **displayName**
- Name used for display purposes. Example 'FirstName LastName'.
- Type: `string`
- **version**
- Metadata version of the entity.
- $ref: [../../type/entityHistory.json#/definitions/entityVersion](../types/entityhistory.md#entityversion)
- **updatedAt**
- Last update time corresponding to the new version of the entity in Unix epoch time milliseconds.
- $ref: [../../type/basic.json#/definitions/timestamp](../types/basic.md#timestamp)
- **updatedBy**
- User who made the update.
- Type: `string`
- **email** `required`
- Email address of the user.
- $ref: [../../type/basic.json#/definitions/email](../types/basic.md#email)
- **href** `required`
- Link to the resource corresponding to this entity.
- $ref: [../../type/basic.json#/definitions/href](../types/basic.md#href)
- **timezone**
- Timezone of the user.
- Type: `string`
- String format must be a "timezone"
- **isBot**
- When true indicates a special type of user called Bot.
- Type: `boolean`
- **isAdmin**
- When true indicates user is an administrator for the system with superuser privileges.
- Type: `boolean`
- **profile**
- Profile of the user.
- $ref: [../../type/profile.json](../types/profile.md)
- **teams**
- Teams that the user belongs to.
- $ref: [../../type/entityReference.json#/definitions/entityReferenceList](../types/entityreference.md#entityreferencelist)
- **owns**
- List of entities owned by the user.
- $ref: [../../type/entityReference.json#/definitions/entityReferenceList](../types/entityreference.md#entityreferencelist)
- **follows**
- List of entities followed by the user.
- $ref: [../../type/entityReference.json#/definitions/entityReferenceList](../types/entityreference.md#entityreferencelist)
- **changeDescription**
- Change that lead to this version of the entity.
- $ref: [../../type/entityHistory.json#/definitions/changeDescription](../types/entityhistory.md#changedescription)
- **deleted**
- When `true` indicates the entity has been soft deleted.
- Type: `boolean`
- Default: _false_
- **roles**
- Roles that the user has been assigned.
- $ref: [../../type/entityReference.json#/definitions/entityReferenceList](../types/entityreference.md#entityreferencelist)
## Type definitions in this schema
### userName
- A unique name of the user, typically the user ID from an identity provider. Example - uid from LDAP.
- Type: `string`
- Length: between 1 and 128
_This document was updated on: Wednesday, March 9, 2022_