Managed Service for YDB API, gRPC: DatabaseService.Update
- gRPC request
- UpdateDatabaseRequest
- StorageConfig
- StorageOption
- ScalePolicy
- FixedScale
- ZonalDatabase
- RegionalDatabase
- DedicatedDatabase
- ServerlessDatabase
- BackupConfig
- BackupSettings
- BackupSchedule
- DailyBackupSchedule
- WeeklyBackupSchedule
- DaysOfWeekBackupSchedule
- RecurringBackupSchedule
- MonitoringConfig
- Alert
- NotificationChannel
- AlertParameter
- DoubleParameterValue
- IntegerParameterValue
- TextParameterValue
- TextListParameterValue
- LabelListParameterValue
- operation.Operation
- UpdateDatabaseMetadata
- 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
Modifies the specified database.
gRPC request
rpc Update (UpdateDatabaseRequest) returns (operation.Operation)
UpdateDatabaseRequest
{
"folderId": "string",
"updateMask": "google.protobuf.FieldMask",
"databaseId": "string",
"name": "string",
"description": "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"
}
]
},
"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"
}
Field |
Description |
folderId |
string |
updateMask |
|
databaseId |
string |
name |
string |
description |
string |
resourcePresetId |
string |
storageConfig |
|
scalePolicy |
|
networkId |
string |
subnetIds[] |
string |
zonalDatabase |
Includes only one of the fields |
regionalDatabase |
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 |
|
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 |
operation.Operation
{
"id": "string",
"description": "string",
"createdAt": "google.protobuf.Timestamp",
"createdBy": "string",
"modifiedAt": "google.protobuf.Timestamp",
"done": "bool",
"metadata": {
"databaseId": "string",
"databaseName": "string"
},
// Includes only one of the fields `error`, `response`
"error": "google.rpc.Status",
"response": {
"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"
}
// end of the list of possible fields
}
An Operation resource. For more information, see Operation.
Field |
Description |
id |
string ID of the operation. |
description |
string Description of the operation. 0-256 characters long. |
createdAt |
Creation timestamp. |
createdBy |
string ID of the user or service account who initiated the operation. |
modifiedAt |
The time when the Operation resource was last modified. |
done |
bool If the value is |
metadata |
Service-specific metadata associated with the operation. |
error |
The error result of the operation in case of failure or cancellation. Includes only one of the fields The operation result. |
response |
The normal response of the operation in case of success. Includes only one of the fields The operation result. |
UpdateDatabaseMetadata
Field |
Description |
databaseId |
string |
databaseName |
string |
Database
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 |