Managed Service for Gitlab API, gRPC: InstanceService.List
Retrieves the list of GitLab instances in the specified folder.
gRPC request
rpc List (ListInstancesRequest) returns (ListInstancesResponse)
ListInstancesRequest
{
"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 |
page_token |
string Page token. To get the next page of results, set |
ListInstancesResponse
{
"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[] |
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 |
Instance
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 |
Creation timestamp. |
updated_at |
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.
|
admin_login |
string Admin username. |
admin_email |
string Admin email. |
domain |
string Instance domain. |
subnet_id |
string Subnet ID. |
planned_operation |
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. |
MaintenanceOperation
Field |
Description |
info |
string The description of the operation. |
delayed_until |
Delay time for the maintenance operation. |
latest_maintenance_time |
Time of the last maintenance window. |
next_maintenance_window_time |
Time of the next maintenance window. |