import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint"; import { Command as $Command } from "@aws-sdk/smithy-client"; import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types"; import { PutBucketMetricsConfigurationRequest } from "../models/models_0"; import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client"; /** * @public * * The input for {@link PutBucketMetricsConfigurationCommand}. */ export interface PutBucketMetricsConfigurationCommandInput extends PutBucketMetricsConfigurationRequest { } /** * @public * * The output of {@link PutBucketMetricsConfigurationCommand}. */ export interface PutBucketMetricsConfigurationCommandOutput extends __MetadataBearer { } /** * @public *

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:

* * @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { S3Client, PutBucketMetricsConfigurationCommand } from "@aws-sdk/client-s3"; // ES Modules import * // const { S3Client, PutBucketMetricsConfigurationCommand } = require("@aws-sdk/client-s3"); // CommonJS import * const client = new S3Client(config); * const input = { // PutBucketMetricsConfigurationRequest * Bucket: "STRING_VALUE", // required * Id: "STRING_VALUE", // required * MetricsConfiguration: { // MetricsConfiguration * Id: "STRING_VALUE", // required * Filter: { // MetricsFilter Union: only one key present * Prefix: "STRING_VALUE", * Tag: { // Tag * Key: "STRING_VALUE", // required * Value: "STRING_VALUE", // required * }, * AccessPointArn: "STRING_VALUE", * And: { // MetricsAndOperator * Prefix: "STRING_VALUE", * Tags: [ // TagSet * { * Key: "STRING_VALUE", // required * Value: "STRING_VALUE", // required * }, * ], * AccessPointArn: "STRING_VALUE", * }, * }, * }, * ExpectedBucketOwner: "STRING_VALUE", * }; * const command = new PutBucketMetricsConfigurationCommand(input); * const response = await client.send(command); * ``` * * @param PutBucketMetricsConfigurationCommandInput - {@link PutBucketMetricsConfigurationCommandInput} * @returns {@link PutBucketMetricsConfigurationCommandOutput} * @see {@link PutBucketMetricsConfigurationCommandInput} for command's `input` shape. * @see {@link PutBucketMetricsConfigurationCommandOutput} for command's `response` shape. * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape. * * */ export declare class PutBucketMetricsConfigurationCommand extends $Command { readonly input: PutBucketMetricsConfigurationCommandInput; static getEndpointParameterInstructions(): EndpointParameterInstructions; /** * @public */ constructor(input: PutBucketMetricsConfigurationCommandInput); /** * @internal */ resolveMiddleware(clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, options?: __HttpHandlerOptions): Handler; /** * @internal */ private serialize; /** * @internal */ private deserialize; }