Cloud Desktop API, REST: Desktop.List

Field

Description

folderId

string

Required field. ID of the folder to create a DesktopGroup in.

To get a folder ID make a yandex.cloud.resourcemanager.v1.FolderService.List request.

The maximum string length in characters is 50.

pageSize

string (int64)

The maximum number of results per page to return. If the number of available
results is larger than pageSize,
the service returns a ListDesktopsResponse.nextPageToken
that can be used to get the next page of results in subsequent list requests.
Default value: 100.

Acceptable values are 0 to 1000, inclusive.

pageToken

string

Page token. To get the next page of results, set pageToken to the
ListDesktopsResponse.nextPageToken returned by a previous list request.

The maximum string length in characters is 100.

filter

string

A filter expression that filters resources listed in the response.
The expression must specify:

1. The field name. Currently you can use filtering only on Desktop.name field.
2. An operator. Can be either = or != for single values, IN or NOT IN for lists of values.
3. Value or a list of values to compare against the values of the field.

The maximum string length in characters is 1000.

orderBy

string

Sorting the list by Desktop.name, Desktop.createdAt and Desktop.status fields.
The default sorting order is ascending.

The maximum string length in characters is 100.

Field

Description

desktops[]

Desktop

List of desktops.

nextPageToken

string

This token allows you to get the next page of results for list requests. If the number of results
is larger than ListDesktopsRequest.pageSize, use
the nextPageToken as the value
for the ListDesktopsRequest.pageToken query parameter
in the next list request. Each subsequent list request will have its own
nextPageToken to continue paging through the results.

Field

Description

id

string

Desktop ID.

folderId

string

ID of the folder that the desktop belongs to.

desktopGroupId

string

ID of the desktop group that the desktop belongs to.

createdAt

string (date-time)

Creation timestamp in RFC3339 text format.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

status

enum (Status)

Status of the desktop.

• CREATING: Desktop is being created.
• ACTIVE: Desktop is ready to be used.
• DELETING: Desktop is being deleted.
• RESTARTING: Desktop is restarting.
• UPDATING: Desktop is updating.
• STARTING: Desktop is starting.
• STOPPING: Desktop is stopping.
• STOPPED: Desktop is stopped.
• ERROR: Desktop did not manage start or restart.
• CREATION_FAILED: Desktop did not manage to get created or updated.
• HEALTH_CHECK: Desktop in the process of health check.

name

string

Name of the desktop.

resources

Resources

Resources of the desktop.

networkInterfaces[]

NetworkInterface

users[]

User

labels

object (map<string, string>)

Labels of the desktop.

Field

Description

memory

string (int64)

The minimum value is 1.

cores

string (int64)

The minimum value is 1.

coreFraction

string (int64)

Acceptable values are 0 to 100, inclusive.

Field

Description

networkId

string

Required field.

The maximum string length in characters is 50.

subnetId

string

Required field.

The maximum string length in characters is 50.

Field

Description

subjectId

string

Required field. Identity of the access binding.

The maximum string length in characters is 100.

subjectType

string

Required field. Type of the access binding, e.g. userAccount, serviceAccount, system.

The maximum string length in characters is 100.