aws-sdk-s3 1.0.0.rc1

data/lib/aws-sdk-s3/bucket_acl.rb

@@ -0,0 +1,168 @@
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing for info on making contributions:
+# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+module Aws
+  module S3
+    class BucketAcl
+
+      extend Aws::Deprecations
+
+      # @overload def initialize(bucket_name, options = {})
+      #   @param [String] bucket_name
+      #   @option options [Client] :client
+      # @overload def initialize(options = {})
+      #   @option options [required, String] :bucket_name
+      #   @option options [Client] :client
+      def initialize(*args)
+        options = Hash === args.last ? args.pop.dup : {}
+        @bucket_name = extract_bucket_name(args, options)
+        @data = options.delete(:data)
+        @client = options.delete(:client) || Client.new(options)
+      end
+
+      # @!group Read-Only Attributes
+
+      # @return [String]
+      def bucket_name
+        @bucket_name
+      end
+
+      # @return [Types::Owner]
+      def owner
+        data.owner
+      end
+
+      # A list of grants.
+      # @return [Array<Types::Grant>]
+      def grants
+        data.grants
+      end
+
+      # @!endgroup
+
+      # @return [Client]
+      def client
+        @client
+      end
+
+      # Loads, or reloads {#data} for the current {BucketAcl}.
+      # Returns `self` making it possible to chain methods.
+      #
+      #     bucket_acl.reload.data
+      #
+      # @return [self]
+      def load
+        resp = @client.get_bucket_acl(bucket: @bucket_name)
+        @data = resp.data
+        self
+      end
+      alias :reload :load
+
+      # @return [Types::GetBucketAclOutput]
+      #   Returns the data for this {BucketAcl}. Calls
+      #   {Client#get_bucket_acl} if {#data_loaded?} is `false`.
+      def data
+        load unless @data
+        @data
+      end
+
+      # @return [Boolean]
+      #   Returns `true` if this resource is loaded.  Accessing attributes or
+      #   {#data} on an unloaded resource will trigger a call to {#load}.
+      def data_loaded?
+        !!@data
+      end
+
+      # @!group Actions
+
+      # @example Request syntax with placeholder values
+      #
+      #   bucket_acl.put({
+      #     acl: "private", # accepts private, public-read, public-read-write, authenticated-read
+      #     access_control_policy: {
+      #       grants: [
+      #         {
+      #           grantee: {
+      #             display_name: "DisplayName",
+      #             email_address: "EmailAddress",
+      #             id: "ID",
+      #             type: "CanonicalUser", # required, accepts CanonicalUser, AmazonCustomerByEmail, Group
+      #             uri: "URI",
+      #           },
+      #           permission: "FULL_CONTROL", # accepts FULL_CONTROL, WRITE, WRITE_ACP, READ, READ_ACP
+      #         },
+      #       ],
+      #       owner: {
+      #         display_name: "DisplayName",
+      #         id: "ID",
+      #       },
+      #     },
+      #     content_md5: "ContentMD5",
+      #     grant_full_control: "GrantFullControl",
+      #     grant_read: "GrantRead",
+      #     grant_read_acp: "GrantReadACP",
+      #     grant_write: "GrantWrite",
+      #     grant_write_acp: "GrantWriteACP",
+      #   })
+      # @param [Hash] options ({})
+      # @option options [String] :acl
+      #   The canned ACL to apply to the bucket.
+      # @option options [Types::AccessControlPolicy] :access_control_policy
+      # @option options [String] :content_md5
+      # @option options [String] :grant_full_control
+      #   Allows grantee the read, write, read ACP, and write ACP permissions on
+      #   the bucket.
+      # @option options [String] :grant_read
+      #   Allows grantee to list the objects in the bucket.
+      # @option options [String] :grant_read_acp
+      #   Allows grantee to read the bucket ACL.
+      # @option options [String] :grant_write
+      #   Allows grantee to create, overwrite, and delete any object in the
+      #   bucket.
+      # @option options [String] :grant_write_acp
+      #   Allows grantee to write the ACL for the applicable bucket.
+      # @return [EmptyStructure]
+      def put(options = {})
+        options = options.merge(bucket: @bucket_name)
+        resp = @client.put_bucket_acl(options)
+        resp.data
+      end
+
+      # @!group Associations
+
+      # @return [Bucket]
+      def bucket
+        Bucket.new(
+          name: @bucket_name,
+          client: @client
+        )
+      end
+
+      # @deprecated
+      # @api private
+      def identifiers
+        { bucket_name: @bucket_name }
+      end
+      deprecated(:identifiers)
+
+      private
+
+      def extract_bucket_name(args, options)
+        value = args[0] || options.delete(:bucket_name)
+        case value
+        when String then value
+        when nil then raise ArgumentError, "missing required option :bucket_name"
+        else
+          msg = "expected :bucket_name to be a String, got #{value.class}"
+          raise ArgumentError, msg
+        end
+      end
+
+      class Collection < Aws::Resources::Collection; end
+    end
+  end
+end

data/lib/aws-sdk-s3/bucket_cors.rb

@@ -0,0 +1,146 @@
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing for info on making contributions:
+# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+module Aws
+  module S3
+    class BucketCors
+
+      extend Aws::Deprecations
+
+      # @overload def initialize(bucket_name, options = {})
+      #   @param [String] bucket_name
+      #   @option options [Client] :client
+      # @overload def initialize(options = {})
+      #   @option options [required, String] :bucket_name
+      #   @option options [Client] :client
+      def initialize(*args)
+        options = Hash === args.last ? args.pop.dup : {}
+        @bucket_name = extract_bucket_name(args, options)
+        @data = options.delete(:data)
+        @client = options.delete(:client) || Client.new(options)
+      end
+
+      # @!group Read-Only Attributes
+
+      # @return [String]
+      def bucket_name
+        @bucket_name
+      end
+
+      # @return [Array<Types::CORSRule>]
+      def cors_rules
+        data.cors_rules
+      end
+
+      # @!endgroup
+
+      # @return [Client]
+      def client
+        @client
+      end
+
+      # Loads, or reloads {#data} for the current {BucketCors}.
+      # Returns `self` making it possible to chain methods.
+      #
+      #     bucket_cors.reload.data
+      #
+      # @return [self]
+      def load
+        resp = @client.get_bucket_cors(bucket: @bucket_name)
+        @data = resp.data
+        self
+      end
+      alias :reload :load
+
+      # @return [Types::GetBucketCorsOutput]
+      #   Returns the data for this {BucketCors}. Calls
+      #   {Client#get_bucket_cors} if {#data_loaded?} is `false`.
+      def data
+        load unless @data
+        @data
+      end
+
+      # @return [Boolean]
+      #   Returns `true` if this resource is loaded.  Accessing attributes or
+      #   {#data} on an unloaded resource will trigger a call to {#load}.
+      def data_loaded?
+        !!@data
+      end
+
+      # @!group Actions
+
+      # @example Request syntax with placeholder values
+      #
+      #   bucket_cors.delete()
+      # @param [Hash] options ({})
+      # @return [EmptyStructure]
+      def delete(options = {})
+        options = options.merge(bucket: @bucket_name)
+        resp = @client.delete_bucket_cors(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   bucket_cors.put({
+      #     cors_configuration: { # required
+      #       cors_rules: [ # required
+      #         {
+      #           allowed_headers: ["AllowedHeader"],
+      #           allowed_methods: ["AllowedMethod"], # required
+      #           allowed_origins: ["AllowedOrigin"], # required
+      #           expose_headers: ["ExposeHeader"],
+      #           max_age_seconds: 1,
+      #         },
+      #       ],
+      #     },
+      #     content_md5: "ContentMD5",
+      #   })
+      # @param [Hash] options ({})
+      # @option options [required, Types::CORSConfiguration] :cors_configuration
+      # @option options [String] :content_md5
+      # @return [EmptyStructure]
+      def put(options = {})
+        options = options.merge(bucket: @bucket_name)
+        resp = @client.put_bucket_cors(options)
+        resp.data
+      end
+
+      # @!group Associations
+
+      # @return [Bucket]
+      def bucket
+        Bucket.new(
+          name: @bucket_name,
+          client: @client
+        )
+      end
+
+      # @deprecated
+      # @api private
+      def identifiers
+        { bucket_name: @bucket_name }
+      end
+      deprecated(:identifiers)
+
+      private
+
+      def extract_bucket_name(args, options)
+        value = args[0] || options.delete(:bucket_name)
+        case value
+        when String then value
+        when nil then raise ArgumentError, "missing required option :bucket_name"
+        else
+          msg = "expected :bucket_name to be a String, got #{value.class}"
+          raise ArgumentError, msg
+        end
+      end
+
+      class Collection < Aws::Resources::Collection; end
+    end
+  end
+end

data/lib/aws-sdk-s3/bucket_lifecycle.rb

@@ -0,0 +1,164 @@
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing for info on making contributions:
+# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+module Aws
+  module S3
+    class BucketLifecycle
+
+      extend Aws::Deprecations
+
+      # @overload def initialize(bucket_name, options = {})
+      #   @param [String] bucket_name
+      #   @option options [Client] :client
+      # @overload def initialize(options = {})
+      #   @option options [required, String] :bucket_name
+      #   @option options [Client] :client
+      def initialize(*args)
+        options = Hash === args.last ? args.pop.dup : {}
+        @bucket_name = extract_bucket_name(args, options)
+        @data = options.delete(:data)
+        @client = options.delete(:client) || Client.new(options)
+      end
+
+      # @!group Read-Only Attributes
+
+      # @return [String]
+      def bucket_name
+        @bucket_name
+      end
+
+      # @return [Array<Types::Rule>]
+      def rules
+        data.rules
+      end
+
+      # @!endgroup
+
+      # @return [Client]
+      def client
+        @client
+      end
+
+      # Loads, or reloads {#data} for the current {BucketLifecycle}.
+      # Returns `self` making it possible to chain methods.
+      #
+      #     bucket_lifecycle.reload.data
+      #
+      # @return [self]
+      def load
+        resp = @client.get_bucket_lifecycle(bucket: @bucket_name)
+        @data = resp.data
+        self
+      end
+      alias :reload :load
+
+      # @return [Types::GetBucketLifecycleOutput]
+      #   Returns the data for this {BucketLifecycle}. Calls
+      #   {Client#get_bucket_lifecycle} if {#data_loaded?} is `false`.
+      def data
+        load unless @data
+        @data
+      end
+
+      # @return [Boolean]
+      #   Returns `true` if this resource is loaded.  Accessing attributes or
+      #   {#data} on an unloaded resource will trigger a call to {#load}.
+      def data_loaded?
+        !!@data
+      end
+
+      # @!group Actions
+
+      # @example Request syntax with placeholder values
+      #
+      #   bucket_lifecycle.delete()
+      # @param [Hash] options ({})
+      # @return [EmptyStructure]
+      def delete(options = {})
+        options = options.merge(bucket: @bucket_name)
+        resp = @client.delete_bucket_lifecycle(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   bucket_lifecycle.put({
+      #     content_md5: "ContentMD5",
+      #     lifecycle_configuration: {
+      #       rules: [ # required
+      #         {
+      #           expiration: {
+      #             date: Time.now,
+      #             days: 1,
+      #             expired_object_delete_marker: false,
+      #           },
+      #           id: "ID",
+      #           prefix: "Prefix", # required
+      #           status: "Enabled", # required, accepts Enabled, Disabled
+      #           transition: {
+      #             date: Time.now,
+      #             days: 1,
+      #             storage_class: "GLACIER", # accepts GLACIER, STANDARD_IA
+      #           },
+      #           noncurrent_version_transition: {
+      #             noncurrent_days: 1,
+      #             storage_class: "GLACIER", # accepts GLACIER, STANDARD_IA
+      #           },
+      #           noncurrent_version_expiration: {
+      #             noncurrent_days: 1,
+      #           },
+      #           abort_incomplete_multipart_upload: {
+      #             days_after_initiation: 1,
+      #           },
+      #         },
+      #       ],
+      #     },
+      #   })
+      # @param [Hash] options ({})
+      # @option options [String] :content_md5
+      # @option options [Types::LifecycleConfiguration] :lifecycle_configuration
+      # @return [EmptyStructure]
+      def put(options = {})
+        options = options.merge(bucket: @bucket_name)
+        resp = @client.put_bucket_lifecycle(options)
+        resp.data
+      end
+
+      # @!group Associations
+
+      # @return [Bucket]
+      def bucket
+        Bucket.new(
+          name: @bucket_name,
+          client: @client
+        )
+      end
+
+      # @deprecated
+      # @api private
+      def identifiers
+        { bucket_name: @bucket_name }
+      end
+      deprecated(:identifiers)
+
+      private
+
+      def extract_bucket_name(args, options)
+        value = args[0] || options.delete(:bucket_name)
+        case value
+        when String then value
+        when nil then raise ArgumentError, "missing required option :bucket_name"
+        else
+          msg = "expected :bucket_name to be a String, got #{value.class}"
+          raise ArgumentError, msg
+        end
+      end
+
+      class Collection < Aws::Resources::Collection; end
+    end
+  end
+end