File: get_bucket_logging.rb

package info (click to toggle)
ruby-fog-aws 3.3.0-5
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 7,816 kB
  • sloc: ruby: 68,587; makefile: 6
file content (45 lines) | stat: -rw-r--r-- 1,687 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
module Fog
  module AWS
    class Storage
      class Real
        require 'fog/aws/parsers/storage/get_bucket_logging'

        # Get logging status for an S3 bucket
        #
        # @param bucket_name [String] name of bucket to get logging status for
        #
        # @return [Excon::Response] response:
        #   * body [Hash]:
        #     * BucketLoggingStatus (will be empty if logging is disabled) [Hash]:
        #       * LoggingEnabled [Hash]:
        #         * TargetBucket [String] - bucket where logs are stored
        #         * TargetPrefix [String] - prefix logs are stored with
        #         * TargetGrants [Array]:
        #           * Grant [Hash]:
        #             * Grantee [Hash]:
        #               * DisplayName [String] - Display name of grantee
        #               * ID [String] - Id of grantee
        #               or
        #               * URI [String] - URI of group to grant access for
        #             * Permission [String] - Permission, in [FULL_CONTROL, WRITE, WRITE_ACP, READ, READ_ACP]
        #
        # @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETlogging.html

        def get_bucket_logging(bucket_name)
          unless bucket_name
            raise ArgumentError.new('bucket_name is required')
          end
          request({
            :expects    => 200,
            :headers    => {},
            :bucket_name => bucket_name,
            :idempotent => true,
            :method     => 'GET',
            :parser     => Fog::Parsers::AWS::Storage::GetBucketLogging.new,
            :query      => {'logging' => nil}
          })
        end
      end
    end
  end
end