feat(spanner): adding EXPECTED_FULFILLMENT_PERIOD to the indicate i…

…nstance creation times (with `FULFILLMENT_PERIOD_NORMAL` or `FULFILLMENT_PERIOD_EXTENDED` ENUM) with the extended instance creation time triggered by On-Demand Capacity Feature

PiperOrigin-RevId: 621488048

google/spanner/admin/instance/v1/common.proto

@@ -1,4 +1,4 @@
-// Copyright 2022 Google LLC
+// Copyright 2023 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -40,3 +40,17 @@ message OperationProgress {
   // successfully.
   google.protobuf.Timestamp end_time = 3;
 }
+
+// Indicates the expected fulfillment period of an operation.
+enum FulfillmentPeriod {
+  // Not specified.
+  FULFILLMENT_PERIOD_UNSPECIFIED = 0;
+
+  // Normal fulfillment period. The operation is expected to complete within
+  // minutes.
+  FULFILLMENT_PERIOD_NORMAL = 1;
+
+  // Extended fulfillment period. It can take up to an hour for the operation
+  // to complete.
+  FULFILLMENT_PERIOD_EXTENDED = 2;
+}

google/spanner/admin/instance/v1/spanner_instance_admin.proto

@@ -1282,6 +1282,9 @@ message CreateInstanceMetadata {
 
   // The time at which this operation failed or was completed successfully.
   google.protobuf.Timestamp end_time = 4;
+
+  // The expected fulfillment period of this create operation.
+  FulfillmentPeriod expected_fulfillment_period = 5;
 }
 
 // Metadata type for the operation returned by
@@ -1302,6 +1305,9 @@ message UpdateInstanceMetadata {
 
   // The time at which this operation failed or was completed successfully.
   google.protobuf.Timestamp end_time = 4;
+
+  // The expected fulfillment period of this update operation.
+  FulfillmentPeriod expected_fulfillment_period = 5;
 }
 
 // Metadata type for the operation returned by