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. |