feat: [Quotas] Added support for hierarchical enrollment in Quota Adjuster consumer API (#8362)

* feat: Added support for hierarchical enrollment in Quota Adjuster consumer API
docs: Added 2 new fields in `.google.api.cloudquotas.v1beta.QuotaAdjusterSettings`
docs: Added inherited and inherited_from in `.google.api.cloudquotas.v1beta.QuotaAdjusterSettings`
docs: Added support for folder and organization level enrollment

PiperOrigin-RevId: 768053907

Source-Link: googleapis/googleapis@818eab1

Source-Link: googleapis/googleapis-gen@43986b3
Copy-Tag: eyJwIjoiUXVvdGFzLy5Pd2xCb3QueWFtbCIsImgiOiI0Mzk4NmIzNDc4Y2NhODNiMTE2MjljYmM3MDQ1ZjJiN2EwNTg5NGUwIn0=

* 🦉 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]

Quotas/metadata/V1Beta/QuotaAdjusterSettings.php

@@ -41,7 +41,7 @@
  *                                                         to -1, it means the value is "unlimited".
  * @param string $quotaPreferenceService                   The name of the service to which the quota preference is applied.
  * @param string $quotaPreferenceQuotaId                   The id of the quota to which the quota preference is applied. A
- *                                                         quota name is unique in the service. Example: `CpusPerProjectPerRegion`
+ *                                                         quota name is unique in the service. For example, `CpusPerProjectPerRegion`
  */
 function create_quota_preference_sample(
     string $formattedParent,

Quotas/samples/V1beta/CloudQuotasClient/create_quota_preference.php

@@ -37,7 +37,7 @@
  *                                                         to -1, it means the value is "unlimited".
  * @param string $quotaPreferenceService                   The name of the service to which the quota preference is applied.
  * @param string $quotaPreferenceQuotaId                   The id of the quota to which the quota preference is applied. A
- *                                                         quota name is unique in the service. Example: `CpusPerProjectPerRegion`
+ *                                                         quota name is unique in the service. For example, `CpusPerProjectPerRegion`
  */
 function update_quota_preference_sample(
     int $quotaPreferenceQuotaConfigPreferredValue,

Quotas/samples/V1beta/CloudQuotasClient/update_quota_preference.php

@@ -26,22 +26,24 @@
 use Google\ApiCore\ApiException;
 use Google\Cloud\CloudQuotas\V1beta\Client\QuotaAdjusterSettingsManagerClient;
 use Google\Cloud\CloudQuotas\V1beta\QuotaAdjusterSettings;
-use Google\Cloud\CloudQuotas\V1beta\QuotaAdjusterSettings\Enablement;
 use Google\Cloud\CloudQuotas\V1beta\UpdateQuotaAdjusterSettingsRequest;
 
 /**
  * RPC Method for updating QuotaAdjusterSettings based on the request
  *
- * @param int $quotaAdjusterSettingsEnablement The configured value of the enablement at the given resource.
+ * This sample has been automatically generated and should be regarded as a code
+ * template only. It will require modifications to work:
+ *  - It may require correct/in-range values for request initialization.
+ *  - It may require specifying regional endpoints when creating the service client,
+ *    please see the apiEndpoint client configuration option for more details.
  */
-function update_quota_adjuster_settings_sample(int $quotaAdjusterSettingsEnablement): void
+function update_quota_adjuster_settings_sample(): void
 {
     // Create a client.
     $quotaAdjusterSettingsManagerClient = new QuotaAdjusterSettingsManagerClient();
 
     // Prepare the request message.
-    $quotaAdjusterSettings = (new QuotaAdjusterSettings())
-        ->setEnablement($quotaAdjusterSettingsEnablement);
+    $quotaAdjusterSettings = new QuotaAdjusterSettings();
     $request = (new UpdateQuotaAdjusterSettingsRequest())
         ->setQuotaAdjusterSettings($quotaAdjusterSettings);
 
@@ -54,20 +56,4 @@ function update_quota_adjuster_settings_sample(int $quotaAdjusterSettingsEnablem
         printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
     }
 }
-
-/**
- * Helper to execute the sample.
- *
- * This sample has been automatically generated and should be regarded as a code
- * template only. It will require modifications to work:
- *  - It may require correct/in-range values for request initialization.
- *  - It may require specifying regional endpoints when creating the service client,
- *    please see the apiEndpoint client configuration option for more details.
- */
-function callSample(): void
-{
-    $quotaAdjusterSettingsEnablement = Enablement::ENABLEMENT_UNSPECIFIED;
-
-    update_quota_adjuster_settings_sample($quotaAdjusterSettingsEnablement);
-}
 // [END cloudquotas_v1beta_generated_QuotaAdjusterSettingsManager_UpdateQuotaAdjusterSettings_sync]

Quotas/samples/V1beta/QuotaAdjusterSettingsManagerClient/update_quota_adjuster_settings.php

@@ -108,6 +108,63 @@ private static function getClientDefaults()
         ];
     }
 
+    /**
+     * Formats a string containing the fully-qualified path to represent a
+     * folder_location_quotaAdjusterSettings resource.
+     *
+     * @param string $folder
+     * @param string $location
+     *
+     * @return string The formatted folder_location_quotaAdjusterSettings resource.
+     *
+     * @experimental
+     */
+    public static function folderLocationQuotaAdjusterSettingsName(string $folder, string $location): string
+    {
+        return self::getPathTemplate('folderLocationQuotaAdjusterSettings')->render([
+            'folder' => $folder,
+            'location' => $location,
+        ]);
+    }
+
+    /**
+     * Formats a string containing the fully-qualified path to represent a
+     * organization_location_quotaAdjusterSettings resource.
+     *
+     * @param string $organization
+     * @param string $location
+     *
+     * @return string The formatted organization_location_quotaAdjusterSettings resource.
+     *
+     * @experimental
+     */
+    public static function organizationLocationQuotaAdjusterSettingsName(string $organization, string $location): string
+    {
+        return self::getPathTemplate('organizationLocationQuotaAdjusterSettings')->render([
+            'organization' => $organization,
+            'location' => $location,
+        ]);
+    }
+
+    /**
+     * Formats a string containing the fully-qualified path to represent a
+     * project_location_quotaAdjusterSettings resource.
+     *
+     * @param string $project
+     * @param string $location
+     *
+     * @return string The formatted project_location_quotaAdjusterSettings resource.
+     *
+     * @experimental
+     */
+    public static function projectLocationQuotaAdjusterSettingsName(string $project, string $location): string
+    {
+        return self::getPathTemplate('projectLocationQuotaAdjusterSettings')->render([
+            'project' => $project,
+            'location' => $location,
+        ]);
+    }
+
     /**
      * Formats a string containing the fully-qualified path to represent a
      * quota_adjuster_settings resource.
@@ -131,6 +188,9 @@ public static function quotaAdjusterSettingsName(string $project, string $locati
      * Parses a formatted name string and returns an associative array of the components in the name.
      * The following name formats are supported:
      * Template: Pattern
+     * - folderLocationQuotaAdjusterSettings: folders/{folder}/locations/{location}/quotaAdjusterSettings
+     * - organizationLocationQuotaAdjusterSettings: organizations/{organization}/locations/{location}/quotaAdjusterSettings
+     * - projectLocationQuotaAdjusterSettings: projects/{project}/locations/{location}/quotaAdjusterSettings
      * - quotaAdjusterSettings: projects/{project}/locations/{location}/quotaAdjusterSettings
      *
      * The optional $template argument can be supplied to specify a particular pattern,