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.

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.

pageToken

string

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

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.

orderBy

string

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

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.

• STATUS_UNSPECIFIED
• 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.

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)

cores

string (int64)

coreFraction

string (int64)

Field

Description

networkId

string

Required field.

subnetId

string

Required field.

Field

Description

subjectId

string

Required field. Identity of the access binding.

subjectType

string

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