@google-cloud/storage-control 0.4.0 → 0.5.0

package/build/protos/google/storage/control/v2/storage_control.proto

@@ -16,13 +16,16 @@ syntax = "proto3";
 
 package google.storage.control.v2;
 
+import "google/api/annotations.proto";
 import "google/api/client.proto";
 import "google/api/field_behavior.proto";
 import "google/api/field_info.proto";
 import "google/api/resource.proto";
 import "google/api/routing.proto";
 import "google/longrunning/operations.proto";
+import "google/protobuf/duration.proto";
 import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
 
 option csharp_namespace = "Google.Cloud.Storage.Control.V2";
@@ -158,6 +161,151 @@ service StorageControl {
     };
     option (google.api.method_signature) = "parent";
   }
+
+  // Creates an Anywhere Cache instance.
+  rpc CreateAnywhereCache(CreateAnywhereCacheRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.routing) = {
+      routing_parameters { field: "parent" path_template: "{bucket=**}" }
+    };
+    option (google.api.method_signature) = "parent,anywhere_cache";
+    option (google.longrunning.operation_info) = {
+      response_type: "AnywhereCache"
+      metadata_type: "CreateAnywhereCacheMetadata"
+    };
+  }
+
+  // Updates an Anywhere Cache instance. Mutable fields include `ttl` and
+  // `admission_policy`.
+  rpc UpdateAnywhereCache(UpdateAnywhereCacheRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.routing) = {
+      routing_parameters {
+        field: "anywhere_cache.name"
+        path_template: "{bucket=projects/*/buckets/*}/**"
+      }
+    };
+    option (google.api.method_signature) = "anywhere_cache,update_mask";
+    option (google.longrunning.operation_info) = {
+      response_type: "AnywhereCache"
+      metadata_type: "UpdateAnywhereCacheMetadata"
+    };
+  }
+
+  // Disables an Anywhere Cache instance. A disabled instance is read-only. The
+  // disablement could be revoked by calling ResumeAnywhereCache. The cache
+  // instance will be deleted automatically if it remains in the disabled state
+  // for at least one hour.
+  rpc DisableAnywhereCache(DisableAnywhereCacheRequest)
+      returns (AnywhereCache) {
+    option (google.api.routing) = {
+      routing_parameters {
+        field: "name"
+        path_template: "{bucket=projects/*/buckets/*}/**"
+      }
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Pauses an Anywhere Cache instance.
+  rpc PauseAnywhereCache(PauseAnywhereCacheRequest) returns (AnywhereCache) {
+    option (google.api.routing) = {
+      routing_parameters {
+        field: "name"
+        path_template: "{bucket=projects/*/buckets/*}/**"
+      }
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Resumes a disabled or paused Anywhere Cache instance.
+  rpc ResumeAnywhereCache(ResumeAnywhereCacheRequest) returns (AnywhereCache) {
+    option (google.api.routing) = {
+      routing_parameters {
+        field: "name"
+        path_template: "{bucket=projects/*/buckets/*}/**"
+      }
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Gets an Anywhere Cache instance.
+  rpc GetAnywhereCache(GetAnywhereCacheRequest) returns (AnywhereCache) {
+    option (google.api.routing) = {
+      routing_parameters {
+        field: "name"
+        path_template: "{bucket=projects/*/buckets/*}/**"
+      }
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Lists Anywhere Cache instances for a given bucket.
+  rpc ListAnywhereCaches(ListAnywhereCachesRequest)
+      returns (ListAnywhereCachesResponse) {
+    option (google.api.routing) = {
+      routing_parameters { field: "parent" path_template: "{bucket=**}" }
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Returns the Project scoped singleton IntelligenceConfig resource.
+  rpc GetProjectIntelligenceConfig(GetProjectIntelligenceConfigRequest)
+      returns (IntelligenceConfig) {
+    option (google.api.http) = {
+      get: "/v2/{name=projects/*/locations/*/intelligenceConfig}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Updates the Project scoped singleton IntelligenceConfig resource.
+  rpc UpdateProjectIntelligenceConfig(UpdateProjectIntelligenceConfigRequest)
+      returns (IntelligenceConfig) {
+    option (google.api.http) = {
+      patch: "/v2/{intelligence_config.name=projects/*/locations/*/intelligenceConfig}"
+      body: "intelligence_config"
+    };
+    option (google.api.method_signature) = "intelligence_config,update_mask";
+  }
+
+  // Returns the Folder scoped singleton IntelligenceConfig resource.
+  rpc GetFolderIntelligenceConfig(GetFolderIntelligenceConfigRequest)
+      returns (IntelligenceConfig) {
+    option (google.api.http) = {
+      get: "/v2/{name=folders/*/locations/*/intelligenceConfig}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Updates the Folder scoped singleton IntelligenceConfig resource.
+  rpc UpdateFolderIntelligenceConfig(UpdateFolderIntelligenceConfigRequest)
+      returns (IntelligenceConfig) {
+    option (google.api.http) = {
+      patch: "/v2/{intelligence_config.name=folders/*/locations/*/intelligenceConfig}"
+      body: "intelligence_config"
+    };
+    option (google.api.method_signature) = "intelligence_config,update_mask";
+  }
+
+  // Returns the Organization scoped singleton IntelligenceConfig resource.
+  rpc GetOrganizationIntelligenceConfig(
+      GetOrganizationIntelligenceConfigRequest) returns (IntelligenceConfig) {
+    option (google.api.http) = {
+      get: "/v2/{name=organizations/*/locations/*/intelligenceConfig}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Updates the Organization scoped singleton IntelligenceConfig resource.
+  rpc UpdateOrganizationIntelligenceConfig(
+      UpdateOrganizationIntelligenceConfigRequest)
+      returns (IntelligenceConfig) {
+    option (google.api.http) = {
+      patch: "/v2/{intelligence_config.name=organizations/*/locations/*/intelligenceConfig}"
+      body: "intelligence_config"
+    };
+    option (google.api.method_signature) = "intelligence_config,update_mask";
+  }
 }
 
 // Contains information about a pending rename operation.
@@ -424,11 +572,13 @@ message StorageLayout {
   option (google.api.resource) = {
     type: "storage.googleapis.com/StorageLayout"
     pattern: "projects/{project}/buckets/{bucket}/storageLayout"
+    plural: "storageLayouts"
+    singular: "storageLayout"
   };
 
   // Configuration for Custom Dual Regions.  It should specify precisely two
   // eligible regions within the same Multiregion. More information on regions
-  // may be found [https://cloud.google.com/storage/docs/locations][here].
+  // may be found [here](https://cloud.google.com/storage/docs/locations).
   message CustomPlacementConfig {
     // List of locations to use for data placement.
     repeated string data_locations = 1;
@@ -642,3 +792,559 @@ message ListManagedFoldersResponse {
   // this value in a subsequent request to return the next page of results.
   string next_page_token = 2;
 }
+
+// Message returned in the metadata field of the Operation resource for
+// CreateAnywhereCache operations.
+message CreateAnywhereCacheMetadata {
+  // Generic metadata for the long running operation.
+  CommonLongRunningOperationMetadata common_metadata = 1;
+
+  // Anywhere Cache ID.
+  optional string anywhere_cache_id = 2;
+
+  // The zone in which the cache instance is running. For example,
+  // us-central1-a.
+  optional string zone = 6;
+
+  // Anywhere Cache entry's TTL. A cache-level config that is applied to all new
+  // cache entries on admission. Default ttl value (24hrs) is applied if not
+  // specified in the create request.
+  optional google.protobuf.Duration ttl = 3;
+
+  // Anywhere Cache entry Admission Policy in kebab-case (e.g.,
+  // "admit-on-first-miss"). Default admission policy (admit-on-first-miss) is
+  // applied if not specified in the create request.
+  optional string admission_policy = 5;
+}
+
+// Message returned in the metadata field of the Operation resource for
+// UpdateAnywhereCache operation.
+message UpdateAnywhereCacheMetadata {
+  // Generic metadata for the long running operation.
+  CommonLongRunningOperationMetadata common_metadata = 1;
+
+  // Anywhere Cache ID.
+  optional string anywhere_cache_id = 2;
+
+  // The zone in which the cache instance is running. For example,
+  // us-central1-a.
+  optional string zone = 5;
+
+  // Anywhere Cache entry's TTL between 1h and 7days. A cache-level config that
+  // is applied to all new cache entries on admission. If `ttl` is pending
+  // update, this field equals to the new value specified in the Update request.
+  optional google.protobuf.Duration ttl = 3;
+
+  // L4 Cache entry Admission Policy in kebab-case (e.g.,
+  // "admit-on-first-miss"). If `admission_policy` is pending
+  // update, this field equals to the new value specified in the Update request.
+  optional string admission_policy = 4;
+}
+
+// An Anywhere Cache Instance.
+message AnywhereCache {
+  option (google.api.resource) = {
+    type: "storage.googleapis.com/AnywhereCache"
+    pattern: "projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}"
+    plural: "anywhereCaches"
+    singular: "anywhereCache"
+  };
+
+  // Immutable. The resource name of this AnywhereCache.
+  // Format:
+  // `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`
+  string name = 1 [(google.api.field_behavior) = IMMUTABLE];
+
+  // Immutable. The zone in which the cache instance is running. For example,
+  // us-central1-a.
+  string zone = 10 [(google.api.field_behavior) = IMMUTABLE];
+
+  // Cache entry TTL (ranges between 1h to 7d). This is a cache-level config
+  // that defines how long a cache entry can live. Default ttl value (24hrs)
+  // is applied if not specified in the create request. TTL must be in whole
+  // seconds.
+  google.protobuf.Duration ttl = 3;
+
+  // Cache admission policy. Valid policies includes:
+  // `admit-on-first-miss` and `admit-on-second-miss`. Defaults to
+  // `admit-on-first-miss`. Default value is applied if not specified in the
+  // create request.
+  string admission_policy = 9;
+
+  // Output only. Cache state including RUNNING, CREATING, DISABLED and PAUSED.
+  string state = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Time when Anywhere cache instance is allocated.
+  google.protobuf.Timestamp create_time = 6
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Time when Anywhere cache instance is last updated, including
+  // creation.
+  google.protobuf.Timestamp update_time = 7
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. True if there is an active update operation against this cache
+  // instance. Subsequential update requests will be rejected if this field is
+  // true. Output only.
+  bool pending_update = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Request message for CreateAnywhereCache.
+message CreateAnywhereCacheRequest {
+  // Required. The bucket to which this cache belongs.
+  // Format: `projects/{project}/buckets/{bucket}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "storage.googleapis.com/AnywhereCache"
+    }
+  ];
+
+  // Required. Properties of the Anywhere Cache instance being created.
+  // The parent bucket name is specified in the `parent` field. Server uses the
+  // default value of `ttl` or `admission_policy` if not specified in
+  // request.
+  AnywhereCache anywhere_cache = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. A unique identifier for this request. UUID is the recommended
+  // format, but other formats are still accepted. This request is only
+  // idempotent if a `request_id` is provided.
+  string request_id = 4 [
+    (google.api.field_info).format = UUID4,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+}
+
+// Request message for UpdateAnywhereCache.
+message UpdateAnywhereCacheRequest {
+  // Required. The Anywhere Cache instance to be updated.
+  AnywhereCache anywhere_cache = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. List of fields to be updated. Mutable fields of AnywhereCache
+  // include `ttl` and `admission_policy`.
+  //
+  // To specify ALL fields, specify a single field with the value `*`. Note: We
+  // recommend against doing this. If a new field is introduced at a later time,
+  // an older client updating with the `*` may accidentally reset the new
+  // field's value.
+  //
+  // Not specifying any fields is an error.
+  google.protobuf.FieldMask update_mask = 2
+      [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. A unique identifier for this request. UUID is the recommended
+  // format, but other formats are still accepted. This request is only
+  // idempotent if a `request_id` is provided.
+  string request_id = 3 [
+    (google.api.field_info).format = UUID4,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+}
+
+// Request message for DisableAnywhereCache.
+message DisableAnywhereCacheRequest {
+  // Required. The name field in the request should be:
+  // `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "storage.googleapis.com/AnywhereCache"
+    }
+  ];
+
+  // Optional. A unique identifier for this request. UUID is the recommended
+  // format, but other formats are still accepted. This request is only
+  // idempotent if a `request_id` is provided.
+  string request_id = 2 [
+    (google.api.field_info).format = UUID4,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+}
+
+// Request message for PauseAnywhereCache.
+message PauseAnywhereCacheRequest {
+  // Required. The name field in the request should be:
+  // `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "storage.googleapis.com/AnywhereCache"
+    }
+  ];
+
+  // Optional. A unique identifier for this request. UUID is the recommended
+  // format, but other formats are still accepted. This request is only
+  // idempotent if a `request_id` is provided.
+  string request_id = 2 [
+    (google.api.field_info).format = UUID4,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+}
+
+// Request message for ResumeAnywhereCache.
+message ResumeAnywhereCacheRequest {
+  // Required. The name field in the request should be:
+  // `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "storage.googleapis.com/AnywhereCache"
+    }
+  ];
+
+  // Optional. A unique identifier for this request. UUID is the recommended
+  // format, but other formats are still accepted. This request is only
+  // idempotent if a `request_id` is provided.
+  string request_id = 2 [
+    (google.api.field_info).format = UUID4,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+}
+
+// Request message for GetAnywhereCache.
+message GetAnywhereCacheRequest {
+  // Required. The name field in the request should be:
+  // `projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "storage.googleapis.com/AnywhereCache"
+    }
+  ];
+
+  // Optional. A unique identifier for this request. UUID is the recommended
+  // format, but other formats are still accepted.
+  string request_id = 2 [
+    (google.api.field_info).format = UUID4,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+}
+
+// Request message for ListAnywhereCaches.
+message ListAnywhereCachesRequest {
+  // Required. The bucket to which this cache belongs.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "storage.googleapis.com/AnywhereCache"
+    }
+  ];
+
+  // Maximum number of caches to return in a single response.
+  // The service will use this parameter or 1,000 items, whichever is smaller.
+  int32 page_size = 2;
+
+  // A previously-returned page token representing part of the larger set of
+  // results to view.
+  string page_token = 3;
+
+  // Optional. A unique identifier for this request. UUID is the recommended
+  // format, but other formats are still accepted.
+  string request_id = 4 [
+    (google.api.field_info).format = UUID4,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+}
+
+// Response message for ListAnywhereCaches.
+message ListAnywhereCachesResponse {
+  // The list of items.
+  repeated AnywhereCache anywhere_caches = 1;
+
+  // A token, which can be sent as `page_token` to retrieve the next page.
+  // If this field is omitted, there are no subsequent pages.
+  string next_page_token = 2;
+}
+
+// The `IntelligenceConfig` resource associated with your organization, folder,
+// or project.
+message IntelligenceConfig {
+  option (google.api.resource) = {
+    type: "storage.googleapis.com/IntelligenceConfig"
+    pattern: "folders/{folder}/locations/{location}/intelligenceConfig"
+    pattern: "organizations/{org}/locations/{location}/intelligenceConfig"
+    pattern: "projects/{project}/locations/{location}/intelligenceConfig"
+    plural: "intelligenceConfigs"
+    singular: "intelligenceConfig"
+  };
+
+  // The edition configuration of the `IntelligenceConfig` resource. This
+  // signifies the edition used for configuring the `IntelligenceConfig`
+  // resource and can only take the following values:
+  // `EDITION_CONFIG_UNSPECIFIED`, `INHERIT`, `DISABLED`, `STANDARD` and
+  // `TRIAL`.
+  enum EditionConfig {
+    // This is an unknown edition of the resource.
+    EDITION_CONFIG_UNSPECIFIED = 0;
+
+    // The inherited edition from the parent and filters. This is the default
+    // edition when there is no `IntelligenceConfig` setup for a GCP resource.
+    INHERIT = 1;
+
+    // The edition configuration is disabled for the `IntelligenceConfig`
+    // resource and its children. Filters are not applicable.
+    DISABLED = 2;
+
+    // The `IntelligenceConfig` resource is of STANDARD edition.
+    STANDARD = 3;
+
+    // The `IntelligenceConfig` resource is available in `TRIAL` edition. During
+    // the trial period, Cloud Storage does not charge for Storage Intelligence
+    // usage. You can specify the buckets to include in the trial period by
+    // using filters. At the end of the trial period, the `IntelligenceConfig`
+    // resource is upgraded to `STANDARD` edition.
+    TRIAL = 5;
+  }
+
+  // Filter over location and bucket using include or exclude semantics.
+  // Resources that match the include or exclude filter are exclusively included
+  // or excluded from the Storage Intelligence plan.
+  message Filter {
+    // Collection of bucket locations.
+    message CloudStorageLocations {
+      // Optional. Bucket locations. Location can be any of the Cloud Storage
+      // regions specified in lower case format. For example, `us-east1`,
+      // `us-west1`.
+      repeated string locations = 1 [(google.api.field_behavior) = OPTIONAL];
+    }
+
+    // Collection of buckets.
+    message CloudStorageBuckets {
+      // Optional. A regex pattern for matching bucket names. Regex should
+      // follow the syntax specified in
+      // [google/re2](https://github.com/google/re2). For example,
+      // `^sample_.*` matches all buckets of the form
+      // `gs://sample_bucket-1`, `gs://sample_bucket-2`,
+      // `gs://sample_bucket-n` but not `gs://test_sample_bucket`.
+      // If you want to match a single bucket, say `gs://sample_bucket`,
+      // use `sample_bucket`.
+      repeated string bucket_id_regexes = 1
+          [(google.api.field_behavior) = OPTIONAL];
+    }
+
+    // Bucket locations to include or exclude.
+    oneof cloud_storage_locations {
+      // Bucket locations to include.
+      CloudStorageLocations included_cloud_storage_locations = 1;
+
+      // Bucket locations to exclude.
+      CloudStorageLocations excluded_cloud_storage_locations = 2;
+    }
+
+    // Buckets to include or exclude.
+    oneof cloud_storage_buckets {
+      // Buckets to include.
+      CloudStorageBuckets included_cloud_storage_buckets = 3;
+
+      // Buckets to exclude.
+      CloudStorageBuckets excluded_cloud_storage_buckets = 4;
+    }
+  }
+
+  // The effective `IntelligenceConfig` for the resource.
+  message EffectiveIntelligenceConfig {
+    // The effective edition of the `IntelligenceConfig` resource.
+    enum EffectiveEdition {
+      // This is an unknown edition of the resource.
+      EFFECTIVE_EDITION_UNSPECIFIED = 0;
+
+      // No edition.
+      NONE = 1;
+
+      // The `IntelligenceConfig` resource is of STANDARD edition.
+      STANDARD = 2;
+    }
+
+    // Output only. The `IntelligenceConfig` edition that is applicable for the
+    // resource.
+    EffectiveEdition effective_edition = 1
+        [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. The `IntelligenceConfig` resource that is applied for the
+    // target resource. Format:
+    // `{organizations|folders|projects}/{id}/locations/{location}/intelligenceConfig`
+    string intelligence_config = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+  }
+
+  // The trial configuration of the `IntelligenceConfig` resource.
+  message TrialConfig {
+    // Output only. The time at which the trial expires.
+    google.protobuf.Timestamp expire_time = 3
+        [(google.api.field_behavior) = OUTPUT_ONLY];
+  }
+
+  // Identifier. The name of the `IntelligenceConfig` resource associated with
+  // your organization, folder, or project.
+  //
+  // The name format varies based on the GCP resource hierarchy as follows:
+  //
+  // * For project:
+  // `projects/{project_number}/locations/global/intelligenceConfig`
+  // * For organization:
+  // `organizations/{org_id}/locations/global/intelligenceConfig`
+  // * For folder: `folders/{folder_id}/locations/global/intelligenceConfig`
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
+
+  // Optional. The edition configuration of the `IntelligenceConfig` resource.
+  EditionConfig edition_config = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Output only. The time at which the `IntelligenceConfig` resource is last
+  // updated.
+  google.protobuf.Timestamp update_time = 3
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Optional. Filter over location and bucket.
+  Filter filter = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Output only. The `IntelligenceConfig` resource that is applicable for the
+  // resource.
+  EffectiveIntelligenceConfig effective_intelligence_config = 5
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // The trial configuration of the `IntelligenceConfig` resource.
+  TrialConfig trial_config = 7;
+}
+
+// Request message to update the `IntelligenceConfig` resource associated with
+// your organization.
+//
+// **IAM Permissions**:
+//
+// Requires `storage.intelligenceConfigs.update`
+// [IAM](https://cloud.google.com/iam/docs/overview#permissions) permission on
+// the organization.
+message UpdateOrganizationIntelligenceConfigRequest {
+  // Required. The `IntelligenceConfig` resource to be updated.
+  IntelligenceConfig intelligence_config = 1
+      [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The `update_mask` that specifies the fields within the
+  // `IntelligenceConfig` resource that should be modified by this update. Only
+  // the listed fields are updated.
+  google.protobuf.FieldMask update_mask = 2
+      [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The ID that uniquely identifies the request, preventing duplicate
+  // processing.
+  string request_id = 3 [
+    (google.api.field_info).format = UUID4,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+}
+
+// Request message to update the `IntelligenceConfig` resource associated with
+// your folder.
+//
+// **IAM Permissions**:
+//
+// Requires `storage.intelligenceConfigs.update`
+// [IAM](https://cloud.google.com/iam/docs/overview#permissions) permission on
+// the folder.
+message UpdateFolderIntelligenceConfigRequest {
+  // Required. The `IntelligenceConfig` resource to be updated.
+  IntelligenceConfig intelligence_config = 1
+      [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The `update_mask` that specifies the fields within the
+  // `IntelligenceConfig` resource that should be modified by this update. Only
+  // the listed fields are updated.
+  google.protobuf.FieldMask update_mask = 2
+      [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The ID that uniquely identifies the request, preventing duplicate
+  // processing.
+  string request_id = 3 [
+    (google.api.field_info).format = UUID4,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+}
+
+// Request message to update the `IntelligenceConfig` resource associated with
+// your project.
+//
+// **IAM Permissions**:
+//
+// Requires `storage.intelligenceConfigs.update`
+// [IAM](https://cloud.google.com/iam/docs/overview#permissions) permission on
+// the folder.
+message UpdateProjectIntelligenceConfigRequest {
+  // Required. The `IntelligenceConfig` resource to be updated.
+  IntelligenceConfig intelligence_config = 1
+      [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The `update_mask` that specifies the fields within the
+  // `IntelligenceConfig` resource that should be modified by this update. Only
+  // the listed fields are updated.
+  google.protobuf.FieldMask update_mask = 2
+      [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The ID that uniquely identifies the request, preventing duplicate
+  // processing.
+  string request_id = 3 [
+    (google.api.field_info).format = UUID4,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+}
+
+// Request message to get the `IntelligenceConfig` resource associated with your
+// organization.
+//
+// **IAM Permissions**
+//
+// Requires `storage.intelligenceConfigs.get`
+// [IAM](https://cloud.google.com/iam/docs/overview#permissions) permission on
+// the organization.
+message GetOrganizationIntelligenceConfigRequest {
+  // Required. The name of the `IntelligenceConfig` resource associated with
+  // your organization.
+  //
+  // Format: `organizations/{org_id}/locations/global/intelligenceConfig`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "storage.googleapis.com/IntelligenceConfig"
+    }
+  ];
+}
+
+// Request message to get the `IntelligenceConfig` resource associated with your
+// folder.
+//
+// **IAM Permissions**
+//
+// Requires `storage.intelligenceConfigs.get`
+// [IAM](https://cloud.google.com/iam/docs/overview#permissions) permission on
+// the folder.
+message GetFolderIntelligenceConfigRequest {
+  // Required. The name of the `IntelligenceConfig` resource associated with
+  // your folder.
+  //
+  // Format: `folders/{id}/locations/global/intelligenceConfig`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "storage.googleapis.com/IntelligenceConfig"
+    }
+  ];
+}
+
+// Request message to get the `IntelligenceConfig` resource associated with your
+// project.
+//
+// **IAM Permissions**:
+//
+// Requires `storage.intelligenceConfigs.get`
+// [IAM](https://cloud.google.com/iam/docs/overview#permissions) permission
+// on the project.
+message GetProjectIntelligenceConfigRequest {
+  // Required. The name of the `IntelligenceConfig` resource associated with
+  // your project.
+  //
+  // Format: `projects/{id}/locations/global/intelligenceConfig`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "storage.googleapis.com/IntelligenceConfig"
+    }
+  ];
+}