Managed Service for Elasticsearch API, gRPC: ClusterService.Stop
Stops the specified Elasticsearch cluster.
gRPC request
rpc Stop (StopClusterRequest) returns (operation.Operation)
StopClusterRequest
{
"cluster_id": "string"
}
Field |
Description |
cluster_id |
string Required field. ID of the Elasticsearch cluster to stop. To get the Elasticsearch cluster ID, make a ClusterService.List request. |
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"
},
// 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",
"elasticsearch": {
"data_node": {
// Includes only one of the fields `elasticsearch_config_set_7`
"elasticsearch_config_set_7": {
"effective_config": {
"max_clause_count": "google.protobuf.Int64Value",
"fielddata_cache_size": "string",
"reindex_remote_whitelist": "string",
"reindex_ssl_ca_path": "string"
},
"user_config": {
"max_clause_count": "google.protobuf.Int64Value",
"fielddata_cache_size": "string",
"reindex_remote_whitelist": "string",
"reindex_ssl_ca_path": "string"
},
"default_config": {
"max_clause_count": "google.protobuf.Int64Value",
"fielddata_cache_size": "string",
"reindex_remote_whitelist": "string",
"reindex_ssl_ca_path": "string"
}
},
// end of the list of possible fields
"resources": {
"resource_preset_id": "string",
"disk_size": "int64",
"disk_type_id": "string"
}
},
"master_node": {
"resources": {
"resource_preset_id": "string",
"disk_size": "int64",
"disk_type_id": "string"
}
},
"plugins": [
"string"
]
},
"edition": "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"
}
}
// 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. |
StopClusterMetadata
Field |
Description |
cluster_id |
string ID of the Elasticsearch cluster. |
Cluster
An Elasticsearch cluster resource.
For more information, see the Concepts section of the documentation.
Field |
Description |
id |
string ID of the Elasticsearch cluster. |
folder_id |
string ID of the folder that the Elasticsearch cluster belongs to. |
created_at |
Creation timestamp. |
name |
string Name of the Elasticsearch cluster. |
description |
string Description of the Elasticsearch cluster. 0-256 characters long. |
labels |
object (map<string, string>) Custom labels for the Elasticsearch cluster as |
environment |
enum Environment Deployment environment of the Elasticsearch cluster.
|
monitoring[] |
Description of monitoring systems relevant to the Elasticsearch cluster. |
config |
Configuration of the Elasticsearch cluster. |
network_id |
string ID of the 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 for access to Object Storage. |
deletion_protection |
bool Deletion Protection inhibits deletion of the cluster |
maintenance_window |
Window of maintenance operations. |
planned_operation |
Maintenance operation planned at nearest maintenance_window. |
Monitoring
Metadata of monitoring system.
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 Elasticsearch cluster. |
ClusterConfig
Field |
Description |
version |
string Elasticsearch version. |
elasticsearch |
Configuration and resource allocation for Elasticsearch nodes. |
edition |
string ElasticSearch edition. |
Elasticsearch
Field |
Description |
data_node |
Configuration and resource allocation for Elasticsearch data nodes. |
master_node |
Configuration and resource allocation for Elasticsearch master nodes. |
plugins[] |
string Cluster wide plugins |
DataNode
Field |
Description |
elasticsearch_config_set_7 |
Elasticsearch 7.x data node configuration. Includes only one of the fields |
resources |
Resources allocated to Elasticsearch data nodes. |
ElasticsearchConfigSet7
Elasticsearch 7.x data node configuration.
Field |
Description |
effective_config |
Required field. Effective settings for an Elasticsearch cluster (a combination of settings defined in |
user_config |
User-defined settings for an Elasticsearch cluster. |
default_config |
Default settings for an Elasticsearch cluster. |
ElasticsearchConfig7
Elasticsearch 7.x supported configuration options are listed here.
Detailed description for each set of options is available in Elasticsearch documentation
Any options that are not listed here are not supported.
Field |
Description |
max_clause_count |
The maximum number of clauses a boolean query can contain. The limit is in place to prevent searches from becoming too large and taking up too much CPU and memory. Default value: See in-depth description in Elasticsearch documentation |
fielddata_cache_size |
string The maximum percentage or absolute value (10%, 512mb) of heap space that is allocated to field data cache. All the field values that are placed in this cache, get loaded to memory in order to provide fast document based access to those values. Default value: unbounded. See in-depth description in Elasticsearch documentation |
reindex_remote_whitelist |
string Remote hosts for reindex have to be explicitly allowed in elasticsearch.yml using the reindex.remote.whitelist property. |
reindex_ssl_ca_path |
string List of paths to PEM encoded certificate files that should be trusted. See in-depth description in Elasticsearch documentation |
Resources
Computational resources.
Field |
Description |
resource_preset_id |
string ID of the preset for computational resources available to a host (CPU, memory etc.). |
disk_size |
int64 Volume of the storage available to a host, in bytes. |
disk_type_id |
string Type of the storage environment for the host. |
MasterNode
Field |
Description |
resources |
Resources allocated to Elasticsearch master nodes. |
MaintenanceWindow
Field |
Description |
anytime |
Includes only one of the fields |
weekly_maintenance_window |
Includes only one of the fields |
AnytimeMaintenanceWindow
Field |
Description |
Empty |
WeeklyMaintenanceWindow
Field |
Description |
day |
enum WeekDay
|
hour |
int64 Hour of the day in UTC. |
MaintenanceOperation
Field |
Description |
info |
string |
delayed_until |