feat: Hierarchical Quota Adjuster

Google APIs · copybara-github · commit 2ecdbee07d0f · 2026-01-30T08:05:34.000-08:00
docs: Folder level and organization level support for the quota adjuster feature.

PiperOrigin-RevId: 863242165
diff --git a/google/api/cloudquotas/v1beta/quota_adjuster_settings.proto b/google/api/cloudquotas/v1beta/quota_adjuster_settings.proto
@@ -42,7 +42,7 @@ service QuotaAdjusterSettingsManager {
   option (google.api.oauth_scopes) =
       "https://www.googleapis.com/auth/cloud-platform";
 
-  // RPC Method for updating QuotaAdjusterSettings based on the request
+  // Updates the QuotaAdjusterSettings for the specified resource.
   rpc UpdateQuotaAdjusterSettings(UpdateQuotaAdjusterSettingsRequest)
       returns (QuotaAdjusterSettings) {
     option (google.api.http) = {
@@ -61,7 +61,7 @@ service QuotaAdjusterSettingsManager {
         "quota_adjuster_settings,update_mask";
   }
 
-  // RPC Method for getting QuotaAdjusterSettings based on the request
+  // Gets the QuotaAdjusterSettings for the specified resource.
   rpc GetQuotaAdjusterSettings(GetQuotaAdjusterSettingsRequest)
       returns (QuotaAdjusterSettings) {
     option (google.api.http) = {
@@ -130,9 +130,13 @@ message QuotaAdjusterSettings {
     DISABLED = 3;
   }
 
-  // Identifier. Name of the config would be of the format:
+  // Identifier. Name of the configuration, in the formats below:
+  //
+  // * For a project:
   //   projects/PROJECT_NUMBER/locations/global/quotaAdjusterSettings
+  // * For a folder:
   //   folders/FOLDER_NUMBER/locations/global/quotaAdjusterSettings
+  // * For an organization:
   //   organizations/ORGANIZATION_NUMBER/locations/global/quotaAdjusterSettings
   string name = 1 [(google.api.field_behavior) = IDENTIFIER];
 
