feat: accept status updates in the SignalZoneState method

Google APIs · copybara-github · commit f817236eef91 · 2025-04-21T12:56:24.000-07:00
feat: expose the allowed hardware count for each SKU
feat: add deployment type and installation dates to orders
docs: make billing_id an output-only field

PiperOrigin-RevId: 749889768
diff --git a/google/cloud/gdchardwaremanagement/v1alpha/BUILD.bazel b/google/cloud/gdchardwaremanagement/v1alpha/BUILD.bazel
@@ -351,7 +351,6 @@ load(
 
 csharp_proto_library(
     name = "gdchardwaremanagement_csharp_proto",
-    extra_opts = [],
     deps = [":gdchardwaremanagement_proto"],
 )
 
diff --git a/google/cloud/gdchardwaremanagement/v1alpha/resources.proto b/google/cloud/gdchardwaremanagement/v1alpha/resources.proto
@@ -117,6 +117,8 @@ message Order {
 
   // Valid types of an Order.
   enum Type {
+    option allow_alias = true;
+
     // Type of the order is unspecified.
     TYPE_UNSPECIFIED = 0;
 
@@ -125,6 +127,27 @@ message Order {
 
     // Proof of concept for the customer.
     POC = 2;
+
+    // Not billed.
+    UNPAID = 2;
+  }
+
+  // Valid types of a deployment.
+  enum DeploymentType {
+    // Deployment type is unspecified.
+    DEPLOYMENT_TYPE_UNSPECIFIED = 0;
+
+    // Prod deployment with SLOs.
+    FULL_PRODUCTION = 1;
+
+    // Deployment with best-effort support and no SLOs.
+    PROOF_OF_CONCEPT = 2;
+
+    // Internal deployment with best-effort support and no SLOs.
+    INTERNAL = 3;
+
+    // Customer lab deployment that we support as though it's prod.
+    CUSTOMER_LAB = 4;
   }
 
   // Identifier. Name of this order.
@@ -186,13 +209,25 @@ message Order {
   google.protobuf.Timestamp submit_time = 14
       [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Required. The Google Cloud Billing ID to be charged for this order.
-  string billing_id = 15 [(google.api.field_behavior) = REQUIRED];
+  // Output only. The Google Cloud Billing ID to be charged for this order.
+  string billing_id = 15 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Optional. Existing hardware to be removed as part of this order.
   // Note: any hardware removed will be recycled unless otherwise agreed.
   repeated HardwareLocation existing_hardware = 16
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Output only. The deployment type of this order.
+  DeploymentType deployment_type = 18
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Actual installation date for this order.
+  google.type.Date actual_installation_date = 19
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Estimated installation date for this order.
+  google.type.Date estimated_installation_date = 20
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // A physical site where hardware will be installed.
@@ -621,6 +656,15 @@ message Sku {
     singular: "sku"
   };
 
+  // Inclusive range.
+  message Range {
+    // The minimum value of the range.
+    int32 min = 1;
+
+    // The maximum value of the range.
+    int32 max = 2;
+  }
+
   // Valid types of a SKU.
   enum Type {
     // Type of the SKU is unspecified. This is not an allowed value.
@@ -673,6 +717,11 @@ message Sku {
 
   // Output only. The vCPU count associated with this SKU.
   int32 vcpu_count = 12 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The inclusive ranges of hardware counts that are allowed in a
+  // zone using this SKU.
+  repeated Range hardware_count_ranges = 13
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // A zone holding a set of hardware.
@@ -698,6 +747,9 @@ message Zone {
     // Factory turnup has succeeded.
     READY_FOR_CUSTOMER_FACTORY_TURNUP_CHECKS = 5;
 
+    // The Zone is running factory turnup checks.
+    CUSTOMER_FACTORY_TURNUP_CHECKS_STARTED = 8;
+
     // The Zone is ready for site turnup.
     READY_FOR_SITE_TURNUP = 6;
 
diff --git a/google/cloud/gdchardwaremanagement/v1alpha/service.proto b/google/cloud/gdchardwaremanagement/v1alpha/service.proto
@@ -1280,6 +1280,9 @@ message SignalZoneStateRequest {
     // State signal of the zone is unspecified.
     STATE_SIGNAL_UNSPECIFIED = 0;
 
+    // Factory turnup checks have started.
+    FACTORY_TURNUP_CHECKS_STARTED = 3;
+
     // The Zone is ready for site turnup.
     FACTORY_TURNUP_CHECKS_PASSED = 1;
 
@@ -1326,6 +1329,15 @@ message SignalZoneStateRequest {
   // state_signal or provisioning_state_signal must be set, but not both.
   ProvisioningStateSignal provisioning_state_signal = 4
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The step being executed. Provides a finer grained status when the
+  // state_signal is FACTORY_TURNUP_CHECKS_STARTED or
+  // FACTORY_TURNUP_CHECKS_FAILED.
+  string step = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Additional details, such as an error message when state_signal is
+  // FACTORY_TURNUP_CHECKS_FAILED.
+  string details = 6 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Represents the metadata of a long-running operation.

Original file line number	Diff line number	Diff line change
`@@ -351,7 +351,6 @@ load(`
`351`	`351`
`352`	`352`	`csharp_proto_library(`
`353`	`353`	`name = "gdchardwaremanagement_csharp_proto",`
`354`		`- extra_opts = [],`
`355`	`354`	`deps = [":gdchardwaremanagement_proto"],`
`356`	`355`	`)`
`357`	`356`