Yandex Cloud
Documentation
PresentationContact UsTry it for free
© 2026 Direct Cursus Technology L.L.C.
Yandex MetaData Hub
  • About Yandex MetaData Hub
    • Getting started
    • Service roles for access management
    • Troubleshooting
    • Terraform reference
      • API authentication
        • Overview
          • Overview
          • List
          • Get
          • Reschedule
    • Yandex Monitoring metrics
    • Audit Trails events
  • Access management
  • Quotas and limits
  • Pricing policy
  • Public materials
  • Release notes

In this article:

  • gRPC request
  • maintenance.v2.ListMaintenancesRequest
  • maintenance.v2.ListMaintenancesResponse
  • Maintenance
  • Resource
  • Detail
  1. Apache Hive™ Metastore
  2. API reference
  3. gRPC
  4. Maintenance
  5. List

Managed Service for Hive Metastore™ API, gRPC: MaintenanceService.List

Written by
Yandex Cloud
Updated at August 26, 2026
View in Markdown
  • gRPC request
  • maintenance.v2.ListMaintenancesRequest
  • maintenance.v2.ListMaintenancesResponse
  • Maintenance
  • Resource
  • Detail

Lists maintenances by conditions, specified in request.

gRPC requestgRPC request

rpc List (maintenance.v2.ListMaintenancesRequest) returns (maintenance.v2.ListMaintenancesResponse)

maintenance.v2.ListMaintenancesRequestmaintenance.v2.ListMaintenancesRequest

{
  // Includes only one of the fields `cloud_id`, `folder_id`, `resource_id`
  "cloud_id": "string",
  "folder_id": "string",
  "resource_id": "string",
  // end of the list of possible fields
  "page_size": "int64",
  "page_token": "string",
  "order_by": "string",
  "filter": "string"
}

ListMaintenancesRequest allows listing maintenances by cloud ID, folder ID, resource type or resource ID.

Field

Description

cloud_id

string

Cloud ID for the resources.

The maximum string length in characters is 50.

Includes only one of the fields cloud_id, folder_id, resource_id.

Container specifies the resources for which to list maintenances. (Required)

folder_id

string

Folder ID for the resources.

The maximum string length in characters is 50.

Includes only one of the fields cloud_id, folder_id, resource_id.

Container specifies the resources for which to list maintenances. (Required)

resource_id

string

Resource ID of the target resource.

The maximum string length in characters is 50.

Includes only one of the fields cloud_id, folder_id, resource_id.

Container specifies the resources for which to list maintenances. (Required)

page_size

int64

The maximum number of maintenances to return per response.

The maximum value is 1000.

page_token

string

Token to retrieve the next page of results. Omitted on the first request.

The maximum string length in characters is 500.

order_by

string

By which field the listing should be ordered and in which direction,
format is "created_at desc". The default sorting order is ascending.
Supported fields: ["created_at", "start_scheduled_at", "started_at"].

The maximum string length in characters is 100.

filter

string

Filter list by various fields.
Supported fields: ["status", "resource_type", "resource_id"]

The maximum string length in characters is 300.

maintenance.v2.ListMaintenancesResponsemaintenance.v2.ListMaintenancesResponse

{
  "maintenances": [
    {
      "id": "string",
      "resource_path": [
        {
          "id": "string",
          "type": "string"
        }
      ],
      "description": "string",
      "details": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "status": "Status",
      "created_at": "google.protobuf.Timestamp",
      "start_scheduled_at": "google.protobuf.Timestamp",
      "completion_scheduled_at": "google.protobuf.Timestamp",
      "max_start_scheduled_at": "google.protobuf.Timestamp",
      "started_at": "google.protobuf.Timestamp",
      "succeeded_at": "google.protobuf.Timestamp",
      "cancelled_at": "google.protobuf.Timestamp",
      "user_controllable": "bool"
    }
  ],
  "next_page_token": "string"
}

Field

Description

maintenances[]

Maintenance

List of maintenances.

next_page_token

string

Token to retrieve the next page of results.

MaintenanceMaintenance

Field

Description

id

string

ID of the maintenance.

resource_path[]

Resource

Full path to the resource affected by maintenance,
represented as a hierarchy from specific resource to top-level container.
Example for a Compute instance with ID "I" in folder "F" and cloud "C":
resource_path = [
{ "compute.instance", "I" },
{ "resource-manager.folder", "F" },
{ "resource-manager.cloud", "C" }
]

description

string

Describes action to be performed.

details[]

Detail

Service-specific details.

status

enum Status

Status of the maintenance.

  • SCHEDULED: Maintenance is scheduled for a future time.
  • RUNNING: Maintenance is currently running.
  • SUCCEEDED: Maintenance completed successfully.
  • CANCELLED: Maintenance is cancelled and will not run.

created_at

google.protobuf.Timestamp

The creation time of the maintenance.

start_scheduled_at

google.protobuf.Timestamp

The time when the maintenance was scheduled to start.

completion_scheduled_at

google.protobuf.Timestamp

The time when the maintenance is estimated to complete. Optional.

max_start_scheduled_at

google.protobuf.Timestamp

Latest time the maintenance can be postponed to.

started_at

google.protobuf.Timestamp

The time time when the maintenance has actually started.

succeeded_at

google.protobuf.Timestamp

The time time when the maintenance has actually completed successfully.

cancelled_at

google.protobuf.Timestamp

The time time when the maintenance has actually been cancelled.

user_controllable

bool

Indicates whether the user can control (reschedule) the maintenance.

ResourceResource

Field

Description

id

string

ID of the resource

type

string

The type of the resource, e.g. resource-manager.cloud, resource-manager.folder, compute.instance, etc.

DetailDetail

Field

Description

key

string

Unique key (service-specific).

value

string

Description (service-specific).

Was the article helpful?

Previous
Overview
Next
Get
© 2026 Direct Cursus Technology L.L.C.