Class: Google::Cloud::Storage::Control::V2::IntelligenceFinding

Inherits:

Object

Object
Google::Cloud::Storage::Control::V2::IntelligenceFinding

show all

Extended by:: Protobuf::MessageExts::ClassMethods

Includes:: Protobuf::MessageExts

Defined in:: proto_docs/google/storage/control/v2/storage_control.rb

Overview

The IntelligenceFinding resource that represents a security, performance, or cost-related finding about a project or bucket.

Defined Under Namespace

Classes: ColdlineAndArchivalStorageOperationsSpike, CrossRegionEgressSpike, StorageGrowthAboveTrend, ThrottledRequestSpike

Instance Attribute Summary collapse

#associated_resources ⇒ ::Array<::String> readonly
Output only.
#category ⇒ ::Google::Cloud::Storage::Control::V2::FindingCategory readonly
Output only.
#coldline_and_archival_storage_operations_spike ⇒ ::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike readonly
Output only.
#create_time ⇒ ::Google::Protobuf::Timestamp readonly
Output only.
#cross_region_egress_spike ⇒ ::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike readonly
Output only.
#description ⇒ ::String readonly
Output only.
#name ⇒ ::String
Identifier.
#observation_period ⇒ ::Google::Type::Interval readonly
Output only.
#severity ⇒ ::Google::Cloud::Storage::Control::V2::FindingSeverity readonly
Output only.
#storage_growth_above_trend ⇒ ::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend readonly
Output only.
#target_resource ⇒ ::String readonly
Output only.
#throttled_requests_spike ⇒ ::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike readonly
Output only.
#type ⇒ ::Google::Cloud::Storage::Control::V2::FindingType readonly
Output only.
#update_time ⇒ ::Google::Protobuf::Timestamp readonly
Output only.

Instance Attribute Details

#associated_resources ⇒ `::Array<::String>` (readonly)

Returns Output only. Contains GCP resource names that are relevant to this IntelligenceFinding. The target_resource is also added as part of associated_resources. eg:

storage.googleapis.com/projects/_/buckets/b1
cloudresourecemanager.googleapis.com/projects/p1.

Returns:

(::Array<::String>) —
Output only. Contains GCP resource names that are relevant to this IntelligenceFinding. The target_resource is also added as part of associated_resources. eg:
- storage.googleapis.com/projects/_/buckets/b1
- cloudresourecemanager.googleapis.com/projects/p1

# File 'proto_docs/google/storage/control/v2/storage_control.rb', line 1358

class IntelligenceFinding
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents a finding about a spike in Class A/B operations on Coldline
  # or Archive Cloud Storage objects.
  # This corresponds to the `COLD_AND_ARCHIVAL_STORAGE_OPERATIONS_SPIKE`
  # finding type.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in operations across the project.
  # @!attribute [r] total_operations_count
  #   @return [::Integer]
  #     Output only. The total count of operations across the project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution>]
  #     Output only. A list of the top buckets driving the increase in
  #     operations.
  class ColdlineAndArchivalStorageOperationsSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the operation spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in operations for the bucket.
    # @!attribute [r] total_operations_count
    #   @return [::Integer]
    #     Output only. The total count of operations for the bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in operations.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the operation spike details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in operations for the object
        #     prefix.
        # @!attribute [r] total_operations_count
        #   @return [::Integer]
        #     Output only. The total count of operations for the object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in cross-region egress from Cloud
  # Storage.
  # This corresponds to the `CROSS_REGION_EGRESS_SPIKE` finding type.
  # @!attribute [r] total_egress_bytes
  #   @return [::Integer]
  #     Output only. The total cross-region egress volume in bytes across the
  #     project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in cross-region egress across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in cross-region
  #     egress.
  class CrossRegionEgressSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the cross-region egress spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_egress_bytes
    #   @return [::Integer]
    #     Output only. The total cross-region egress volume in bytes for the
    #     bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in cross-region egress for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in cross-region egress.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the cross-region egress spike details for an object
        # prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] total_egress_bytes
        #   @return [::Integer]
        #     Output only. The total cross-region egress volume in bytes from the
        #     object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in cross-region egress for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in throttled requests (429 errors)
  # within a project.
  # This corresponds to the `THROTTLED_REQUEST_SPIKE` finding type.
  # @!attribute [r] throttled_requests
  #   @return [::Integer]
  #     Output only. The count of throttled requests across the project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in throttled requests across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in throttled
  #     requests.
  class ThrottledRequestSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the throttled requests details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] throttled_requests
    #   @return [::Integer]
    #     Output only. The count of throttled requests for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in throttled requests for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of top object prefixes driving the increase in
      #     throttled requests.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents throttled requests details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] throttled_requests
        #   @return [::Integer]
        #     Output only. The count of throttled requests for the object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in throttled requests for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a storage growth above the expected trend.
  # This corresponds to the `STORAGE_GROWTH_ABOVE_TREND` finding type.
  # @!attribute [r] total_storage_growth_bytes
  #   @return [::Integer]
  #     Output only. The total storage growth in bytes.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in storage growth.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in storage
  #     growth.
  class StorageGrowthAboveTrend
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the storage growth details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_storage_growth_bytes
    #   @return [::Integer]
    #     Output only. The total storage growth in bytes for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in storage growth for the bucket.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end
end

#category ⇒ `::Google::Cloud::Storage::Control::V2::FindingCategory` (readonly)

Returns Output only. Category of this finding.

Returns:

(::Google::Cloud::Storage::Control::V2::FindingCategory) —
Output only. Category of this finding.

# File 'proto_docs/google/storage/control/v2/storage_control.rb', line 1358

class IntelligenceFinding
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents a finding about a spike in Class A/B operations on Coldline
  # or Archive Cloud Storage objects.
  # This corresponds to the `COLD_AND_ARCHIVAL_STORAGE_OPERATIONS_SPIKE`
  # finding type.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in operations across the project.
  # @!attribute [r] total_operations_count
  #   @return [::Integer]
  #     Output only. The total count of operations across the project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution>]
  #     Output only. A list of the top buckets driving the increase in
  #     operations.
  class ColdlineAndArchivalStorageOperationsSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the operation spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in operations for the bucket.
    # @!attribute [r] total_operations_count
    #   @return [::Integer]
    #     Output only. The total count of operations for the bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in operations.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the operation spike details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in operations for the object
        #     prefix.
        # @!attribute [r] total_operations_count
        #   @return [::Integer]
        #     Output only. The total count of operations for the object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in cross-region egress from Cloud
  # Storage.
  # This corresponds to the `CROSS_REGION_EGRESS_SPIKE` finding type.
  # @!attribute [r] total_egress_bytes
  #   @return [::Integer]
  #     Output only. The total cross-region egress volume in bytes across the
  #     project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in cross-region egress across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in cross-region
  #     egress.
  class CrossRegionEgressSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the cross-region egress spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_egress_bytes
    #   @return [::Integer]
    #     Output only. The total cross-region egress volume in bytes for the
    #     bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in cross-region egress for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in cross-region egress.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the cross-region egress spike details for an object
        # prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] total_egress_bytes
        #   @return [::Integer]
        #     Output only. The total cross-region egress volume in bytes from the
        #     object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in cross-region egress for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in throttled requests (429 errors)
  # within a project.
  # This corresponds to the `THROTTLED_REQUEST_SPIKE` finding type.
  # @!attribute [r] throttled_requests
  #   @return [::Integer]
  #     Output only. The count of throttled requests across the project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in throttled requests across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in throttled
  #     requests.
  class ThrottledRequestSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the throttled requests details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] throttled_requests
    #   @return [::Integer]
    #     Output only. The count of throttled requests for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in throttled requests for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of top object prefixes driving the increase in
      #     throttled requests.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents throttled requests details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] throttled_requests
        #   @return [::Integer]
        #     Output only. The count of throttled requests for the object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in throttled requests for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a storage growth above the expected trend.
  # This corresponds to the `STORAGE_GROWTH_ABOVE_TREND` finding type.
  # @!attribute [r] total_storage_growth_bytes
  #   @return [::Integer]
  #     Output only. The total storage growth in bytes.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in storage growth.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in storage
  #     growth.
  class StorageGrowthAboveTrend
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the storage growth details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_storage_growth_bytes
    #   @return [::Integer]
    #     Output only. The total storage growth in bytes for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in storage growth for the bucket.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end
end

#coldline_and_archival_storage_operations_spike ⇒ `::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike` (readonly)

Returns Output only. IntelligenceFinding about a spike in Class A/B operations on Coldline or Archive Cloud Storage objects.

Note: The following fields are mutually exclusive: coldline_and_archival_storage_operations_spike, throttled_requests_spike, cross_region_egress_spike, storage_growth_above_trend. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:

(::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike) —
Output only. IntelligenceFinding about a spike in Class A/B operations on Coldline or Archive Cloud Storage objects.

Note: The following fields are mutually exclusive: coldline_and_archival_storage_operations_spike, throttled_requests_spike, cross_region_egress_spike, storage_growth_above_trend. If a field in that set is populated, all other fields in the set will automatically be cleared.

# File 'proto_docs/google/storage/control/v2/storage_control.rb', line 1358

class IntelligenceFinding
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents a finding about a spike in Class A/B operations on Coldline
  # or Archive Cloud Storage objects.
  # This corresponds to the `COLD_AND_ARCHIVAL_STORAGE_OPERATIONS_SPIKE`
  # finding type.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in operations across the project.
  # @!attribute [r] total_operations_count
  #   @return [::Integer]
  #     Output only. The total count of operations across the project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution>]
  #     Output only. A list of the top buckets driving the increase in
  #     operations.
  class ColdlineAndArchivalStorageOperationsSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the operation spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in operations for the bucket.
    # @!attribute [r] total_operations_count
    #   @return [::Integer]
    #     Output only. The total count of operations for the bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in operations.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the operation spike details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in operations for the object
        #     prefix.
        # @!attribute [r] total_operations_count
        #   @return [::Integer]
        #     Output only. The total count of operations for the object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in cross-region egress from Cloud
  # Storage.
  # This corresponds to the `CROSS_REGION_EGRESS_SPIKE` finding type.
  # @!attribute [r] total_egress_bytes
  #   @return [::Integer]
  #     Output only. The total cross-region egress volume in bytes across the
  #     project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in cross-region egress across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in cross-region
  #     egress.
  class CrossRegionEgressSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the cross-region egress spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_egress_bytes
    #   @return [::Integer]
    #     Output only. The total cross-region egress volume in bytes for the
    #     bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in cross-region egress for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in cross-region egress.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the cross-region egress spike details for an object
        # prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] total_egress_bytes
        #   @return [::Integer]
        #     Output only. The total cross-region egress volume in bytes from the
        #     object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in cross-region egress for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in throttled requests (429 errors)
  # within a project.
  # This corresponds to the `THROTTLED_REQUEST_SPIKE` finding type.
  # @!attribute [r] throttled_requests
  #   @return [::Integer]
  #     Output only. The count of throttled requests across the project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in throttled requests across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in throttled
  #     requests.
  class ThrottledRequestSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the throttled requests details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] throttled_requests
    #   @return [::Integer]
    #     Output only. The count of throttled requests for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in throttled requests for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of top object prefixes driving the increase in
      #     throttled requests.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents throttled requests details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] throttled_requests
        #   @return [::Integer]
        #     Output only. The count of throttled requests for the object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in throttled requests for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a storage growth above the expected trend.
  # This corresponds to the `STORAGE_GROWTH_ABOVE_TREND` finding type.
  # @!attribute [r] total_storage_growth_bytes
  #   @return [::Integer]
  #     Output only. The total storage growth in bytes.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in storage growth.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in storage
  #     growth.
  class StorageGrowthAboveTrend
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the storage growth details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_storage_growth_bytes
    #   @return [::Integer]
    #     Output only. The total storage growth in bytes for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in storage growth for the bucket.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end
end

#create_time ⇒ `::Google::Protobuf::Timestamp` (readonly)

Returns Output only. The time at which the finding was created.

Returns:

(::Google::Protobuf::Timestamp) —
Output only. The time at which the finding was created.

# File 'proto_docs/google/storage/control/v2/storage_control.rb', line 1358

class IntelligenceFinding
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents a finding about a spike in Class A/B operations on Coldline
  # or Archive Cloud Storage objects.
  # This corresponds to the `COLD_AND_ARCHIVAL_STORAGE_OPERATIONS_SPIKE`
  # finding type.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in operations across the project.
  # @!attribute [r] total_operations_count
  #   @return [::Integer]
  #     Output only. The total count of operations across the project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution>]
  #     Output only. A list of the top buckets driving the increase in
  #     operations.
  class ColdlineAndArchivalStorageOperationsSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the operation spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in operations for the bucket.
    # @!attribute [r] total_operations_count
    #   @return [::Integer]
    #     Output only. The total count of operations for the bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in operations.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the operation spike details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in operations for the object
        #     prefix.
        # @!attribute [r] total_operations_count
        #   @return [::Integer]
        #     Output only. The total count of operations for the object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in cross-region egress from Cloud
  # Storage.
  # This corresponds to the `CROSS_REGION_EGRESS_SPIKE` finding type.
  # @!attribute [r] total_egress_bytes
  #   @return [::Integer]
  #     Output only. The total cross-region egress volume in bytes across the
  #     project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in cross-region egress across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in cross-region
  #     egress.
  class CrossRegionEgressSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the cross-region egress spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_egress_bytes
    #   @return [::Integer]
    #     Output only. The total cross-region egress volume in bytes for the
    #     bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in cross-region egress for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in cross-region egress.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the cross-region egress spike details for an object
        # prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] total_egress_bytes
        #   @return [::Integer]
        #     Output only. The total cross-region egress volume in bytes from the
        #     object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in cross-region egress for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in throttled requests (429 errors)
  # within a project.
  # This corresponds to the `THROTTLED_REQUEST_SPIKE` finding type.
  # @!attribute [r] throttled_requests
  #   @return [::Integer]
  #     Output only. The count of throttled requests across the project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in throttled requests across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in throttled
  #     requests.
  class ThrottledRequestSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the throttled requests details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] throttled_requests
    #   @return [::Integer]
    #     Output only. The count of throttled requests for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in throttled requests for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of top object prefixes driving the increase in
      #     throttled requests.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents throttled requests details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] throttled_requests
        #   @return [::Integer]
        #     Output only. The count of throttled requests for the object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in throttled requests for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a storage growth above the expected trend.
  # This corresponds to the `STORAGE_GROWTH_ABOVE_TREND` finding type.
  # @!attribute [r] total_storage_growth_bytes
  #   @return [::Integer]
  #     Output only. The total storage growth in bytes.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in storage growth.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in storage
  #     growth.
  class StorageGrowthAboveTrend
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the storage growth details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_storage_growth_bytes
    #   @return [::Integer]
    #     Output only. The total storage growth in bytes for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in storage growth for the bucket.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end
end

#cross_region_egress_spike ⇒ `::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike` (readonly)

Returns Output only. IntelligenceFinding about a spike in cross-region egress.

Note: The following fields are mutually exclusive: cross_region_egress_spike, coldline_and_archival_storage_operations_spike, throttled_requests_spike, storage_growth_above_trend. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:

(::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike) —
Output only. IntelligenceFinding about a spike in cross-region egress.

Note: The following fields are mutually exclusive: cross_region_egress_spike, coldline_and_archival_storage_operations_spike, throttled_requests_spike, storage_growth_above_trend. If a field in that set is populated, all other fields in the set will automatically be cleared.

# File 'proto_docs/google/storage/control/v2/storage_control.rb', line 1358

class IntelligenceFinding
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents a finding about a spike in Class A/B operations on Coldline
  # or Archive Cloud Storage objects.
  # This corresponds to the `COLD_AND_ARCHIVAL_STORAGE_OPERATIONS_SPIKE`
  # finding type.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in operations across the project.
  # @!attribute [r] total_operations_count
  #   @return [::Integer]
  #     Output only. The total count of operations across the project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution>]
  #     Output only. A list of the top buckets driving the increase in
  #     operations.
  class ColdlineAndArchivalStorageOperationsSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the operation spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in operations for the bucket.
    # @!attribute [r] total_operations_count
    #   @return [::Integer]
    #     Output only. The total count of operations for the bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in operations.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the operation spike details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in operations for the object
        #     prefix.
        # @!attribute [r] total_operations_count
        #   @return [::Integer]
        #     Output only. The total count of operations for the object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in cross-region egress from Cloud
  # Storage.
  # This corresponds to the `CROSS_REGION_EGRESS_SPIKE` finding type.
  # @!attribute [r] total_egress_bytes
  #   @return [::Integer]
  #     Output only. The total cross-region egress volume in bytes across the
  #     project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in cross-region egress across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in cross-region
  #     egress.
  class CrossRegionEgressSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the cross-region egress spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_egress_bytes
    #   @return [::Integer]
    #     Output only. The total cross-region egress volume in bytes for the
    #     bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in cross-region egress for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in cross-region egress.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the cross-region egress spike details for an object
        # prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] total_egress_bytes
        #   @return [::Integer]
        #     Output only. The total cross-region egress volume in bytes from the
        #     object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in cross-region egress for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in throttled requests (429 errors)
  # within a project.
  # This corresponds to the `THROTTLED_REQUEST_SPIKE` finding type.
  # @!attribute [r] throttled_requests
  #   @return [::Integer]
  #     Output only. The count of throttled requests across the project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in throttled requests across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in throttled
  #     requests.
  class ThrottledRequestSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the throttled requests details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] throttled_requests
    #   @return [::Integer]
    #     Output only. The count of throttled requests for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in throttled requests for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of top object prefixes driving the increase in
      #     throttled requests.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents throttled requests details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] throttled_requests
        #   @return [::Integer]
        #     Output only. The count of throttled requests for the object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in throttled requests for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a storage growth above the expected trend.
  # This corresponds to the `STORAGE_GROWTH_ABOVE_TREND` finding type.
  # @!attribute [r] total_storage_growth_bytes
  #   @return [::Integer]
  #     Output only. The total storage growth in bytes.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in storage growth.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in storage
  #     growth.
  class StorageGrowthAboveTrend
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the storage growth details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_storage_growth_bytes
    #   @return [::Integer]
    #     Output only. The total storage growth in bytes for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in storage growth for the bucket.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end
end

#description ⇒ `::String` (readonly)

Returns Output only. A short description about the finding.

Returns:

(::String) —
Output only. A short description about the finding.

# File 'proto_docs/google/storage/control/v2/storage_control.rb', line 1358

class IntelligenceFinding
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents a finding about a spike in Class A/B operations on Coldline
  # or Archive Cloud Storage objects.
  # This corresponds to the `COLD_AND_ARCHIVAL_STORAGE_OPERATIONS_SPIKE`
  # finding type.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in operations across the project.
  # @!attribute [r] total_operations_count
  #   @return [::Integer]
  #     Output only. The total count of operations across the project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution>]
  #     Output only. A list of the top buckets driving the increase in
  #     operations.
  class ColdlineAndArchivalStorageOperationsSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the operation spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in operations for the bucket.
    # @!attribute [r] total_operations_count
    #   @return [::Integer]
    #     Output only. The total count of operations for the bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in operations.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the operation spike details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in operations for the object
        #     prefix.
        # @!attribute [r] total_operations_count
        #   @return [::Integer]
        #     Output only. The total count of operations for the object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in cross-region egress from Cloud
  # Storage.
  # This corresponds to the `CROSS_REGION_EGRESS_SPIKE` finding type.
  # @!attribute [r] total_egress_bytes
  #   @return [::Integer]
  #     Output only. The total cross-region egress volume in bytes across the
  #     project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in cross-region egress across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in cross-region
  #     egress.
  class CrossRegionEgressSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the cross-region egress spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_egress_bytes
    #   @return [::Integer]
    #     Output only. The total cross-region egress volume in bytes for the
    #     bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in cross-region egress for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in cross-region egress.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the cross-region egress spike details for an object
        # prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] total_egress_bytes
        #   @return [::Integer]
        #     Output only. The total cross-region egress volume in bytes from the
        #     object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in cross-region egress for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in throttled requests (429 errors)
  # within a project.
  # This corresponds to the `THROTTLED_REQUEST_SPIKE` finding type.
  # @!attribute [r] throttled_requests
  #   @return [::Integer]
  #     Output only. The count of throttled requests across the project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in throttled requests across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in throttled
  #     requests.
  class ThrottledRequestSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the throttled requests details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] throttled_requests
    #   @return [::Integer]
    #     Output only. The count of throttled requests for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in throttled requests for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of top object prefixes driving the increase in
      #     throttled requests.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents throttled requests details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] throttled_requests
        #   @return [::Integer]
        #     Output only. The count of throttled requests for the object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in throttled requests for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a storage growth above the expected trend.
  # This corresponds to the `STORAGE_GROWTH_ABOVE_TREND` finding type.
  # @!attribute [r] total_storage_growth_bytes
  #   @return [::Integer]
  #     Output only. The total storage growth in bytes.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in storage growth.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in storage
  #     growth.
  class StorageGrowthAboveTrend
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the storage growth details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_storage_growth_bytes
    #   @return [::Integer]
    #     Output only. The total storage growth in bytes for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in storage growth for the bucket.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end
end

#name ⇒ `::String`

Returns Identifier. The resource name of IntelligenceFinding. Format: projects/{project}/locations/{location}/intelligenceFindings/{intelligence_finding}.

Returns:

(::String) —
Identifier. The resource name of IntelligenceFinding. Format: projects/{project}/locations/{location}/intelligenceFindings/{intelligence_finding}

# File 'proto_docs/google/storage/control/v2/storage_control.rb', line 1358

class IntelligenceFinding
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents a finding about a spike in Class A/B operations on Coldline
  # or Archive Cloud Storage objects.
  # This corresponds to the `COLD_AND_ARCHIVAL_STORAGE_OPERATIONS_SPIKE`
  # finding type.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in operations across the project.
  # @!attribute [r] total_operations_count
  #   @return [::Integer]
  #     Output only. The total count of operations across the project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution>]
  #     Output only. A list of the top buckets driving the increase in
  #     operations.
  class ColdlineAndArchivalStorageOperationsSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the operation spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in operations for the bucket.
    # @!attribute [r] total_operations_count
    #   @return [::Integer]
    #     Output only. The total count of operations for the bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in operations.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the operation spike details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in operations for the object
        #     prefix.
        # @!attribute [r] total_operations_count
        #   @return [::Integer]
        #     Output only. The total count of operations for the object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in cross-region egress from Cloud
  # Storage.
  # This corresponds to the `CROSS_REGION_EGRESS_SPIKE` finding type.
  # @!attribute [r] total_egress_bytes
  #   @return [::Integer]
  #     Output only. The total cross-region egress volume in bytes across the
  #     project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in cross-region egress across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in cross-region
  #     egress.
  class CrossRegionEgressSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the cross-region egress spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_egress_bytes
    #   @return [::Integer]
    #     Output only. The total cross-region egress volume in bytes for the
    #     bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in cross-region egress for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in cross-region egress.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the cross-region egress spike details for an object
        # prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] total_egress_bytes
        #   @return [::Integer]
        #     Output only. The total cross-region egress volume in bytes from the
        #     object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in cross-region egress for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in throttled requests (429 errors)
  # within a project.
  # This corresponds to the `THROTTLED_REQUEST_SPIKE` finding type.
  # @!attribute [r] throttled_requests
  #   @return [::Integer]
  #     Output only. The count of throttled requests across the project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in throttled requests across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in throttled
  #     requests.
  class ThrottledRequestSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the throttled requests details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] throttled_requests
    #   @return [::Integer]
    #     Output only. The count of throttled requests for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in throttled requests for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of top object prefixes driving the increase in
      #     throttled requests.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents throttled requests details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] throttled_requests
        #   @return [::Integer]
        #     Output only. The count of throttled requests for the object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in throttled requests for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a storage growth above the expected trend.
  # This corresponds to the `STORAGE_GROWTH_ABOVE_TREND` finding type.
  # @!attribute [r] total_storage_growth_bytes
  #   @return [::Integer]
  #     Output only. The total storage growth in bytes.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in storage growth.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in storage
  #     growth.
  class StorageGrowthAboveTrend
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the storage growth details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_storage_growth_bytes
    #   @return [::Integer]
    #     Output only. The total storage growth in bytes for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in storage growth for the bucket.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end
end

#observation_period ⇒ `::Google::Type::Interval` (readonly)

Returns Output only. The time interval during which the underlying data was used to generate this IntelligenceFinding.

Returns:

(::Google::Type::Interval) —
Output only. The time interval during which the underlying data was used to generate this IntelligenceFinding.

# File 'proto_docs/google/storage/control/v2/storage_control.rb', line 1358

class IntelligenceFinding
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents a finding about a spike in Class A/B operations on Coldline
  # or Archive Cloud Storage objects.
  # This corresponds to the `COLD_AND_ARCHIVAL_STORAGE_OPERATIONS_SPIKE`
  # finding type.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in operations across the project.
  # @!attribute [r] total_operations_count
  #   @return [::Integer]
  #     Output only. The total count of operations across the project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution>]
  #     Output only. A list of the top buckets driving the increase in
  #     operations.
  class ColdlineAndArchivalStorageOperationsSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the operation spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in operations for the bucket.
    # @!attribute [r] total_operations_count
    #   @return [::Integer]
    #     Output only. The total count of operations for the bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in operations.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the operation spike details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in operations for the object
        #     prefix.
        # @!attribute [r] total_operations_count
        #   @return [::Integer]
        #     Output only. The total count of operations for the object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in cross-region egress from Cloud
  # Storage.
  # This corresponds to the `CROSS_REGION_EGRESS_SPIKE` finding type.
  # @!attribute [r] total_egress_bytes
  #   @return [::Integer]
  #     Output only. The total cross-region egress volume in bytes across the
  #     project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in cross-region egress across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in cross-region
  #     egress.
  class CrossRegionEgressSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the cross-region egress spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_egress_bytes
    #   @return [::Integer]
    #     Output only. The total cross-region egress volume in bytes for the
    #     bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in cross-region egress for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in cross-region egress.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the cross-region egress spike details for an object
        # prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] total_egress_bytes
        #   @return [::Integer]
        #     Output only. The total cross-region egress volume in bytes from the
        #     object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in cross-region egress for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in throttled requests (429 errors)
  # within a project.
  # This corresponds to the `THROTTLED_REQUEST_SPIKE` finding type.
  # @!attribute [r] throttled_requests
  #   @return [::Integer]
  #     Output only. The count of throttled requests across the project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in throttled requests across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in throttled
  #     requests.
  class ThrottledRequestSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the throttled requests details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] throttled_requests
    #   @return [::Integer]
    #     Output only. The count of throttled requests for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in throttled requests for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of top object prefixes driving the increase in
      #     throttled requests.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents throttled requests details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] throttled_requests
        #   @return [::Integer]
        #     Output only. The count of throttled requests for the object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in throttled requests for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a storage growth above the expected trend.
  # This corresponds to the `STORAGE_GROWTH_ABOVE_TREND` finding type.
  # @!attribute [r] total_storage_growth_bytes
  #   @return [::Integer]
  #     Output only. The total storage growth in bytes.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in storage growth.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in storage
  #     growth.
  class StorageGrowthAboveTrend
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the storage growth details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_storage_growth_bytes
    #   @return [::Integer]
    #     Output only. The total storage growth in bytes for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in storage growth for the bucket.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end
end

#severity ⇒ `::Google::Cloud::Storage::Control::V2::FindingSeverity` (readonly)

Returns Output only. Severity of the finding.

Returns:

(::Google::Cloud::Storage::Control::V2::FindingSeverity) —
Output only. Severity of the finding.

# File 'proto_docs/google/storage/control/v2/storage_control.rb', line 1358

class IntelligenceFinding
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents a finding about a spike in Class A/B operations on Coldline
  # or Archive Cloud Storage objects.
  # This corresponds to the `COLD_AND_ARCHIVAL_STORAGE_OPERATIONS_SPIKE`
  # finding type.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in operations across the project.
  # @!attribute [r] total_operations_count
  #   @return [::Integer]
  #     Output only. The total count of operations across the project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution>]
  #     Output only. A list of the top buckets driving the increase in
  #     operations.
  class ColdlineAndArchivalStorageOperationsSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the operation spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in operations for the bucket.
    # @!attribute [r] total_operations_count
    #   @return [::Integer]
    #     Output only. The total count of operations for the bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in operations.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the operation spike details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in operations for the object
        #     prefix.
        # @!attribute [r] total_operations_count
        #   @return [::Integer]
        #     Output only. The total count of operations for the object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in cross-region egress from Cloud
  # Storage.
  # This corresponds to the `CROSS_REGION_EGRESS_SPIKE` finding type.
  # @!attribute [r] total_egress_bytes
  #   @return [::Integer]
  #     Output only. The total cross-region egress volume in bytes across the
  #     project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in cross-region egress across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in cross-region
  #     egress.
  class CrossRegionEgressSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the cross-region egress spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_egress_bytes
    #   @return [::Integer]
    #     Output only. The total cross-region egress volume in bytes for the
    #     bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in cross-region egress for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in cross-region egress.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the cross-region egress spike details for an object
        # prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] total_egress_bytes
        #   @return [::Integer]
        #     Output only. The total cross-region egress volume in bytes from the
        #     object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in cross-region egress for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in throttled requests (429 errors)
  # within a project.
  # This corresponds to the `THROTTLED_REQUEST_SPIKE` finding type.
  # @!attribute [r] throttled_requests
  #   @return [::Integer]
  #     Output only. The count of throttled requests across the project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in throttled requests across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in throttled
  #     requests.
  class ThrottledRequestSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the throttled requests details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] throttled_requests
    #   @return [::Integer]
    #     Output only. The count of throttled requests for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in throttled requests for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of top object prefixes driving the increase in
      #     throttled requests.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents throttled requests details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] throttled_requests
        #   @return [::Integer]
        #     Output only. The count of throttled requests for the object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in throttled requests for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a storage growth above the expected trend.
  # This corresponds to the `STORAGE_GROWTH_ABOVE_TREND` finding type.
  # @!attribute [r] total_storage_growth_bytes
  #   @return [::Integer]
  #     Output only. The total storage growth in bytes.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in storage growth.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in storage
  #     growth.
  class StorageGrowthAboveTrend
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the storage growth details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_storage_growth_bytes
    #   @return [::Integer]
    #     Output only. The total storage growth in bytes for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in storage growth for the bucket.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end
end

#storage_growth_above_trend ⇒ `::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend` (readonly)

Returns Output only. IntelligenceFinding about growth in storage above the expected trend.

Note: The following fields are mutually exclusive: storage_growth_above_trend, coldline_and_archival_storage_operations_spike, throttled_requests_spike, cross_region_egress_spike. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:

(::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend) —
Output only. IntelligenceFinding about growth in storage above the expected trend.

Note: The following fields are mutually exclusive: storage_growth_above_trend, coldline_and_archival_storage_operations_spike, throttled_requests_spike, cross_region_egress_spike. If a field in that set is populated, all other fields in the set will automatically be cleared.

# File 'proto_docs/google/storage/control/v2/storage_control.rb', line 1358

class IntelligenceFinding
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents a finding about a spike in Class A/B operations on Coldline
  # or Archive Cloud Storage objects.
  # This corresponds to the `COLD_AND_ARCHIVAL_STORAGE_OPERATIONS_SPIKE`
  # finding type.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in operations across the project.
  # @!attribute [r] total_operations_count
  #   @return [::Integer]
  #     Output only. The total count of operations across the project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution>]
  #     Output only. A list of the top buckets driving the increase in
  #     operations.
  class ColdlineAndArchivalStorageOperationsSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the operation spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in operations for the bucket.
    # @!attribute [r] total_operations_count
    #   @return [::Integer]
    #     Output only. The total count of operations for the bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in operations.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the operation spike details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in operations for the object
        #     prefix.
        # @!attribute [r] total_operations_count
        #   @return [::Integer]
        #     Output only. The total count of operations for the object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in cross-region egress from Cloud
  # Storage.
  # This corresponds to the `CROSS_REGION_EGRESS_SPIKE` finding type.
  # @!attribute [r] total_egress_bytes
  #   @return [::Integer]
  #     Output only. The total cross-region egress volume in bytes across the
  #     project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in cross-region egress across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in cross-region
  #     egress.
  class CrossRegionEgressSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the cross-region egress spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_egress_bytes
    #   @return [::Integer]
    #     Output only. The total cross-region egress volume in bytes for the
    #     bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in cross-region egress for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in cross-region egress.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the cross-region egress spike details for an object
        # prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] total_egress_bytes
        #   @return [::Integer]
        #     Output only. The total cross-region egress volume in bytes from the
        #     object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in cross-region egress for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in throttled requests (429 errors)
  # within a project.
  # This corresponds to the `THROTTLED_REQUEST_SPIKE` finding type.
  # @!attribute [r] throttled_requests
  #   @return [::Integer]
  #     Output only. The count of throttled requests across the project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in throttled requests across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in throttled
  #     requests.
  class ThrottledRequestSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the throttled requests details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] throttled_requests
    #   @return [::Integer]
    #     Output only. The count of throttled requests for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in throttled requests for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of top object prefixes driving the increase in
      #     throttled requests.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents throttled requests details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] throttled_requests
        #   @return [::Integer]
        #     Output only. The count of throttled requests for the object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in throttled requests for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a storage growth above the expected trend.
  # This corresponds to the `STORAGE_GROWTH_ABOVE_TREND` finding type.
  # @!attribute [r] total_storage_growth_bytes
  #   @return [::Integer]
  #     Output only. The total storage growth in bytes.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in storage growth.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in storage
  #     growth.
  class StorageGrowthAboveTrend
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the storage growth details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_storage_growth_bytes
    #   @return [::Integer]
    #     Output only. The total storage growth in bytes for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in storage growth for the bucket.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end
end

#target_resource ⇒ `::String` (readonly)

Returns Output only. The fully qualified resource name of the resource that this IntelligenceFinding applies to. eg:

storage.googleapis.com/projects/_/buckets/b1
cloudresourecemanager.googleapis.com/projects/p1.

Returns:

(::String) —
Output only. The fully qualified resource name of the resource that this IntelligenceFinding applies to. eg:
- storage.googleapis.com/projects/_/buckets/b1
- cloudresourecemanager.googleapis.com/projects/p1

# File 'proto_docs/google/storage/control/v2/storage_control.rb', line 1358

class IntelligenceFinding
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents a finding about a spike in Class A/B operations on Coldline
  # or Archive Cloud Storage objects.
  # This corresponds to the `COLD_AND_ARCHIVAL_STORAGE_OPERATIONS_SPIKE`
  # finding type.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in operations across the project.
  # @!attribute [r] total_operations_count
  #   @return [::Integer]
  #     Output only. The total count of operations across the project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution>]
  #     Output only. A list of the top buckets driving the increase in
  #     operations.
  class ColdlineAndArchivalStorageOperationsSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the operation spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in operations for the bucket.
    # @!attribute [r] total_operations_count
    #   @return [::Integer]
    #     Output only. The total count of operations for the bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in operations.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the operation spike details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in operations for the object
        #     prefix.
        # @!attribute [r] total_operations_count
        #   @return [::Integer]
        #     Output only. The total count of operations for the object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in cross-region egress from Cloud
  # Storage.
  # This corresponds to the `CROSS_REGION_EGRESS_SPIKE` finding type.
  # @!attribute [r] total_egress_bytes
  #   @return [::Integer]
  #     Output only. The total cross-region egress volume in bytes across the
  #     project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in cross-region egress across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in cross-region
  #     egress.
  class CrossRegionEgressSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the cross-region egress spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_egress_bytes
    #   @return [::Integer]
    #     Output only. The total cross-region egress volume in bytes for the
    #     bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in cross-region egress for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in cross-region egress.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the cross-region egress spike details for an object
        # prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] total_egress_bytes
        #   @return [::Integer]
        #     Output only. The total cross-region egress volume in bytes from the
        #     object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in cross-region egress for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in throttled requests (429 errors)
  # within a project.
  # This corresponds to the `THROTTLED_REQUEST_SPIKE` finding type.
  # @!attribute [r] throttled_requests
  #   @return [::Integer]
  #     Output only. The count of throttled requests across the project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in throttled requests across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in throttled
  #     requests.
  class ThrottledRequestSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the throttled requests details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] throttled_requests
    #   @return [::Integer]
    #     Output only. The count of throttled requests for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in throttled requests for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of top object prefixes driving the increase in
      #     throttled requests.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents throttled requests details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] throttled_requests
        #   @return [::Integer]
        #     Output only. The count of throttled requests for the object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in throttled requests for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a storage growth above the expected trend.
  # This corresponds to the `STORAGE_GROWTH_ABOVE_TREND` finding type.
  # @!attribute [r] total_storage_growth_bytes
  #   @return [::Integer]
  #     Output only. The total storage growth in bytes.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in storage growth.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in storage
  #     growth.
  class StorageGrowthAboveTrend
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the storage growth details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_storage_growth_bytes
    #   @return [::Integer]
    #     Output only. The total storage growth in bytes for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in storage growth for the bucket.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end
end

#throttled_requests_spike ⇒ `::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike` (readonly)

Returns Output only. IntelligenceFinding about a spike in throttled requests (429 errors) within a project.

Note: The following fields are mutually exclusive: throttled_requests_spike, coldline_and_archival_storage_operations_spike, cross_region_egress_spike, storage_growth_above_trend. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:

(::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike) —
Output only. IntelligenceFinding about a spike in throttled requests (429 errors) within a project.

Note: The following fields are mutually exclusive: throttled_requests_spike, coldline_and_archival_storage_operations_spike, cross_region_egress_spike, storage_growth_above_trend. If a field in that set is populated, all other fields in the set will automatically be cleared.

# File 'proto_docs/google/storage/control/v2/storage_control.rb', line 1358

class IntelligenceFinding
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents a finding about a spike in Class A/B operations on Coldline
  # or Archive Cloud Storage objects.
  # This corresponds to the `COLD_AND_ARCHIVAL_STORAGE_OPERATIONS_SPIKE`
  # finding type.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in operations across the project.
  # @!attribute [r] total_operations_count
  #   @return [::Integer]
  #     Output only. The total count of operations across the project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution>]
  #     Output only. A list of the top buckets driving the increase in
  #     operations.
  class ColdlineAndArchivalStorageOperationsSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the operation spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in operations for the bucket.
    # @!attribute [r] total_operations_count
    #   @return [::Integer]
    #     Output only. The total count of operations for the bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in operations.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the operation spike details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in operations for the object
        #     prefix.
        # @!attribute [r] total_operations_count
        #   @return [::Integer]
        #     Output only. The total count of operations for the object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in cross-region egress from Cloud
  # Storage.
  # This corresponds to the `CROSS_REGION_EGRESS_SPIKE` finding type.
  # @!attribute [r] total_egress_bytes
  #   @return [::Integer]
  #     Output only. The total cross-region egress volume in bytes across the
  #     project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in cross-region egress across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in cross-region
  #     egress.
  class CrossRegionEgressSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the cross-region egress spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_egress_bytes
    #   @return [::Integer]
    #     Output only. The total cross-region egress volume in bytes for the
    #     bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in cross-region egress for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in cross-region egress.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the cross-region egress spike details for an object
        # prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] total_egress_bytes
        #   @return [::Integer]
        #     Output only. The total cross-region egress volume in bytes from the
        #     object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in cross-region egress for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in throttled requests (429 errors)
  # within a project.
  # This corresponds to the `THROTTLED_REQUEST_SPIKE` finding type.
  # @!attribute [r] throttled_requests
  #   @return [::Integer]
  #     Output only. The count of throttled requests across the project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in throttled requests across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in throttled
  #     requests.
  class ThrottledRequestSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the throttled requests details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] throttled_requests
    #   @return [::Integer]
    #     Output only. The count of throttled requests for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in throttled requests for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of top object prefixes driving the increase in
      #     throttled requests.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents throttled requests details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] throttled_requests
        #   @return [::Integer]
        #     Output only. The count of throttled requests for the object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in throttled requests for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a storage growth above the expected trend.
  # This corresponds to the `STORAGE_GROWTH_ABOVE_TREND` finding type.
  # @!attribute [r] total_storage_growth_bytes
  #   @return [::Integer]
  #     Output only. The total storage growth in bytes.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in storage growth.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in storage
  #     growth.
  class StorageGrowthAboveTrend
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the storage growth details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_storage_growth_bytes
    #   @return [::Integer]
    #     Output only. The total storage growth in bytes for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in storage growth for the bucket.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end
end

#type ⇒ `::Google::Cloud::Storage::Control::V2::FindingType` (readonly)

Returns Output only. Type of this finding.

Returns:

(::Google::Cloud::Storage::Control::V2::FindingType) —
Output only. Type of this finding.

# File 'proto_docs/google/storage/control/v2/storage_control.rb', line 1358

class IntelligenceFinding
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents a finding about a spike in Class A/B operations on Coldline
  # or Archive Cloud Storage objects.
  # This corresponds to the `COLD_AND_ARCHIVAL_STORAGE_OPERATIONS_SPIKE`
  # finding type.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in operations across the project.
  # @!attribute [r] total_operations_count
  #   @return [::Integer]
  #     Output only. The total count of operations across the project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution>]
  #     Output only. A list of the top buckets driving the increase in
  #     operations.
  class ColdlineAndArchivalStorageOperationsSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the operation spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in operations for the bucket.
    # @!attribute [r] total_operations_count
    #   @return [::Integer]
    #     Output only. The total count of operations for the bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in operations.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the operation spike details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in operations for the object
        #     prefix.
        # @!attribute [r] total_operations_count
        #   @return [::Integer]
        #     Output only. The total count of operations for the object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in cross-region egress from Cloud
  # Storage.
  # This corresponds to the `CROSS_REGION_EGRESS_SPIKE` finding type.
  # @!attribute [r] total_egress_bytes
  #   @return [::Integer]
  #     Output only. The total cross-region egress volume in bytes across the
  #     project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in cross-region egress across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in cross-region
  #     egress.
  class CrossRegionEgressSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the cross-region egress spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_egress_bytes
    #   @return [::Integer]
    #     Output only. The total cross-region egress volume in bytes for the
    #     bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in cross-region egress for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in cross-region egress.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the cross-region egress spike details for an object
        # prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] total_egress_bytes
        #   @return [::Integer]
        #     Output only. The total cross-region egress volume in bytes from the
        #     object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in cross-region egress for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in throttled requests (429 errors)
  # within a project.
  # This corresponds to the `THROTTLED_REQUEST_SPIKE` finding type.
  # @!attribute [r] throttled_requests
  #   @return [::Integer]
  #     Output only. The count of throttled requests across the project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in throttled requests across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in throttled
  #     requests.
  class ThrottledRequestSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the throttled requests details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] throttled_requests
    #   @return [::Integer]
    #     Output only. The count of throttled requests for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in throttled requests for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of top object prefixes driving the increase in
      #     throttled requests.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents throttled requests details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] throttled_requests
        #   @return [::Integer]
        #     Output only. The count of throttled requests for the object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in throttled requests for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a storage growth above the expected trend.
  # This corresponds to the `STORAGE_GROWTH_ABOVE_TREND` finding type.
  # @!attribute [r] total_storage_growth_bytes
  #   @return [::Integer]
  #     Output only. The total storage growth in bytes.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in storage growth.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in storage
  #     growth.
  class StorageGrowthAboveTrend
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the storage growth details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_storage_growth_bytes
    #   @return [::Integer]
    #     Output only. The total storage growth in bytes for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in storage growth for the bucket.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end
end

#update_time ⇒ `::Google::Protobuf::Timestamp` (readonly)

Returns Output only. The time at which the finding was last updated.

Returns:

(::Google::Protobuf::Timestamp) —
Output only. The time at which the finding was last updated.

# File 'proto_docs/google/storage/control/v2/storage_control.rb', line 1358

class IntelligenceFinding
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Represents a finding about a spike in Class A/B operations on Coldline
  # or Archive Cloud Storage objects.
  # This corresponds to the `COLD_AND_ARCHIVAL_STORAGE_OPERATIONS_SPIKE`
  # finding type.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in operations across the project.
  # @!attribute [r] total_operations_count
  #   @return [::Integer]
  #     Output only. The total count of operations across the project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution>]
  #     Output only. A list of the top buckets driving the increase in
  #     operations.
  class ColdlineAndArchivalStorageOperationsSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the operation spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in operations for the bucket.
    # @!attribute [r] total_operations_count
    #   @return [::Integer]
    #     Output only. The total count of operations for the bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in operations.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the operation spike details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in operations for the object
        #     prefix.
        # @!attribute [r] total_operations_count
        #   @return [::Integer]
        #     Output only. The total count of operations for the object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in cross-region egress from Cloud
  # Storage.
  # This corresponds to the `CROSS_REGION_EGRESS_SPIKE` finding type.
  # @!attribute [r] total_egress_bytes
  #   @return [::Integer]
  #     Output only. The total cross-region egress volume in bytes across the
  #     project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in cross-region egress across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in cross-region
  #     egress.
  class CrossRegionEgressSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the cross-region egress spike details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_egress_bytes
    #   @return [::Integer]
    #     Output only. The total cross-region egress volume in bytes for the
    #     bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in cross-region egress for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of the top object prefixes driving the increase
      #     in cross-region egress.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents the cross-region egress spike details for an object
        # prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] total_egress_bytes
        #   @return [::Integer]
        #     Output only. The total cross-region egress volume in bytes from the
        #     object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in cross-region egress for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a spike in throttled requests (429 errors)
  # within a project.
  # This corresponds to the `THROTTLED_REQUEST_SPIKE` finding type.
  # @!attribute [r] throttled_requests
  #   @return [::Integer]
  #     Output only. The count of throttled requests across the project.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in throttled requests across the
  #     project.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in throttled
  #     requests.
  class ThrottledRequestSpike
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the throttled requests details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] throttled_requests
    #   @return [::Integer]
    #     Output only. The count of throttled requests for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in throttled requests for the
    #     bucket.
    # @!attribute [r] contribution
    #   @return [::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution]
    #     Output only. The details about the contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `contribution`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    #
    #     Note: The following fields are mutually exclusive: `error`, `contribution`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Represents the contribution of the bucket towards the
      # `IntelligenceFinding`.
      # @!attribute [r] top_prefixes
      #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike::BucketContribution::Contribution::PrefixContribution>]
      #     Output only. A list of top object prefixes driving the increase in
      #     throttled requests.
      class Contribution
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods

        # Represents throttled requests details for an object prefix.
        # @!attribute [r] prefix
        #   @return [::String]
        #     Output only. The object prefix.
        #     Format: `a/b/c`, 'a/b/d', etc.
        # @!attribute [r] throttled_requests
        #   @return [::Integer]
        #     Output only. The count of throttled requests for the object prefix.
        # @!attribute [r] percentage_increase
        #   @return [::Float]
        #     Output only. The percentage increase in throttled requests for the
        #     object prefix.
        class PrefixContribution
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end

  # Represents a finding about a storage growth above the expected trend.
  # This corresponds to the `STORAGE_GROWTH_ABOVE_TREND` finding type.
  # @!attribute [r] total_storage_growth_bytes
  #   @return [::Integer]
  #     Output only. The total storage growth in bytes.
  # @!attribute [r] percentage_increase
  #   @return [::Float]
  #     Output only. The percentage increase in storage growth.
  # @!attribute [r] top_buckets
  #   @return [::Array<::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend::BucketContribution>]
  #     Output only. A list of top buckets driving the increase in storage
  #     growth.
  class StorageGrowthAboveTrend
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Represents the storage growth details for a bucket.
    # @!attribute [r] bucket
    #   @return [::String]
    #     Output only. The name of the bucket.
    # @!attribute [r] total_storage_growth_bytes
    #   @return [::Integer]
    #     Output only. The total storage growth in bytes for the bucket.
    # @!attribute [r] percentage_increase
    #   @return [::Float]
    #     Output only. The percentage increase in storage growth for the bucket.
    # @!attribute [r] error
    #   @return [::Google::Rpc::Status]
    #     Output only. The error related to accessing the details about the
    #     contribution of the bucket.
    class BucketContribution
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end
end

Class: Google::Cloud::Storage::Control::V2::IntelligenceFinding

Overview

Defined Under Namespace

Instance Attribute Summary collapse

Instance Attribute Details

#associated_resources ⇒ ::Array<::String> (readonly)

#category ⇒ ::Google::Cloud::Storage::Control::V2::FindingCategory (readonly)

#coldline_and_archival_storage_operations_spike ⇒ ::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike (readonly)

#create_time ⇒ ::Google::Protobuf::Timestamp (readonly)

#cross_region_egress_spike ⇒ ::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike (readonly)

#description ⇒ ::String (readonly)

#name ⇒ ::String

#observation_period ⇒ ::Google::Type::Interval (readonly)

#severity ⇒ ::Google::Cloud::Storage::Control::V2::FindingSeverity (readonly)

#storage_growth_above_trend ⇒ ::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend (readonly)

#target_resource ⇒ ::String (readonly)

#throttled_requests_spike ⇒ ::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike (readonly)

#type ⇒ ::Google::Cloud::Storage::Control::V2::FindingType (readonly)

#update_time ⇒ ::Google::Protobuf::Timestamp (readonly)

#associated_resources ⇒ `::Array<::String>` (readonly)

#category ⇒ `::Google::Cloud::Storage::Control::V2::FindingCategory` (readonly)

#coldline_and_archival_storage_operations_spike ⇒ `::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ColdlineAndArchivalStorageOperationsSpike` (readonly)

#create_time ⇒ `::Google::Protobuf::Timestamp` (readonly)

#cross_region_egress_spike ⇒ `::Google::Cloud::Storage::Control::V2::IntelligenceFinding::CrossRegionEgressSpike` (readonly)

#description ⇒ `::String` (readonly)

#name ⇒ `::String`

#observation_period ⇒ `::Google::Type::Interval` (readonly)

#severity ⇒ `::Google::Cloud::Storage::Control::V2::FindingSeverity` (readonly)

#storage_growth_above_trend ⇒ `::Google::Cloud::Storage::Control::V2::IntelligenceFinding::StorageGrowthAboveTrend` (readonly)

#target_resource ⇒ `::String` (readonly)

#throttled_requests_spike ⇒ `::Google::Cloud::Storage::Control::V2::IntelligenceFinding::ThrottledRequestSpike` (readonly)

#type ⇒ `::Google::Cloud::Storage::Control::V2::FindingType` (readonly)

#update_time ⇒ `::Google::Protobuf::Timestamp` (readonly)