Skip to main content

List

Returns the list of available backups for the specified Greenplum® cluster.

import { cloudApi, serviceClients, Session } from "@yandex-cloud/nodejs-sdk";

const ListBackupsRequest =
  cloudApi.mdb.clickhouse_backup_service.ListBackupsRequest;

(async () => {
  const authToken = process.env["YC_OAUTH_TOKEN"];
  const session = new Session({ oauthToken: authToken });
  const client = session.client(serviceClients.BackupServiceClient);

  const result = await client.list(
    ListBackupsRequest.fromPartial({
      folderId: "folderId",
      // pageSize: 0,
      // pageToken: "pageToken"
    })
  );
  console.log(result);
})();

ListBackupsRequest​

folderId : string​

ID of the folder to list backups in.

pageSize : int64​

The maximum number of results per page to return.

If the number of available results is larger than page_size, the service returns a ListBackupsResponse.next_page_token that can be used to get the next page of results in subsequent list requests.

Default value is 100.

pageToken : string​

The page token. To get the next page of results, set page_token to the ListBackupsResponse.next_page_token returned by the previous list request.

ListBackupsResponse​

backups : Backup​

Requested list of backups.

nextPageToken : string​

This token allows you to get the next page of results for a list request.

If the number of results is larger than ListBackupsRequest.page_size specified in the request, use the next_page_token as the value for the ListBackupsRequest.page_token parameter in the next list request.

Each subsequent ListBackups request has its own next_page_token to continue paging through the results.

Backup​

BackupMethod​
  • BACKUP_METHOD_UNSPECIFIED

  • BASE

    Base backup

  • INCREMENTAL

    Delta (incremental) Greenplum backup

BackupCreationType​
  • BACKUP_CREATION_TYPE_UNSPECIFIED

  • AUTOMATED

    Backup created by automated daily schedule

  • MANUAL

    Backup created by user request

id : string​

Required. ID of the backup.

folderId : string​

ID of the folder that the backup belongs to.

createdAt : google.protobuf.Timestamp​

Time when the backup operation was completed.

sourceClusterId : string​

ID of the Greenplum® cluster that the backup was created for.

startedAt : google.protobuf.Timestamp​

Time when the backup operation was started.

size : int64​

Size of the backup in bytes.

type : BackupCreationType​

How this backup was created (manual/automatic/etc...)

method : BackupMethod​

Method of backup creation

journalSize : int64​

Size of the journal associated with backup, in bytes