googleapis/google/cloud/databasecenter/v1beta/maintenance.proto
Google APIs 9eea40c74d feat: Adding Method QueryIssues of Database Center API v1beta
docs: A comment for field `maintenance_version` in message `.google.cloud.databasecenter.v1beta.MaintenanceInfo` is changed
docs: A comment for field `filter` in message `.google.cloud.databasecenter.v1beta.QueryDatabaseResourceGroupsRequest` is changed
docs: A comment for field `order_by` in message `.google.cloud.databasecenter.v1beta.QueryDatabaseResourceGroupsRequest` is changed
docs: A comment for field `filter` in message `.google.cloud.databasecenter.v1beta.AggregateIssueStatsRequest` is changed
docs: A comment for field `filter` in message `.google.cloud.databasecenter.v1beta.AggregateFleetRequest` is changed
docs: A comment for field `order_by` in message `.google.cloud.databasecenter.v1beta.AggregateFleetRequest` is changed
docs: A comment for message `AggregateFleetResponse` is changed

PiperOrigin-RevId: 868397264
2026-02-10 17:42:46 -08:00

102 lines
3.9 KiB
Protocol Buffer

// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
syntax = "proto3";
package google.cloud.databasecenter.v1beta;
import "google/api/field_behavior.proto";
import "google/type/date.proto";
import "google/type/dayofweek.proto";
import "google/type/timeofday.proto";
option csharp_namespace = "Google.Cloud.DatabaseCenter.V1Beta";
option go_package = "cloud.google.com/go/databasecenter/apiv1beta/databasecenterpb;databasecenterpb";
option java_multiple_files = true;
option java_outer_classname = "MaintenanceProto";
option java_package = "com.google.cloud.databasecenter.v1beta";
option php_namespace = "Google\\Cloud\\DatabaseCenter\\V1beta";
option ruby_package = "Google::Cloud::DatabaseCenter::V1beta";
// Phase/Week of the maintenance window. This is to capture order of
// maintenance. For example, for Cloud SQL resources -
// https://cloud.google.com/sql/docs/mysql/maintenance.
// This enum can be extended to support DB Center specific phases for
// recommendation plan generation.
enum Phase {
// Phase is unspecified.
PHASE_UNSPECIFIED = 0;
// Week 1.
PHASE_WEEK1 = 1;
// Week 2.
PHASE_WEEK2 = 2;
// Week 5.
PHASE_WEEK5 = 3;
// Any phase.
PHASE_ANY = 4;
}
// Maintenance window for the database resource. It specifies preferred time
// and day of the week and phase in some cases, when the maintenance can start.
message ResourceMaintenanceSchedule {
// Optional. Preferred time to start the maintenance operation on the
// specified day.
google.type.TimeOfDay start_time = 1 [(google.api.field_behavior) = OPTIONAL];
// Optional. Preferred day of the week for maintenance, e.g. MONDAY, TUESDAY,
// etc.
google.type.DayOfWeek day = 2 [(google.api.field_behavior) = OPTIONAL];
// Optional. Phase of the maintenance window. This is to capture order of
// maintenance. For example, for Cloud SQL resources, this can be used to
// capture if the maintenance window is in Week1, Week2, Week5, etc. Non
// production resources are usually part of early phase.
// For more details, refer to Cloud SQL resources -
// https://cloud.google.com/sql/docs/mysql/maintenance
Phase phase = 3 [(google.api.field_behavior) = OPTIONAL];
}
// Deny maintenance period for the database resource. It specifies the time
// range during which the maintenance cannot start. This is configured by the
// customer.
message ResourceMaintenanceDenySchedule {
// Optional. The start date of the deny maintenance period.
google.type.Date start_date = 1 [(google.api.field_behavior) = OPTIONAL];
// Optional. Deny period end date.
google.type.Date end_date = 2 [(google.api.field_behavior) = OPTIONAL];
// Optional. Time in UTC when the deny period starts on start_date and ends on
// end_date.
google.type.TimeOfDay time = 3 [(google.api.field_behavior) = OPTIONAL];
}
// MaintenanceInfo to capture the maintenance details of database resource.
message MaintenanceInfo {
// Optional. Maintenance window for the database resource.
ResourceMaintenanceSchedule maintenance_schedule = 1
[(google.api.field_behavior) = OPTIONAL];
// Optional. List of Deny maintenance period for the database resource.
repeated ResourceMaintenanceDenySchedule deny_maintenance_schedules = 2
[(google.api.field_behavior) = OPTIONAL];
// Output only. Current Maintenance version of the database resource. Example:
// "MYSQL_8_0_41.R20250531.01_15"
string maintenance_version = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
}