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

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

  • gRPC request
  • ListInstancesRequest
  • ListInstancesResponse
  • Instance
  • MaintenanceOperation
  1. Справочник API
  2. gRPC (англ.)
  3. Instance
  4. List

Managed Service for Gitlab API, gRPC: InstanceService.List

Статья создана
Yandex Cloud
Обновлена 11 июня 2025 г.
  • gRPC request
  • ListInstancesRequest
  • ListInstancesResponse
  • Instance
  • MaintenanceOperation

Retrieves the list of GitLab instances in the specified folder.

gRPC requestgRPC request

rpc List (ListInstancesRequest) returns (ListInstancesResponse)

ListInstancesRequestListInstancesRequest

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

Request message for InstanceService.List.

Field

Description

folder_id

string

ID of the folder to list instances in.

page_size

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 [ListInstancesRequest.next_page_token]
that can be used to get the next page of results in subsequent list requests.

page_token

string

Page token. To get the next page of results, set page_token to the [ListInstancesRequest.next_page_token]
returned by the previous list request.

ListInstancesResponseListInstancesResponse

{
  "instances": [
    {
      "id": "string",
      "folder_id": "string",
      "created_at": "google.protobuf.Timestamp",
      "updated_at": "google.protobuf.Timestamp",
      "name": "string",
      "description": "string",
      "labels": "map<string, string>",
      "resource_preset_id": "string",
      "disk_size": "int64",
      "status": "Status",
      "admin_login": "string",
      "admin_email": "string",
      "domain": "string",
      "subnet_id": "string",
      "planned_operation": {
        "info": "string",
        "delayed_until": "google.protobuf.Timestamp",
        "latest_maintenance_time": "google.protobuf.Timestamp",
        "next_maintenance_window_time": "google.protobuf.Timestamp"
      },
      "backup_retain_period_days": "int64",
      "maintenance_delete_untagged": "bool",
      "deletion_protection": "bool",
      "approval_rules_id": "string",
      "gitlab_version": "string"
    }
  ],
  "next_page_token": "string"
}

Response message for InstanceService.List.

Field

Description

instances[]

Instance

List of GitLab instances.

next_page_token

string

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

InstanceInstance

Instance represents a GitLab instance with its configuration and state.

Field

Description

id

string

Unique instance ID.

folder_id

string

Folder ID where instance resides.

created_at

google.protobuf.Timestamp

Creation timestamp.

updated_at

google.protobuf.Timestamp

Last update timestamp.

name

string

Human-readable name.

description

string

Instance description.

labels

object (map<string, string>)

Resource labels as key-value pairs.

resource_preset_id

string

Resource preset ID.

disk_size

int64

Disk size in bytes.

status

enum Status

Current instance status.

  • STATUS_UNSPECIFIED: Default state.
  • CREATING: Instance is being created.
  • RUNNING: Instance is running normally.
  • UPDATING: Instance is being updated.
  • ERROR: Instance is in error state.
  • DELETING: Instance is being deleted.
  • BACKUP_CREATING: Backup is being created.
  • BACKUP_RESTORING: Backup is being restored.
  • STARTING: Instance is starting.
  • STOPPING: Instance is stopping.
  • STOPPED: Instance is stopped.
  • BACKGROUND_MIGRATIONS: Background migrations in progress.
  • OBJECT_STORAGE_MIGRATIONS: Object storage migrations in progress.
  • SNAPSHOT_RESTORING: Snapshot is being restored.

admin_login

string

Admin username.

admin_email

string

Admin email.

domain

string

Instance domain.

subnet_id

string

Subnet ID.

planned_operation

MaintenanceOperation

Planned maintenance operation.

backup_retain_period_days

int64

How long to keep backups (days).

maintenance_delete_untagged

bool

Delete untagged resources during maintenance.

deletion_protection

bool

Protect from accidental deletion.

approval_rules_id

string

Approval rules ID.

gitlab_version

string

GitLab version of the instance.

MaintenanceOperationMaintenanceOperation

Field

Description

info

string

The description of the operation.

delayed_until

google.protobuf.Timestamp

Delay time for the maintenance operation.

latest_maintenance_time

google.protobuf.Timestamp

Time of the last maintenance window.

next_maintenance_window_time

google.protobuf.Timestamp

Time of the next maintenance window.

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

Предыдущая
Get
Следующая
Create
Проект Яндекса
© 2025 ТОО «Облачные Сервисы Казахстан»