Yandex.Cloud
  • Services
  • Why Yandex.Cloud
  • Solutions
  • Pricing
  • Documentation
  • Contact us
Get started
Yandex Managed Service for Elasticsearch
  • Getting started
  • Step-by-step instructions
    • All instructions
    • Information about existing clusters
    • Creating clusters
    • Connecting to clusters
    • Stopping and starting clusters
    • Changing cluster settings
    • Managing Elasticsearch hosts
    • Managing Elasticsearch users
    • Deleting a cluster
  • Concepts
    • Relationship between service resources
    • Host roles
    • Elasticsearch editions
    • Indexes
    • Search using Elasticsearch
    • Host classes
    • Managed Service for Elasticsearch
    • Quotas and limits
    • Storage types
    • Sharding and replication
    • Elasticsearch plugins
  • Access management
  • Pricing policy
  • API reference
    • API authentication
    • gRPC
      • Overview
      • ClusterService
      • ResourcePresetService
      • UserService
      • OperationService
    • REST
      • Overview
      • Cluster
        • Overview
        • addHosts
        • create
        • delete
        • deleteHosts
        • get
        • list
        • listHosts
        • listLogs
        • listOperations
        • move
        • start
        • stop
        • streamLogs
        • update
      • ResourcePreset
        • Overview
        • get
        • list
      • User
        • Overview
        • create
        • delete
        • get
        • list
        • update
      • Operation
        • Overview
        • get
  • Questions and answers
  1. API reference
  2. gRPC
  3. ClusterService

ClusterService

  • Calls ClusterService
  • Get
    • GetClusterRequest
    • Cluster
    • Monitoring
    • ClusterConfig
    • Elasticsearch
    • DataNode
    • MasterNode
  • List
    • ListClustersRequest
    • ListClustersResponse
    • Cluster
    • Monitoring
    • ClusterConfig
    • Elasticsearch
    • DataNode
    • MasterNode
  • Create
    • CreateClusterRequest
    • ConfigSpec
    • ElasticsearchSpec
    • DataNode
    • MasterNode
    • UserSpec
    • HostSpec
    • Operation
    • CreateClusterMetadata
    • Cluster
    • Monitoring
    • ClusterConfig
    • Elasticsearch
    • DataNode
    • MasterNode
  • Update
    • UpdateClusterRequest
    • ConfigSpec
    • ElasticsearchSpec
    • DataNode
    • MasterNode
    • Operation
    • UpdateClusterMetadata
    • Cluster
    • Monitoring
    • ClusterConfig
    • Elasticsearch
    • DataNode
    • MasterNode
  • Delete
    • DeleteClusterRequest
    • Operation
    • DeleteClusterMetadata
  • Move
    • MoveClusterRequest
    • Operation
    • MoveClusterMetadata
    • Cluster
    • Monitoring
    • ClusterConfig
    • Elasticsearch
    • DataNode
    • MasterNode
  • Start
    • StartClusterRequest
    • Operation
    • StartClusterMetadata
    • Cluster
    • Monitoring
    • ClusterConfig
    • Elasticsearch
    • DataNode
    • MasterNode
  • Stop
    • StopClusterRequest
    • Operation
    • StopClusterMetadata
    • Cluster
    • Monitoring
    • ClusterConfig
    • Elasticsearch
    • DataNode
    • MasterNode
  • ListLogs
    • ListClusterLogsRequest
    • ListClusterLogsResponse
    • LogRecord
  • StreamLogs
    • StreamClusterLogsRequest
    • StreamLogRecord
    • LogRecord
  • ListOperations
    • ListClusterOperationsRequest
    • ListClusterOperationsResponse
    • Operation
  • ListHosts
    • ListClusterHostsRequest
    • ListClusterHostsResponse
    • Host
    • Resources
    • Service
  • AddHosts
    • AddClusterHostsRequest
    • HostSpec
    • Operation
    • AddClusterHostsMetadata
  • DeleteHosts
    • DeleteClusterHostsRequest
    • Operation
    • DeleteClusterHostsMetadata

A set of methods for managing Elasticsearch clusters.

Call Description
Get Returns the specified Elasticsearch cluster.
List Retrieves the list of Elasticsearch clusters that belong to the specified folder.
Create Creates a new Elasticsearch cluster in the specified folder.
Update Updates the specified Elasticsearch cluster.
Delete Deletes the specified Elasticsearch cluster.
Move Moves the specified Elasticsearch cluster to the specified folder.
Start Starts the specified Elasticsearch cluster.
Stop Stops the specified Elasticsearch cluster.
ListLogs Retrieves logs for the specified Elasticsearch cluster.
StreamLogs Same as ListLogs but using server-side streaming.
ListOperations Retrieves the list of operations for the specified Elasticsearch cluster.
ListHosts Retrieves a list of hosts for the specified Elasticsearch cluster.
AddHosts Adds new hosts to the specified Elasticsearch cluster.
DeleteHosts Deletes specified hosts from the specified Elasticsearch cluster.

Calls ClusterService

Get

Returns the specified Elasticsearch cluster.
To get the list of available Elasticsearch clusters, make a List request.

rpc Get (GetClusterRequest) returns (Cluster)

GetClusterRequest

Field Description
cluster_id string
Required. ID of the Elasticsearch cluster to return.
To get the cluster ID, make a ClusterService.List request. The maximum string length in characters is 50.

Cluster

Field Description
id string
ID of the Elasticsearch cluster. This ID is assigned at creation time.
folder_id string
ID of the folder that the Elasticsearch cluster belongs to.
created_at google.protobuf.Timestamp
Creation timestamp.
name string
Name of the Elasticsearch cluster. The name must be unique within the folder. 1-63 characters long.
description string
Description of the Elasticsearch cluster. 0-256 characters long.
labels map<string,string>
Custom labels for the Elasticsearch cluster as key:value pairs. A maximum of 64 labels per resource is allowed.
environment enum Environment
Deployment environment of the Elasticsearch cluster.
  • PRODUCTION: stable environment with a conservative update policy when only hotfixes are applied during regular maintenance.
  • PRESTABLE: environment with a more aggressive update policy when new versions are rolled out irrespective of backward compatibility.
    monitoring[] Monitoring
    Description of monitoring systems relevant to the Elasticsearch cluster.
    config ClusterConfig
    Configuration of the Elasticsearch cluster.
    network_id string
    ID of the network that the cluster belongs to.
    health enum Health
    Aggregated cluster health.
    • HEALTH_UNKNOWN: state of the cluster is unknown (Host.health of all hosts in the cluster is UNKNOWN).
    • ALIVE: cluster is alive and well (Host.health of all hosts in the cluster is ALIVE).
    • DEAD: cluster is inoperable (Host.health of all hosts in the cluster is DEAD).
    • DEGRADED: cluster is in degraded state (Host.health of at least one of the hosts in the cluster is not ALIVE).
      status enum Status
      Current state of the cluster.
      • STATUS_UNKNOWN: cluster state is unknown.
      • CREATING: cluster is being created.
      • RUNNING: cluster is running normally.
      • ERROR: cluster encountered a problem and cannot operate.
      • UPDATING: cluster is being updated.
      • STOPPING: cluster is stopping.
      • STOPPED: cluster stopped.
      • STARTING: cluster is starting.
        security_group_ids[] string
        User security groups

        Monitoring

        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 Elasticsearch
        Configuration and resource allocation for Elasticsearch nodes.

        Elasticsearch

        Field Description
        data_node DataNode
        Configuration and resource allocation for Elasticsearch data nodes.
        master_node MasterNode
        Configuration and resource allocation for Elasticsearch master nodes.

        DataNode

        Field Description
        config oneof: elasticsearch_config_set_7
          elasticsearch_config_set_7 config.ElasticsearchConfigSet7
        Elasticsearch 7.x data node configuration.
        resources Resources
        Resources allocated to Elasticsearch data nodes.

        MasterNode

        Field Description
        resources Resources
        Resources allocated to Elasticsearch master nodes.

        List

        Retrieves the list of Elasticsearch clusters that belong to the specified folder.

        rpc List (ListClustersRequest) returns (ListClustersResponse)

        ListClustersRequest

        Field Description
        folder_id string
        Required. ID of the folder to list Elasticsearch clusters in.
        To get the folder ID, make a yandex.cloud.resourcemanager.v1.FolderService.List request. The maximum string length in characters is 50.
        page_size int64
        The maximum number of results per page to return. If the number of available results is larger than page_size, the service returns a ListClustersResponse.next_page_token that can be used to get the next page of results in subsequent list requests. The maximum value is 1000.
        page_token string
        Page token. To get the next page of results, set page_token to the ListClustersResponse.next_page_token returned by a previous list request. The maximum string length in characters is 100.
        filter string
        1. The field name to filter by. Currently you can only use filtering with the Cluster.name field.
        2. An operator. Can be either = or != for single values, IN or NOT IN for lists of values.
        3. The value. Мust be 1-63 characters long and match the regular expression ^[a-zA-Z0-9_-]+$.
        The maximum string length in characters is 1000.

        ListClustersResponse

        Field Description
        clusters[] Cluster
        List of Elasticsearch clusters.
        next_page_token string
        Token that allows you to get the next page of results for list requests.
        If the number of results is larger than ListClustersRequest.page_size, use next_page_token as the value for the ListClustersRequest.page_token parameter in the next list request. Each subsequent list request will have its own next_page_token to continue paging through the results.

        Cluster

        Field Description
        id string
        ID of the Elasticsearch cluster. This ID is assigned at creation time.
        folder_id string
        ID of the folder that the Elasticsearch cluster belongs to.
        created_at google.protobuf.Timestamp
        Creation timestamp.
        name string
        Name of the Elasticsearch cluster. The name must be unique within the folder. 1-63 characters long.
        description string
        Description of the Elasticsearch cluster. 0-256 characters long.
        labels map<string,string>
        Custom labels for the Elasticsearch cluster as key:value pairs. A maximum of 64 labels per resource is allowed.
        environment enum Environment
        Deployment environment of the Elasticsearch cluster.
        • PRODUCTION: stable environment with a conservative update policy when only hotfixes are applied during regular maintenance.
        • PRESTABLE: environment with a more aggressive update policy when new versions are rolled out irrespective of backward compatibility.
          monitoring[] Monitoring
          Description of monitoring systems relevant to the Elasticsearch cluster.
          config ClusterConfig
          Configuration of the Elasticsearch cluster.
          network_id string
          ID of the network that the cluster belongs to.
          health enum Health
          Aggregated cluster health.
          • HEALTH_UNKNOWN: state of the cluster is unknown (Host.health of all hosts in the cluster is UNKNOWN).
          • ALIVE: cluster is alive and well (Host.health of all hosts in the cluster is ALIVE).
          • DEAD: cluster is inoperable (Host.health of all hosts in the cluster is DEAD).
          • DEGRADED: cluster is in degraded state (Host.health of at least one of the hosts in the cluster is not ALIVE).
            status enum Status
            Current state of the cluster.
            • STATUS_UNKNOWN: cluster state is unknown.
            • CREATING: cluster is being created.
            • RUNNING: cluster is running normally.
            • ERROR: cluster encountered a problem and cannot operate.
            • UPDATING: cluster is being updated.
            • STOPPING: cluster is stopping.
            • STOPPED: cluster stopped.
            • STARTING: cluster is starting.
              security_group_ids[] string
              User security groups

              Monitoring

              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 Elasticsearch
              Configuration and resource allocation for Elasticsearch nodes.

              Elasticsearch

              Field Description
              data_node DataNode
              Configuration and resource allocation for Elasticsearch data nodes.
              master_node MasterNode
              Configuration and resource allocation for Elasticsearch master nodes.

              DataNode

              Field Description
              config oneof: elasticsearch_config_set_7
                elasticsearch_config_set_7 config.ElasticsearchConfigSet7
              Elasticsearch 7.x data node configuration.
              resources Resources
              Resources allocated to Elasticsearch data nodes.

              MasterNode

              Field Description
              resources Resources
              Resources allocated to Elasticsearch master nodes.

              Create

              Creates a new Elasticsearch cluster in the specified folder.

              rpc Create (CreateClusterRequest) returns (operation.Operation)

              Metadata and response of Operation:

                  Operation.metadata:CreateClusterMetadata

                  Operation.response:Cluster

              CreateClusterRequest

              Field Description
              folder_id string
              Required. ID of the folder to create the Elasticsearch cluster in. The maximum string length in characters is 50.
              name string
              Required. Name of the Elasticsearch cluster. The name must be unique within the folder. The maximum string length in characters is 63. Value must match the regular expression [a-zA-Z0-9_-]*.
              description string
              Description of the Elasticsearch cluster. The maximum string length in characters is 256.
              labels map<string,string>
              Custom labels for the Elasticsearch cluster as key:value pairs.
              For example, "project": "mvp" or "source": "dictionary". No more than 64 per resource. The maximum string length in characters for each value is 63. Each value must match the regular expression [-_0-9a-z]*. The string length in characters for each key must be 1-63. Each key must match the regular expression [a-z][-_0-9a-z]*.
              environment Cluster.Environment
              Deployment environment of the Elasticsearch cluster.
              config_spec ConfigSpec
              Required. Elasticsearch and hosts configuration for the cluster.
              user_specs[] UserSpec
              One or more descriptions of users to be created in Elasticsearch cluster. The number of elements must be greater than 0.
              host_specs[] HostSpec
              One or more configurations of hosts to be created in the Elasticsearch cluster. The number of elements must be greater than 0.
              network_id string
              Required. ID of the network to create the Elasticsearch cluster in. The maximum string length in characters is 50.
              security_group_ids[] string
              User security groups

              ConfigSpec

              Field Description
              version string
              Elasticsearch version.
              elasticsearch_spec ElasticsearchSpec
              Configuration and resource allocation for Elasticsearch nodes.

              ElasticsearchSpec

              Field Description
              data_node DataNode
              Configuration and resource allocation for Elasticsearch data nodes.
              master_node MasterNode
              Configuration and resource allocation for Elasticsearch master nodes.

              DataNode

              Field Description
              config oneof: elasticsearch_config_7
              Elasticsearch data node configuration.
                elasticsearch_config_7 config.ElasticsearchConfig7
              Elasticsearch data node configuration.
              resources Resources
              Resources allocated to Elasticsearch data nodes.

              MasterNode

              Field Description
              resources Resources
              Resources allocated to Elasticsearch master nodes.

              UserSpec

              Field Description
              name string
              Required. Name of the Elasticsearch user. The maximum string length in characters is 63. Value must match the regular expression [a-zA-Z0-9_]*.
              password string
              Required. Password of the Elasticsearch user. The string length in characters must be 8-128.

              HostSpec

              Field Description
              zone_id string
              ID of the availability zone where the host resides. The maximum string length in characters is 50.
              subnet_id string
              ID of the subnet the host resides in. The maximum string length in characters is 50.
              assign_public_ip bool
              The flag that defines whether a public IP address is assigned to the host.
              If the value is true, then this host is available on the Internet via it's public IP address.
              type Host.Type
              Required. Host type.
              shard_name string
              The shard name to create on the host. The maximum string length in characters is 63. Value must match the regular expression [a-zA-Z0-9_-]*.

              Operation

              Field Description
              id string
              ID of the operation.
              description string
              Description of the operation. 0-256 characters long.
              created_at google.protobuf.Timestamp
              Creation timestamp.
              created_by string
              ID of the user or service account who initiated the operation.
              modified_at google.protobuf.Timestamp
              The time when the Operation resource was last modified.
              done bool
              If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
              metadata google.protobuf.Any<CreateClusterMetadata>
              Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
              result oneof: error or response
              The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
                error google.rpc.Status
              The error result of the operation in case of failure or cancellation.
                response google.protobuf.Any<Cluster>
              if operation finished successfully.

              CreateClusterMetadata

              Field Description
              cluster_id string
              ID of the Elasticsearch cluster that is being created.

              Cluster

              Field Description
              id string
              ID of the Elasticsearch cluster. This ID is assigned at creation time.
              folder_id string
              ID of the folder that the Elasticsearch cluster belongs to.
              created_at google.protobuf.Timestamp
              Creation timestamp.
              name string
              Name of the Elasticsearch cluster. The name must be unique within the folder. 1-63 characters long.
              description string
              Description of the Elasticsearch cluster. 0-256 characters long.
              labels map<string,string>
              Custom labels for the Elasticsearch cluster as key:value pairs. A maximum of 64 labels per resource is allowed.
              environment enum Environment
              Deployment environment of the Elasticsearch cluster.
              • PRODUCTION: stable environment with a conservative update policy when only hotfixes are applied during regular maintenance.
              • PRESTABLE: environment with a more aggressive update policy when new versions are rolled out irrespective of backward compatibility.
                monitoring[] Monitoring
                Description of monitoring systems relevant to the Elasticsearch cluster.
                config ClusterConfig
                Configuration of the Elasticsearch cluster.
                network_id string
                ID of the network that the cluster belongs to.
                health enum Health
                Aggregated cluster health.
                • HEALTH_UNKNOWN: state of the cluster is unknown (Host.health of all hosts in the cluster is UNKNOWN).
                • ALIVE: cluster is alive and well (Host.health of all hosts in the cluster is ALIVE).
                • DEAD: cluster is inoperable (Host.health of all hosts in the cluster is DEAD).
                • DEGRADED: cluster is in degraded state (Host.health of at least one of the hosts in the cluster is not ALIVE).
                  status enum Status
                  Current state of the cluster.
                  • STATUS_UNKNOWN: cluster state is unknown.
                  • CREATING: cluster is being created.
                  • RUNNING: cluster is running normally.
                  • ERROR: cluster encountered a problem and cannot operate.
                  • UPDATING: cluster is being updated.
                  • STOPPING: cluster is stopping.
                  • STOPPED: cluster stopped.
                  • STARTING: cluster is starting.
                    security_group_ids[] string
                    User security groups

                    Monitoring

                    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 Elasticsearch
                    Configuration and resource allocation for Elasticsearch nodes.

                    Elasticsearch

                    Field Description
                    data_node DataNode
                    Configuration and resource allocation for Elasticsearch data nodes.
                    master_node MasterNode
                    Configuration and resource allocation for Elasticsearch master nodes.

                    DataNode

                    Field Description
                    config oneof: elasticsearch_config_set_7
                      elasticsearch_config_set_7 config.ElasticsearchConfigSet7
                    Elasticsearch 7.x data node configuration.
                    resources Resources
                    Resources allocated to Elasticsearch data nodes.

                    MasterNode

                    Field Description
                    resources Resources
                    Resources allocated to Elasticsearch master nodes.

                    Update

                    Updates the specified Elasticsearch cluster.

                    rpc Update (UpdateClusterRequest) returns (operation.Operation)

                    Metadata and response of Operation:

                        Operation.metadata:UpdateClusterMetadata

                        Operation.response:Cluster

                    UpdateClusterRequest

                    Field Description
                    cluster_id string
                    Required. ID of the Elasticsearch cluster to update.
                    To get the Elasticsearch cluster ID, make a ClusterService.List request. The maximum string length in characters is 50.
                    update_mask google.protobuf.FieldMask
                    description string
                    New description of the Elasticsearch cluster. The maximum string length in characters is 256.
                    labels map<string,string>
                    Custom labels for the Elasticsearch cluster as key:value pairs.
                    For example, "project": "mvp" or "source": "dictionary".
                    The new set of labels will completely replace the old ones. To add a label, request the current set with the ClusterService.Get method, then send an ClusterService.Update request with the new label added to the set. No more than 64 per resource. The maximum string length in characters for each value is 63. Each value must match the regular expression [-_0-9a-z]*. The string length in characters for each key must be 1-63. Each key must match the regular expression [a-z][-_0-9a-z]*.
                    config_spec ConfigSpec
                    New configuration and resources for hosts in the Elasticsearch cluster.
                    Use update_mask to prevent reverting all cluster settings that are not listed in config_spec to their default values.
                    name string
                    New name for the Elasticsearch cluster. The maximum string length in characters is 63. Value must match the regular expression [a-zA-Z0-9_-]*.
                    security_group_ids[] string
                    User security groups

                    ConfigSpec

                    Field Description
                    version string
                    Elasticsearch version.
                    elasticsearch_spec ElasticsearchSpec
                    Configuration and resource allocation for Elasticsearch nodes.

                    ElasticsearchSpec

                    Field Description
                    data_node DataNode
                    Configuration and resource allocation for Elasticsearch data nodes.
                    master_node MasterNode
                    Configuration and resource allocation for Elasticsearch master nodes.

                    DataNode

                    Field Description
                    config oneof: elasticsearch_config_7
                    Elasticsearch data node configuration.
                      elasticsearch_config_7 config.ElasticsearchConfig7
                    Elasticsearch data node configuration.
                    resources Resources
                    Resources allocated to Elasticsearch data nodes.

                    MasterNode

                    Field Description
                    resources Resources
                    Resources allocated to Elasticsearch master nodes.

                    Operation

                    Field Description
                    id string
                    ID of the operation.
                    description string
                    Description of the operation. 0-256 characters long.
                    created_at google.protobuf.Timestamp
                    Creation timestamp.
                    created_by string
                    ID of the user or service account who initiated the operation.
                    modified_at google.protobuf.Timestamp
                    The time when the Operation resource was last modified.
                    done bool
                    If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
                    metadata google.protobuf.Any<UpdateClusterMetadata>
                    Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
                    result oneof: error or response
                    The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
                      error google.rpc.Status
                    The error result of the operation in case of failure or cancellation.
                      response google.protobuf.Any<Cluster>
                    if operation finished successfully.

                    UpdateClusterMetadata

                    Field Description
                    cluster_id string
                    ID of the Elasticsearch cluster that is being updated.

                    Cluster

                    Field Description
                    id string
                    ID of the Elasticsearch cluster. This ID is assigned at creation time.
                    folder_id string
                    ID of the folder that the Elasticsearch cluster belongs to.
                    created_at google.protobuf.Timestamp
                    Creation timestamp.
                    name string
                    Name of the Elasticsearch cluster. The name must be unique within the folder. 1-63 characters long.
                    description string
                    Description of the Elasticsearch cluster. 0-256 characters long.
                    labels map<string,string>
                    Custom labels for the Elasticsearch cluster as key:value pairs. A maximum of 64 labels per resource is allowed.
                    environment enum Environment
                    Deployment environment of the Elasticsearch cluster.
                    • PRODUCTION: stable environment with a conservative update policy when only hotfixes are applied during regular maintenance.
                    • PRESTABLE: environment with a more aggressive update policy when new versions are rolled out irrespective of backward compatibility.
                      monitoring[] Monitoring
                      Description of monitoring systems relevant to the Elasticsearch cluster.
                      config ClusterConfig
                      Configuration of the Elasticsearch cluster.
                      network_id string
                      ID of the network that the cluster belongs to.
                      health enum Health
                      Aggregated cluster health.
                      • HEALTH_UNKNOWN: state of the cluster is unknown (Host.health of all hosts in the cluster is UNKNOWN).
                      • ALIVE: cluster is alive and well (Host.health of all hosts in the cluster is ALIVE).
                      • DEAD: cluster is inoperable (Host.health of all hosts in the cluster is DEAD).
                      • DEGRADED: cluster is in degraded state (Host.health of at least one of the hosts in the cluster is not ALIVE).
                        status enum Status
                        Current state of the cluster.
                        • STATUS_UNKNOWN: cluster state is unknown.
                        • CREATING: cluster is being created.
                        • RUNNING: cluster is running normally.
                        • ERROR: cluster encountered a problem and cannot operate.
                        • UPDATING: cluster is being updated.
                        • STOPPING: cluster is stopping.
                        • STOPPED: cluster stopped.
                        • STARTING: cluster is starting.
                          security_group_ids[] string
                          User security groups

                          Monitoring

                          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 Elasticsearch
                          Configuration and resource allocation for Elasticsearch nodes.

                          Elasticsearch

                          Field Description
                          data_node DataNode
                          Configuration and resource allocation for Elasticsearch data nodes.
                          master_node MasterNode
                          Configuration and resource allocation for Elasticsearch master nodes.

                          DataNode

                          Field Description
                          config oneof: elasticsearch_config_set_7
                            elasticsearch_config_set_7 config.ElasticsearchConfigSet7
                          Elasticsearch 7.x data node configuration.
                          resources Resources
                          Resources allocated to Elasticsearch data nodes.

                          MasterNode

                          Field Description
                          resources Resources
                          Resources allocated to Elasticsearch master nodes.

                          Delete

                          Deletes the specified Elasticsearch cluster.

                          rpc Delete (DeleteClusterRequest) returns (operation.Operation)

                          Metadata and response of Operation:

                              Operation.metadata:DeleteClusterMetadata

                              Operation.response:google.protobuf.Empty

                          DeleteClusterRequest

                          Field Description
                          cluster_id string
                          Required. ID of the Elasticsearch cluster to delete.
                          To get the Elasticsearch cluster ID, make a ClusterService.List request. The maximum string length in characters is 50.

                          Operation

                          Field Description
                          id string
                          ID of the operation.
                          description string
                          Description of the operation. 0-256 characters long.
                          created_at google.protobuf.Timestamp
                          Creation timestamp.
                          created_by string
                          ID of the user or service account who initiated the operation.
                          modified_at google.protobuf.Timestamp
                          The time when the Operation resource was last modified.
                          done bool
                          If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
                          metadata google.protobuf.Any<DeleteClusterMetadata>
                          Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
                          result oneof: error or response
                          The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
                            error google.rpc.Status
                          The error result of the operation in case of failure or cancellation.
                            response google.protobuf.Any<google.protobuf.Empty>
                          if operation finished successfully.

                          DeleteClusterMetadata

                          Field Description
                          cluster_id string
                          ID of the Elasticsearch cluster that is being deleted.

                          Move

                          Moves the specified Elasticsearch cluster to the specified folder.

                          rpc Move (MoveClusterRequest) returns (operation.Operation)

                          Metadata and response of Operation:

                              Operation.metadata:MoveClusterMetadata

                              Operation.response:Cluster

                          MoveClusterRequest

                          Field Description
                          cluster_id string
                          Required. ID of the Elasticsearch cluster to move.
                          To get the Elasticsearch cluster ID, make a ClusterService.List request. The maximum string length in characters is 50.
                          destination_folder_id string
                          Required. ID of the destination folder. The maximum string length in characters is 50.

                          Operation

                          Field Description
                          id string
                          ID of the operation.
                          description string
                          Description of the operation. 0-256 characters long.
                          created_at google.protobuf.Timestamp
                          Creation timestamp.
                          created_by string
                          ID of the user or service account who initiated the operation.
                          modified_at google.protobuf.Timestamp
                          The time when the Operation resource was last modified.
                          done bool
                          If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
                          metadata google.protobuf.Any<MoveClusterMetadata>
                          Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
                          result oneof: error or response
                          The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
                            error google.rpc.Status
                          The error result of the operation in case of failure or cancellation.
                            response google.protobuf.Any<Cluster>
                          if operation finished successfully.

                          MoveClusterMetadata

                          Field Description
                          cluster_id string
                          ID of the Elasticsearch cluster being moved.
                          source_folder_id string
                          ID of the source folder.
                          destination_folder_id string
                          ID of the destination folder.

                          Cluster

                          Field Description
                          id string
                          ID of the Elasticsearch cluster. This ID is assigned at creation time.
                          folder_id string
                          ID of the folder that the Elasticsearch cluster belongs to.
                          created_at google.protobuf.Timestamp
                          Creation timestamp.
                          name string
                          Name of the Elasticsearch cluster. The name must be unique within the folder. 1-63 characters long.
                          description string
                          Description of the Elasticsearch cluster. 0-256 characters long.
                          labels map<string,string>
                          Custom labels for the Elasticsearch cluster as key:value pairs. A maximum of 64 labels per resource is allowed.
                          environment enum Environment
                          Deployment environment of the Elasticsearch cluster.
                          • PRODUCTION: stable environment with a conservative update policy when only hotfixes are applied during regular maintenance.
                          • PRESTABLE: environment with a more aggressive update policy when new versions are rolled out irrespective of backward compatibility.
                            monitoring[] Monitoring
                            Description of monitoring systems relevant to the Elasticsearch cluster.
                            config ClusterConfig
                            Configuration of the Elasticsearch cluster.
                            network_id string
                            ID of the network that the cluster belongs to.
                            health enum Health
                            Aggregated cluster health.
                            • HEALTH_UNKNOWN: state of the cluster is unknown (Host.health of all hosts in the cluster is UNKNOWN).
                            • ALIVE: cluster is alive and well (Host.health of all hosts in the cluster is ALIVE).
                            • DEAD: cluster is inoperable (Host.health of all hosts in the cluster is DEAD).
                            • DEGRADED: cluster is in degraded state (Host.health of at least one of the hosts in the cluster is not ALIVE).
                              status enum Status
                              Current state of the cluster.
                              • STATUS_UNKNOWN: cluster state is unknown.
                              • CREATING: cluster is being created.
                              • RUNNING: cluster is running normally.
                              • ERROR: cluster encountered a problem and cannot operate.
                              • UPDATING: cluster is being updated.
                              • STOPPING: cluster is stopping.
                              • STOPPED: cluster stopped.
                              • STARTING: cluster is starting.
                                security_group_ids[] string
                                User security groups

                                Monitoring

                                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 Elasticsearch
                                Configuration and resource allocation for Elasticsearch nodes.

                                Elasticsearch

                                Field Description
                                data_node DataNode
                                Configuration and resource allocation for Elasticsearch data nodes.
                                master_node MasterNode
                                Configuration and resource allocation for Elasticsearch master nodes.

                                DataNode

                                Field Description
                                config oneof: elasticsearch_config_set_7
                                  elasticsearch_config_set_7 config.ElasticsearchConfigSet7
                                Elasticsearch 7.x data node configuration.
                                resources Resources
                                Resources allocated to Elasticsearch data nodes.

                                MasterNode

                                Field Description
                                resources Resources
                                Resources allocated to Elasticsearch master nodes.

                                Start

                                Starts the specified Elasticsearch cluster.

                                rpc Start (StartClusterRequest) returns (operation.Operation)

                                Metadata and response of Operation:

                                    Operation.metadata:StartClusterMetadata

                                    Operation.response:Cluster

                                StartClusterRequest

                                Field Description
                                cluster_id string
                                Required. ID of the Elasticsearch cluster to start.
                                To get the Elasticsearch cluster ID, make a ClusterService.List request. The maximum string length in characters is 50.

                                Operation

                                Field Description
                                id string
                                ID of the operation.
                                description string
                                Description of the operation. 0-256 characters long.
                                created_at google.protobuf.Timestamp
                                Creation timestamp.
                                created_by string
                                ID of the user or service account who initiated the operation.
                                modified_at google.protobuf.Timestamp
                                The time when the Operation resource was last modified.
                                done bool
                                If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
                                metadata google.protobuf.Any<StartClusterMetadata>
                                Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
                                result oneof: error or response
                                The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
                                  error google.rpc.Status
                                The error result of the operation in case of failure or cancellation.
                                  response google.protobuf.Any<Cluster>
                                if operation finished successfully.

                                StartClusterMetadata

                                Field Description
                                cluster_id string
                                ID of the Elasticsearch cluster.

                                Cluster

                                Field Description
                                id string
                                ID of the Elasticsearch cluster. This ID is assigned at creation time.
                                folder_id string
                                ID of the folder that the Elasticsearch cluster belongs to.
                                created_at google.protobuf.Timestamp
                                Creation timestamp.
                                name string
                                Name of the Elasticsearch cluster. The name must be unique within the folder. 1-63 characters long.
                                description string
                                Description of the Elasticsearch cluster. 0-256 characters long.
                                labels map<string,string>
                                Custom labels for the Elasticsearch cluster as key:value pairs. A maximum of 64 labels per resource is allowed.
                                environment enum Environment
                                Deployment environment of the Elasticsearch cluster.
                                • PRODUCTION: stable environment with a conservative update policy when only hotfixes are applied during regular maintenance.
                                • PRESTABLE: environment with a more aggressive update policy when new versions are rolled out irrespective of backward compatibility.
                                  monitoring[] Monitoring
                                  Description of monitoring systems relevant to the Elasticsearch cluster.
                                  config ClusterConfig
                                  Configuration of the Elasticsearch cluster.
                                  network_id string
                                  ID of the network that the cluster belongs to.
                                  health enum Health
                                  Aggregated cluster health.
                                  • HEALTH_UNKNOWN: state of the cluster is unknown (Host.health of all hosts in the cluster is UNKNOWN).
                                  • ALIVE: cluster is alive and well (Host.health of all hosts in the cluster is ALIVE).
                                  • DEAD: cluster is inoperable (Host.health of all hosts in the cluster is DEAD).
                                  • DEGRADED: cluster is in degraded state (Host.health of at least one of the hosts in the cluster is not ALIVE).
                                    status enum Status
                                    Current state of the cluster.
                                    • STATUS_UNKNOWN: cluster state is unknown.
                                    • CREATING: cluster is being created.
                                    • RUNNING: cluster is running normally.
                                    • ERROR: cluster encountered a problem and cannot operate.
                                    • UPDATING: cluster is being updated.
                                    • STOPPING: cluster is stopping.
                                    • STOPPED: cluster stopped.
                                    • STARTING: cluster is starting.
                                      security_group_ids[] string
                                      User security groups

                                      Monitoring

                                      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 Elasticsearch
                                      Configuration and resource allocation for Elasticsearch nodes.

                                      Elasticsearch

                                      Field Description
                                      data_node DataNode
                                      Configuration and resource allocation for Elasticsearch data nodes.
                                      master_node MasterNode
                                      Configuration and resource allocation for Elasticsearch master nodes.

                                      DataNode

                                      Field Description
                                      config oneof: elasticsearch_config_set_7
                                        elasticsearch_config_set_7 config.ElasticsearchConfigSet7
                                      Elasticsearch 7.x data node configuration.
                                      resources Resources
                                      Resources allocated to Elasticsearch data nodes.

                                      MasterNode

                                      Field Description
                                      resources Resources
                                      Resources allocated to Elasticsearch master nodes.

                                      Stop

                                      Stops the specified Elasticsearch cluster.

                                      rpc Stop (StopClusterRequest) returns (operation.Operation)

                                      Metadata and response of Operation:

                                          Operation.metadata:StopClusterMetadata

                                          Operation.response:Cluster

                                      StopClusterRequest

                                      Field Description
                                      cluster_id string
                                      Required. ID of the Elasticsearch cluster to stop.
                                      To get the Elasticsearch cluster ID, make a ClusterService.List request. The maximum string length in characters is 50.

                                      Operation

                                      Field Description
                                      id string
                                      ID of the operation.
                                      description string
                                      Description of the operation. 0-256 characters long.
                                      created_at google.protobuf.Timestamp
                                      Creation timestamp.
                                      created_by string
                                      ID of the user or service account who initiated the operation.
                                      modified_at google.protobuf.Timestamp
                                      The time when the Operation resource was last modified.
                                      done bool
                                      If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
                                      metadata google.protobuf.Any<StopClusterMetadata>
                                      Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
                                      result oneof: error or response
                                      The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
                                        error google.rpc.Status
                                      The error result of the operation in case of failure or cancellation.
                                        response google.protobuf.Any<Cluster>
                                      if operation finished successfully.

                                      StopClusterMetadata

                                      Field Description
                                      cluster_id string
                                      ID of the Elasticsearch cluster.

                                      Cluster

                                      Field Description
                                      id string
                                      ID of the Elasticsearch cluster. This ID is assigned at creation time.
                                      folder_id string
                                      ID of the folder that the Elasticsearch cluster belongs to.
                                      created_at google.protobuf.Timestamp
                                      Creation timestamp.
                                      name string
                                      Name of the Elasticsearch cluster. The name must be unique within the folder. 1-63 characters long.
                                      description string
                                      Description of the Elasticsearch cluster. 0-256 characters long.
                                      labels map<string,string>
                                      Custom labels for the Elasticsearch cluster as key:value pairs. A maximum of 64 labels per resource is allowed.
                                      environment enum Environment
                                      Deployment environment of the Elasticsearch cluster.
                                      • PRODUCTION: stable environment with a conservative update policy when only hotfixes are applied during regular maintenance.
                                      • PRESTABLE: environment with a more aggressive update policy when new versions are rolled out irrespective of backward compatibility.
                                        monitoring[] Monitoring
                                        Description of monitoring systems relevant to the Elasticsearch cluster.
                                        config ClusterConfig
                                        Configuration of the Elasticsearch cluster.
                                        network_id string
                                        ID of the network that the cluster belongs to.
                                        health enum Health
                                        Aggregated cluster health.
                                        • HEALTH_UNKNOWN: state of the cluster is unknown (Host.health of all hosts in the cluster is UNKNOWN).
                                        • ALIVE: cluster is alive and well (Host.health of all hosts in the cluster is ALIVE).
                                        • DEAD: cluster is inoperable (Host.health of all hosts in the cluster is DEAD).
                                        • DEGRADED: cluster is in degraded state (Host.health of at least one of the hosts in the cluster is not ALIVE).
                                          status enum Status
                                          Current state of the cluster.
                                          • STATUS_UNKNOWN: cluster state is unknown.
                                          • CREATING: cluster is being created.
                                          • RUNNING: cluster is running normally.
                                          • ERROR: cluster encountered a problem and cannot operate.
                                          • UPDATING: cluster is being updated.
                                          • STOPPING: cluster is stopping.
                                          • STOPPED: cluster stopped.
                                          • STARTING: cluster is starting.
                                            security_group_ids[] string
                                            User security groups

                                            Monitoring

                                            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 Elasticsearch
                                            Configuration and resource allocation for Elasticsearch nodes.

                                            Elasticsearch

                                            Field Description
                                            data_node DataNode
                                            Configuration and resource allocation for Elasticsearch data nodes.
                                            master_node MasterNode
                                            Configuration and resource allocation for Elasticsearch master nodes.

                                            DataNode

                                            Field Description
                                            config oneof: elasticsearch_config_set_7
                                              elasticsearch_config_set_7 config.ElasticsearchConfigSet7
                                            Elasticsearch 7.x data node configuration.
                                            resources Resources
                                            Resources allocated to Elasticsearch data nodes.

                                            MasterNode

                                            Field Description
                                            resources Resources
                                            Resources allocated to Elasticsearch master nodes.

                                            ListLogs

                                            Retrieves logs for the specified Elasticsearch cluster.
                                            For more information about logs, see the Logs section in the documentation.

                                            rpc ListLogs (ListClusterLogsRequest) returns (ListClusterLogsResponse)

                                            ListClusterLogsRequest

                                            Field Description
                                            cluster_id string
                                            Required. ID of the Elasticsearch cluster to request logs for.
                                            To get the Elasticsearch cluster ID, make a ClusterService.List request. The maximum string length in characters is 50.
                                            column_filter[] string
                                            Columns from the logs table to request.
                                            If no columns are specified, full log records are returned.
                                            from_time google.protobuf.Timestamp
                                            Start timestamp for the logs request.
                                            to_time google.protobuf.Timestamp
                                            End timestamp for the logs request.
                                            page_size int64
                                            The maximum number of results per page to return.
                                            If the number of available results is larger than page_size, the service returns a ListClusterLogsResponse.next_page_token that can be used to get the next page of results in subsequent list requests. The maximum value is 1000.
                                            page_token string
                                            Page token.
                                            To get the next page of results, set page_token to the ListClusterLogsResponse.next_page_token returned by a previous list request. The maximum string length in characters is 100.
                                            always_next_page_token bool
                                            The flag that defines behavior of providing the next page token.
                                            If this flag is set to true, this API method will always return ListClusterLogsResponse.next_page_token, even if current page is empty.
                                            filter string
                                            1. The field name to filter by. Currently filtering can be applied to the hostname field.
                                            2. A conditional operator. Can be either = or != for single values, IN or NOT IN for lists of values.
                                            3. The value. Must be 1-63 characters long and match the regular expression ^[a-z0-9.-]{1,61}$.
                                            The maximum string length in characters is 1000.

                                            ListClusterLogsResponse

                                            Field Description
                                            logs[] LogRecord
                                            Requested log records.
                                            next_page_token string
                                            Token that allows you to get the next page of results for list requests.
                                            If the number of results is larger than ListClusterLogsRequest.page_size, use next_page_token as the value for the ListClusterLogsRequest.page_token query parameter in the next list request. Each subsequent list request will have its own next_page_token to continue paging through the results.
                                            This value is interchangeable with StreamLogRecord.next_record_token from StreamLogs method.

                                            LogRecord

                                            Field Description
                                            timestamp google.protobuf.Timestamp
                                            Log record timestamp.
                                            message map<string,string>
                                            Contents of the log record.

                                            StreamLogs

                                            Same as ListLogs but using server-side streaming. Also supports tail -f semantics.

                                            rpc StreamLogs (StreamClusterLogsRequest) returns (stream StreamLogRecord)

                                            StreamClusterLogsRequest

                                            Field Description
                                            cluster_id string
                                            Required. ID of the Elasticsearch cluster.
                                            To get the Elasticsearch cluster ID, make a ClusterService.List request. The maximum string length in characters is 50.
                                            column_filter[] string
                                            Columns from logs table to get in the response.
                                            If no columns are specified, full log records are returned.
                                            from_time google.protobuf.Timestamp
                                            Start timestamp for the logs request.
                                            to_time google.protobuf.Timestamp
                                            End timestamp for the logs request.
                                            If this field is not set, all existing logs will be sent and then the new ones asthey appear. In essence it has tail -f semantics.
                                            record_token string
                                            Record token.
                                            Set record_token to the StreamLogRecord.next_record_token returned by a previous ClusterService.StreamLogs request to start streaming from next log record. The maximum string length in characters is 100.
                                            filter string
                                            1. The field name to filter by. Currently filtering can be applied to the hostname field.
                                            2. A conditional operator. Can be either = or != for single values, IN or NOT IN for lists of values.
                                            3. The value. Must be 3-63 characters long and match the regular expression ^[a-z][-a-z0-9]{1,61}[a-z0-9]$.
                                            The maximum string length in characters is 1000.

                                            StreamLogRecord

                                            Field Description
                                            record LogRecord
                                            One of the requested log records.
                                            next_record_token string
                                            This token allows you to continue streaming logs starting from the exact same record.
                                            To continue streaming, specify value of next_record_token as value for StreamClusterLogsRequest.record_token parameter in the next StreamLogs request.
                                            This value is interchangeable with ListClusterLogsResponse.next_page_token from ListLogs method.

                                            LogRecord

                                            Field Description
                                            timestamp google.protobuf.Timestamp
                                            Log record timestamp.
                                            message map<string,string>
                                            Contents of the log record.

                                            ListOperations

                                            Retrieves the list of operations for the specified Elasticsearch cluster.

                                            rpc ListOperations (ListClusterOperationsRequest) returns (ListClusterOperationsResponse)

                                            ListClusterOperationsRequest

                                            Field Description
                                            cluster_id string
                                            Required. ID of the Elasticsearch cluster to list operations for.
                                            To get the Elasticsearch cluster ID, make a ClusterService.List request. The maximum string length in characters is 50.
                                            page_size int64
                                            The maximum number of results per page to return.
                                            If the number of available results is larger than page_size, the service returns a ListClusterOperationsResponse.next_page_token that can be used to get the next page of results in subsequent list requests. The maximum value is 1000.
                                            page_token string
                                            Page token.
                                            To get the next page of results, set page_token to the ListClusterOperationsResponse.next_page_token returned by a previous list request. The maximum string length in characters is 100.

                                            ListClusterOperationsResponse

                                            Field Description
                                            operations[] operation.Operation
                                            List of operations for the specified Elasticsearch cluster.
                                            next_page_token string
                                            Token that allows you to get the next page of results for list requests.
                                            If the number of results is larger than ListClusterOperationsRequest.page_size, use the next_page_token as the value for the ListClusterOperationsRequest.page_token query parameter in the next list request. Each subsequent list request will have its own next_page_token to continue paging through the results.

                                            Operation

                                            Field Description
                                            id string
                                            ID of the operation.
                                            description string
                                            Description of the operation. 0-256 characters long.
                                            created_at google.protobuf.Timestamp
                                            Creation timestamp.
                                            created_by string
                                            ID of the user or service account who initiated the operation.
                                            modified_at google.protobuf.Timestamp
                                            The time when the Operation resource was last modified.
                                            done bool
                                            If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
                                            metadata google.protobuf.Any
                                            Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
                                            result oneof: error or response
                                            The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
                                              error google.rpc.Status
                                            The error result of the operation in case of failure or cancellation.
                                              response google.protobuf.Any
                                            The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is the standard Create/Update, the response should be the target resource of the operation. Any method that returns a long-running operation should document the response type, if any.

                                            ListHosts

                                            Retrieves a list of hosts for the specified Elasticsearch cluster.

                                            rpc ListHosts (ListClusterHostsRequest) returns (ListClusterHostsResponse)

                                            ListClusterHostsRequest

                                            Field Description
                                            cluster_id string
                                            Required. ID of the Elasticsearch cluster.
                                            To get the Elasticsearch cluster ID, make a ClusterService.List request. The maximum string length in characters is 50.
                                            page_size int64
                                            The maximum number of results per page to return.
                                            If the number of available results is larger than page_size, the service returns a ListClusterHostsResponse.next_page_token that can be used to get the next page of results in subsequent list requests. The maximum value is 1000.
                                            page_token string
                                            Page token.
                                            To get the next page of results, set page_token to the ListClusterHostsResponse.next_page_token returned by a previous list request. The maximum string length in characters is 100.

                                            ListClusterHostsResponse

                                            Field Description
                                            hosts[] Host
                                            List of hosts.
                                            next_page_token string
                                            Token that allows you to get the next page of results for list requests.
                                            If the number of results is larger than ListClusterHostsRequest.page_size, use the next_page_token as the value for the ListClusterHostsRequest.page_token query parameter in the next list request. Each subsequent list request will have its own next_page_token to continue paging through the results.

                                            Host

                                            Field Description
                                            name string
                                            Name of the host.
                                            cluster_id string
                                            ID of the Elasticsearch cluster.
                                            zone_id string
                                            ID of the availability zone where the host resides.
                                            type enum Type
                                            Host type.
                                            • DATA_NODE: the host is an Elasticsearch data node.
                                            • MASTER_NODE: the host is an Elasticsearch master node.
                                              resources Resources
                                              health enum Health
                                              Aggregated host health data.
                                              • UNKNOWN: health of the host is unknown.
                                              • ALIVE: the host is performing all its functions normally.
                                              • DEAD: the host is inoperable and cannot perform any of its essential functions.
                                              • DEGRADED: the host is degraded and can perform only some of its essential functions.
                                                services[] Service
                                                Services provided by the host.
                                                subnet_id string
                                                ID of the subnet the host resides in.
                                                assign_public_ip bool
                                                The flag that defines whether a public IP address is assigned to the host.
                                                If the value is true, then this host is available on the Internet via it's public IP address.

                                                Resources

                                                Field Description
                                                resource_preset_id string
                                                ID of the preset for computational resources available to a host (CPU, memory etc.). All available presets are listed in the documentation.
                                                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. All available types are listed in the documentation.

                                                Service

                                                Field Description
                                                type enum Type
                                                Type of the service provided by the host.
                                                • ELASTICSEARCH: the Elasticsearch service.
                                                  health enum Health
                                                  Service health data.
                                                  • UNKNOWN: health of the service is unknown.
                                                  • ALIVE: the service is working normally.
                                                  • DEAD: the service is dead or unresponsive.

                                                    AddHosts

                                                    Adds new hosts to the specified Elasticsearch cluster.

                                                    rpc AddHosts (AddClusterHostsRequest) returns (operation.Operation)

                                                    Metadata and response of Operation:

                                                        Operation.metadata:AddClusterHostsMetadata

                                                        Operation.response:google.protobuf.Empty

                                                    AddClusterHostsRequest

                                                    Field Description
                                                    cluster_id string
                                                    Required. ID of the Elasticsearch cluster.
                                                    To get the Elasticsearch cluster ID, make a ClusterService.List request. The maximum string length in characters is 50.
                                                    host_specs[] HostSpec
                                                    One or more configurations of hosts to be added to the Elasticsearch cluster. The number of elements must be greater than 0.

                                                    HostSpec

                                                    Field Description
                                                    zone_id string
                                                    ID of the availability zone where the host resides. The maximum string length in characters is 50.
                                                    subnet_id string
                                                    ID of the subnet the host resides in. The maximum string length in characters is 50.
                                                    assign_public_ip bool
                                                    The flag that defines whether a public IP address is assigned to the host.
                                                    If the value is true, then this host is available on the Internet via it's public IP address.
                                                    type Host.Type
                                                    Required. Host type.
                                                    shard_name string
                                                    The shard name to create on the host. The maximum string length in characters is 63. Value must match the regular expression [a-zA-Z0-9_-]*.

                                                    Operation

                                                    Field Description
                                                    id string
                                                    ID of the operation.
                                                    description string
                                                    Description of the operation. 0-256 characters long.
                                                    created_at google.protobuf.Timestamp
                                                    Creation timestamp.
                                                    created_by string
                                                    ID of the user or service account who initiated the operation.
                                                    modified_at google.protobuf.Timestamp
                                                    The time when the Operation resource was last modified.
                                                    done bool
                                                    If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
                                                    metadata google.protobuf.Any<AddClusterHostsMetadata>
                                                    Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
                                                    result oneof: error or response
                                                    The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
                                                      error google.rpc.Status
                                                    The error result of the operation in case of failure or cancellation.
                                                      response google.protobuf.Any<google.protobuf.Empty>
                                                    if operation finished successfully.

                                                    AddClusterHostsMetadata

                                                    Field Description
                                                    cluster_id string
                                                    ID of the Elasticsearch cluster.
                                                    host_names[] string
                                                    Names of the host that are being added.

                                                    DeleteHosts

                                                    Deletes specified hosts from the specified Elasticsearch cluster.

                                                    rpc DeleteHosts (DeleteClusterHostsRequest) returns (operation.Operation)

                                                    Metadata and response of Operation:

                                                        Operation.metadata:DeleteClusterHostsMetadata

                                                        Operation.response:google.protobuf.Empty

                                                    DeleteClusterHostsRequest

                                                    Field Description
                                                    cluster_id string
                                                    Required. ID of the Elasticsearch cluster.
                                                    To get the Elasticsearch cluster ID, make a ClusterService.List request. The maximum string length in characters is 50.
                                                    host_names[] string
                                                    Names of the hosts to delete. The number of elements must be greater than 0. The maximum string length in characters for each value is 253.

                                                    Operation

                                                    Field Description
                                                    id string
                                                    ID of the operation.
                                                    description string
                                                    Description of the operation. 0-256 characters long.
                                                    created_at google.protobuf.Timestamp
                                                    Creation timestamp.
                                                    created_by string
                                                    ID of the user or service account who initiated the operation.
                                                    modified_at google.protobuf.Timestamp
                                                    The time when the Operation resource was last modified.
                                                    done bool
                                                    If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
                                                    metadata google.protobuf.Any<DeleteClusterHostsMetadata>
                                                    Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
                                                    result oneof: error or response
                                                    The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
                                                      error google.rpc.Status
                                                    The error result of the operation in case of failure or cancellation.
                                                      response google.protobuf.Any<google.protobuf.Empty>
                                                    if operation finished successfully.

                                                    DeleteClusterHostsMetadata

                                                    Field Description
                                                    cluster_id string
                                                    ID of the Elasticsearch cluster.
                                                    host_names[] string
                                                    Names of the hosts that are being deleted.
                                                    In this article:
                                                    • Calls ClusterService
                                                    • Get
                                                    • GetClusterRequest
                                                    • Cluster
                                                    • Monitoring
                                                    • ClusterConfig
                                                    • Elasticsearch
                                                    • DataNode
                                                    • MasterNode
                                                    • List
                                                    • ListClustersRequest
                                                    • ListClustersResponse
                                                    • Cluster
                                                    • Monitoring
                                                    • ClusterConfig
                                                    • Elasticsearch
                                                    • DataNode
                                                    • MasterNode
                                                    • Create
                                                    • CreateClusterRequest
                                                    • ConfigSpec
                                                    • ElasticsearchSpec
                                                    • DataNode
                                                    • MasterNode
                                                    • UserSpec
                                                    • HostSpec
                                                    • Operation
                                                    • CreateClusterMetadata
                                                    • Cluster
                                                    • Monitoring
                                                    • ClusterConfig
                                                    • Elasticsearch
                                                    • DataNode
                                                    • MasterNode
                                                    • Update
                                                    • UpdateClusterRequest
                                                    • ConfigSpec
                                                    • ElasticsearchSpec
                                                    • DataNode
                                                    • MasterNode
                                                    • Operation
                                                    • UpdateClusterMetadata
                                                    • Cluster
                                                    • Monitoring
                                                    • ClusterConfig
                                                    • Elasticsearch
                                                    • DataNode
                                                    • MasterNode
                                                    • Delete
                                                    • DeleteClusterRequest
                                                    • Operation
                                                    • DeleteClusterMetadata
                                                    • Move
                                                    • MoveClusterRequest
                                                    • Operation
                                                    • MoveClusterMetadata
                                                    • Cluster
                                                    • Monitoring
                                                    • ClusterConfig
                                                    • Elasticsearch
                                                    • DataNode
                                                    • MasterNode
                                                    • Start
                                                    • StartClusterRequest
                                                    • Operation
                                                    • StartClusterMetadata
                                                    • Cluster
                                                    • Monitoring
                                                    • ClusterConfig
                                                    • Elasticsearch
                                                    • DataNode
                                                    • MasterNode
                                                    • Stop
                                                    • StopClusterRequest
                                                    • Operation
                                                    • StopClusterMetadata
                                                    • Cluster
                                                    • Monitoring
                                                    • ClusterConfig
                                                    • Elasticsearch
                                                    • DataNode
                                                    • MasterNode
                                                    • ListLogs
                                                    • ListClusterLogsRequest
                                                    • ListClusterLogsResponse
                                                    • LogRecord
                                                    • StreamLogs
                                                    • StreamClusterLogsRequest
                                                    • StreamLogRecord
                                                    • LogRecord
                                                    • ListOperations
                                                    • ListClusterOperationsRequest
                                                    • ListClusterOperationsResponse
                                                    • Operation
                                                    • ListHosts
                                                    • ListClusterHostsRequest
                                                    • ListClusterHostsResponse
                                                    • Host
                                                    • Resources
                                                    • Service
                                                    • AddHosts
                                                    • AddClusterHostsRequest
                                                    • HostSpec
                                                    • Operation
                                                    • AddClusterHostsMetadata
                                                    • DeleteHosts
                                                    • DeleteClusterHostsRequest
                                                    • Operation
                                                    • DeleteClusterHostsMetadata
                                                    Language / Region
                                                    Careers
                                                    Privacy policy
                                                    Terms of use
                                                    Brandbook
                                                    © 2021 Yandex.Cloud LLC