feat: make reservation_name parameter generally visible in QueuedResource message

Google APIs · copybara-github · commit cad90d2ae086 · 2023-04-14T11:06:33.000-07:00
---
feat: add DeleteQueuedResource experiment

---
docs(v2alpha1): minor formatting to the description for `queued_resource_id`

PiperOrigin-RevId: 524336094
diff --git a/google/cloud/tpu/v2alpha1/cloud_tpu.proto b/google/cloud/tpu/v2alpha1/cloud_tpu.proto
@@ -164,6 +164,20 @@ service Tpu {
     };
   }
 
+  // Resets a QueuedResource TPU instance
+  rpc ResetQueuedResource(ResetQueuedResourceRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v2alpha1/{name=projects/*/locations/*/queuedResources/*}:reset"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name";
+    option (google.longrunning.operation_info) = {
+      response_type: "QueuedResource"
+      metadata_type: "OperationMetadata"
+    };
+  }
+
   // Generates the Cloud TPU service identity for the project.
   rpc GenerateServiceIdentity(GenerateServiceIdentityRequest)
       returns (GenerateServiceIdentityResponse) {
@@ -629,6 +643,10 @@ message QueuedResource {
 
   // Output only. State of the QueuedResource request.
   QueuedResourceState state = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Name of the reservation in which the resource should be provisioned.
+  // Format: projects/{project}/locations/{zone}/reservations/{reservation}
+  string reservation_name = 8;
 }
 
 // QueuedResourceState defines the details of the QueuedResource request.
@@ -884,7 +902,7 @@ message CreateQueuedResourceRequest {
     }
   ];
 
-  // The unqualified resource name. Should follow the ^[A-Za-z0-9_.~+%-]+$
+  // The unqualified resource name. Should follow the `^[A-Za-z0-9_.~+%-]+$`
   // regex format.
   string queued_resource_id = 2;
 
@@ -910,6 +928,18 @@ message DeleteQueuedResourceRequest {
   string request_id = 2;
 }
 
+// Request for
+// [ResetQueuedResource][google.cloud.tpu.v2alpha1.Tpu.ResetQueuedResource].
+message ResetQueuedResourceRequest {
+  // Required. The name of the queued resource.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "tpu.googleapis.com/QueuedResource"
+    }
+  ];
+}
+
 // The per-product per-project service identity for Cloud TPU service.
 message ServiceIdentity {
   // The email address of the service identity.
