Yandex Cloud
Documentation
PresentationContact UsTry it for free
© 2026 Direct Cursus Technology L.L.C.
Yandex Managed Service for Valkey™
  • Getting started
  • Access management
  • Inspections and recommendations
  • Pricing policy
  • Terraform reference
    • API authentication
      • Overview
        • Overview
        • Get
        • List
        • Create
        • Update
        • Delete
        • Start
        • Stop
        • Move
        • Backup
        • Restore
        • RescheduleMaintenance
        • StartFailover
        • ListLogs
        • StreamLogs
        • ListOperations
        • ListBackups
        • ListHosts
        • AddHosts
        • DeleteHosts
        • UpdateHosts
        • GetShard
        • ListShards
        • AddShard
        • DeleteShard
        • Rebalance
        • EnableSharding
        • ListAccessBindings
        • SetAccessBindings
        • UpdateAccessBindings
  • Monitoring metrics
  • Audit Trails events
  • Public materials
  • Release notes
  • FAQ

In this article:

  • gRPC request
  • GetClusterShardRequest
  • Shard
  1. API reference
  2. gRPC
  3. Cluster
  4. GetShard

Managed Service for Redis API, gRPC: ClusterService.GetShard

Written by
Yandex Cloud
Updated at October 7, 2026
View in Markdown
  • gRPC request
  • GetClusterShardRequest
  • Shard

Returns the specified shard.

gRPC requestgRPC request

rpc GetShard (GetClusterShardRequest) returns (Shard)

GetClusterShardRequestGetClusterShardRequest

{
  "cluster_id": "string",
  "shard_name": "string"
}

Field

Description

cluster_id

string

Required field. ID of the Valkey cluster the shard belongs to.
To get the cluster ID use a ClusterService.List request.

The maximum string length in characters is 50.

shard_name

string

Required field. Name of Valkey shard to return.
To get the shard name use a ClusterService.ListShards request.

The maximum string length in characters is 63. Value must match the regular expression [a-zA-Z0-9_-]*.

ShardShard

{
  "name": "string",
  "cluster_id": "string",
  "is_ha": "bool"
}

Field

Description

name

string

Name of the Valkey shard. The shard name is assigned by user at creation time, and cannot be changed.
1-63 characters long.

cluster_id

string

ID of the Valkey cluster the shard belongs to. The ID is assigned by MDB at creation time.

is_ha

bool

Indicates whether the shard topology is highly available as defined by the Yandex Cloud SLA for managed databases.

Was the article helpful?

Previous
UpdateHosts
Next
ListShards
© 2026 Direct Cursus Technology L.L.C.