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
    • ML Services
    • 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
        • Get
        • List
        • Create
        • Update
        • Delete
        • ListOperations
        • ListInstances
        • ListHosts
        • UpdateHost
        • ListAccessBindings
        • SetAccessBindings
        • UpdateAccessBindings
  • Monitoring metrics
  • Audit Trails events
  • Release notes

In this article:

  • gRPC request
  • GetHostGroupRequest
  • HostGroup
  • ScalePolicy
  • FixedScale
  1. API reference
  2. gRPC
  3. HostGroup
  4. Get

Compute Cloud API, gRPC: HostGroupService.Get

Written by
Yandex Cloud
Updated at December 17, 2024
  • gRPC request
  • GetHostGroupRequest
  • HostGroup
  • ScalePolicy
  • FixedScale

Returns the specified host group.

gRPC requestgRPC request

rpc Get (GetHostGroupRequest) returns (HostGroup)

GetHostGroupRequestGetHostGroupRequest

{
  "host_group_id": "string"
}

Field

Description

host_group_id

string

Required field. ID of the host group to return.
To get the host group ID, use HostGroupService.List request.

HostGroupHostGroup

{
  "id": "string",
  "folder_id": "string",
  "created_at": "google.protobuf.Timestamp",
  "name": "string",
  "description": "string",
  "labels": "map<string, string>",
  "zone_id": "string",
  "status": "Status",
  "type_id": "string",
  "maintenance_policy": "MaintenancePolicy",
  "scale_policy": {
    // Includes only one of the fields `fixed_scale`
    "fixed_scale": {
      "size": "int64"
    }
    // end of the list of possible fields
  }
}

Represents group of dedicated hosts

Field

Description

id

string

ID of the group.

folder_id

string

ID of the folder that the group belongs to.

created_at

google.protobuf.Timestamp

Creation timestamp in RFC3339 text format.

name

string

Name of the group. The name is unique within the folder.

description

string

Description of the group.

labels

object (map<string, string>)

Resource labels as key:value pairs.

zone_id

string

Availability zone where all dedicated hosts are allocated.

status

enum Status

Status of the group.

  • STATUS_UNSPECIFIED
  • CREATING
  • READY
  • UPDATING
  • DELETING

type_id

string

ID of host type. Resources provided by each host of the group.

maintenance_policy

enum MaintenancePolicy

Behaviour on maintenance events.

  • MAINTENANCE_POLICY_UNSPECIFIED
  • RESTART: Restart instance to move it to another host during maintenance
  • MIGRATE: Use live migration to move instance to another host during maintenance

scale_policy

ScalePolicy

Scale policy. Only fixed number of hosts are supported at this moment.

ScalePolicyScalePolicy

Field

Description

fixed_scale

FixedScale

Includes only one of the fields fixed_scale.

FixedScaleFixedScale

Field

Description

size

int64

Was the article helpful?

Previous
Overview
Next
List
© 2025 Direct Cursus Technology L.L.C.