Yandex Cloud
Search
Contact UsGet started
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML Services
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex MetaData Hub
  • About Yandex MetaData Hub
    • Getting started
    • Service roles for access management
      • API authentication
        • Overview
          • Overview
          • Get
          • ResolveCluster
          • List
          • Create
          • Update
          • Delete
          • ListOperations
  • Access management
  • Quotas and limits
  • Pricing policy
  • Public materials
  • Release notes

In this article:

  • HTTP request
  • Path parameters
  • Response
  • ConnectionParams
  • PostgreSQLConnection
  • PostgreSQLCluster
  • Host
  • TLSParams
  • TLSConfig
  • PostgreSQLAuth
  • UserPasswordAuth
  • Password
  • PasswordGenerationOptions
  • LockboxPasswordGenerationOptions
  • MySQLConnection
  • MySQLCluster
  • Host
  • MySQLAuth
  • MongoDBConnection
  • MongoDBCluster
  • Host
  • MongoDBAuth
  • ClickHouseConnection
  • ClickHouseCluster
  • Host
  • ShardGroup
  • ClickHouseAuth
  • KafkaConnection
  • KafkaCluster
  • Host
  • KafkaAuth
  • KafkaSaslSecurity
  • RedisConnection
  • RedisCluster
  • Host
  • RedisAuth
  • UserPasswordAuth
  • OpenSearchConnection
  • OpenSearchCluster
  • Host
  • OpenSearchAuth
  • TrinoConnection
  • TrinoCluster
  • Coordinator
  • TrinoAuth
  • ValkeyConnection
  • ValkeyCluster
  • Host
  • ValkeyAuth
  • UserPasswordAuth
  • GreenplumConnection
  • GreenplumCluster
  • Host
  • GreenplumAuth
  • LockboxSecret
  1. Connection Manager
  2. API reference
  3. REST
  4. Connection
  5. Get

Connection Manager API, REST: Connection.Get

Written by
Yandex Cloud
Updated at October 3, 2025
  • HTTP request
  • Path parameters
  • Response
  • ConnectionParams
  • PostgreSQLConnection
  • PostgreSQLCluster
  • Host
  • TLSParams
  • TLSConfig
  • PostgreSQLAuth
  • UserPasswordAuth
  • Password
  • PasswordGenerationOptions
  • LockboxPasswordGenerationOptions
  • MySQLConnection
  • MySQLCluster
  • Host
  • MySQLAuth
  • MongoDBConnection
  • MongoDBCluster
  • Host
  • MongoDBAuth
  • ClickHouseConnection
  • ClickHouseCluster
  • Host
  • ShardGroup
  • ClickHouseAuth
  • KafkaConnection
  • KafkaCluster
  • Host
  • KafkaAuth
  • KafkaSaslSecurity
  • RedisConnection
  • RedisCluster
  • Host
  • RedisAuth
  • UserPasswordAuth
  • OpenSearchConnection
  • OpenSearchCluster
  • Host
  • OpenSearchAuth
  • TrinoConnection
  • TrinoCluster
  • Coordinator
  • TrinoAuth
  • ValkeyConnection
  • ValkeyCluster
  • Host
  • ValkeyAuth
  • UserPasswordAuth
  • GreenplumConnection
  • GreenplumCluster
  • Host
  • GreenplumAuth
  • LockboxSecret

Returns connection.

HTTP requestHTTP request

GET https://connman.api.cloud.yandex.net/v1/connection/{connectionId}

Path parametersPath parameters

Field

Description

connectionId

string

Required field.

ResponseResponse

HTTP Code: 200 - OK

{
  "id": "string",
  "folderId": "string",
  "createdAt": "string",
  "updatedAt": "string",
  "name": "string",
  "description": "string",
  "labels": "object",
  "createdBy": "string",
  "params": {
    // Includes only one of the fields `postgresql`, `mysql`, `mongodb`, `clickhouse`, `kafka`, `redis`, `opensearch`, `trino`, `valkey`, `greenplum`
    "postgresql": {
      "cluster": {
        "hosts": [
          {
            "host": "string",
            "port": "string",
            "role": "string",
            "replicaType": "string",
            "health": "string"
          }
        ],
        "tlsParams": {
          // Includes only one of the fields `tls`
          "tls": {
            "caCertificate": "string"
          }
          // end of the list of possible fields
        }
      },
      "managedClusterId": "string",
      "auth": {
        // Includes only one of the fields `userPassword`
        "userPassword": {
          "user": "string",
          "password": {
            "raw": "string",
            "passwordGenerationOptions": {
              "cookie": "string",
              // Includes only one of the fields `lockboxPasswordGenerationOptions`
              "lockboxPasswordGenerationOptions": {
                "length": "string",
                "includeUppercase": "boolean",
                "includeLowercase": "boolean",
                "includeDigits": "boolean",
                "includePunctuation": "boolean",
                "includedPunctuation": "string",
                "excludedPunctuation": "string"
              }
              // end of the list of possible fields
            },
            // Includes only one of the fields `lockboxSecretKey`
            "lockboxSecretKey": "string"
            // end of the list of possible fields
          }
        }
        // end of the list of possible fields
      },
      "databases": [
        "string"
      ]
    },
    "mysql": {
      "cluster": {
        "hosts": [
          {
            "host": "string",
            "port": "string",
            "role": "string",
            "health": "string"
          }
        ],
        "tlsParams": {
          // Includes only one of the fields `tls`
          "tls": {
            "caCertificate": "string"
          }
          // end of the list of possible fields
        }
      },
      "managedClusterId": "string",
      "auth": {
        // Includes only one of the fields `userPassword`
        "userPassword": {
          "user": "string",
          "password": {
            "raw": "string",
            "passwordGenerationOptions": {
              "cookie": "string",
              // Includes only one of the fields `lockboxPasswordGenerationOptions`
              "lockboxPasswordGenerationOptions": {
                "length": "string",
                "includeUppercase": "boolean",
                "includeLowercase": "boolean",
                "includeDigits": "boolean",
                "includePunctuation": "boolean",
                "includedPunctuation": "string",
                "excludedPunctuation": "string"
              }
              // end of the list of possible fields
            },
            // Includes only one of the fields `lockboxSecretKey`
            "lockboxSecretKey": "string"
            // end of the list of possible fields
          }
        }
        // end of the list of possible fields
      },
      "databases": [
        "string"
      ]
    },
    "mongodb": {
      "cluster": {
        "hosts": [
          {
            "host": "string",
            "port": "string",
            "role": "string",
            "health": "string",
            "type": "string"
          }
        ],
        "tlsParams": {
          // Includes only one of the fields `tls`
          "tls": {
            "caCertificate": "string"
          }
          // end of the list of possible fields
        }
      },
      "managedClusterId": "string",
      "auth": {
        // Includes only one of the fields `userPassword`
        "userPassword": {
          "user": "string",
          "password": {
            "raw": "string",
            "passwordGenerationOptions": {
              "cookie": "string",
              // Includes only one of the fields `lockboxPasswordGenerationOptions`
              "lockboxPasswordGenerationOptions": {
                "length": "string",
                "includeUppercase": "boolean",
                "includeLowercase": "boolean",
                "includeDigits": "boolean",
                "includePunctuation": "boolean",
                "includedPunctuation": "string",
                "excludedPunctuation": "string"
              }
              // end of the list of possible fields
            },
            // Includes only one of the fields `lockboxSecretKey`
            "lockboxSecretKey": "string"
            // end of the list of possible fields
          }
        },
        // end of the list of possible fields
        "authSource": "string"
      },
      "databases": [
        "string"
      ]
    },
    "clickhouse": {
      "cluster": {
        "tlsParams": {
          // Includes only one of the fields `tls`
          "tls": {
            "caCertificate": "string"
          }
          // end of the list of possible fields
        },
        "hosts": [
          {
            "host": "string",
            "httpPort": "string",
            "tcpPort": "string",
            "shardName": "string",
            "health": "string"
          }
        ],
        "shardGroups": [
          {
            "name": "string",
            "shardNames": [
              "string"
            ]
          }
        ]
      },
      "managedClusterId": "string",
      "auth": {
        // Includes only one of the fields `userPassword`
        "userPassword": {
          "user": "string",
          "password": {
            "raw": "string",
            "passwordGenerationOptions": {
              "cookie": "string",
              // Includes only one of the fields `lockboxPasswordGenerationOptions`
              "lockboxPasswordGenerationOptions": {
                "length": "string",
                "includeUppercase": "boolean",
                "includeLowercase": "boolean",
                "includeDigits": "boolean",
                "includePunctuation": "boolean",
                "includedPunctuation": "string",
                "excludedPunctuation": "string"
              }
              // end of the list of possible fields
            },
            // Includes only one of the fields `lockboxSecretKey`
            "lockboxSecretKey": "string"
            // end of the list of possible fields
          }
        }
        // end of the list of possible fields
      },
      "databases": [
        "string"
      ]
    },
    "kafka": {
      "cluster": {
        "hosts": [
          {
            "host": "string",
            "port": "string",
            "health": "string"
          }
        ],
        "tlsParams": {
          // Includes only one of the fields `tls`
          "tls": {
            "caCertificate": "string"
          }
          // end of the list of possible fields
        }
      },
      "managedClusterId": "string",
      "auth": {
        // Includes only one of the fields `sasl`
        "sasl": {
          "user": "string",
          "password": {
            "raw": "string",
            "passwordGenerationOptions": {
              "cookie": "string",
              // Includes only one of the fields `lockboxPasswordGenerationOptions`
              "lockboxPasswordGenerationOptions": {
                "length": "string",
                "includeUppercase": "boolean",
                "includeLowercase": "boolean",
                "includeDigits": "boolean",
                "includePunctuation": "boolean",
                "includedPunctuation": "string",
                "excludedPunctuation": "string"
              }
              // end of the list of possible fields
            },
            // Includes only one of the fields `lockboxSecretKey`
            "lockboxSecretKey": "string"
            // end of the list of possible fields
          },
          "supportedMechanisms": [
            "string"
          ]
        }
        // end of the list of possible fields
      }
    },
    "redis": {
      "cluster": {
        "hosts": [
          {
            "host": "string",
            "port": "string",
            "role": "string",
            "health": "string",
            "shardName": "string"
          }
        ],
        "sentinelPort": "string",
        "tlsParams": {
          // Includes only one of the fields `tls`
          "tls": {
            "caCertificate": "string"
          }
          // end of the list of possible fields
        }
      },
      "auth": {
        // Includes only one of the fields `userPassword`
        "userPassword": {
          "user": "string",
          "password": {
            "raw": "string",
            "passwordGenerationOptions": {
              "cookie": "string",
              // Includes only one of the fields `lockboxPasswordGenerationOptions`
              "lockboxPasswordGenerationOptions": {
                "length": "string",
                "includeUppercase": "boolean",
                "includeLowercase": "boolean",
                "includeDigits": "boolean",
                "includePunctuation": "boolean",
                "includedPunctuation": "string",
                "excludedPunctuation": "string"
              }
              // end of the list of possible fields
            },
            // Includes only one of the fields `lockboxSecretKey`
            "lockboxSecretKey": "string"
            // end of the list of possible fields
          }
        }
        // end of the list of possible fields
      },
      "databases": [
        "string"
      ]
    },
    "opensearch": {
      "cluster": {
        "hosts": [
          {
            "host": "string",
            "port": "string",
            "health": "string",
            "roles": [
              "string"
            ]
          }
        ],
        "tlsParams": {
          // Includes only one of the fields `tls`
          "tls": {
            "caCertificate": "string"
          }
          // end of the list of possible fields
        }
      },
      "managedClusterId": "string",
      "auth": {
        // Includes only one of the fields `userPassword`
        "userPassword": {
          "user": "string",
          "password": {
            "raw": "string",
            "passwordGenerationOptions": {
              "cookie": "string",
              // Includes only one of the fields `lockboxPasswordGenerationOptions`
              "lockboxPasswordGenerationOptions": {
                "length": "string",
                "includeUppercase": "boolean",
                "includeLowercase": "boolean",
                "includeDigits": "boolean",
                "includePunctuation": "boolean",
                "includedPunctuation": "string",
                "excludedPunctuation": "string"
              }
              // end of the list of possible fields
            },
            // Includes only one of the fields `lockboxSecretKey`
            "lockboxSecretKey": "string"
            // end of the list of possible fields
          }
        }
        // end of the list of possible fields
      }
    },
    "trino": {
      "cluster": {
        "coordinator": {
          "host": "string",
          "port": "string"
        },
        "tlsParams": {
          // Includes only one of the fields `tls`
          "tls": {
            "caCertificate": "string"
          }
          // end of the list of possible fields
        }
      },
      "auth": {
        // Includes only one of the fields `userPassword`
        "userPassword": {
          "user": "string",
          "password": {
            "raw": "string",
            "passwordGenerationOptions": {
              "cookie": "string",
              // Includes only one of the fields `lockboxPasswordGenerationOptions`
              "lockboxPasswordGenerationOptions": {
                "length": "string",
                "includeUppercase": "boolean",
                "includeLowercase": "boolean",
                "includeDigits": "boolean",
                "includePunctuation": "boolean",
                "includedPunctuation": "string",
                "excludedPunctuation": "string"
              }
              // end of the list of possible fields
            },
            // Includes only one of the fields `lockboxSecretKey`
            "lockboxSecretKey": "string"
            // end of the list of possible fields
          }
        }
        // end of the list of possible fields
      }
    },
    "valkey": {
      "cluster": {
        "hosts": [
          {
            "host": "string",
            "port": "string",
            "role": "string",
            "health": "string",
            "shardName": "string"
          }
        ],
        "sentinelPort": "string",
        "tlsParams": {
          // Includes only one of the fields `tls`
          "tls": {
            "caCertificate": "string"
          }
          // end of the list of possible fields
        }
      },
      "managedClusterId": "string",
      "auth": {
        // Includes only one of the fields `userPassword`
        "userPassword": {
          "user": "string",
          "password": {
            "raw": "string",
            "passwordGenerationOptions": {
              "cookie": "string",
              // Includes only one of the fields `lockboxPasswordGenerationOptions`
              "lockboxPasswordGenerationOptions": {
                "length": "string",
                "includeUppercase": "boolean",
                "includeLowercase": "boolean",
                "includeDigits": "boolean",
                "includePunctuation": "boolean",
                "includedPunctuation": "string",
                "excludedPunctuation": "string"
              }
              // end of the list of possible fields
            },
            // Includes only one of the fields `lockboxSecretKey`
            "lockboxSecretKey": "string"
            // end of the list of possible fields
          }
        }
        // end of the list of possible fields
      },
      "databases": [
        "string"
      ]
    },
    "greenplum": {
      "cluster": {
        "coordinatorHosts": [
          {
            "host": "string",
            "port": "string",
            "role": "string",
            "health": "string"
          }
        ],
        "tlsParams": {
          // Includes only one of the fields `tls`
          "tls": {
            "caCertificate": "string"
          }
          // end of the list of possible fields
        }
      },
      "managedClusterId": "string",
      "auth": {
        // Includes only one of the fields `userPassword`
        "userPassword": {
          "user": "string",
          "password": {
            "raw": "string",
            "passwordGenerationOptions": {
              "cookie": "string",
              // Includes only one of the fields `lockboxPasswordGenerationOptions`
              "lockboxPasswordGenerationOptions": {
                "length": "string",
                "includeUppercase": "boolean",
                "includeLowercase": "boolean",
                "includeDigits": "boolean",
                "includePunctuation": "boolean",
                "includedPunctuation": "string",
                "excludedPunctuation": "string"
              }
              // end of the list of possible fields
            },
            // Includes only one of the fields `lockboxSecretKey`
            "lockboxSecretKey": "string"
            // end of the list of possible fields
          }
        }
        // end of the list of possible fields
      },
      "databases": [
        "string"
      ]
    }
    // end of the list of possible fields
  },
  // Includes only one of the fields `lockboxSecret`
  "lockboxSecret": {
    "id": "string",
    "version": "string",
    "newestVersion": "string"
  },
  // end of the list of possible fields
  "isManaged": "boolean",
  "canUse": "boolean"
}

Field

Description

id

string

folderId

string

createdAt

string (date-time)

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

updatedAt

string (date-time)

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

name

string

description

string

labels

object (map<string, string>)

createdBy

string

params

ConnectionParams

lockboxSecret

LockboxSecret

Includes only one of the fields lockboxSecret.

isManaged

boolean

canUse

boolean

ConnectionParamsConnectionParams

Field

Description

postgresql

PostgreSQLConnection

Includes only one of the fields postgresql, mysql, mongodb, clickhouse, kafka, redis, opensearch, trino, valkey, greenplum.

mysql

MySQLConnection

Includes only one of the fields postgresql, mysql, mongodb, clickhouse, kafka, redis, opensearch, trino, valkey, greenplum.

mongodb

MongoDBConnection

Includes only one of the fields postgresql, mysql, mongodb, clickhouse, kafka, redis, opensearch, trino, valkey, greenplum.

clickhouse

ClickHouseConnection

Includes only one of the fields postgresql, mysql, mongodb, clickhouse, kafka, redis, opensearch, trino, valkey, greenplum.

kafka

KafkaConnection

Includes only one of the fields postgresql, mysql, mongodb, clickhouse, kafka, redis, opensearch, trino, valkey, greenplum.

redis

RedisConnection

Includes only one of the fields postgresql, mysql, mongodb, clickhouse, kafka, redis, opensearch, trino, valkey, greenplum.

opensearch

OpenSearchConnection

Includes only one of the fields postgresql, mysql, mongodb, clickhouse, kafka, redis, opensearch, trino, valkey, greenplum.

trino

TrinoConnection

Includes only one of the fields postgresql, mysql, mongodb, clickhouse, kafka, redis, opensearch, trino, valkey, greenplum.

valkey

ValkeyConnection

Includes only one of the fields postgresql, mysql, mongodb, clickhouse, kafka, redis, opensearch, trino, valkey, greenplum.

greenplum

GreenplumConnection

Includes only one of the fields postgresql, mysql, mongodb, clickhouse, kafka, redis, opensearch, trino, valkey, greenplum.

PostgreSQLConnectionPostgreSQLConnection

Field

Description

cluster

PostgreSQLCluster

When creating/updating Connection, the field "cluster" is mutually
exclusive with "managed_cluster_id".

managedClusterId

string

When creating/updating Connection, the field "managed_cluster_id" is
mutually exclusive with "cluster".

auth

PostgreSQLAuth

databases[]

string

PostgreSQLClusterPostgreSQLCluster

Field

Description

hosts[]

Host

tlsParams

TLSParams

HostHost

Field

Description

host

string

port

string (int64)

role

enum (Role)

  • ROLE_UNSPECIFIED
  • MASTER
  • REPLICA

replicaType

enum (ReplicaType)

  • REPLICA_TYPE_UNSPECIFIED
  • ASYNC
  • SYNC
  • QUORUM

health

enum (Health)

  • HEALTH_UNSPECIFIED
  • ALIVE
  • DEAD
  • DEGRADED
  • READONLY

TLSParamsTLSParams

Field

Description

tls

TLSConfig

Includes only one of the fields tls.

TLSConfigTLSConfig

Field

Description

caCertificate

string

PostgreSQLAuthPostgreSQLAuth

Field

Description

userPassword

UserPasswordAuth

Includes only one of the fields userPassword.

UserPasswordAuthUserPasswordAuth

Field

Description

user

string

password

Password

PasswordPassword

Field

Description

raw

string

When creating/updating Password, the field "raw" is mutually exclusive
with "password_generation_options". In order to switch to the "raw"
password you have to explicitly clear the "password_generation_options"
field.

passwordGenerationOptions

PasswordGenerationOptions

When creating/updating Password, the field "password_generation_options"
is mutually exclusive with "raw". In order to switch to the
"password_generation_options" you have to explicitly clear the "raw"
field.

lockboxSecretKey

string

Read-only. Do not fill this field in create/update requests.

Includes only one of the fields lockboxSecretKey.

PasswordGenerationOptionsPasswordGenerationOptions

Field

Description

cookie

string

Cookie is an arbitrary non-sensitive string that is saved with the
password. When updating PasswordGenerationOptions, if the cookie passed
in the update request differs from the cookie in the current
PasswordGenerationOptions, the password will be re-generated. If the
same cookie is passed, the password will not change.

lockboxPasswordGenerationOptions

LockboxPasswordGenerationOptions

Includes only one of the fields lockboxPasswordGenerationOptions.

LockboxPasswordGenerationOptionsLockboxPasswordGenerationOptions

Field

Description

length

string (int64)

password length; by default, a reasonable length will be decided

includeUppercase

boolean

whether at least one A..Z character is included in the password, true by default

includeLowercase

boolean

whether at least one a..z character is included in the password, true by default

includeDigits

boolean

whether at least one 0..9 character is included in the password, true by default

includePunctuation

boolean

whether at least one punctuation character is included in the password, true by default
punctuation characters by default: !"#$%&'()*+,-./:;<=>?@[]^_`{|}~
to customize the punctuation characters, see included_punctuation and excluded_punctuation below

includedPunctuation

string

If include_punctuation is true, one of these two fields (not both) may be used optionally to customize the punctuation:
a string of specific punctuation characters to use

excludedPunctuation

string

a string of punctuation characters to exclude from the default

MySQLConnectionMySQLConnection

Field

Description

cluster

MySQLCluster

When creating/updating Connection, the field "cluster" is mutually
exclusive with "managed_cluster_id".

managedClusterId

string

When creating/updating Connection, the field "managed_cluster_id" is
mutually exclusive with "cluster".

auth

MySQLAuth

databases[]

string

MySQLClusterMySQLCluster

Field

Description

hosts[]

Host

tlsParams

TLSParams

HostHost

Field

Description

host

string

port

string (int64)

role

enum (Role)

  • ROLE_UNSPECIFIED
  • MASTER
  • REPLICA

health

enum (Health)

  • HEALTH_UNSPECIFIED
  • ALIVE
  • DEAD
  • DEGRADED
  • READONLY

MySQLAuthMySQLAuth

Field

Description

userPassword

UserPasswordAuth

Includes only one of the fields userPassword.

MongoDBConnectionMongoDBConnection

Field

Description

cluster

MongoDBCluster

When creating/updating Connection, the field "cluster" is mutually
exclusive with "managed_cluster_id".

managedClusterId

string

When creating/updating Connection, the field "managed_cluster_id" is
mutually exclusive with "cluster".

auth

MongoDBAuth

databases[]

string

MongoDBClusterMongoDBCluster

Field

Description

hosts[]

Host

tlsParams

TLSParams

HostHost

Field

Description

host

string

port

string (int64)

role

enum (Role)

  • ROLE_UNSPECIFIED
  • PRIMARY
  • SECONDARY

health

enum (Health)

  • HEALTH_UNSPECIFIED
  • ALIVE
  • DEAD
  • DEGRADED

type

enum (Type)

  • TYPE_UNSPECIFIED
  • MONGOD
  • MONGOS
  • MONGOINFRA

MongoDBAuthMongoDBAuth

Field

Description

userPassword

UserPasswordAuth

Includes only one of the fields userPassword.

authSource

string

ClickHouseConnectionClickHouseConnection

Field

Description

cluster

ClickHouseCluster

When creating/updating Connection, the field "cluster" is mutually
exclusive with "managed_cluster_id".

managedClusterId

string

When creating/updating Connection, the field "managed_cluster_id" is
mutually exclusive with "cluster".

auth

ClickHouseAuth

databases[]

string

ClickHouseClusterClickHouseCluster

Field

Description

tlsParams

TLSParams

hosts[]

Host

shardGroups[]

ShardGroup

HostHost

Field

Description

host

string

httpPort

string (int64)

depends on tls params may vary as http or https

tcpPort

string (int64)

shardName

string

health

enum (Health)

  • HEALTH_UNKNOWN
  • ALIVE
  • DEAD
  • DEGRADED

ShardGroupShardGroup

Field

Description

name

string

shardNames[]

string

ClickHouseAuthClickHouseAuth

Field

Description

userPassword

UserPasswordAuth

Includes only one of the fields userPassword.

KafkaConnectionKafkaConnection

Field

Description

cluster

KafkaCluster

When creating/updating Connection, the field "cluster" is mutually
exclusive with "managed_cluster_id".

managedClusterId

string

When creating/updating Connection, the field "managed_cluster_id" is
mutually exclusive with "cluster".

auth

KafkaAuth

KafkaClusterKafkaCluster

Field

Description

hosts[]

Host

tlsParams

TLSParams

HostHost

Field

Description

host

string

port

string (int64)

health

enum (Health)

  • HEALTH_UNSPECIFIED: Host is in unknown state (we have no data)
  • ALIVE: Host is alive and well (all services are alive)
  • DEAD: Host is inoperable (it cannot perform any of its essential functions)
  • DEGRADED: Host is partially alive (it can perform some of its essential functions)

KafkaAuthKafkaAuth

Field

Description

sasl

KafkaSaslSecurity

Includes only one of the fields sasl.

KafkaSaslSecurityKafkaSaslSecurity

Field

Description

user

string

password

Password

supportedMechanisms[]

enum (Mechanism)

  • MECHANISM_UNSPECIFIED
  • PLAIN
  • SCRAM_SHA256
  • SCRAM_SHA512

RedisConnectionRedisConnection

Field

Description

cluster

RedisCluster

auth

RedisAuth

databases[]

string (int64)

RedisClusterRedisCluster

Field

Description

hosts[]

Host

sentinelPort

string (int64)

tlsParams

TLSParams

HostHost

Field

Description

host

string

port

string (int64)

role

enum (Role)

  • ROLE_UNSPECIFIED
  • MASTER
  • REPLICA

health

enum (Health)

  • HEALTH_UNSPECIFIED
  • ALIVE
  • DEAD
  • DEGRADED

shardName

string

RedisAuthRedisAuth

Field

Description

userPassword

UserPasswordAuth

Includes only one of the fields userPassword.

UserPasswordAuthUserPasswordAuth

Field

Description

user

string

password

Password

OpenSearchConnectionOpenSearchConnection

Field

Description

cluster

OpenSearchCluster

When creating/updating Connection, the field "cluster" is mutually
exclusive with "managed_cluster_id".

managedClusterId

string

When creating/updating Connection, the field "managed_cluster_id" is
mutually exclusive with "cluster".

auth

OpenSearchAuth

OpenSearchClusterOpenSearchCluster

Field

Description

hosts[]

Host

tlsParams

TLSParams

HostHost

Field

Description

host

string

port

string (int64)

health

enum (Health)

  • HEALTH_UNSPECIFIED
  • ALIVE
  • DEAD
  • DEGRADED
  • READONLY

roles[]

enum (GroupRole)

  • GROUP_ROLE_UNSPECIFIED
  • DATA
  • MANAGER

OpenSearchAuthOpenSearchAuth

Field

Description

userPassword

UserPasswordAuth

Includes only one of the fields userPassword.

TrinoConnectionTrinoConnection

Field

Description

cluster

TrinoCluster

auth

TrinoAuth

TrinoClusterTrinoCluster

Field

Description

coordinator

Coordinator

tlsParams

TLSParams

CoordinatorCoordinator

Field

Description

host

string

port

string (int64)

TrinoAuthTrinoAuth

Field

Description

userPassword

UserPasswordAuth

Includes only one of the fields userPassword.

ValkeyConnectionValkeyConnection

Field

Description

cluster

ValkeyCluster

When creating/updating Connection, the field "cluster" is mutually
exclusive with "managed_cluster_id".

managedClusterId

string

When creating/updating Connection, the field "managed_cluster_id" is
mutually exclusive with "cluster".

auth

ValkeyAuth

databases[]

string (int64)

ValkeyClusterValkeyCluster

Field

Description

hosts[]

Host

sentinelPort

string (int64)

tlsParams

TLSParams

HostHost

Field

Description

host

string

port

string (int64)

role

enum (Role)

  • ROLE_UNSPECIFIED
  • MASTER
  • REPLICA

health

enum (Health)

  • HEALTH_UNSPECIFIED
  • ALIVE
  • DEAD
  • DEGRADED

shardName

string

ValkeyAuthValkeyAuth

Field

Description

userPassword

UserPasswordAuth

Includes only one of the fields userPassword.

UserPasswordAuthUserPasswordAuth

Field

Description

user

string

password

Password

GreenplumConnectionGreenplumConnection

Field

Description

cluster

GreenplumCluster

When creating/updating Connection, the field "cluster" is mutually
exclusive with "managed_cluster_id".

managedClusterId

string

When creating/updating Connection, the field "managed_cluster_id" is
mutually exclusive with "cluster".

auth

GreenplumAuth

databases[]

string

GreenplumClusterGreenplumCluster

Field

Description

coordinatorHosts[]

Host

tlsParams

TLSParams

HostHost

Field

Description

host

string

port

string (int64)

role

enum (Role)

  • ROLE_UNSPECIFIED
  • MASTER
  • REPLICA

health

enum (Health)

  • HEALTH_UNSPECIFIED
  • ALIVE
  • DEAD
  • DEGRADED
  • UNBALANCED

GreenplumAuthGreenplumAuth

Field

Description

userPassword

UserPasswordAuth

Includes only one of the fields userPassword.

LockboxSecretLockboxSecret

Field

Description

id

string

version

string

newestVersion

string

Was the article helpful?

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