Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.S3.PutBucketMetricsConfiguration

Contents

Creating a Request
Request Lenses
Destructuring the Response

Description

Sets a metrics configuration (specified by the metrics configuration ID) for the bucket. You can have up to 1,000 metrics configurations per bucket. If you're updating an existing metrics configuration, note that this is a full replacement of the existing metrics configuration. If you don't include the elements you want to keep, they are erased.

To use this operation, you must have permissions to perform the s3:PutMetricsConfiguration action. The bucket owner has this permission by default. The bucket owner can grant this permission to others. For more information about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 Resources.

For information about CloudWatch request metrics for Amazon S3, see Monitoring Metrics with Amazon CloudWatch.

The following operations are related to PutBucketMetricsConfiguration:

GetBucketLifecycle has the following special error:

Error code: TooManyConfigurations
- Description: You are attempting to create a new configuration but have already reached the 1,000-configuration limit.
- HTTP Status Code: HTTP 400 Bad Request

Creating a Request

data PutBucketMetricsConfiguration Source #

See: newPutBucketMetricsConfiguration smart constructor.

Constructors

PutBucketMetricsConfiguration'

Fields

expectedBucketOwner :: Maybe Text
The account ID of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied) error.
bucket :: BucketName
The name of the bucket for which the metrics configuration is set.
id :: Text
The ID used to identify the metrics configuration.
metricsConfiguration :: MetricsConfiguration
Specifies the metrics configuration.

Instances

Instances details

Eq PutBucketMetricsConfiguration Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration Methods (==) :: PutBucketMetricsConfiguration -> PutBucketMetricsConfiguration -> Bool # (/=) :: PutBucketMetricsConfiguration -> PutBucketMetricsConfiguration -> Bool #
Read PutBucketMetricsConfiguration Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration Methods readsPrec :: Int -> ReadS PutBucketMetricsConfiguration # readList :: ReadS [PutBucketMetricsConfiguration] # readPrec :: ReadPrec PutBucketMetricsConfiguration # readListPrec :: ReadPrec [PutBucketMetricsConfiguration] #
Show PutBucketMetricsConfiguration Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration Methods showsPrec :: Int -> PutBucketMetricsConfiguration -> ShowS # show :: PutBucketMetricsConfiguration -> String # showList :: [PutBucketMetricsConfiguration] -> ShowS #
Generic PutBucketMetricsConfiguration Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration Associated Types type Rep PutBucketMetricsConfiguration :: Type -> Type # Methods from :: PutBucketMetricsConfiguration -> Rep PutBucketMetricsConfiguration x # to :: Rep PutBucketMetricsConfiguration x -> PutBucketMetricsConfiguration #
NFData PutBucketMetricsConfiguration Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration Methods rnf :: PutBucketMetricsConfiguration -> () #
Hashable PutBucketMetricsConfiguration Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration Methods hashWithSalt :: Int -> PutBucketMetricsConfiguration -> Int # hash :: PutBucketMetricsConfiguration -> Int #
AWSRequest PutBucketMetricsConfiguration Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration Associated Types type AWSResponse PutBucketMetricsConfiguration # Methods request :: PutBucketMetricsConfiguration -> Request PutBucketMetricsConfiguration # response :: MonadResource m => Logger -> Service -> Proxy PutBucketMetricsConfiguration -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse PutBucketMetricsConfiguration))) #
ToHeaders PutBucketMetricsConfiguration Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration Methods toHeaders :: PutBucketMetricsConfiguration -> [Header] #
ToPath PutBucketMetricsConfiguration Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration Methods toPath :: PutBucketMetricsConfiguration -> ByteString #
ToQuery PutBucketMetricsConfiguration Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration Methods toQuery :: PutBucketMetricsConfiguration -> QueryString #
ToElement PutBucketMetricsConfiguration Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration Methods toElement :: PutBucketMetricsConfiguration -> Element #
type Rep PutBucketMetricsConfiguration Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration type Rep PutBucketMetricsConfiguration = D1 ('MetaData "PutBucketMetricsConfiguration" "Amazonka.S3.PutBucketMetricsConfiguration" "libZSservicesZSamazonka-s3ZSamazonka-s3" 'False) (C1 ('MetaCons "PutBucketMetricsConfiguration'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "expectedBucketOwner") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "bucket") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 BucketName)) :: (S1 ('MetaSel ('Just "id") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "metricsConfiguration") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 MetricsConfiguration))))
type AWSResponse PutBucketMetricsConfiguration Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration type AWSResponse PutBucketMetricsConfiguration = PutBucketMetricsConfigurationResponse

newPutBucketMetricsConfiguration Source #

Arguments

:: BucketName	`$sel:bucket:PutBucketMetricsConfiguration'`
-> Text	`$sel:id:PutBucketMetricsConfiguration'`
-> MetricsConfiguration	`$sel:metricsConfiguration:PutBucketMetricsConfiguration'`
-> PutBucketMetricsConfiguration

Create a value of PutBucketMetricsConfiguration with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:expectedBucketOwner:PutBucketMetricsConfiguration', putBucketMetricsConfiguration_expectedBucketOwner - The account ID of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied) error.

$sel:bucket:PutBucketMetricsConfiguration', putBucketMetricsConfiguration_bucket - The name of the bucket for which the metrics configuration is set.

$sel:id:PutBucketMetricsConfiguration', putBucketMetricsConfiguration_id - The ID used to identify the metrics configuration.

$sel:metricsConfiguration:PutBucketMetricsConfiguration', putBucketMetricsConfiguration_metricsConfiguration - Specifies the metrics configuration.

Request Lenses

putBucketMetricsConfiguration_expectedBucketOwner :: Lens' PutBucketMetricsConfiguration (Maybe Text) Source #

The account ID of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied) error.

putBucketMetricsConfiguration_bucket :: Lens' PutBucketMetricsConfiguration BucketName Source #

The name of the bucket for which the metrics configuration is set.

putBucketMetricsConfiguration_id :: Lens' PutBucketMetricsConfiguration Text Source #

The ID used to identify the metrics configuration.

putBucketMetricsConfiguration_metricsConfiguration :: Lens' PutBucketMetricsConfiguration MetricsConfiguration Source #

Specifies the metrics configuration.

Destructuring the Response

data PutBucketMetricsConfigurationResponse Source #

See: newPutBucketMetricsConfigurationResponse smart constructor.

Constructors

PutBucketMetricsConfigurationResponse'

Instances

Instances details

Eq PutBucketMetricsConfigurationResponse Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration Methods (==) :: PutBucketMetricsConfigurationResponse -> PutBucketMetricsConfigurationResponse -> Bool # (/=) :: PutBucketMetricsConfigurationResponse -> PutBucketMetricsConfigurationResponse -> Bool #
Read PutBucketMetricsConfigurationResponse Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration Methods readsPrec :: Int -> ReadS PutBucketMetricsConfigurationResponse # readList :: ReadS [PutBucketMetricsConfigurationResponse] # readPrec :: ReadPrec PutBucketMetricsConfigurationResponse # readListPrec :: ReadPrec [PutBucketMetricsConfigurationResponse] #
Show PutBucketMetricsConfigurationResponse Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration Methods showsPrec :: Int -> PutBucketMetricsConfigurationResponse -> ShowS # show :: PutBucketMetricsConfigurationResponse -> String # showList :: [PutBucketMetricsConfigurationResponse] -> ShowS #
Generic PutBucketMetricsConfigurationResponse Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration Associated Types type Rep PutBucketMetricsConfigurationResponse :: Type -> Type # Methods from :: PutBucketMetricsConfigurationResponse -> Rep PutBucketMetricsConfigurationResponse x # to :: Rep PutBucketMetricsConfigurationResponse x -> PutBucketMetricsConfigurationResponse #
NFData PutBucketMetricsConfigurationResponse Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration Methods rnf :: PutBucketMetricsConfigurationResponse -> () #
type Rep PutBucketMetricsConfigurationResponse Source #
Instance details Defined in Amazonka.S3.PutBucketMetricsConfiguration type Rep PutBucketMetricsConfigurationResponse = D1 ('MetaData "PutBucketMetricsConfigurationResponse" "Amazonka.S3.PutBucketMetricsConfiguration" "libZSservicesZSamazonka-s3ZSamazonka-s3" 'False) (C1 ('MetaCons "PutBucketMetricsConfigurationResponse'" 'PrefixI 'False) (U1 :: Type -> Type))

newPutBucketMetricsConfigurationResponse :: PutBucketMetricsConfigurationResponse Source #

Create a value of PutBucketMetricsConfigurationResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.