Contact UsGet started
© 2024 Iron Hive LLC Belgrade

Managed Service for YDB API, gRPC: BackupService.Get

Written by
Updated at October 17, 2024

Returns the specified backup.

gRPC request

rpc Get (GetBackupRequest) returns (Backup)

GetBackupRequest

{
  "backupId": "string"
}

Field

Description

backupId

string

Required field. Required. ID of the YDB backup.

Backup

{
  "id": "string",
  "name": "string",
  "folderId": "string",
  "databaseId": "string",
  "description": "string",
  "createdAt": "google.protobuf.Timestamp",
  "startedAt": "google.protobuf.Timestamp",
  "completedAt": "google.protobuf.Timestamp",
  "status": "Status",
  "backupSettings": {
    "name": "string",
    "description": "string",
    "backupSchedule": {
      // Includes only one of the fields `dailyBackupSchedule`, `weeklyBackupSchedule`, `recurringBackupSchedule`
      "dailyBackupSchedule": {
        "executeTime": "google.type.TimeOfDay"
      },
      "weeklyBackupSchedule": {
        "daysOfWeek": [
          {
            "days": [
              "DayOfWeek"
            ],
            "executeTime": "google.type.TimeOfDay"
          }
        ]
      },
      "recurringBackupSchedule": {
        "startTime": "google.protobuf.Timestamp",
        "recurrence": "string"
      },
      // end of the list of possible fields
      "nextExecuteTime": "google.protobuf.Timestamp"
    },
    "backupTimeToLive": "google.protobuf.Duration",
    "sourcePaths": [
      "string"
    ],
    "sourcePathsToExclude": [
      "string"
    ],
    "type": "Type",
    "storageClass": "StorageClass"
  },
  "type": "Type",
  "size": "int64"
}

Field

Description

id

string

name

string

human readable backup name.

folderId

string

databaseId

string

description

string

description of backup.

createdAt

google.protobuf.Timestamp

startedAt

google.protobuf.Timestamp

indicates when backup started.

completedAt

google.protobuf.Timestamp

indicates when backup completed.

status

enum Status

  • STATUS_UNSPECIFIED
  • CREATING
  • READY
  • ERROR
  • CANCELLED

backupSettings

BackupSettings

settings used to make backup.

type

enum Type

  • TYPE_UNSPECIFIED
  • SYSTEM: indicates that backup started by the system.
  • USER

size

int64

size of backup in bytes.

BackupSettings

Field

Description

name

string

name of backup settings

description

string

human readable description.

backupSchedule

BackupSchedule

provide schedule. if empty, backup will be disabled.

backupTimeToLive

google.protobuf.Duration

provide time to live of backup.

sourcePaths[]

string

provide a list of source paths. Each path can be directory, table or even database itself.
Each directory (or database) will be traversed recursively and all childs of directory will be included to backup.
By default, backup will be created for full database.

sourcePathsToExclude[]

string

provide a list of paths to exclude from backup.
Each path is a directory, table, or database.
Each directory (or database) will be traversed recursively and all childs of directory will be excluded.

type

enum Type

  • TYPE_UNSPECIFIED
  • SYSTEM
  • USER

storageClass

enum StorageClass

  • STORAGE_CLASS_UNSPECIFIED
  • STANDARD
  • REDUCED_REDUNDANCY
  • STANDARD_IA
  • ONEZONE_IA
  • INTELLIGENT_TIERING
  • GLACIER
  • DEEP_ARCHIVE
  • OUTPOSTS

BackupSchedule

Field

Description

dailyBackupSchedule

DailyBackupSchedule

Includes only one of the fields dailyBackupSchedule, weeklyBackupSchedule, recurringBackupSchedule.

weeklyBackupSchedule

WeeklyBackupSchedule

Includes only one of the fields dailyBackupSchedule, weeklyBackupSchedule, recurringBackupSchedule.

recurringBackupSchedule

RecurringBackupSchedule

Includes only one of the fields dailyBackupSchedule, weeklyBackupSchedule, recurringBackupSchedule.

nextExecuteTime

google.protobuf.Timestamp

output only field: when next backup will be executed
using provided schedule.

DailyBackupSchedule

Field

Description

executeTime

google.type.TimeOfDay

Required field.

WeeklyBackupSchedule

Field

Description

daysOfWeek[]

DaysOfWeekBackupSchedule

DaysOfWeekBackupSchedule

Field

Description

days[]

enum DayOfWeek

  • DAY_OF_WEEK_UNSPECIFIED: The unspecified day-of-week.
  • MONDAY: The day-of-week of Monday.
  • TUESDAY: The day-of-week of Tuesday.
  • WEDNESDAY: The day-of-week of Wednesday.
  • THURSDAY: The day-of-week of Thursday.
  • FRIDAY: The day-of-week of Friday.
  • SATURDAY: The day-of-week of Saturday.
  • SUNDAY: The day-of-week of Sunday.

executeTime

google.type.TimeOfDay

Required field.

RecurringBackupSchedule

Field

Description

startTime

google.protobuf.Timestamp

Required field. Timestamp of the first recurrence.

recurrence

string

Required field. An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how
this backup reccurs.
The FREQ values of MINUTELY, and SECONDLY are not supported.
Previous
Overview
Next
ListPaths