diff --git a/clients/client-cloudtrail/src/commands/CreateTrailCommand.ts b/clients/client-cloudtrail/src/commands/CreateTrailCommand.ts index d4843a76fecd..5731ba761d19 100644 --- a/clients/client-cloudtrail/src/commands/CreateTrailCommand.ts +++ b/clients/client-cloudtrail/src/commands/CreateTrailCommand.ts @@ -128,6 +128,9 @@ export interface CreateTrailCommandOutput extends CreateTrailResponse, __Metadat *

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 InvalidS3BucketNameException} (client fault) *

This exception is thrown when the provided S3 bucket name is not valid.

* diff --git a/clients/client-cloudtrail/src/commands/DescribeTrailsCommand.ts b/clients/client-cloudtrail/src/commands/DescribeTrailsCommand.ts index 2161f7928bff..2b18bd65f6c0 100644 --- a/clients/client-cloudtrail/src/commands/DescribeTrailsCommand.ts +++ b/clients/client-cloudtrail/src/commands/DescribeTrailsCommand.ts @@ -75,6 +75,17 @@ export interface DescribeTrailsCommandOutput extends DescribeTrailsResponse, __M * @see {@link DescribeTrailsCommandOutput} 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 channel ARN: + * arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890 + *

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

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

diff --git a/clients/client-cloudtrail/src/commands/ListImportFailuresCommand.ts b/clients/client-cloudtrail/src/commands/ListImportFailuresCommand.ts index f2803dbe3aad..269b1ab26841 100644 --- a/clients/client-cloudtrail/src/commands/ListImportFailuresCommand.ts +++ b/clients/client-cloudtrail/src/commands/ListImportFailuresCommand.ts @@ -67,6 +67,9 @@ export interface ListImportFailuresCommandOutput extends ListImportFailuresRespo *

A token that is not valid, or a token that was previously used in a request with * different parameters. This exception is thrown if the token is not valid.

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

The request includes a parameter that is not valid.

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

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

* diff --git a/clients/client-cloudtrail/src/models/models_0.ts b/clients/client-cloudtrail/src/models/models_0.ts index b5f810614bac..eafae9147be9 100644 --- a/clients/client-cloudtrail/src/models/models_0.ts +++ b/clients/client-cloudtrail/src/models/models_0.ts @@ -766,6 +766,11 @@ export interface AdvancedFieldSelector { * *
  • *

    + * AWS::AppConfig::Configuration + *

    + *
    • + *
  • + *

    * AWS::B2BI::Transformer *

    *
    • @@ -836,11 +841,41 @@ export interface AdvancedFieldSelector { * *
  • *

    + * AWS::GreengrassV2::ComponentVersion + *

    + *
    • + *
  • + *

    + * AWS::GreengrassV2::Deployment + *

    + *
    • + *
  • + *

    * AWS::GuardDuty::Detector *

    *
    • *
  • *

    + * AWS::IoT::Certificate + *

    + *
    • + *
  • + *

    + * AWS::IoT::Thing + *

    + *
    • + *
  • + *

    + * AWS::IoTSiteWise::Asset + *

    + *
    • + *
  • + *

    + * AWS::IoTSiteWise::TimeSeries + *

    + *
    • + *
  • + *

    * AWS::IoTTwinMaker::Entity *

    *
    • @@ -911,62 +946,67 @@ export interface AdvancedFieldSelector { * *
  • *

    - * AWS::SageMaker::Endpoint + * AWS::S3::AccessPoint *

    *
    • *
  • *

    - * AWS::SageMaker::ExperimentTrialComponent + * AWS::S3ObjectLambda::AccessPoint *

    *
    • *
  • *

    - * AWS::SageMaker::FeatureGroup + * AWS::S3Outposts::Object *

    *
    • *
  • *

    - * AWS::ServiceDiscovery::Namespace + * AWS::SageMaker::Endpoint *

    *
    • *
  • *

    - * AWS::ServiceDiscovery::Service + * AWS::SageMaker::ExperimentTrialComponent *

    *
    • *
  • *

    - * AWS::SCN::Instance + * AWS::SageMaker::FeatureGroup *

    *
    • *
  • *

    - * AWS::SNS::PlatformEndpoint + * AWS::ServiceDiscovery::Namespace *

    *
    • *
  • *

    - * AWS::SNS::Topic + * AWS::ServiceDiscovery::Service *

    *
    • *
  • *

    - * AWS::SQS::Queue + * AWS::SCN::Instance *

    *
    • *
  • *

    - * AWS::S3::AccessPoint + * AWS::SNS::PlatformEndpoint *

    *
    • *
  • *

    - * AWS::S3ObjectLambda::AccessPoint + * AWS::SNS::Topic *

    *
    • *
  • *

    - * AWS::S3Outposts::Object + * AWS::SWF::Domain + *

    + *
    • + *
  • + *

    + * AWS::SQS::Queue *

    *
    • *
  • @@ -1049,6 +1089,16 @@ export interface AdvancedFieldSelector { *

    *
    • * + *

    When resources.type equals AWS::AppConfig::Configuration, and the operator is + * set to Equals or NotEquals, the ARN must be in the + * following format:

    + * *

    When resources.type equals AWS::B2BI::Transformer, and the operator is * set to Equals or NotEquals, the ARN must be in the * following format:

    @@ -1189,6 +1239,26 @@ export interface AdvancedFieldSelector { *

    * * + *

    When resources.type equals AWS::GreengrassV2::ComponentVersion, and the + * operator is set to Equals or NotEquals, the ARN must be in + * the following format:

    + * + *

    When resources.type equals AWS::GreengrassV2::Deployment, and the + * operator is set to Equals or NotEquals, the ARN must be in + * the following format:

    + * *

    When resources.type equals AWS::GuardDuty::Detector, and the * operator is set to Equals or NotEquals, the ARN must be in * the following format:

    @@ -1199,6 +1269,46 @@ export interface AdvancedFieldSelector { *

    * * + *

    When resources.type equals AWS::IoT::Certificate, + * and the operator is set to Equals or NotEquals, the ARN + * must be in the following format:

    + * + *

    When resources.type equals AWS::IoT::Thing, + * and the operator is set to Equals or NotEquals, the ARN + * must be in the following format:

    + * + *

    When resources.type equals AWS::IoTSiteWise::Asset, + * and the operator is set to Equals or NotEquals, the ARN + * must be in the following format:

    + * + *

    When resources.type equals AWS::IoTSiteWise::TimeSeries, + * and the operator is set to Equals or NotEquals, the ARN + * must be in the following format:

    + * *

    When resources.type equals AWS::IoTTwinMaker::Entity, * and the operator is set to Equals or NotEquals, the ARN * must be in the following format:

    @@ -1339,6 +1449,44 @@ export interface AdvancedFieldSelector { *

    * * + *

    When resources.type equals AWS::S3::AccessPoint, and the + * operator is set to Equals or NotEquals, the ARN must be in + * one of the following formats. To log events on all objects in an S3 access point, we + * recommend that you use only the access point ARN, don’t include the object path, and + * use the StartsWith or NotStartsWith operators.

    + * + *

    When resources.type equals + * AWS::S3ObjectLambda::AccessPoint, and the operator is set to + * Equals or NotEquals, the ARN must be in the following + * format:

    + * + *

    When resources.type equals AWS::S3Outposts::Object, and + * the operator is set to Equals or NotEquals, the ARN must be + * in the following format:

    + * *

    When resources.type equals AWS::SageMaker::Endpoint, and the operator is set to * Equals or NotEquals, the ARN must be in the following format:

    * - *

    When resources.type equals AWS::SQS::Queue, + *

    When resources.type equals AWS::SWF::Domain, * and the operator is set to Equals or NotEquals, the ARN * must be in the following format:

    * - *

    When resources.type equals AWS::S3::AccessPoint, and the - * operator is set to Equals or NotEquals, the ARN must be in - * one of the following formats. To log events on all objects in an S3 access point, we - * recommend that you use only the access point ARN, don’t include the object path, and - * use the StartsWith or NotStartsWith operators.

    - * - *

    When resources.type equals - * AWS::S3ObjectLambda::AccessPoint, and the operator is set to - * Equals or NotEquals, the ARN must be in the following - * format:

    - * - *

    When resources.type equals AWS::S3Outposts::Object, and - * the operator is set to Equals or NotEquals, the ARN must be - * in the following format:

    + *

    When resources.type equals AWS::SQS::Queue, + * and the operator is set to Equals or NotEquals, the ARN + * must be in the following format:

    * @@ -1573,14 +1693,18 @@ export interface AdvancedFieldSelector { /** * @public - *

    Advanced event selectors let you create fine-grained selectors for the following CloudTrail event record fields. They help you control costs by logging only those + *

    Advanced event selectors let you create fine-grained selectors for CloudTrail management and data events. They help you control costs by logging only those * events that are important to you. For more information about advanced event selectors, see - * Logging data events in the CloudTrail User Guide.

    + * Logging management events and + * Logging data events in the CloudTrail User Guide.

    + *

    You cannot apply both event selectors and advanced event selectors to a trail.

    + *

    + * Supported CloudTrail event record fields for management events + *

    * + *

    + * Supported CloudTrail event record fields for data events + *

    + * - *

    You cannot apply both event selectors and advanced event selectors to a trail.

    + * + *

    For event data stores for CloudTrail Insights events, Config configuration items, Audit Manager evidence, or events outside of Amazon Web Services, the only supported field is + * eventCategory.

    + *     */ export interface AdvancedEventSelector { /** @@ -6263,7 +6403,10 @@ export interface LookupAttribute { /** * @public - *

    Specifies a value for the specified AttributeKey.

    + *

    Specifies a value for the specified AttributeKey.

    + *

    The maximum length for the AttributeValue is 2000 characters. The + * following characters ('_', ' ', ',', + * '\\n') count as two characters towards the 2000 character limit.

    */ AttributeValue: string | undefined; } diff --git a/codegen/sdk-codegen/aws-models/cloudtrail.json b/codegen/sdk-codegen/aws-models/cloudtrail.json index c3c97a62b402..3aafdfaf5466 100644 --- a/codegen/sdk-codegen/aws-models/cloudtrail.json +++ b/codegen/sdk-codegen/aws-models/cloudtrail.json @@ -251,7 +251,7 @@ } }, "traits": { - "smithy.api#documentation": "

    Advanced event selectors let you create fine-grained selectors for the following CloudTrail event record fields. They help you control costs by logging only those\n events that are important to you. For more information about advanced event selectors, see\n Logging data events in the CloudTrail User Guide.

    \n \n

    You cannot apply both event selectors and advanced event selectors to a trail.

    " + "smithy.api#documentation": "

    Advanced event selectors let you create fine-grained selectors for CloudTrail management and data events. They help you control costs by logging only those\n events that are important to you. For more information about advanced event selectors, see\n Logging management events and \n Logging data events in the CloudTrail User Guide.

    \n

    You cannot apply both event selectors and advanced event selectors to a trail.

    \n

    \n Supported CloudTrail event record fields for management events\n

    \n \n

    \n Supported CloudTrail event record fields for data events\n

    \n \n \n

    For event data stores for CloudTrail Insights events, Config configuration items, Audit Manager evidence, or events outside of Amazon Web Services, the only supported field is\n eventCategory.

    \n     " } }, "com.amazonaws.cloudtrail#AdvancedEventSelectors": { @@ -266,7 +266,7 @@ "Field": { "target": "com.amazonaws.cloudtrail#SelectorField", "traits": { - "smithy.api#documentation": "

    A field in a CloudTrail event record on which to filter events to be logged. For\n event data stores for CloudTrail Insights events, Config configuration items, Audit Manager evidence, or events outside of Amazon Web Services, the field is used only for\n selecting events as filtering is not supported.

    \n

    For CloudTrail management events, supported fields include readOnly,\n eventCategory, and eventSource.

    \n

    For CloudTrail data events, supported fields include readOnly,\n eventCategory, eventName, resources.type, and resources.ARN.

    \n

    For event data stores for CloudTrail Insights events, Config configuration items, Audit Manager evidence, or events outside of Amazon Web Services, the only supported field is\n eventCategory.

    \n ", + "smithy.api#documentation": "

    A field in a CloudTrail event record on which to filter events to be logged. For\n event data stores for CloudTrail Insights events, Config configuration items, Audit Manager evidence, or events outside of Amazon Web Services, the field is used only for\n selecting events as filtering is not supported.

    \n

    For CloudTrail management events, supported fields include readOnly,\n eventCategory, and eventSource.

    \n

    For CloudTrail data events, supported fields include readOnly,\n eventCategory, eventName, resources.type, and resources.ARN.

    \n

    For event data stores for CloudTrail Insights events, Config configuration items, Audit Manager evidence, or events outside of Amazon Web Services, the only supported field is\n eventCategory.

    \n ", "smithy.api#required": {} } }, @@ -2302,6 +2302,9 @@ { "target": "com.amazonaws.cloudtrail#InvalidParameterCombinationException" }, + { + "target": "com.amazonaws.cloudtrail#InvalidParameterException" + }, { "target": "com.amazonaws.cloudtrail#InvalidS3BucketNameException" }, @@ -3112,6 +3115,9 @@ "target": "com.amazonaws.cloudtrail#DescribeTrailsResponse" }, "errors": [ + { + "target": "com.amazonaws.cloudtrail#CloudTrailARNInvalidException" + }, { "target": "com.amazonaws.cloudtrail#InvalidTrailNameException" }, @@ -6089,6 +6095,9 @@ { "target": "com.amazonaws.cloudtrail#InvalidNextTokenException" }, + { + "target": "com.amazonaws.cloudtrail#InvalidParameterException" + }, { "target": "com.amazonaws.cloudtrail#OperationNotPermittedException" }, @@ -6802,7 +6811,7 @@ "AttributeValue": { "target": "com.amazonaws.cloudtrail#LookupAttributeValue", "traits": { - "smithy.api#documentation": "

    Specifies a value for the specified AttributeKey.

    ", + "smithy.api#documentation": "

    Specifies a value for the specified AttributeKey.

    \n

    The maximum length for the AttributeValue is 2000 characters. The\n following characters ('_', ' ', ',',\n '\\\\n') count as two characters towards the 2000 character limit.

    ", "smithy.api#required": {} } }