Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • Машинное обучение
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Истории успеха
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Managed Service for YDB
  • Начало работы
  • Управление доступом
    • Обзор
    • Аутентификация в API
      • Overview
        • Overview
        • Get
        • ListPaths
        • List
        • ListAccessBindings
        • SetAccessBindings
        • UpdateAccessBindings
        • Delete
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Вопросы и ответы
  • Публичные материалы
  • Обучающие курсы

В этой статье:

  • gRPC request
  • ListBackupsRequest
  • ListBackupsResponse
  • Backup
  • BackupSettings
  • BackupSchedule
  • DailyBackupSchedule
  • WeeklyBackupSchedule
  • DaysOfWeekBackupSchedule
  • RecurringBackupSchedule
  1. Справочник API Yandex Cloud для Managed Service for YDB
  2. gRPC (англ.)
  3. Backup
  4. List

Managed Service for YDB API, gRPC: BackupService.List

Статья создана
Yandex Cloud
Обновлена 26 ноября 2024 г.
  • gRPC request
  • ListBackupsRequest
  • ListBackupsResponse
  • Backup
  • BackupSettings
  • BackupSchedule
  • DailyBackupSchedule
  • WeeklyBackupSchedule
  • DaysOfWeekBackupSchedule
  • RecurringBackupSchedule

Retrieves a list of backups.

gRPC requestgRPC request

rpc List (ListBackupsRequest) returns (ListBackupsResponse)

ListBackupsRequestListBackupsRequest

{
  "folder_id": "string",
  "page_size": "int64",
  "page_token": "string"
}

Field

Description

folder_id

string

page_size

int64

The maximum number of results per page that should be returned. If the number of available
results is larger than page_size, the service returns a next_page_token that can be used
to get the next page of results in subsequent ListBackups requests.
Acceptable values are 0 to 1000, inclusive. Default value: 100.

page_token

string

Page token. Set page_token to the next_page_token returned by a previous ListBackups
request to get the next page of results.

ListBackupsResponseListBackupsResponse

{
  "backups": [
    {
      "id": "string",
      "name": "string",
      "folder_id": "string",
      "database_id": "string",
      "description": "string",
      "created_at": "google.protobuf.Timestamp",
      "started_at": "google.protobuf.Timestamp",
      "completed_at": "google.protobuf.Timestamp",
      "status": "Status",
      "backup_settings": {
        "name": "string",
        "description": "string",
        "backup_schedule": {
          // Includes only one of the fields `daily_backup_schedule`, `weekly_backup_schedule`, `recurring_backup_schedule`
          "daily_backup_schedule": {
            "execute_time": "google.type.TimeOfDay"
          },
          "weekly_backup_schedule": {
            "days_of_week": [
              {
                "days": [
                  "DayOfWeek"
                ],
                "execute_time": "google.type.TimeOfDay"
              }
            ]
          },
          "recurring_backup_schedule": {
            "start_time": "google.protobuf.Timestamp",
            "recurrence": "string"
          },
          // end of the list of possible fields
          "next_execute_time": "google.protobuf.Timestamp"
        },
        "backup_time_to_live": "google.protobuf.Duration",
        "source_paths": [
          "string"
        ],
        "source_paths_to_exclude": [
          "string"
        ],
        "type": "Type",
        "storage_class": "StorageClass"
      },
      "type": "Type",
      "size": "int64"
    }
  ],
  "next_page_token": "string"
}

Field

Description

backups[]

Backup

next_page_token

string

This token allows you to get the next page of results for ListBackups requests,
if the number of results is larger than page_size specified in the request.
To get the next page, specify the value of next_page_token as a value for
the page_token parameter in the next ListBackups request. Subsequent ListBackups
requests will have their own next_page_token to continue paging through the results.

BackupBackup

Field

Description

id

string

name

string

human readable backup name.

folder_id

string

database_id

string

description

string

description of backup.

created_at

google.protobuf.Timestamp

started_at

google.protobuf.Timestamp

indicates when backup started.

completed_at

google.protobuf.Timestamp

indicates when backup completed.

status

enum Status

  • STATUS_UNSPECIFIED
  • CREATING
  • READY
  • ERROR
  • CANCELLED

backup_settings

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.

BackupSettingsBackupSettings

Field

Description

name

string

name of backup settings

description

string

human readable description.

backup_schedule

BackupSchedule

provide schedule. if empty, backup will be disabled.

backup_time_to_live

google.protobuf.Duration

provide time to live of backup.

source_paths[]

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.

source_paths_to_exclude[]

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

storage_class

enum StorageClass

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

BackupScheduleBackupSchedule

Field

Description

daily_backup_schedule

DailyBackupSchedule

Includes only one of the fields daily_backup_schedule, weekly_backup_schedule, recurring_backup_schedule.

weekly_backup_schedule

WeeklyBackupSchedule

Includes only one of the fields daily_backup_schedule, weekly_backup_schedule, recurring_backup_schedule.

recurring_backup_schedule

RecurringBackupSchedule

Includes only one of the fields daily_backup_schedule, weekly_backup_schedule, recurring_backup_schedule.

next_execute_time

google.protobuf.Timestamp

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

DailyBackupScheduleDailyBackupSchedule

Field

Description

execute_time

google.type.TimeOfDay

Required field.

WeeklyBackupScheduleWeeklyBackupSchedule

Field

Description

days_of_week[]

DaysOfWeekBackupSchedule

DaysOfWeekBackupScheduleDaysOfWeekBackupSchedule

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.

execute_time

google.type.TimeOfDay

Required field.

RecurringBackupScheduleRecurringBackupSchedule

Field

Description

start_time

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.

Была ли статья полезна?

Предыдущая
ListPaths
Следующая
ListAccessBindings
Проект Яндекса
© 2025 ООО «Яндекс.Облако»