@aws-sdk/client-auditmanager 3.350.0 → 3.353.0

package/dist-types/commands/CreateAssessmentFrameworkCommand.d.ts

@@ -83,7 +83,7 @@ export interface CreateAssessmentFrameworkCommandOutput extends CreateAssessment
  * //                 sourceSetUpOption: "System_Controls_Mapping" || "Procedural_Controls_Mapping",
  * //                 sourceType: "AWS_Cloudtrail" || "AWS_Config" || "AWS_Security_Hub" || "AWS_API_Call" || "MANUAL",
  * //                 sourceKeyword: { // SourceKeyword
- * //                   keywordInputType: "SELECT_FROM_LIST",
+ * //                   keywordInputType: "SELECT_FROM_LIST" || "UPLOAD_FILE" || "INPUT_TEXT",
  * //                   keywordValue: "STRING_VALUE",
  * //                 },
  * //                 sourceFrequency: "DAILY" || "WEEKLY" || "MONTHLY",

package/dist-types/commands/CreateControlCommand.d.ts

@@ -43,7 +43,7 @@ export interface CreateControlCommandOutput extends CreateControlResponse, __Met
  *       sourceSetUpOption: "System_Controls_Mapping" || "Procedural_Controls_Mapping",
  *       sourceType: "AWS_Cloudtrail" || "AWS_Config" || "AWS_Security_Hub" || "AWS_API_Call" || "MANUAL",
  *       sourceKeyword: { // SourceKeyword
- *         keywordInputType: "SELECT_FROM_LIST",
+ *         keywordInputType: "SELECT_FROM_LIST" || "UPLOAD_FILE" || "INPUT_TEXT",
  *         keywordValue: "STRING_VALUE",
  *       },
  *       sourceFrequency: "DAILY" || "WEEKLY" || "MONTHLY",
@@ -75,7 +75,7 @@ export interface CreateControlCommandOutput extends CreateControlResponse, __Met
  * //         sourceSetUpOption: "System_Controls_Mapping" || "Procedural_Controls_Mapping",
  * //         sourceType: "AWS_Cloudtrail" || "AWS_Config" || "AWS_Security_Hub" || "AWS_API_Call" || "MANUAL",
  * //         sourceKeyword: { // SourceKeyword
- * //           keywordInputType: "SELECT_FROM_LIST",
+ * //           keywordInputType: "SELECT_FROM_LIST" || "UPLOAD_FILE" || "INPUT_TEXT",
  * //           keywordValue: "STRING_VALUE",
  * //         },
  * //         sourceFrequency: "DAILY" || "WEEKLY" || "MONTHLY",

package/dist-types/commands/DeleteControlCommand.d.ts

@@ -24,6 +24,12 @@ export interface DeleteControlCommandOutput extends DeleteControlResponse, __Met
 /**
  * @public
  * <p> Deletes a custom control in Audit Manager. </p>
+ *          <important>
+ *             <p>When you invoke this operation, the custom control is deleted from any frameworks or
+ *             assessments that it’s currently part of. As a result, Audit Manager will stop
+ *             collecting evidence for that custom control in all of your assessments. This includes
+ *             assessments that you previously created before you deleted the custom control.</p>
+ *          </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetAccountStatusCommand.d.ts

@@ -23,7 +23,7 @@ export interface GetAccountStatusCommandOutput extends GetAccountStatusResponse,
 }
 /**
  * @public
- * <p> Returns the registration status of an account in Audit Manager. </p>
+ * <p> Gets the registration status of an account in Audit Manager. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetAssessmentCommand.d.ts

@@ -23,7 +23,7 @@ export interface GetAssessmentCommandOutput extends GetAssessmentResponse, __Met
 }
 /**
  * @public
- * <p>Returns an assessment from Audit Manager. </p>
+ * <p>Gets information about a specified assessment. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetAssessmentFrameworkCommand.d.ts

@@ -23,7 +23,7 @@ export interface GetAssessmentFrameworkCommandOutput extends GetAssessmentFramew
 }
 /**
  * @public
- * <p>Returns a framework from Audit Manager. </p>
+ * <p>Gets information about a specified framework.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -68,7 +68,7 @@ export interface GetAssessmentFrameworkCommandOutput extends GetAssessmentFramew
  * //                 sourceSetUpOption: "System_Controls_Mapping" || "Procedural_Controls_Mapping",
  * //                 sourceType: "AWS_Cloudtrail" || "AWS_Config" || "AWS_Security_Hub" || "AWS_API_Call" || "MANUAL",
  * //                 sourceKeyword: { // SourceKeyword
- * //                   keywordInputType: "SELECT_FROM_LIST",
+ * //                   keywordInputType: "SELECT_FROM_LIST" || "UPLOAD_FILE" || "INPUT_TEXT",
  * //                   keywordValue: "STRING_VALUE",
  * //                 },
  * //                 sourceFrequency: "DAILY" || "WEEKLY" || "MONTHLY",

package/dist-types/commands/GetAssessmentReportUrlCommand.d.ts

@@ -23,7 +23,7 @@ export interface GetAssessmentReportUrlCommandOutput extends GetAssessmentReport
 }
 /**
  * @public
- * <p> Returns the URL of an assessment report in Audit Manager. </p>
+ * <p> Gets the URL of an assessment report in Audit Manager. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetChangeLogsCommand.d.ts

@@ -23,7 +23,7 @@ export interface GetChangeLogsCommandOutput extends GetChangeLogsResponse, __Met
 }
 /**
  * @public
- * <p> Returns a list of changelogs from Audit Manager. </p>
+ * <p> Gets a list of changelogs from Audit Manager. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetControlCommand.d.ts

@@ -23,7 +23,7 @@ export interface GetControlCommandOutput extends GetControlResponse, __MetadataB
 }
 /**
  * @public
- * <p> Returns a control from Audit Manager. </p>
+ * <p> Gets information about a specified control.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -54,7 +54,7 @@ export interface GetControlCommandOutput extends GetControlResponse, __MetadataB
  * //         sourceSetUpOption: "System_Controls_Mapping" || "Procedural_Controls_Mapping",
  * //         sourceType: "AWS_Cloudtrail" || "AWS_Config" || "AWS_Security_Hub" || "AWS_API_Call" || "MANUAL",
  * //         sourceKeyword: { // SourceKeyword
- * //           keywordInputType: "SELECT_FROM_LIST",
+ * //           keywordInputType: "SELECT_FROM_LIST" || "UPLOAD_FILE" || "INPUT_TEXT",
  * //           keywordValue: "STRING_VALUE",
  * //         },
  * //         sourceFrequency: "DAILY" || "WEEKLY" || "MONTHLY",

package/dist-types/commands/GetDelegationsCommand.d.ts

@@ -23,7 +23,7 @@ export interface GetDelegationsCommandOutput extends GetDelegationsResponse, __M
 }
 /**
  * @public
- * <p> Returns a list of delegations from an audit owner to a delegate. </p>
+ * <p> Gets a list of delegations from an audit owner to a delegate. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetEvidenceByEvidenceFolderCommand.d.ts

@@ -23,7 +23,7 @@ export interface GetEvidenceByEvidenceFolderCommandOutput extends GetEvidenceByE
 }
 /**
  * @public
- * <p> Returns all evidence from a specified evidence folder in Audit Manager. </p>
+ * <p> Gets all evidence from a specified evidence folder in Audit Manager. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetEvidenceCommand.d.ts

@@ -23,7 +23,7 @@ export interface GetEvidenceCommandOutput extends GetEvidenceResponse, __Metadat
 }
 /**
  * @public
- * <p> Returns evidence from Audit Manager. </p>
+ * <p> Gets information about a specified evidence item.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetEvidenceFileUploadUrlCommand.d.ts

@@ -0,0 +1,105 @@
+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 { AuditManagerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../AuditManagerClient";
+import { GetEvidenceFileUploadUrlRequest, GetEvidenceFileUploadUrlResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link GetEvidenceFileUploadUrlCommand}.
+ */
+export interface GetEvidenceFileUploadUrlCommandInput extends GetEvidenceFileUploadUrlRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link GetEvidenceFileUploadUrlCommand}.
+ */
+export interface GetEvidenceFileUploadUrlCommandOutput extends GetEvidenceFileUploadUrlResponse, __MetadataBearer {
+}
+/**
+ * @public
+ * <p>Creates a presigned Amazon S3 URL that can be used to upload a file as manual
+ *          evidence. For instructions on how to use this operation, see <a href="https://docs.aws.amazon.com/audit-manager/latest/userguide/upload-evidence.html#how-to-upload-manual-evidence-files">Upload a file from your browser </a> in the <i>Audit Manager User
+ *             Guide</i>.</p>
+ *          <p>The following restrictions apply to this operation:</p>
+ *          <ul>
+ *             <li>
+ *                <p>Maximum size of an individual evidence file: 100 MB</p>
+ *             </li>
+ *             <li>
+ *                <p>Number of daily manual evidence uploads per control: 100</p>
+ *             </li>
+ *             <li>
+ *                <p>Supported file formats: See <a href="https://docs.aws.amazon.com/audit-manager/latest/userguide/upload-evidence.html#supported-manual-evidence-files">Supported file types for manual evidence</a> in the <i>Audit Manager User Guide</i>
+ *                </p>
+ *             </li>
+ *          </ul>
+ *          <p>For more information about Audit Manager service restrictions, see <a href="https://docs.aws.amazon.com/audit-manager/latest/userguide/service-quotas.html">Quotas and
+ *             restrictions for Audit Manager</a>.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { AuditManagerClient, GetEvidenceFileUploadUrlCommand } from "@aws-sdk/client-auditmanager"; // ES Modules import
+ * // const { AuditManagerClient, GetEvidenceFileUploadUrlCommand } = require("@aws-sdk/client-auditmanager"); // CommonJS import
+ * const client = new AuditManagerClient(config);
+ * const input = { // GetEvidenceFileUploadUrlRequest
+ *   fileName: "STRING_VALUE", // required
+ * };
+ * const command = new GetEvidenceFileUploadUrlCommand(input);
+ * const response = await client.send(command);
+ * // { // GetEvidenceFileUploadUrlResponse
+ * //   evidenceFileName: "STRING_VALUE",
+ * //   uploadUrl: "STRING_VALUE",
+ * // };
+ *
+ * ```
+ *
+ * @param GetEvidenceFileUploadUrlCommandInput - {@link GetEvidenceFileUploadUrlCommandInput}
+ * @returns {@link GetEvidenceFileUploadUrlCommandOutput}
+ * @see {@link GetEvidenceFileUploadUrlCommandInput} for command's `input` shape.
+ * @see {@link GetEvidenceFileUploadUrlCommandOutput} for command's `response` shape.
+ * @see {@link AuditManagerClientResolvedConfig | config} for AuditManagerClient's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p> Your account isn't registered with Audit Manager. Check the delegated
+ *          administrator setup on the Audit Manager settings page, and try again. </p>
+ *
+ * @throws {@link InternalServerException} (server fault)
+ *  <p> An internal service error occurred during the processing of your request. Try again
+ *          later. </p>
+ *
+ * @throws {@link ThrottlingException} (client fault)
+ *  <p>The request was denied due to request throttling.</p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p> The request has invalid or missing parameters. </p>
+ *
+ * @throws {@link AuditManagerServiceException}
+ * <p>Base exception class for all service exceptions from AuditManager service.</p>
+ *
+ */
+export declare class GetEvidenceFileUploadUrlCommand extends $Command<GetEvidenceFileUploadUrlCommandInput, GetEvidenceFileUploadUrlCommandOutput, AuditManagerClientResolvedConfig> {
+    readonly input: GetEvidenceFileUploadUrlCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    /**
+     * @public
+     */
+    constructor(input: GetEvidenceFileUploadUrlCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: AuditManagerClientResolvedConfig, options?: __HttpHandlerOptions): Handler<GetEvidenceFileUploadUrlCommandInput, GetEvidenceFileUploadUrlCommandOutput>;
+    /**
+     * @internal
+     */
+    private serialize;
+    /**
+     * @internal
+     */
+    private deserialize;
+}

package/dist-types/commands/GetEvidenceFolderCommand.d.ts

@@ -23,8 +23,7 @@ export interface GetEvidenceFolderCommandOutput extends GetEvidenceFolderRespons
 }
 /**
  * @public
- * <p> Returns an evidence folder from the specified assessment in Audit Manager.
- *       </p>
+ * <p> Gets an evidence folder from a specified assessment in Audit Manager. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetEvidenceFoldersByAssessmentCommand.d.ts

@@ -23,8 +23,7 @@ export interface GetEvidenceFoldersByAssessmentCommandOutput extends GetEvidence
 }
 /**
  * @public
- * <p> Returns the evidence folders from a specified assessment in Audit Manager.
- *       </p>
+ * <p> Gets the evidence folders from a specified assessment in Audit Manager. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetEvidenceFoldersByAssessmentControlCommand.d.ts

@@ -23,7 +23,7 @@ export interface GetEvidenceFoldersByAssessmentControlCommandOutput extends GetE
 }
 /**
  * @public
- * <p> Returns a list of evidence folders that are associated with a specified control in an
+ * <p> Gets a list of evidence folders that are associated with a specified control in an
  *             Audit Manager assessment. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

package/dist-types/commands/GetOrganizationAdminAccountCommand.d.ts

@@ -23,7 +23,7 @@ export interface GetOrganizationAdminAccountCommandOutput extends GetOrganizatio
 }
 /**
  * @public
- * <p> Returns the name of the delegated Amazon Web Services administrator account for the
+ * <p> Gets the name of the delegated Amazon Web Services administrator account for a specified
  *          organization. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

package/dist-types/commands/GetServicesInScopeCommand.d.ts

@@ -23,8 +23,8 @@ export interface GetServicesInScopeCommandOutput extends GetServicesInScopeRespo
 }
 /**
  * @public
- * <p>Returns a list of all of the Amazon Web Services that you can choose to include
- *          in your assessment. When you <a href="https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_CreateAssessment.html">create an assessment</a>, specify which of these services you want to include to
+ * <p>Gets a list of all of the Amazon Web Services that you can choose to include in
+ *          your assessment. When you <a href="https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_CreateAssessment.html">create an assessment</a>, specify which of these services you want to include to
  *          narrow the assessment's <a href="https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_Scope.html">scope</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

package/dist-types/commands/GetSettingsCommand.d.ts

@@ -23,7 +23,7 @@ export interface GetSettingsCommandOutput extends GetSettingsResponse, __Metadat
 }
 /**
  * @public
- * <p> Returns the settings for the specified Amazon Web Services account. </p>
+ * <p> Gets the settings for a specified Amazon Web Services account. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -31,7 +31,7 @@ export interface GetSettingsCommandOutput extends GetSettingsResponse, __Metadat
  * // const { AuditManagerClient, GetSettingsCommand } = require("@aws-sdk/client-auditmanager"); // CommonJS import
  * const client = new AuditManagerClient(config);
  * const input = { // GetSettingsRequest
- *   attribute: "ALL" || "IS_AWS_ORG_ENABLED" || "SNS_TOPIC" || "DEFAULT_ASSESSMENT_REPORTS_DESTINATION" || "DEFAULT_PROCESS_OWNERS" || "EVIDENCE_FINDER_ENABLEMENT" || "DEREGISTRATION_POLICY", // required
+ *   attribute: "ALL" || "IS_AWS_ORG_ENABLED" || "SNS_TOPIC" || "DEFAULT_ASSESSMENT_REPORTS_DESTINATION" || "DEFAULT_PROCESS_OWNERS" || "EVIDENCE_FINDER_ENABLEMENT" || "DEREGISTRATION_POLICY" || "DEFAULT_EXPORT_DESTINATION", // required
  * };
  * const command = new GetSettingsCommand(input);
  * const response = await client.send(command);
@@ -59,6 +59,10 @@ export interface GetSettingsCommandOutput extends GetSettingsResponse, __Metadat
  * //     deregistrationPolicy: { // DeregistrationPolicy
  * //       deleteResources: "ALL" || "DEFAULT",
  * //     },
+ * //     defaultExportDestination: { // DefaultExportDestination
+ * //       destinationType: "S3",
+ * //       destination: "STRING_VALUE",
+ * //     },
  * //   },
  * // };
  *

package/dist-types/commands/UpdateAssessmentFrameworkCommand.d.ts

@@ -82,7 +82,7 @@ export interface UpdateAssessmentFrameworkCommandOutput extends UpdateAssessment
  * //                 sourceSetUpOption: "System_Controls_Mapping" || "Procedural_Controls_Mapping",
  * //                 sourceType: "AWS_Cloudtrail" || "AWS_Config" || "AWS_Security_Hub" || "AWS_API_Call" || "MANUAL",
  * //                 sourceKeyword: { // SourceKeyword
- * //                   keywordInputType: "SELECT_FROM_LIST",
+ * //                   keywordInputType: "SELECT_FROM_LIST" || "UPLOAD_FILE" || "INPUT_TEXT",
  * //                   keywordValue: "STRING_VALUE",
  * //                 },
  * //                 sourceFrequency: "DAILY" || "WEEKLY" || "MONTHLY",

package/dist-types/commands/UpdateControlCommand.d.ts

@@ -45,7 +45,7 @@ export interface UpdateControlCommandOutput extends UpdateControlResponse, __Met
  *       sourceSetUpOption: "System_Controls_Mapping" || "Procedural_Controls_Mapping",
  *       sourceType: "AWS_Cloudtrail" || "AWS_Config" || "AWS_Security_Hub" || "AWS_API_Call" || "MANUAL",
  *       sourceKeyword: { // SourceKeyword
- *         keywordInputType: "SELECT_FROM_LIST",
+ *         keywordInputType: "SELECT_FROM_LIST" || "UPLOAD_FILE" || "INPUT_TEXT",
  *         keywordValue: "STRING_VALUE",
  *       },
  *       sourceFrequency: "DAILY" || "WEEKLY" || "MONTHLY",
@@ -74,7 +74,7 @@ export interface UpdateControlCommandOutput extends UpdateControlResponse, __Met
  * //         sourceSetUpOption: "System_Controls_Mapping" || "Procedural_Controls_Mapping",
  * //         sourceType: "AWS_Cloudtrail" || "AWS_Config" || "AWS_Security_Hub" || "AWS_API_Call" || "MANUAL",
  * //         sourceKeyword: { // SourceKeyword
- * //           keywordInputType: "SELECT_FROM_LIST",
+ * //           keywordInputType: "SELECT_FROM_LIST" || "UPLOAD_FILE" || "INPUT_TEXT",
  * //           keywordValue: "STRING_VALUE",
  * //         },
  * //         sourceFrequency: "DAILY" || "WEEKLY" || "MONTHLY",

package/dist-types/commands/UpdateSettingsCommand.d.ts

@@ -47,6 +47,10 @@ export interface UpdateSettingsCommandOutput extends UpdateSettingsResponse, __M
  *   deregistrationPolicy: { // DeregistrationPolicy
  *     deleteResources: "ALL" || "DEFAULT",
  *   },
+ *   defaultExportDestination: { // DefaultExportDestination
+ *     destinationType: "S3",
+ *     destination: "STRING_VALUE",
+ *   },
  * };
  * const command = new UpdateSettingsCommand(input);
  * const response = await client.send(command);
@@ -74,6 +78,10 @@ export interface UpdateSettingsCommandOutput extends UpdateSettingsResponse, __M
  * //     deregistrationPolicy: { // DeregistrationPolicy
  * //       deleteResources: "ALL" || "DEFAULT",
  * //     },
+ * //     defaultExportDestination: { // DefaultExportDestination
+ * //       destinationType: "S3",
+ * //       destination: "STRING_VALUE",
+ * //     },
  * //   },
  * // };
  *

package/dist-types/commands/index.d.ts

@@ -25,6 +25,7 @@ export * from "./GetControlCommand";
 export * from "./GetDelegationsCommand";
 export * from "./GetEvidenceByEvidenceFolderCommand";
 export * from "./GetEvidenceCommand";
+export * from "./GetEvidenceFileUploadUrlCommand";
 export * from "./GetEvidenceFolderCommand";
 export * from "./GetEvidenceFoldersByAssessmentCommand";
 export * from "./GetEvidenceFoldersByAssessmentControlCommand";