feat(client-cloudtrail): Added exceptions to CreateTrail, DescribeTra…

…ils, and ListImportFailures APIs.
aws · Mar 8, 2024 · 56b092a · 56b092a
1 parent 4f1f762
commit 56b092a
Show file tree

Hide file tree

Showing 5 changed files with 227 additions and 58 deletions.
diff --git 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
  *  <p>This exception is thrown when the combination of parameters provided is not
  *          valid.</p>
  *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The request includes a parameter that is not valid.</p>
+ *
  * @throws {@link InvalidS3BucketNameException} (client fault)
  *  <p>This exception is thrown when the provided S3 bucket name is not valid.</p>
  *

diff --git 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)
+ *  <p>This exception is thrown when an operation is called with an ARN that is not valid.</p>
+ *          <p>The following is the format of a trail ARN: <code>arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail</code>
+ *          </p>
+ *          <p>The following is the format of an event data store ARN:
+ *          <code>arn:aws:cloudtrail:us-east-2:123456789012:eventdatastore/EXAMPLE-f852-4e8f-8bd1-bcf6cEXAMPLE</code>
+ *          </p>
+ *          <p>The following is the format of a channel ARN:
+ *          <code>arn:aws:cloudtrail:us-east-2:123456789012:channel/01234567890</code>
+ *          </p>
+ *
  * @throws {@link InvalidTrailNameException} (client fault)
  *  <p>This exception is thrown when the provided trail name is not valid. Trail names must
  *          meet the following requirements:</p>

diff --git 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
  *  <p>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.</p>
  *
+ * @throws {@link InvalidParameterException} (client fault)
+ *  <p>The request includes a parameter that is not valid.</p>
+ *
  * @throws {@link OperationNotPermittedException} (client fault)
  *  <p>This exception is thrown when the requested operation is not permitted.</p>
  *