Users, REST: User.Create
Create a new user.
HTTP request
POST https://rest-assistant.api.cloud.yandex.net/users/v1/users
Body parameters
{
"folderId": "string",
"name": "string",
"description": "string",
"source": "string",
"expirationConfig": {
"expirationPolicy": "string",
"ttlDays": "string"
},
"labels": "object"
}
Request message for creating a new user.
|
Field |
Description |
|
folderId |
string Required field. |
|
name |
string Name of the user. |
|
description |
string Description of the user. |
|
source |
string |
|
expirationConfig |
Expiration configuration for the user. |
|
labels |
object (map<string, string>) Set of key-value pairs to label the user. |
ExpirationConfig
|
Field |
Description |
|
expirationPolicy |
enum (ExpirationPolicy)
|
|
ttlDays |
string (int64) |
Response
HTTP Code: 200 - OK
{
"id": "string",
"folderId": "string",
"name": "string",
"description": "string",
"source": "string",
"createdBy": "string",
"createdAt": "string",
"updatedBy": "string",
"updatedAt": "string",
"expirationConfig": {
"expirationPolicy": "string",
"ttlDays": "string"
},
"expiresAt": "string",
"labels": "object"
}
|
Field |
Description |
|
id |
string Unique identifier of the user. |
|
folderId |
string ID of the folder that the user belongs to. |
|
name |
string Name of the user. |
|
description |
string Description of the user. |
|
source |
string |
|
createdBy |
string Identifier of the subject who created this user. |
|
createdAt |
string (date-time) Timestamp representing when the user was created. String in RFC3339 text format. The range of possible values is from To work with values in this field, use the APIs described in the |
|
updatedBy |
string Identifier of the subject who last updated this user. |
|
updatedAt |
string (date-time) Timestamp representing the last time this user was updated. String in RFC3339 text format. The range of possible values is from To work with values in this field, use the APIs described in the |
|
expirationConfig |
Configuration for the expiration of the user, defining when and how the user will expire. |
|
expiresAt |
string (date-time) Timestamp representing when the user will expire. String in RFC3339 text format. The range of possible values is from To work with values in this field, use the APIs described in the |
|
labels |
object (map<string, string>) Set of key-value pairs that can be used to organize and categorize the user. |
ExpirationConfig
|
Field |
Description |
|
expirationPolicy |
enum (ExpirationPolicy)
|
|
ttlDays |
string (int64) |