Connection Manager API, REST: Connection.Get
- 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 request
GET https://connman.api.cloud.yandex.net/v1/connection/{connectionId}
Path parameters
Field |
Description |
connectionId |
string Required field. |
Response
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 To work with values in this field, use the APIs described in the |
updatedAt |
string (date-time) String in RFC3339 To work with values in this field, use the APIs described in the |
name |
string |
description |
string |
labels |
object (map<string, string>) |
createdBy |
string |
params |
|
lockboxSecret |
Includes only one of the fields |
isManaged |
boolean |
canUse |
boolean |
ConnectionParams
Field |
Description |
postgresql |
Includes only one of the fields |
mysql |
Includes only one of the fields |
mongodb |
Includes only one of the fields |
clickhouse |
Includes only one of the fields |
kafka |
Includes only one of the fields |
redis |
Includes only one of the fields |
opensearch |
Includes only one of the fields |
trino |
Includes only one of the fields |
valkey |
Includes only one of the fields |
greenplum |
Includes only one of the fields |
PostgreSQLConnection
Field |
Description |
cluster |
When creating/updating Connection, the field "cluster" is mutually |
managedClusterId |
string When creating/updating Connection, the field "managed_cluster_id" is |
auth |
|
databases[] |
string |
PostgreSQLCluster
Field |
Description |
hosts[] |
|
tlsParams |
Host
Field |
Description |
host |
string |
port |
string (int64) |
role |
enum (Role)
|
replicaType |
enum (ReplicaType)
|
health |
enum (Health)
|
TLSParams
Field |
Description |
tls |
Includes only one of the fields |
TLSConfig
Field |
Description |
caCertificate |
string |
PostgreSQLAuth
Field |
Description |
userPassword |
Includes only one of the fields |
UserPasswordAuth
Field |
Description |
user |
string |
password |
Password
Field |
Description |
raw |
string When creating/updating Password, the field "raw" is mutually exclusive |
passwordGenerationOptions |
When creating/updating Password, the field "password_generation_options" |
lockboxSecretKey |
string Read-only. Do not fill this field in create/update requests. Includes only one of the fields |
PasswordGenerationOptions
Field |
Description |
cookie |
string Cookie is an arbitrary non-sensitive string that is saved with the |
lockboxPasswordGenerationOptions |
LockboxPasswordGenerationOptions Includes only one of the fields |
LockboxPasswordGenerationOptions
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 |
includedPunctuation |
string If include_punctuation is true, one of these two fields (not both) may be used optionally to customize the punctuation: |
excludedPunctuation |
string a string of punctuation characters to exclude from the default |
MySQLConnection
Field |
Description |
cluster |
When creating/updating Connection, the field "cluster" is mutually |
managedClusterId |
string When creating/updating Connection, the field "managed_cluster_id" is |
auth |
|
databases[] |
string |
MySQLCluster
Field |
Description |
hosts[] |
|
tlsParams |
Host
Field |
Description |
host |
string |
port |
string (int64) |
role |
enum (Role)
|
health |
enum (Health)
|
MySQLAuth
Field |
Description |
userPassword |
Includes only one of the fields |
MongoDBConnection
Field |
Description |
cluster |
When creating/updating Connection, the field "cluster" is mutually |
managedClusterId |
string When creating/updating Connection, the field "managed_cluster_id" is |
auth |
|
databases[] |
string |
MongoDBCluster
Field |
Description |
hosts[] |
|
tlsParams |
Host
Field |
Description |
host |
string |
port |
string (int64) |
role |
enum (Role)
|
health |
enum (Health)
|
type |
enum (Type)
|
MongoDBAuth
Field |
Description |
userPassword |
Includes only one of the fields |
authSource |
string |
ClickHouseConnection
Field |
Description |
cluster |
When creating/updating Connection, the field "cluster" is mutually |
managedClusterId |
string When creating/updating Connection, the field "managed_cluster_id" is |
auth |
|
databases[] |
string |
ClickHouseCluster
Field |
Description |
tlsParams |
|
hosts[] |
|
shardGroups[] |
Host
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)
|
ShardGroup
Field |
Description |
name |
string |
shardNames[] |
string |
ClickHouseAuth
Field |
Description |
userPassword |
Includes only one of the fields |
KafkaConnection
Field |
Description |
cluster |
When creating/updating Connection, the field "cluster" is mutually |
managedClusterId |
string When creating/updating Connection, the field "managed_cluster_id" is |
auth |
KafkaCluster
Field |
Description |
hosts[] |
|
tlsParams |
Host
Field |
Description |
host |
string |
port |
string (int64) |
health |
enum (Health)
|
KafkaAuth
Field |
Description |
sasl |
Includes only one of the fields |
KafkaSaslSecurity
Field |
Description |
user |
string |
password |
|
supportedMechanisms[] |
enum (Mechanism)
|
RedisConnection
Field |
Description |
cluster |
|
auth |
|
databases[] |
string (int64) |
RedisCluster
Field |
Description |
hosts[] |
|
sentinelPort |
string (int64) |
tlsParams |
Host
Field |
Description |
host |
string |
port |
string (int64) |
role |
enum (Role)
|
health |
enum (Health)
|
shardName |
string |
RedisAuth
Field |
Description |
userPassword |
Includes only one of the fields |
UserPasswordAuth
Field |
Description |
user |
string |
password |
OpenSearchConnection
Field |
Description |
cluster |
When creating/updating Connection, the field "cluster" is mutually |
managedClusterId |
string When creating/updating Connection, the field "managed_cluster_id" is |
auth |
OpenSearchCluster
Field |
Description |
hosts[] |
|
tlsParams |
Host
Field |
Description |
host |
string |
port |
string (int64) |
health |
enum (Health)
|
roles[] |
enum (GroupRole)
|
OpenSearchAuth
Field |
Description |
userPassword |
Includes only one of the fields |
TrinoConnection
Field |
Description |
cluster |
|
auth |
TrinoCluster
Field |
Description |
coordinator |
|
tlsParams |
Coordinator
Field |
Description |
host |
string |
port |
string (int64) |
TrinoAuth
Field |
Description |
userPassword |
Includes only one of the fields |
ValkeyConnection
Field |
Description |
cluster |
When creating/updating Connection, the field "cluster" is mutually |
managedClusterId |
string When creating/updating Connection, the field "managed_cluster_id" is |
auth |
|
databases[] |
string (int64) |
ValkeyCluster
Field |
Description |
hosts[] |
|
sentinelPort |
string (int64) |
tlsParams |
Host
Field |
Description |
host |
string |
port |
string (int64) |
role |
enum (Role)
|
health |
enum (Health)
|
shardName |
string |
ValkeyAuth
Field |
Description |
userPassword |
Includes only one of the fields |
UserPasswordAuth
Field |
Description |
user |
string |
password |
GreenplumConnection
Field |
Description |
cluster |
When creating/updating Connection, the field "cluster" is mutually |
managedClusterId |
string When creating/updating Connection, the field "managed_cluster_id" is |
auth |
|
databases[] |
string |
GreenplumCluster
Field |
Description |
coordinatorHosts[] |
|
tlsParams |
Host
Field |
Description |
host |
string |
port |
string (int64) |
role |
enum (Role)
|
health |
enum (Health)
|
GreenplumAuth
Field |
Description |
userPassword |
Includes only one of the fields |
LockboxSecret
Field |
Description |
id |
string |
version |
string |
newestVersion |
string |