Managed Service for YDB API, gRPC: DatabaseService.Get
- gRPC request
- GetDatabaseRequest
- Database
- StorageConfig
- StorageOption
- ScalePolicy
- FixedScale
- ZonalDatabase
- RegionalDatabase
- DedicatedDatabase
- ServerlessDatabase
- BackupConfig
- BackupSettings
- BackupSchedule
- DailyBackupSchedule
- WeeklyBackupSchedule
- DaysOfWeekBackupSchedule
- RecurringBackupSchedule
- MonitoringConfig
- Alert
- NotificationChannel
- AlertParameter
- DoubleParameterValue
- IntegerParameterValue
- TextParameterValue
- TextListParameterValue
- LabelListParameterValue
Returns the specified database.
gRPC request
rpc Get (GetDatabaseRequest) returns (Database)
GetDatabaseRequest
{
"databaseId": "string"
}
Field |
Description |
databaseId |
string Required field. Required. ID of the YDB cluster. |
Database
{
"id": "string",
"folderId": "string",
"createdAt": "google.protobuf.Timestamp",
"name": "string",
"description": "string",
"status": "Status",
"endpoint": "string",
"resourcePresetId": "string",
"storageConfig": {
"storageOptions": [
{
"storageTypeId": "string",
"groupCount": "int64"
}
],
"storageSizeLimit": "int64"
},
"scalePolicy": {
// Includes only one of the fields `fixedScale`
"fixedScale": {
"size": "int64"
}
// end of the list of possible fields
},
"networkId": "string",
"subnetIds": [
"string"
],
// Includes only one of the fields `zonalDatabase`, `regionalDatabase`, `dedicatedDatabase`, `serverlessDatabase`
"zonalDatabase": {
"zoneId": "string"
},
"regionalDatabase": {
"regionId": "string"
},
"dedicatedDatabase": {
"resourcePresetId": "string",
"storageConfig": {
"storageOptions": [
{
"storageTypeId": "string",
"groupCount": "int64"
}
],
"storageSizeLimit": "int64"
},
"scalePolicy": {
// Includes only one of the fields `fixedScale`
"fixedScale": {
"size": "int64"
}
// end of the list of possible fields
},
"networkId": "string",
"subnetIds": [
"string"
],
"assignPublicIps": "bool"
},
"serverlessDatabase": {
"throttlingRcuLimit": "int64",
"storageSizeLimit": "int64",
"enableThrottlingRcuLimit": "bool",
"provisionedRcuLimit": "int64",
"topicWriteQuota": "int64"
},
// end of the list of possible fields
"assignPublicIps": "bool",
"locationId": "string",
"labels": "string",
"backupConfig": {
"backupSettings": [
{
"name": "string",
"description": "string",
"backupSchedule": {
// Includes only one of the fields `dailyBackupSchedule`, `weeklyBackupSchedule`, `recurringBackupSchedule`
"dailyBackupSchedule": {
"executeTime": "google.type.TimeOfDay"
},
"weeklyBackupSchedule": {
"daysOfWeek": [
{
"days": [
"DayOfWeek"
],
"executeTime": "google.type.TimeOfDay"
}
]
},
"recurringBackupSchedule": {
"startTime": "google.protobuf.Timestamp",
"recurrence": "string"
},
// end of the list of possible fields
"nextExecuteTime": "google.protobuf.Timestamp"
},
"backupTimeToLive": "google.protobuf.Duration",
"sourcePaths": [
"string"
],
"sourcePathsToExclude": [
"string"
],
"type": "Type",
"storageClass": "StorageClass"
}
]
},
"documentApiEndpoint": "string",
"kinesisApiEndpoint": "string",
"kafkaApiEndpoint": "string",
"monitoringConfig": {
"alerts": [
{
"alertId": "string",
"alertTemplateId": "string",
"name": "string",
"description": "string",
"notificationChannels": [
{
"notificationChannelId": "string",
"notifyAboutStatuses": [
"AlertEvaluationStatus"
],
"repeateNotifyDelayMs": "int64"
}
],
"alertParameters": [
{
// Includes only one of the fields `doubleParameterValue`, `integerParameterValue`, `textParameterValue`, `textListParameterValue`, `labelListParameterValue`
"doubleParameterValue": {
"name": "string",
"value": "double"
},
"integerParameterValue": {
"name": "string",
"value": "int64"
},
"textParameterValue": {
"name": "string",
"value": "string"
},
"textListParameterValue": {
"name": "string",
"values": [
"string"
]
},
"labelListParameterValue": {
"name": "string",
"values": [
"string"
]
}
// end of the list of possible fields
}
],
"alertThresholds": [
{
// Includes only one of the fields `doubleParameterValue`, `integerParameterValue`, `textParameterValue`, `textListParameterValue`, `labelListParameterValue`
"doubleParameterValue": {
"name": "string",
"value": "double"
},
"integerParameterValue": {
"name": "string",
"value": "int64"
},
"textParameterValue": {
"name": "string",
"value": "string"
},
"textListParameterValue": {
"name": "string",
"values": [
"string"
]
},
"labelListParameterValue": {
"name": "string",
"values": [
"string"
]
}
// end of the list of possible fields
}
]
}
]
},
"deletionProtection": "bool"
}
YDB database.
Field |
Description |
id |
string |
folderId |
string |
createdAt |
|
name |
string |
description |
string |
status |
enum Status
|
endpoint |
string |
resourcePresetId |
string |
storageConfig |
|
scalePolicy |
|
networkId |
string |
subnetIds[] |
string |
zonalDatabase |
deprecated field Includes only one of the fields |
regionalDatabase |
deprecated field Includes only one of the fields |
dedicatedDatabase |
Includes only one of the fields |
serverlessDatabase |
Includes only one of the fields |
assignPublicIps |
bool |
locationId |
string |
labels |
string |
backupConfig |
|
documentApiEndpoint |
string |
kinesisApiEndpoint |
string |
kafkaApiEndpoint |
string |
monitoringConfig |
|
deletionProtection |
bool |
StorageConfig
Field |
Description |
storageOptions[] |
|
storageSizeLimit |
int64 output only field: storage size limit of dedicated database. |
StorageOption
Field |
Description |
storageTypeId |
string |
groupCount |
int64 |
ScalePolicy
Field |
Description |
fixedScale |
Includes only one of the fields |
FixedScale
Field |
Description |
size |
int64 |
ZonalDatabase
Field |
Description |
zoneId |
string Required field. |
RegionalDatabase
Field |
Description |
regionId |
string Required field. |
DedicatedDatabase
Field |
Description |
resourcePresetId |
string |
storageConfig |
|
scalePolicy |
|
networkId |
string |
subnetIds[] |
string |
assignPublicIps |
bool |
ServerlessDatabase
Field |
Description |
throttlingRcuLimit |
int64 Let's define 1 RU - 1 request unit |
storageSizeLimit |
int64 Specify serverless database storage size limit. If zero, default value is applied. |
enableThrottlingRcuLimit |
bool If false, the database is throttled by cloud value. |
provisionedRcuLimit |
int64 Specify the number of provisioned RCUs to pay less if the database has predictable load. |
topicWriteQuota |
int64 write quota for topic service, defined in bytes per second. |
BackupConfig
Field |
Description |
backupSettings[] |
BackupSettings
Field |
Description |
name |
string name of backup settings |
description |
string human readable description. |
backupSchedule |
provide schedule. if empty, backup will be disabled. |
backupTimeToLive |
provide time to live of backup. |
sourcePaths[] |
string provide a list of source paths. Each path can be directory, table or even database itself. |
sourcePathsToExclude[] |
string provide a list of paths to exclude from backup. |
type |
enum Type
|
storageClass |
enum StorageClass
|
BackupSchedule
Field |
Description |
dailyBackupSchedule |
Includes only one of the fields |
weeklyBackupSchedule |
Includes only one of the fields |
recurringBackupSchedule |
Includes only one of the fields |
nextExecuteTime |
output only field: when next backup will be executed |
DailyBackupSchedule
Field |
Description |
executeTime |
Required field. |
WeeklyBackupSchedule
Field |
Description |
daysOfWeek[] |
DaysOfWeekBackupSchedule
Field |
Description |
days[] |
enum DayOfWeek
|
executeTime |
Required field. |
RecurringBackupSchedule
Field |
Description |
startTime |
Required field. Timestamp of the first recurrence. |
recurrence |
string Required field. An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how |
MonitoringConfig
Field |
Description |
alerts[] |
Alert
Field |
Description |
alertId |
string output only field. |
alertTemplateId |
string template of the alert. |
name |
string name of the alert. |
description |
string human readable description of the alert. |
notificationChannels[] |
the notification channels of the alert. |
alertParameters[] |
alert parameters to override. |
alertThresholds[] |
alert paratemers to override. |
NotificationChannel
Field |
Description |
notificationChannelId |
string |
notifyAboutStatuses[] |
enum AlertEvaluationStatus
|
repeateNotifyDelayMs |
int64 |
AlertParameter
Field |
Description |
doubleParameterValue |
Includes only one of the fields |
integerParameterValue |
Includes only one of the fields |
textParameterValue |
Includes only one of the fields |
textListParameterValue |
Includes only one of the fields |
labelListParameterValue |
Includes only one of the fields |
DoubleParameterValue
Field |
Description |
name |
string Required. Parameter name |
value |
double Required. Parameter value |
IntegerParameterValue
Field |
Description |
name |
string Required. Parameter name |
value |
int64 Required. Parameter value |
TextParameterValue
Field |
Description |
name |
string Required. Parameter name |
value |
string Required. Parameter value |
TextListParameterValue
Field |
Description |
name |
string Required. Parameter name |
values[] |
string Required. Parameter value |
LabelListParameterValue
Field |
Description |
name |
string Required. Parameter name |
values[] |
string Required. Parameter value |