feat: added new WAITING_FOR_RESOURCES state for QueuedResourceState

Google APIs · copybara-github · commit 1004d19fb21c · 2023-09-19T13:20:39.000-07:00
PiperOrigin-RevId: 566723901
diff --git a/google/cloud/tpu/v2alpha1/cloud_tpu.proto b/google/cloud/tpu/v2alpha1/cloud_tpu.proto
@@ -723,6 +723,17 @@ message QueuedResourceState {
     // The resources specified in the QueuedResource request have been
     // deleted.
     SUSPENDED = 8;
+
+    // The QueuedResource request has passed initial validation and has been
+    // persisted in the queue. It will remain in this state until there are
+    // sufficient free resources to begin provisioning your request. Wait times
+    // will vary significantly depending on demand levels. When demand is high,
+    // not all requests can be immediately provisioned. If you
+    // need more reliable obtainability of TPUs consider purchasing a
+    // reservation. To put a limit on how long you are willing to wait, use
+    // [timing
+    // constraints](https://cloud.google.com/tpu/docs/queued-resources#request_a_queued_resource_before_a_specified_time).
+    WAITING_FOR_RESOURCES = 9;
   }
 
   // Further data for the creating state.
