import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
import { PutBucketLoggingRequest } from "../models/models_0";
import {
deserializeAws_restXmlPutBucketLoggingCommand,
serializeAws_restXmlPutBucketLoggingCommand,
} from "../protocols/Aws_restXml";
import { getBucketEndpointPlugin } from "@aws-sdk/middleware-bucket-endpoint";
import { getSerdePlugin } from "@aws-sdk/middleware-serde";
import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
import { Command as $Command } from "@aws-sdk/smithy-client";
import {
FinalizeHandlerArguments,
Handler,
HandlerExecutionContext,
MiddlewareStack,
HttpHandlerOptions as __HttpHandlerOptions,
MetadataBearer as __MetadataBearer,
SerdeContext as __SerdeContext,
} from "@aws-sdk/types";
export type PutBucketLoggingCommandInput = PutBucketLoggingRequest;
export type PutBucketLoggingCommandOutput = __MetadataBearer;
/**
* Set the logging parameters for a bucket and to specify permissions for who can view and
* modify the logging parameters. All logs are saved to buckets in the same AWS Region as the
* source bucket. To set the logging status of a bucket, you must be the bucket owner.
*
* The bucket owner is automatically granted FULL_CONTROL to all logs. You use the
* Grantee request element to grant access to other people. The
* Permissions request element specifies the kind of access the grantee has to
* the logs.
*
*
* Grantee Values
*
* You can specify the person (grantee) to whom you're assigning access rights (using
* request elements) in the following ways:
*
*
* -
*
By the person's ID:
*
* <>ID<><>GranteesEmail<>
*
*
* DisplayName is optional and ignored in the request.
*
* -
*
By Email address:
*
* <>Grantees@email.com<>
*
* The grantee is resolved to the CanonicalUser and, in a response to a GET Object
* acl request, appears as the CanonicalUser.
*
* -
*
By URI:
*
* <>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<>
*
*
*
*
*
* To enable logging, you use LoggingEnabled and its children request elements. To disable
* logging, you use an empty BucketLoggingStatus request element:
*
*
*
*
* For more information about server access logging, see Server Access Logging.
*
* For more information about creating a bucket, see CreateBucket. For more
* information about returning the logging status of a bucket, see GetBucketLogging.
*
* The following operations are related to PutBucketLogging:
*
*/
export class PutBucketLoggingCommand extends $Command<
PutBucketLoggingCommandInput,
PutBucketLoggingCommandOutput,
S3ClientResolvedConfig
> {
// Start section: command_properties
// End section: command_properties
constructor(readonly input: PutBucketLoggingCommandInput) {
// Start section: command_constructor
super();
// End section: command_constructor
}
/**
* @internal
*/
resolveMiddleware(
clientStack: MiddlewareStack,
configuration: S3ClientResolvedConfig,
options?: __HttpHandlerOptions
): Handler {
this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
this.middlewareStack.use(getBucketEndpointPlugin(configuration));
const stack = clientStack.concat(this.middlewareStack);
const { logger } = configuration;
const clientName = "S3Client";
const commandName = "PutBucketLoggingCommand";
const handlerExecutionContext: HandlerExecutionContext = {
logger,
clientName,
commandName,
inputFilterSensitiveLog: PutBucketLoggingRequest.filterSensitiveLog,
outputFilterSensitiveLog: (output: any) => output,
};
const { requestHandler } = configuration;
return stack.resolve(
(request: FinalizeHandlerArguments) =>
requestHandler.handle(request.request as __HttpRequest, options || {}),
handlerExecutionContext
);
}
private serialize(input: PutBucketLoggingCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
return serializeAws_restXmlPutBucketLoggingCommand(input, context);
}
private deserialize(output: __HttpResponse, context: __SerdeContext): Promise {
return deserializeAws_restXmlPutBucketLoggingCommand(output, context);
}
// Start section: command_body_extra
// End section: command_body_extra
}