Managed Service for OpenSearch API, gRPC: ClusterService.Restore
- gRPC request
- RestoreClusterRequest
- ConfigCreateSpec
- OpenSearchCreateSpec
- NodeGroup
- Resources
- DiskSizeAutoscaling
- OpenSearchConfig2
- KeystoreSetting
- DashboardsCreateSpec
- NodeGroup
- Access
- SnapshotManagement
- SnapshotSchedule
- HourlySnapshotSchedule
- DailySnapshotSchedule
- WeeklySnapshotSchedule
- MaintenanceWindow
- AnytimeMaintenanceWindow
- WeeklyMaintenanceWindow
- operation.Operation
- RestoreClusterMetadata
- Cluster
- Monitoring
- ClusterConfig
- OpenSearch
- NodeGroup
- Resources
- DiskSizeAutoscaling
- OpenSearchConfigSet2
- OpenSearchConfig2
- Dashboards
- NodeGroup
- Access
- SnapshotManagement
- SnapshotSchedule
- HourlySnapshotSchedule
- DailySnapshotSchedule
- WeeklySnapshotSchedule
- MaintenanceWindow
- AnytimeMaintenanceWindow
- WeeklyMaintenanceWindow
- MaintenanceOperation
Creates a new OpenSearch cluster using the specified backup.
gRPC request
rpc Restore (RestoreClusterRequest) returns (operation.Operation)
RestoreClusterRequest
{
"backup_id": "string",
"name": "string",
"description": "string",
"labels": "map<string, string>",
"environment": "Environment",
"config_spec": {
"version": "string",
"admin_password": "string",
"opensearch_spec": {
"plugins": [
"string"
],
"node_groups": [
{
"name": "string",
"resources": {
"resource_preset_id": "string",
"disk_size": "int64",
"disk_type_id": "string"
},
"hosts_count": "int64",
"zone_ids": [
"string"
],
"subnet_ids": [
"string"
],
"assign_public_ip": "bool",
"roles": [
"GroupRole"
],
"disk_size_autoscaling": {
"planned_usage_threshold": "int64",
"emergency_usage_threshold": "int64",
"disk_size_limit": "int64"
}
}
],
// Includes only one of the fields `opensearch_config_2`
"opensearch_config_2": {
"max_clause_count": "google.protobuf.Int64Value",
"fielddata_cache_size": "string",
"reindex_remote_whitelist": "string"
},
// end of the list of possible fields
"keystore_settings": [
{
"name": "string",
"value": "string"
}
]
},
"dashboards_spec": {
"node_groups": [
{
"name": "string",
"resources": {
"resource_preset_id": "string",
"disk_size": "int64",
"disk_type_id": "string"
},
"hosts_count": "int64",
"zone_ids": [
"string"
],
"subnet_ids": [
"string"
],
"assign_public_ip": "bool",
"disk_size_autoscaling": {
"planned_usage_threshold": "int64",
"emergency_usage_threshold": "int64",
"disk_size_limit": "int64"
}
}
]
},
"access": {
"data_transfer": "bool",
"serverless": "bool"
},
"snapshot_management": {
"snapshot_schedule": {
// Includes only one of the fields `hourly_snapshot_schedule`, `daily_snapshot_schedule`, `weekly_snapshot_schedule`
"hourly_snapshot_schedule": {
"minute": "int64"
},
"daily_snapshot_schedule": {
"hour": "int64",
"minute": "int64"
},
"weekly_snapshot_schedule": {
"day": "WeekDay",
"hour": "int64",
"minute": "int64"
}
// end of the list of possible fields
},
"snapshot_max_age_days": "google.protobuf.Int64Value"
}
},
"network_id": "string",
"security_group_ids": [
"string"
],
"service_account_id": "string",
"deletion_protection": "bool",
"folder_id": "string",
"maintenance_window": {
// Includes only one of the fields `anytime`, `weekly_maintenance_window`
"anytime": "AnytimeMaintenanceWindow",
"weekly_maintenance_window": {
"day": "WeekDay",
"hour": "int64"
}
// end of the list of possible fields
},
"disk_encryption_key_id": "google.protobuf.StringValue"
}
|
Field |
Description |
|
backup_id |
string Required field. ID of the backup to create a new cluster from. To get the backup ID, use a ClusterService.ListBackups request. |
|
name |
string Required field. Name of the new OpenSearch cluster to be created from the backup. The name must be unique within the folder. The maximum string length in characters is 63. Value must match the regular expression |
|
description |
string Description of the new OpenSearch cluster to be created from the backup. The maximum string length in characters is 256. |
|
labels |
object (map<string, string>) Custom labels for the new OpenSearch cluster to be created from the backup as No more than 64 per resource. The maximum string length in characters for each value is 63. Each value must match the regular expression |
|
environment |
enum Environment Deployment environment of the new OpenSearch cluster to be created from the backup.
|
|
config_spec |
Required field. Configuration for the new OpenSearch cluster to be created from the backup. |
|
network_id |
string Required field. ID of the network to create the cluster in. The maximum string length in characters is 50. |
|
security_group_ids[] |
string User security groups. |
|
service_account_id |
string ID of the service account used to access Object Storage. |
|
deletion_protection |
bool Determines whether the cluster is protected from being deleted. |
|
folder_id |
string Required field. ID of the folder to create the OpenSearch cluster in. To get the folder ID, use a yandex.cloud.resourcemanager.v1.FolderService.List request. The maximum string length in characters is 50. |
|
maintenance_window |
Cluster maintenance window. Should be defined by either one of the two options. |
|
disk_encryption_key_id |
ID of the key to encrypt cluster disks. |
ConfigCreateSpec
|
Field |
Description |
|
version |
string OpenSearch version. |
|
admin_password |
string Required field. OpenSearch admin password. |
|
opensearch_spec |
OpenSearch configuration. |
|
dashboards_spec |
Dashboards configuration. |
|
access |
Access policy for external services. |
|
snapshot_management |
Snapshot management configuration |
OpenSearchCreateSpec
OpenSearch create-time configuration.
|
Field |
Description |
|
plugins[] |
string Names of the cluster plugins. |
|
node_groups[] |
OpenSearch type host groups of the cluster. |
|
opensearch_config_2 |
Includes only one of the fields |
|
keystore_settings[] |
Initial cluster keystore settings. |
NodeGroup
Configuration of the host group.
|
Field |
Description |
|
name |
string Required field. Name of the group. The maximum string length in characters is 63. Value must match the regular expression |
|
resources |
Resources allocated to the hosts. |
|
hosts_count |
int64 Number of hosts in the group. The minimum value is 1. |
|
zone_ids[] |
string IDs of the availability zones the hosts belong to. The maximum number of elements is 10. The maximum string length in characters for each value is 50. |
|
subnet_ids[] |
string IDs of the subnets that the hosts belong to. The maximum number of elements is 10. The maximum string length in characters for each value is 50. |
|
assign_public_ip |
bool Determines whether a public IP is assigned to the hosts in the group. |
|
roles[] |
enum GroupRole Roles of the hosts in the group.
|
|
disk_size_autoscaling |
Disk size autoscaling settings |
Resources
A list of computational resources allocated to a host.
|
Field |
Description |
|
resource_preset_id |
string ID of the preset for computational resources allocated to a host. |
|
disk_size |
int64 Volume of the storage used by the host, in bytes. |
|
disk_type_id |
string Type of the storage used by the host: |
DiskSizeAutoscaling
|
Field |
Description |
|
planned_usage_threshold |
int64 Amount of used storage for automatic disk scaling in the maintenance window, 0 means disabled, in percent. Acceptable values are 0 to 100, inclusive. |
|
emergency_usage_threshold |
int64 Amount of used storage for immediately automatic disk scaling, 0 means disabled, in percent. Acceptable values are 0 to 100, inclusive. |
|
disk_size_limit |
int64 Limit on how large the storage for database instances can automatically grow, in bytes. |
OpenSearchConfig2
|
Field |
Description |
|
max_clause_count |
the maximum number of allowed boolean clauses in a query |
|
fielddata_cache_size |
string the percentage or absolute value (10%, 512mb) of heap space that is allocated to fielddata |
|
reindex_remote_whitelist |
string |
KeystoreSetting
Single keystore entry.
|
Field |
Description |
|
name |
string Keystore entry name. |
|
value |
string Keystore entry value. |
DashboardsCreateSpec
Dashboards create-time configuration.
|
Field |
Description |
|
node_groups[] |
Dashboards type host groups of the cluster. |
NodeGroup
|
Field |
Description |
|
name |
string Required field. Name of the group. The maximum string length in characters is 63. Value must match the regular expression |
|
resources |
Resources allocated to the hosts. |
|
hosts_count |
int64 Number of hosts in the group. The minimum value is 1. |
|
zone_ids[] |
string IDs of the availability zones the hosts belong to. |
|
subnet_ids[] |
string IDs of the subnets that the hosts belong to. The maximum number of elements is 10. The maximum string length in characters for each value is 50. |
|
assign_public_ip |
bool Determines whether a public IP is assigned to the hosts in the group. |
|
disk_size_autoscaling |
Disk size autoscaling settings |
Access
Access policy for external services.
|
Field |
Description |
|
data_transfer |
bool Determines whether the access to Data Transfer is allowed. |
|
serverless |
bool Determines whether the access to Serverless is allowed. |
SnapshotManagement
Snapshot management configuration
|
Field |
Description |
|
snapshot_schedule |
Snapshot creation schedule |
|
snapshot_max_age_days |
Snapshot max age in days The minimum value is 7. |
SnapshotSchedule
Snapshot creation schedule
|
Field |
Description |
|
hourly_snapshot_schedule |
Hourly based snapshot schedule Includes only one of the fields |
|
daily_snapshot_schedule |
Daily based snapshot schedule Includes only one of the fields |
|
weekly_snapshot_schedule |
Weekly based snapshot schedule Includes only one of the fields |
HourlySnapshotSchedule
Hourly based snapshot schedule
|
Field |
Description |
|
minute |
int64 The minute of the hour at which the backup should be created. Acceptable values are 0 to 59, inclusive. |
DailySnapshotSchedule
Daily based snapshot schedule
|
Field |
Description |
|
hour |
int64 The hour of the day in UTC timezone at which the backup should be created. Acceptable values are 0 to 23, inclusive. |
|
minute |
int64 The minute of the hour at which the backup should be created. Acceptable values are 0 to 59, inclusive. |
WeeklySnapshotSchedule
Weekly based snapshot schedule
|
Field |
Description |
|
day |
enum WeekDay Day of the week
|
|
hour |
int64 The hour of the day in UTC timezone at which the backup should be created. Acceptable values are 0 to 23, inclusive. |
|
minute |
int64 The minute of the hour at which the backup should be created. Acceptable values are 0 to 59, inclusive. |
MaintenanceWindow
An OpenSearch cluster maintenance window. Should be defined by either one of the two options.
|
Field |
Description |
|
anytime |
An any-time maintenance window. Includes only one of the fields |
|
weekly_maintenance_window |
A weekly maintenance window. Includes only one of the fields |
AnytimeMaintenanceWindow
An any-time maintenance window.
|
Field |
Description |
|
Empty |
|
WeeklyMaintenanceWindow
A weekly maintenance window.
|
Field |
Description |
|
day |
enum WeekDay Day of the week.
|
|
hour |
int64 Hour of the day in the UTC timezone. Acceptable values are 1 to 24, inclusive. |
operation.Operation
{
"id": "string",
"description": "string",
"created_at": "google.protobuf.Timestamp",
"created_by": "string",
"modified_at": "google.protobuf.Timestamp",
"done": "bool",
"metadata": {
"cluster_id": "string",
"backup_id": "string"
},
// Includes only one of the fields `error`, `response`
"error": "google.rpc.Status",
"response": {
"id": "string",
"folder_id": "string",
"created_at": "google.protobuf.Timestamp",
"name": "string",
"description": "string",
"labels": "map<string, string>",
"environment": "Environment",
"monitoring": [
{
"name": "string",
"description": "string",
"link": "string"
}
],
"config": {
"version": "string",
"opensearch": {
"plugins": [
"string"
],
"node_groups": [
{
"name": "string",
"resources": {
"resource_preset_id": "string",
"disk_size": "int64",
"disk_type_id": "string"
},
"hosts_count": "int64",
"zone_ids": [
"string"
],
"subnet_ids": [
"string"
],
"assign_public_ip": "bool",
"roles": [
"GroupRole"
],
"disk_size_autoscaling": {
"planned_usage_threshold": "int64",
"emergency_usage_threshold": "int64",
"disk_size_limit": "int64"
}
}
],
// Includes only one of the fields `opensearch_config_set_2`
"opensearch_config_set_2": {
"effective_config": {
"max_clause_count": "google.protobuf.Int64Value",
"fielddata_cache_size": "string",
"reindex_remote_whitelist": "string"
},
"user_config": {
"max_clause_count": "google.protobuf.Int64Value",
"fielddata_cache_size": "string",
"reindex_remote_whitelist": "string"
},
"default_config": {
"max_clause_count": "google.protobuf.Int64Value",
"fielddata_cache_size": "string",
"reindex_remote_whitelist": "string"
}
},
// end of the list of possible fields
"keystore_settings": [
"string"
]
},
"dashboards": {
"node_groups": [
{
"name": "string",
"resources": {
"resource_preset_id": "string",
"disk_size": "int64",
"disk_type_id": "string"
},
"hosts_count": "int64",
"zone_ids": [
"string"
],
"subnet_ids": [
"string"
],
"assign_public_ip": "bool",
"disk_size_autoscaling": {
"planned_usage_threshold": "int64",
"emergency_usage_threshold": "int64",
"disk_size_limit": "int64"
}
}
]
},
"access": {
"data_transfer": "bool",
"serverless": "bool"
},
"snapshot_management": {
"snapshot_schedule": {
// Includes only one of the fields `hourly_snapshot_schedule`, `daily_snapshot_schedule`, `weekly_snapshot_schedule`
"hourly_snapshot_schedule": {
"minute": "int64"
},
"daily_snapshot_schedule": {
"hour": "int64",
"minute": "int64"
},
"weekly_snapshot_schedule": {
"day": "WeekDay",
"hour": "int64",
"minute": "int64"
}
// end of the list of possible fields
},
"snapshot_max_age_days": "google.protobuf.Int64Value"
},
"full_version": "string"
},
"network_id": "string",
"health": "Health",
"status": "Status",
"security_group_ids": [
"string"
],
"service_account_id": "string",
"deletion_protection": "bool",
"maintenance_window": {
// Includes only one of the fields `anytime`, `weekly_maintenance_window`
"anytime": "AnytimeMaintenanceWindow",
"weekly_maintenance_window": {
"day": "WeekDay",
"hour": "int64"
}
// end of the list of possible fields
},
"planned_operation": {
"info": "string",
"delayed_until": "google.protobuf.Timestamp",
"latest_maintenance_time": "google.protobuf.Timestamp",
"next_maintenance_window_time": "google.protobuf.Timestamp"
},
"disk_encryption_key_id": "google.protobuf.StringValue"
}
// end of the list of possible fields
}
An Operation resource. For more information, see Operation.
|
Field |
Description |
|
id |
string ID of the operation. |
|
description |
string Description of the operation. 0-256 characters long. |
|
created_at |
Creation timestamp. |
|
created_by |
string ID of the user or service account who initiated the operation. |
|
modified_at |
The time when the Operation resource was last modified. |
|
done |
bool If the value is |
|
metadata |
Service-specific metadata associated with the operation. |
|
error |
The error result of the operation in case of failure or cancellation. Includes only one of the fields The operation result. |
|
response |
The normal response of the operation in case of success. Includes only one of the fields The operation result. |
RestoreClusterMetadata
|
Field |
Description |
|
cluster_id |
string ID of the new OpenSearch cluster being created from a backup. |
|
backup_id |
string ID of the backup being used for creating a cluster. |
Cluster
An OpenSearch cluster resource.
|
Field |
Description |
|
id |
string ID of the OpenSearch cluster. |
|
folder_id |
string ID of the folder that the OpenSearch cluster belongs to. |
|
created_at |
Time when the cluster was created. |
|
name |
string Name of the OpenSearch cluster. |
|
description |
string Description of the OpenSearch cluster. 0-256 characters long. |
|
labels |
object (map<string, string>) Custom labels for the OpenSearch cluster as |
|
environment |
enum Environment Deployment environment of the OpenSearch cluster.
|
|
monitoring[] |
Description of monitoring systems relevant to the OpenSearch cluster. |
|
config |
Configuration of the OpenSearch cluster. |
|
network_id |
string ID of the cloud network that the cluster belongs to. |
|
health |
enum Health Aggregated cluster health.
|
|
status |
enum Status Current state of the cluster.
|
|
security_group_ids[] |
string User security groups. |
|
service_account_id |
string ID of the service account used to access Object Storage. |
|
deletion_protection |
bool Determines whether the cluster is protected from being deleted. |
|
maintenance_window |
Cluster maintenance window. Should be defined by either one of the two options. |
|
planned_operation |
Maintenance operation planned at nearest |
|
disk_encryption_key_id |
ID of the key to encrypt cluster disks. |
Monitoring
Monitoring system metadata.
|
Field |
Description |
|
name |
string Name of the monitoring system. |
|
description |
string Description of the monitoring system. |
|
link |
string Link to the monitoring system charts for the OpenSearch cluster. |
ClusterConfig
The OpenSearch cluster configuration.
|
Field |
Description |
|
version |
string Version of the OpenSearch server software. |
|
opensearch |
OpenSearch configuration. |
|
dashboards |
Dashboards configuration. |
|
access |
Access policy for external services. |
|
snapshot_management |
Snapshot management configuration |
|
full_version |
string Full version |
OpenSearch
The OpenSearch host group type configuration.
|
Field |
Description |
|
plugins[] |
string Names of the cluster plugins. |
|
node_groups[] |
Host groups of the OpenSearch type. |
|
opensearch_config_set_2 |
Includes only one of the fields |
|
keystore_settings[] |
string Keystore entries names. |
NodeGroup
Configuration of the host group.
|
Field |
Description |
|
name |
string Name of the group. Must be 1-63 characters long. |
|
resources |
Resources allocated to the hosts. |
|
hosts_count |
int64 Number of hosts in the group. |
|
zone_ids[] |
string IDs of the availability zones the hosts belong to. |
|
subnet_ids[] |
string IDs of the subnets that the hosts belong to. |
|
assign_public_ip |
bool Determines whether a public IP is assigned to the hosts in the group. |
|
roles[] |
enum GroupRole Roles of the host group.
|
|
disk_size_autoscaling |
Disk size autoscaling settings |
Resources
A list of computational resources allocated to a host.
|
Field |
Description |
|
resource_preset_id |
string ID of the preset for computational resources allocated to a host. |
|
disk_size |
int64 Volume of the storage used by the host, in bytes. |
|
disk_type_id |
string Type of the storage used by the host: |
DiskSizeAutoscaling
|
Field |
Description |
|
planned_usage_threshold |
int64 Amount of used storage for automatic disk scaling in the maintenance window, 0 means disabled, in percent. Acceptable values are 0 to 100, inclusive. |
|
emergency_usage_threshold |
int64 Amount of used storage for immediately automatic disk scaling, 0 means disabled, in percent. Acceptable values are 0 to 100, inclusive. |
|
disk_size_limit |
int64 Limit on how large the storage for database instances can automatically grow, in bytes. |
OpenSearchConfigSet2
|
Field |
Description |
|
effective_config |
Required field. |
|
user_config |
|
|
default_config |
OpenSearchConfig2
|
Field |
Description |
|
max_clause_count |
the maximum number of allowed boolean clauses in a query |
|
fielddata_cache_size |
string the percentage or absolute value (10%, 512mb) of heap space that is allocated to fielddata |
|
reindex_remote_whitelist |
string |
Dashboards
The Dashboards host group type configuration.
|
Field |
Description |
|
node_groups[] |
Host groups of the Dashboards type. |
NodeGroup
|
Field |
Description |
|
name |
string Name of the group. 1-63 characters long. |
|
resources |
Resources allocated to the hosts. |
|
hosts_count |
int64 Number of hosts in the group. |
|
zone_ids[] |
string IDs of the availability zones the hosts belong to. |
|
subnet_ids[] |
string IDs of the subnets that the hosts belong to. |
|
assign_public_ip |
bool Determines whether a public IP is assigned to the hosts in the group. |
|
disk_size_autoscaling |
Disk size autoscaling settings |
Access
Access policy for external services.
|
Field |
Description |
|
data_transfer |
bool Determines whether the access to Data Transfer is allowed. |
|
serverless |
bool Determines whether the access to Serverless is allowed. |
SnapshotManagement
Snapshot management configuration
|
Field |
Description |
|
snapshot_schedule |
Snapshot creation schedule |
|
snapshot_max_age_days |
Snapshot max age in days The minimum value is 7. |
SnapshotSchedule
Snapshot creation schedule
|
Field |
Description |
|
hourly_snapshot_schedule |
Hourly based snapshot schedule Includes only one of the fields |
|
daily_snapshot_schedule |
Daily based snapshot schedule Includes only one of the fields |
|
weekly_snapshot_schedule |
Weekly based snapshot schedule Includes only one of the fields |
HourlySnapshotSchedule
Hourly based snapshot schedule
|
Field |
Description |
|
minute |
int64 The minute of the hour at which the backup should be created. Acceptable values are 0 to 59, inclusive. |
DailySnapshotSchedule
Daily based snapshot schedule
|
Field |
Description |
|
hour |
int64 The hour of the day in UTC timezone at which the backup should be created. Acceptable values are 0 to 23, inclusive. |
|
minute |
int64 The minute of the hour at which the backup should be created. Acceptable values are 0 to 59, inclusive. |
WeeklySnapshotSchedule
Weekly based snapshot schedule
|
Field |
Description |
|
day |
enum WeekDay Day of the week
|
|
hour |
int64 The hour of the day in UTC timezone at which the backup should be created. Acceptable values are 0 to 23, inclusive. |
|
minute |
int64 The minute of the hour at which the backup should be created. Acceptable values are 0 to 59, inclusive. |
MaintenanceWindow
An OpenSearch cluster maintenance window. Should be defined by either one of the two options.
|
Field |
Description |
|
anytime |
An any-time maintenance window. Includes only one of the fields |
|
weekly_maintenance_window |
A weekly maintenance window. Includes only one of the fields |
AnytimeMaintenanceWindow
An any-time maintenance window.
|
Field |
Description |
|
Empty |
|
WeeklyMaintenanceWindow
A weekly maintenance window.
|
Field |
Description |
|
day |
enum WeekDay Day of the week.
|
|
hour |
int64 Hour of the day in the UTC timezone. Acceptable values are 1 to 24, inclusive. |
MaintenanceOperation
|
Field |
Description |
|
info |
string The description of the operation. The maximum string length in characters is 256. |
|
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. |