fix: [Lustre] Changed field behavior for an existing field per_unit_storage_throughput. It is now required (#8359)

* fix: Changed field behavior for an existing field per_unit_storage_throughput. It is now required
docs: expand on and update various comments

PiperOrigin-RevId: 766812120

Source-Link: googleapis/googleapis@85d120d

Source-Link: googleapis/googleapis-gen@40a2bce
Copy-Tag: eyJwIjoiTHVzdHJlLy5Pd2xCb3QueWFtbCIsImgiOiI0MGEyYmNlODdhM2FmN2JhOTA2ZGU2YmVmMTUyMjBlMzA4ZTg0YzYwIn0=

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

Lustre/metadata/V1/Instance.php

@@ -33,32 +33,35 @@
 /**
  * Creates a new instance in a given project and location.
  *
- * @param string $formattedParent          The instance's project and location, in the format
- *                                         `projects/{project}/locations/{location}`. Locations map to Google Cloud
- *                                         zones; for example, `us-west1-b`. Please see
- *                                         {@see LustreClient::locationName()} for help formatting this field.
- * @param string $instanceId               The name of the Managed Lustre instance.
+ * @param string $formattedParent                  The instance's project and location, in the format
+ *                                                 `projects/{project}/locations/{location}`. Locations map to Google Cloud
+ *                                                 zones; for example, `us-west1-b`. Please see
+ *                                                 {@see LustreClient::locationName()} for help formatting this field.
+ * @param string $instanceId                       The name of the Managed Lustre instance.
  *
- *                                         * Must contain only lowercase letters, numbers, and hyphens.
- *                                         * Must start with a letter.
- *                                         * Must be between 1-63 characters.
- *                                         * Must end with a number or a letter.
- * @param string $instanceFilesystem       Immutable. The filesystem name for this instance. This name is
- *                                         used by client-side tools, including when mounting the instance. Must be
- *                                         eight characters or less and can only contain letters and numbers.
- * @param int    $instanceCapacityGib      The storage capacity of the instance in gibibytes (GiB). Allowed
- *                                         values are from `18000` to `936000`, in increments of 9000.
- * @param string $formattedInstanceNetwork Immutable. The full name of the VPC network to which the instance
- *                                         is connected. Must be in the format
- *                                         `projects/{project_id}/global/networks/{network_name}`. Please see
- *                                         {@see LustreClient::networkName()} for help formatting this field.
+ *                                                 * Must contain only lowercase letters, numbers, and hyphens.
+ *                                                 * Must start with a letter.
+ *                                                 * Must be between 1-63 characters.
+ *                                                 * Must end with a number or a letter.
+ * @param string $instanceFilesystem               Immutable. The filesystem name for this instance. This name is
+ *                                                 used by client-side tools, including when mounting the instance. Must be
+ *                                                 eight characters or less and can only contain letters and numbers.
+ * @param int    $instanceCapacityGib              The storage capacity of the instance in gibibytes (GiB). Allowed
+ *                                                 values are from `18000` to `954000`, in increments of 9000.
+ * @param string $formattedInstanceNetwork         Immutable. The full name of the VPC network to which the instance
+ *                                                 is connected. Must be in the format
+ *                                                 `projects/{project_id}/global/networks/{network_name}`. Please see
+ *                                                 {@see LustreClient::networkName()} for help formatting this field.
+ * @param int    $instancePerUnitStorageThroughput The throughput of the instance in MB/s/TiB.
+ *                                                 Valid values are 125, 250, 500, 1000.
  */
 function create_instance_sample(
     string $formattedParent,
     string $instanceId,
     string $instanceFilesystem,
     int $instanceCapacityGib,
-    string $formattedInstanceNetwork
+    string $formattedInstanceNetwork,
+    int $instancePerUnitStorageThroughput
 ): void {
     // Create a client.
     $lustreClient = new LustreClient();
@@ -67,7 +70,8 @@ function create_instance_sample(
     $instance = (new Instance())
         ->setFilesystem($instanceFilesystem)
         ->setCapacityGib($instanceCapacityGib)
-        ->setNetwork($formattedInstanceNetwork);
+        ->setNetwork($formattedInstanceNetwork)
+        ->setPerUnitStorageThroughput($instancePerUnitStorageThroughput);
     $request = (new CreateInstanceRequest())
         ->setParent($formattedParent)
         ->setInstanceId($instanceId)
@@ -109,13 +113,15 @@ function callSample(): void
     $instanceFilesystem = '[FILESYSTEM]';
     $instanceCapacityGib = 0;
     $formattedInstanceNetwork = LustreClient::networkName('[PROJECT]', '[NETWORK]');
+    $instancePerUnitStorageThroughput = 0;
 
     create_instance_sample(
         $formattedParent,
         $instanceId,
         $instanceFilesystem,
         $instanceCapacityGib,
-        $formattedInstanceNetwork
+        $formattedInstanceNetwork,
+        $instancePerUnitStorageThroughput
     );
 }
 // [END lustre_v1_generated_Lustre_CreateInstance_sync]

Lustre/samples/V1/LustreClient/create_instance.php

@@ -33,7 +33,8 @@
 /**
  * Exports data from a Managed Lustre instance to Cloud Storage.
  *
- * @param string $formattedName Name of the resource. Please see
+ * @param string $formattedName The name of the Managed Lustre instance in the format
+ *                              `projects/{project}/locations/{location}/instances/{instance}`. Please see
  *                              {@see LustreClient::instanceName()} for help formatting this field.
  */
 function export_data_sample(string $formattedName): void

Lustre/samples/V1/LustreClient/export_data.php

@@ -33,7 +33,8 @@
 /**
  * Imports data from Cloud Storage to a Managed Lustre instance.
  *
- * @param string $formattedName Name of the resource. Please see
+ * @param string $formattedName The name of the Managed Lustre instance in the format
+ *                              `projects/{project}/locations/{location}/instances/{instance}`. Please see
  *                              {@see LustreClient::instanceName()} for help formatting this field.
  */
 function import_data_sample(string $formattedName): void

Lustre/samples/V1/LustreClient/import_data.php

@@ -33,20 +33,23 @@
 /**
  * Updates the parameters of a single instance.
  *
- * @param string $instanceFilesystem       Immutable. The filesystem name for this instance. This name is
- *                                         used by client-side tools, including when mounting the instance. Must be
- *                                         eight characters or less and can only contain letters and numbers.
- * @param int    $instanceCapacityGib      The storage capacity of the instance in gibibytes (GiB). Allowed
- *                                         values are from `18000` to `936000`, in increments of 9000.
- * @param string $formattedInstanceNetwork Immutable. The full name of the VPC network to which the instance
- *                                         is connected. Must be in the format
- *                                         `projects/{project_id}/global/networks/{network_name}`. Please see
- *                                         {@see LustreClient::networkName()} for help formatting this field.
+ * @param string $instanceFilesystem               Immutable. The filesystem name for this instance. This name is
+ *                                                 used by client-side tools, including when mounting the instance. Must be
+ *                                                 eight characters or less and can only contain letters and numbers.
+ * @param int    $instanceCapacityGib              The storage capacity of the instance in gibibytes (GiB). Allowed
+ *                                                 values are from `18000` to `954000`, in increments of 9000.
+ * @param string $formattedInstanceNetwork         Immutable. The full name of the VPC network to which the instance
+ *                                                 is connected. Must be in the format
+ *                                                 `projects/{project_id}/global/networks/{network_name}`. Please see
+ *                                                 {@see LustreClient::networkName()} for help formatting this field.
+ * @param int    $instancePerUnitStorageThroughput The throughput of the instance in MB/s/TiB.
+ *                                                 Valid values are 125, 250, 500, 1000.
  */
 function update_instance_sample(
     string $instanceFilesystem,
     int $instanceCapacityGib,
-    string $formattedInstanceNetwork
+    string $formattedInstanceNetwork,
+    int $instancePerUnitStorageThroughput
 ): void {
     // Create a client.
     $lustreClient = new LustreClient();
@@ -55,7 +58,8 @@ function update_instance_sample(
     $instance = (new Instance())
         ->setFilesystem($instanceFilesystem)
         ->setCapacityGib($instanceCapacityGib)
-        ->setNetwork($formattedInstanceNetwork);
+        ->setNetwork($formattedInstanceNetwork)
+        ->setPerUnitStorageThroughput($instancePerUnitStorageThroughput);
     $request = (new UpdateInstanceRequest())
         ->setInstance($instance);
 
@@ -93,7 +97,13 @@ function callSample(): void
     $instanceFilesystem = '[FILESYSTEM]';
     $instanceCapacityGib = 0;
     $formattedInstanceNetwork = LustreClient::networkName('[PROJECT]', '[NETWORK]');
+    $instancePerUnitStorageThroughput = 0;
 
-    update_instance_sample($instanceFilesystem, $instanceCapacityGib, $formattedInstanceNetwork);
+    update_instance_sample(
+        $instanceFilesystem,
+        $instanceCapacityGib,
+        $formattedInstanceNetwork,
+        $instancePerUnitStorageThroughput
+    );
 }
 // [END lustre_v1_generated_Lustre_UpdateInstance_sync]