import { Command as $Command } from "@smithy/smithy-client"; import type { MetadataBearer as __MetadataBearer } from "@smithy/types"; import type { CloudTrailClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../CloudTrailClient"; import type { PutEventConfigurationRequest, PutEventConfigurationResponse } from "../models/models_0"; /** * @public */ export type { __MetadataBearer }; export { $Command }; /** * @public * * The input for {@link PutEventConfigurationCommand}. */ export interface PutEventConfigurationCommandInput extends PutEventConfigurationRequest { } /** * @public * * The output of {@link PutEventConfigurationCommand}. */ export interface PutEventConfigurationCommandOutput extends PutEventConfigurationResponse, __MetadataBearer { } declare const PutEventConfigurationCommand_base: { new (input: PutEventConfigurationCommandInput): import("@smithy/smithy-client").CommandImpl; new (...[input]: [] | [PutEventConfigurationCommandInput]): import("@smithy/smithy-client").CommandImpl; getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions; }; /** *

Updates the event configuration settings for the specified event data store or trail. This operation supports updating the maximum event size, adding or modifying context key selectors for event data store, and configuring aggregation settings for the trail.

* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { CloudTrailClient, PutEventConfigurationCommand } from "@aws-sdk/client-cloudtrail"; // ES Modules import * // const { CloudTrailClient, PutEventConfigurationCommand } = require("@aws-sdk/client-cloudtrail"); // CommonJS import * // import type { CloudTrailClientConfig } from "@aws-sdk/client-cloudtrail"; * const config = {}; // type is CloudTrailClientConfig * const client = new CloudTrailClient(config); * const input = { // PutEventConfigurationRequest * TrailName: "STRING_VALUE", * EventDataStore: "STRING_VALUE", * MaxEventSize: "Standard" || "Large", * ContextKeySelectors: [ // ContextKeySelectors * { // ContextKeySelector * Type: "TagContext" || "RequestContext", // required * Equals: [ // OperatorTargetList // required * "STRING_VALUE", * ], * }, * ], * AggregationConfigurations: [ // AggregationConfigurations * { // AggregationConfiguration * Templates: [ // Templates // required * "API_ACTIVITY" || "RESOURCE_ACCESS" || "USER_ACTIONS", * ], * EventCategory: "Data", // required * }, * ], * }; * const command = new PutEventConfigurationCommand(input); * const response = await client.send(command); * // { // PutEventConfigurationResponse * // TrailARN: "STRING_VALUE", * // EventDataStoreArn: "STRING_VALUE", * // MaxEventSize: "Standard" || "Large", * // ContextKeySelectors: [ // ContextKeySelectors * // { // ContextKeySelector * // Type: "TagContext" || "RequestContext", // required * // Equals: [ // OperatorTargetList // required * // "STRING_VALUE", * // ], * // }, * // ], * // AggregationConfigurations: [ // AggregationConfigurations * // { // AggregationConfiguration * // Templates: [ // Templates // required * // "API_ACTIVITY" || "RESOURCE_ACCESS" || "USER_ACTIONS", * // ], * // EventCategory: "Data", // required * // }, * // ], * // }; * * ``` * * @param PutEventConfigurationCommandInput - {@link PutEventConfigurationCommandInput} * @returns {@link PutEventConfigurationCommandOutput} * @see {@link PutEventConfigurationCommandInput} for command's `input` shape. * @see {@link PutEventConfigurationCommandOutput} for command's `response` shape. * @see {@link CloudTrailClientResolvedConfig | config} for CloudTrailClient's `config` shape. * * @throws {@link CloudTrailARNInvalidException} (client fault) *

This exception is thrown when an operation is called with an ARN that is not valid.

*

The following is the format of a trail ARN: arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail *

*

The following is the format of an event data store ARN: * arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE *

*

The following is the format of a dashboard ARN: arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDash *

*

The following is the format of a channel ARN: * arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890 *

* * @throws {@link ConflictException} (client fault) *

This exception is thrown when the specified resource is not ready for an operation. This * can occur when you try to run an operation on a resource before CloudTrail has time * to fully load the resource, or because another operation is modifying the resource. If this exception occurs, wait a few minutes, and then try the * operation again.

* * @throws {@link EventDataStoreARNInvalidException} (client fault) *

The specified event data store ARN is not valid or does not map to an event data store * in your account.

* * @throws {@link EventDataStoreNotFoundException} (client fault) *

The specified event data store was not found.

* * @throws {@link InactiveEventDataStoreException} (client fault) *

The event data store is inactive.

* * @throws {@link InsufficientDependencyServiceAccessPermissionException} (client fault) *

This exception is thrown when the IAM identity that is used to create * the organization resource lacks one or more required permissions for creating an * organization resource in a required service.

* * @throws {@link InsufficientIAMAccessPermissionException} (client fault) *

The task can't be completed because you are signed in with an account that lacks permissions to view or create a service-linked role. Sign in with an account that has the required permissions and then try again.

* * @throws {@link InvalidEventDataStoreCategoryException} (client fault) *

This exception is thrown when event categories of specified event data stores are not * valid.

* * @throws {@link InvalidEventDataStoreStatusException} (client fault) *

The event data store is not in a status that supports the operation.

* * @throws {@link InvalidHomeRegionException} (client fault) *

This exception is thrown when an operation is called on a trail from a Region other than * the Region in which the trail was created.

* * @throws {@link InvalidParameterCombinationException} (client fault) *

This exception is thrown when the combination of parameters provided is not * valid.

* * @throws {@link InvalidParameterException} (client fault) *

The request includes a parameter that is not valid.

* * @throws {@link InvalidTrailNameException} (client fault) *

This exception is thrown when the provided trail name is not valid. Trail names must * meet the following requirements:

* * * @throws {@link NoManagementAccountSLRExistsException} (client fault) *

This exception is thrown when the management account does not have a service-linked * role.

* * @throws {@link NotOrganizationMasterAccountException} (client fault) *

This exception is thrown when the Amazon Web Services account making the request to * create or update an organization trail or event data store is not the management account * for an organization in Organizations. For more information, see Prepare For Creating a Trail For Your Organization or Organization event data stores.

* * @throws {@link OperationNotPermittedException} (client fault) *

This exception is thrown when the requested operation is not permitted.

* * @throws {@link ThrottlingException} (client fault) *

* This exception is thrown when the request rate exceeds the limit. *

* * @throws {@link TrailNotFoundException} (client fault) *

This exception is thrown when the trail with the given name is not found.

* * @throws {@link UnsupportedOperationException} (client fault) *

This exception is thrown when the requested operation is not supported.

* * @throws {@link CloudTrailServiceException} *

Base exception class for all service exceptions from CloudTrail service.

* * * @public */ export declare class PutEventConfigurationCommand extends PutEventConfigurationCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: PutEventConfigurationRequest; output: PutEventConfigurationResponse; }; sdk: { input: PutEventConfigurationCommandInput; output: PutEventConfigurationCommandOutput; }; }; }