feat: Instance.ActivationPolicy field

Google APIs · copybara-github · commit 1a096dccca53 · 2025-06-17T17:36:48.000-07:00
feat: Cluster.DenyMaintenancePeriod field
feat: InstanceNetworkConfig.network output field
feat: InstanceNetworkConfig.allocated_ip_range_override field
feat: Backup.create_completion_time output field
docs: A comment for field `earliest_restorable_time`
docs: A comment for field `status` in message `PscAutoConnectionConfig`

PiperOrigin-RevId: 772688974
diff --git a/google/cloud/alloydb/v1/BUILD.bazel b/google/cloud/alloydb/v1/BUILD.bazel
@@ -38,6 +38,7 @@ proto_library(
         "//google/api:resource_proto",
         "//google/longrunning:operations_proto",
         "//google/rpc:status_proto",
+        "//google/type:date_proto",
         "//google/type:dayofweek_proto",
         "//google/type:timeofday_proto",
         "@com_google_protobuf//:duration_proto",
@@ -146,6 +147,7 @@ go_grpc_library(
         "//google/api:annotations_go_proto",
         "//google/longrunning:longrunning_go_proto",
         "//google/rpc:status_go_proto",
+        "//google/type:date_go_proto",
         "//google/type:dayofweek_go_proto",
         "//google/type:timeofday_go_proto",
     ],
diff --git a/google/cloud/alloydb/v1/resources.proto b/google/cloud/alloydb/v1/resources.proto
@@ -23,6 +23,7 @@ import "google/cloud/alloydb/v1/csql_resources.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
 import "google/protobuf/wrappers.proto";
+import "google/type/date.proto";
 import "google/type/dayofweek.proto";
 import "google/type/timeofday.proto";
 
@@ -354,13 +355,20 @@ message ContinuousBackupInfo {
   google.protobuf.Timestamp enabled_time = 2
       [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Output only. Days of the week on which a continuous backup is taken. Output
-  // only field. Ignored if passed into the request.
+  // Output only. Days of the week on which a continuous backup is taken.
   repeated google.type.DayOfWeek schedule = 3
       [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Output only. The earliest restorable time that can be restored to. Output
-  // only field.
+  // Output only. The earliest restorable time that can be restored to. If
+  // continuous backups and recovery was recently enabled, the earliest
+  // restorable time is the creation time of the earliest eligible backup within
+  // this cluster's continuous backup recovery window. After a cluster has had
+  // continuous backups enabled for the duration of its recovery window, the
+  // earliest restorable time becomes "now minus the recovery window". For
+  // example, assuming a point in time recovery is attempted at 04/16/2025
+  // 3:23:00PM with a 14d recovery window, the earliest restorable time would be
+  // 04/02/2025 3:23:00PM. This field is only visible if the
+  // CLUSTER_VIEW_CONTINUOUS_BACKUP cluster view is provided.
   google.protobuf.Timestamp earliest_restorable_time = 4
       [(google.api.field_behavior) = OUTPUT_ONLY];
 }
@@ -404,8 +412,34 @@ message MaintenanceUpdatePolicy {
     google.type.TimeOfDay start_time = 2;
   }
 
+  // DenyMaintenancePeriod definition. Excepting emergencies, maintenance
+  // will not be scheduled to start within this deny period. The start_date must
+  // be less than the end_date.
+  message DenyMaintenancePeriod {
+    // Deny period start date.
+    // This can be:
+    // * A full date, with non-zero year, month and day values OR
+    // * A month and day value, with a zero year for recurring
+    google.type.Date start_date = 1;
+
+    // Deny period end date.
+    // This can be:
+    // * A full date, with non-zero year, month and day values OR
+    // * A month and day value, with a zero year for recurring
+    google.type.Date end_date = 2;
+
+    // Time in UTC when the deny period starts on start_date and ends on
+    // end_date. This can be:
+    // * Full time OR
+    // * All zeros for 00:00:00 UTC
+    google.type.TimeOfDay time = 3;
+  }
+
   // Preferred windows to perform maintenance. Currently limited to 1.
   repeated MaintenanceWindow maintenance_windows = 1;
+
+  // Periods to deny maintenance. Currently limited to 1.
+  repeated DenyMaintenancePeriod deny_maintenance_periods = 2;
 }
 
 // MaintenanceSchedule stores the maintenance schedule generated from
@@ -870,9 +904,33 @@ message Instance {
     ];
 
     // Output only. The status of the PSC service automation connection.
+    // Possible values:
+    //   "STATE_UNSPECIFIED" - An invalid state as the default case.
+    //   "ACTIVE" - The connection has been created successfully.
+    //   "FAILED" - The connection is not functional since some resources on the
+    // connection fail to be created.
+    //   "CREATING" - The connection is being created.
+    //   "DELETING" - The connection is being deleted.
+    //   "CREATE_REPAIRING" - The connection is being repaired to complete
+    // creation.
+    //   "DELETE_REPAIRING" - The connection is being repaired to complete
+    // deletion.
     string status = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 
     // Output only. The status of the service connection policy.
+    // Possible values:
+    //   "STATE_UNSPECIFIED" - Default state, when Connection Map is created
+    // initially.
+    //   "VALID" - Set when policy and map configuration is valid, and their
+    // matching can lead to allowing creation of PSC Connections subject to
+    // other constraints like connections limit.
+    //   "CONNECTION_POLICY_MISSING" - No Service Connection Policy found for
+    // this network and Service Class
+    //   "POLICY_LIMIT_REACHED" - Service Connection Policy limit reached for
+    //   this network and Service Class
+    //   "CONSUMER_INSTANCE_PROJECT_NOT_ALLOWLISTED" - The consumer instance
+    // project is not in AllowedGoogleProducersResourceHierarchyLevels of the
+    // matching ServiceConnectionPolicy.
     string consumer_network_status = 5
         [(google.api.field_behavior) = OUTPUT_ONLY];
   }
@@ -926,6 +984,28 @@ message Instance {
     // Optional. Enabling an outbound public IP address to support a database
     // server sending requests out into the internet.
     bool enable_outbound_public_ip = 3 [(google.api.field_behavior) = OPTIONAL];
+
+    // Output only. The resource link for the VPC network in which instance
+    // resources are created and from which they are accessible via Private IP.
+    // This will be the same value as the parent cluster's network. It is
+    // specified in the form: //
+    // `projects/{project_number}/global/networks/{network_id}`.
+    string network = 4 [
+      (google.api.field_behavior) = OUTPUT_ONLY,
+      (google.api.resource_reference) = {
+        type: "compute.googleapis.com/Network"
+      }
+    ];
+
+    // Optional. Name of the allocated IP range for the private IP AlloyDB
+    // instance, for example: "google-managed-services-default". If set, the
+    // instance IPs will be created from this allocated range and will override
+    // the IP range used by the parent cluster. The range name must comply with
+    // [RFC 1035](http://datatracker.ietf.org/doc/html/rfc1035). Specifically,
+    // the name must be 1-63 characters long and match the regular expression
+    // [a-z]([-a-z0-9]*[a-z0-9])?.
+    string allocated_ip_range_override = 5
+        [(google.api.field_behavior) = OPTIONAL];
   }
 
   // Instance State
@@ -1001,6 +1081,18 @@ message Instance {
     REGIONAL = 2;
   }
 
+  // Specifies whether an instance needs to spin up.
+  enum ActivationPolicy {
+    // The policy is not specified.
+    ACTIVATION_POLICY_UNSPECIFIED = 0;
+
+    // The instance is running.
+    ALWAYS = 1;
+
+    // The instance is not running.
+    NEVER = 2;
+  }
+
   // Output only. The name of the instance resource with the format:
   //  * projects/{project}/locations/{region}/clusters/{cluster_id}/instances/{instance_id}
   // where the cluster and instance ID segments should satisfy the regex
@@ -1144,6 +1236,16 @@ message Instance {
     (google.api.field_info).format = IPV4,
     (google.api.field_behavior) = OUTPUT_ONLY
   ];
+
+  // Optional. Specifies whether an instance needs to spin up. Once the instance
+  // is active, the activation policy can be updated to the `NEVER` to stop the
+  // instance. Likewise, the activation policy can be updated to `ALWAYS` to
+  // start the instance.
+  // There are restrictions around when an instance can/cannot be activated (for
+  // example, a read pool instance should be stopped before stopping primary
+  // etc.). Please refer to the API documentation for more details.
+  ActivationPolicy activation_policy = 35
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // ConnectionInfo singleton resource.
@@ -1270,13 +1372,20 @@ message Backup {
       [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Update time stamp
+  //
+  // Users should not infer any meaning from this field. Its value is generally
+  // unrelated to the timing of the backup creation operation.
   google.protobuf.Timestamp update_time = 5
       [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Delete time stamp
   google.protobuf.Timestamp delete_time = 15
       [(google.api.field_behavior) = OUTPUT_ONLY];
 
+  // Output only. Timestamp when the resource finished being created.
+  google.protobuf.Timestamp create_completion_time = 26
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
   // Labels as key value pairs
   map<string, string> labels = 6;
 
diff --git a/google/cloud/alloydb/v1/service.proto b/google/cloud/alloydb/v1/service.proto
@@ -874,7 +874,7 @@ message UpgradeClusterResponse {
     string logs_url = 3;
   }
 
-  // Details regarding the upgrade of instaces associated with a cluster.
+  // Details regarding the upgrade of instances associated with a cluster.
   message InstanceUpgradeDetails {
     // Normalized name of the instance.
     string name = 1;
@@ -1080,6 +1080,7 @@ message PromoteClusterRequest {
 
 // Message for restoring a Cluster from a backup or another cluster at a given
 // point in time.
+// NEXT_ID: 11
 message RestoreClusterRequest {
   // Required.
   // The source to import from.
