docs: Update reservation field to include NO_RESERVATION

Google APIs · copybara-github · commit ef5e6701c70c · 2024-11-27T00:28:39.000-08:00
---
docs: clarify that user provided labels will also be applied to Cloud Logging
PiperOrigin-RevId: 700592805
diff --git a/google/cloud/batch/v1/job.proto b/google/cloud/batch/v1/job.proto
@@ -58,16 +58,18 @@ message Job {
   // Compute resource allocation for all TaskGroups in the Job.
   AllocationPolicy allocation_policy = 7;
 
-  // Labels for the Job. Labels could be user provided or system generated.
-  // For example,
-  // "labels": {
-  //    "department": "finance",
-  //    "environment": "test"
-  //  }
-  // You can assign up to 64 labels.  [Google Compute Engine label
-  // restrictions](https://cloud.google.com/compute/docs/labeling-resources#restrictions)
-  // apply.
-  // Label names that start with "goog-" or "google-" are reserved.
+  // Custom labels to apply to the job and any Cloud Logging
+  // [LogEntry](https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry)
+  // that it generates.
+  //
+  // Use labels to group and describe the resources they are applied to. Batch
+  // automatically applies predefined labels and supports multiple `labels`
+  // fields for each job, which each let you apply custom labels to various
+  // resources. Label names that start with "goog-" or "google-" are
+  // reserved for predefined labels. For more information about labels with
+  // Batch, see
+  // [Organize resources using
+  // labels](https://cloud.google.com/batch/docs/organize-resources-using-labels).
   map<string, string> labels = 8;
 
   // Output only. Job status. It is read only for users.
@@ -409,6 +411,8 @@ message AllocationPolicy {
 
     // Optional. If specified, VMs will consume only the specified reservation.
     // If not specified (default), VMs will consume any applicable reservation.
+    // Additionally, VMs will not consume any reservation if "NO_RESERVATION"
+    // is specified.
     string reservation = 7 [(google.api.field_behavior) = OPTIONAL];
   }
 
@@ -561,13 +565,17 @@ message AllocationPolicy {
   //  default cloud-platform scope. (list of strings)
   ServiceAccount service_account = 9;
 
-  // Labels applied to all VM instances and other resources
-  // created by AllocationPolicy.
-  // Labels could be user provided or system generated.
-  // You can assign up to 64 labels. [Google Compute Engine label
-  // restrictions](https://cloud.google.com/compute/docs/labeling-resources#restrictions)
-  // apply.
-  // Label names that start with "goog-" or "google-" are reserved.
+  // Custom labels to apply to the job and all the Compute Engine resources
+  // that both are created by this allocation policy and support labels.
+  //
+  // Use labels to group and describe the resources they are applied to. Batch
+  // automatically applies predefined labels and supports multiple `labels`
+  // fields for each job, which each let you apply custom labels to various
+  // resources. Label names that start with "goog-" or "google-" are
+  // reserved for predefined labels. For more information about labels with
+  // Batch, see
+  // [Organize resources using
+  // labels](https://cloud.google.com/batch/docs/organize-resources-using-labels).
   map<string, string> labels = 6;
 
   // The network policy.
