Yandex Cloud
Search
Contact UsGet started
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI for business
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex Compute Cloud
  • Yandex Container Solution
  • Access management
  • Pricing policy
  • Terraform reference
    • API authentication
      • Overview
        • Overview
        • List
        • Get
        • Reschedule
  • Monitoring metrics
  • Audit Trails events
  • Release notes

In this article:

  • gRPC request
  • yandex.cloud.maintenance.v2.GetMaintenanceRequest
  • yandex.cloud.maintenance.v2.Maintenance
  • Resource
  • Detail
  1. API reference
  2. gRPC
  3. Maintenance
  4. Get

Compute Cloud API, gRPC: MaintenanceService.Get

Written by
Yandex Cloud
Updated at August 8, 2025
  • gRPC request
  • yandex.cloud.maintenance.v2.GetMaintenanceRequest
  • yandex.cloud.maintenance.v2.Maintenance
  • Resource
  • Detail

Retrieves the specific Maintenance by ID.

gRPC requestgRPC request

rpc Get (yandex.cloud.maintenance.v2.GetMaintenanceRequest) returns (yandex.cloud.maintenance.v2.Maintenance)

yandex.cloud.maintenance.v2.GetMaintenanceRequestyandex.cloud.maintenance.v2.GetMaintenanceRequest

{
  "maintenance_id": "string"
}

GetMaintenanceRequest allows getting Maintenance by ID.

Field

Description

maintenance_id

string

Required field.

yandex.cloud.maintenance.v2.Maintenanceyandex.cloud.maintenance.v2.Maintenance

{
  "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"
}

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.

  • STATUS_UNSPECIFIED: Not set.
  • 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
List
Next
Reschedule
© 2025 Direct Cursus Technology L.L.C.