View Source aws_auditmanager (aws v0.5.0)

Welcome to the Audit Manager API reference.

This guide is for developers who need detailed information about the Audit Manager API operations, data types, and errors.

Audit Manager is a service that provides automated evidence collection so that you can continually audit your Amazon Web Services usage. You can use it to assess the effectiveness of your controls, manage risk, and simplify compliance.

Audit Manager provides prebuilt frameworks that structure and automate assessments for a given compliance standard. Frameworks include a prebuilt collection of controls with descriptions and testing procedures. These controls are grouped according to the requirements of the specified compliance standard or regulation. You can also customize frameworks and controls to support internal audits with specific requirements.

Use the following links to get started with the Audit Manager API:

  • Actions: An alphabetical list of all Audit Manager API operations.

  • Data types: An alphabetical list of all Audit Manager data types.

  • Common parameters: Parameters that all Query operations can use.

  • Common errors: Client and server errors that all operations can return.

If you're new to Audit Manager, we recommend that you review the Audit Manager User Guide.

Link to this section Summary

Functions

Associates an evidence folder to an assessment report in a Audit Manager assessment.
Associates a list of evidence to an assessment report in an Audit Manager assessment.
Creates a batch of delegations for an assessment in Audit Manager.
Deletes a batch of delegations for an assessment in Audit Manager.
Disassociates a list of evidence from an assessment report in Audit Manager.
Uploads one or more pieces of evidence to a control in an Audit Manager assessment.
Creates an assessment in Audit Manager.
Creates a custom framework in Audit Manager.
Creates an assessment report for the specified assessment.
Creates a new custom control in Audit Manager.
Deletes an assessment in Audit Manager.
Deletes a custom framework in Audit Manager.
Deletes a share request for a custom framework in Audit Manager.
Deletes an assessment report from an assessment in Audit Manager.
Deletes a custom control in Audit Manager.
Deregisters an account in Audit Manager.

Removes the specified member Amazon Web Services account as a delegated administrator for Audit Manager.

Disassociates an evidence folder from the specified assessment report in Audit Manager.
Returns the registration status of an account in Audit Manager.
Returns an assessment from Audit Manager.
Returns a framework from Audit Manager.
Returns the URL of an assessment report in Audit Manager.
Returns a list of changelogs from Audit Manager.
Returns a control from Audit Manager.
Returns a list of delegations from an audit owner to a delegate.
Returns all evidence from a specified evidence folder in Audit Manager.
Returns an evidence folder from the specified assessment in Audit Manager.
Returns the evidence folders from a specified assessment in Audit Manager.
Returns a list of evidence folders that are associated with a specified control of an assessment in Audit Manager.
Gets the latest analytics data for all your current active assessments.
Gets the latest analytics data for a specific active assessment.
Returns the name of the delegated Amazon Web Services administrator account for the organization.
Returns a list of the in-scope Amazon Web Services services for the specified assessment.
Returns the settings for the specified Amazon Web Services account.

Lists the latest analytics data for controls within a specific control domain and a specific active assessment.

Returns a list of sent or received share requests for custom frameworks in Audit Manager.
Returns a list of the frameworks that are available in the Audit Manager framework library.
Returns a list of assessment reports created in Audit Manager.
Returns a list of current and past assessments from Audit Manager.

Lists the latest analytics data for control domains across all of your active assessments.

Lists analytics data for control domains within a specified active assessment.

Lists the latest analytics data for controls within a specific control domain across all active assessments.

Returns a list of controls from Audit Manager.
Returns a list of keywords that are pre-mapped to the specified control data source.
Returns a list of all Audit Manager notifications.
Returns a list of tags for the specified resource in Audit Manager.
Enables Audit Manager for the specified Amazon Web Services account.
Enables an Amazon Web Services account within the organization as the delegated administrator for Audit Manager.

Creates a share request for a custom framework in Audit Manager.

Tags the specified resource in Audit Manager.
Removes a tag from a resource in Audit Manager.
Edits an Audit Manager assessment.
Updates a control within an assessment in Audit Manager.
Updates the status of a control set in an Audit Manager assessment.
Updates a custom framework in Audit Manager.
Updates a share request for a custom framework in Audit Manager.
Updates the status of an assessment in Audit Manager.
Updates a custom control in Audit Manager.
Updates Audit Manager settings for the current user account.
Validates the integrity of an assessment report in Audit Manager.

Link to this section Functions

Link to this function

associate_assessment_report_evidence_folder(Client, AssessmentId, Input)

View Source
Associates an evidence folder to an assessment report in a Audit Manager assessment.
Link to this function

associate_assessment_report_evidence_folder(Client, AssessmentId, Input0, Options0)

View Source
Link to this function

batch_associate_assessment_report_evidence(Client, AssessmentId, Input)

View Source
Associates a list of evidence to an assessment report in an Audit Manager assessment.
Link to this function

batch_associate_assessment_report_evidence(Client, AssessmentId, Input0, Options0)

View Source
Link to this function

batch_create_delegation_by_assessment(Client, AssessmentId, Input)

View Source
Creates a batch of delegations for an assessment in Audit Manager.
Link to this function

batch_create_delegation_by_assessment(Client, AssessmentId, Input0, Options0)

View Source
Link to this function

batch_delete_delegation_by_assessment(Client, AssessmentId, Input)

View Source
Deletes a batch of delegations for an assessment in Audit Manager.
Link to this function

batch_delete_delegation_by_assessment(Client, AssessmentId, Input0, Options0)

View Source
Link to this function

batch_disassociate_assessment_report_evidence(Client, AssessmentId, Input)

View Source
Disassociates a list of evidence from an assessment report in Audit Manager.
Link to this function

batch_disassociate_assessment_report_evidence(Client, AssessmentId, Input0, Options0)

View Source
Link to this function

batch_import_evidence_to_assessment_control(Client, AssessmentId, ControlId, ControlSetId, Input)

View Source
Uploads one or more pieces of evidence to a control in an Audit Manager assessment.
Link to this function

batch_import_evidence_to_assessment_control(Client, AssessmentId, ControlId, ControlSetId, Input0, Options0)

View Source
Link to this function

create_assessment(Client, Input)

View Source
Creates an assessment in Audit Manager.
Link to this function

create_assessment(Client, Input0, Options0)

View Source
Link to this function

create_assessment_framework(Client, Input)

View Source
Creates a custom framework in Audit Manager.
Link to this function

create_assessment_framework(Client, Input0, Options0)

View Source
Link to this function

create_assessment_report(Client, AssessmentId, Input)

View Source
Creates an assessment report for the specified assessment.
Link to this function

create_assessment_report(Client, AssessmentId, Input0, Options0)

View Source
Link to this function

create_control(Client, Input)

View Source
Creates a new custom control in Audit Manager.
Link to this function

create_control(Client, Input0, Options0)

View Source
Link to this function

delete_assessment(Client, AssessmentId, Input)

View Source
Deletes an assessment in Audit Manager.
Link to this function

delete_assessment(Client, AssessmentId, Input0, Options0)

View Source
Link to this function

delete_assessment_framework(Client, FrameworkId, Input)

View Source
Deletes a custom framework in Audit Manager.
Link to this function

delete_assessment_framework(Client, FrameworkId, Input0, Options0)

View Source
Link to this function

delete_assessment_framework_share(Client, RequestId, Input)

View Source
Deletes a share request for a custom framework in Audit Manager.
Link to this function

delete_assessment_framework_share(Client, RequestId, Input0, Options0)

View Source
Link to this function

delete_assessment_report(Client, AssessmentId, AssessmentReportId, Input)

View Source
Deletes an assessment report from an assessment in Audit Manager.
Link to this function

delete_assessment_report(Client, AssessmentId, AssessmentReportId, Input0, Options0)

View Source
Link to this function

delete_control(Client, ControlId, Input)

View Source
Deletes a custom control in Audit Manager.
Link to this function

delete_control(Client, ControlId, Input0, Options0)

View Source
Link to this function

deregister_account(Client, Input)

View Source
Deregisters an account in Audit Manager.
Link to this function

deregister_account(Client, Input0, Options0)

View Source
Link to this function

deregister_organization_admin_account(Client, Input)

View Source

Removes the specified member Amazon Web Services account as a delegated administrator for Audit Manager.

When you remove a delegated administrator from your Audit Manager settings, you continue to have access to the evidence that you previously collected under that account. This is also the case when you deregister a delegated administrator from Audit Manager. However, Audit Manager will stop collecting and attaching evidence to that delegated administrator account moving forward.
Link to this function

deregister_organization_admin_account(Client, Input0, Options0)

View Source
Link to this function

disassociate_assessment_report_evidence_folder(Client, AssessmentId, Input)

View Source
Disassociates an evidence folder from the specified assessment report in Audit Manager.
Link to this function

disassociate_assessment_report_evidence_folder(Client, AssessmentId, Input0, Options0)

View Source
Link to this function

get_account_status(Client)

View Source
Returns the registration status of an account in Audit Manager.
Link to this function

get_account_status(Client, QueryMap, HeadersMap)

View Source
Link to this function

get_account_status(Client, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_assessment(Client, AssessmentId)

View Source
Returns an assessment from Audit Manager.
Link to this function

get_assessment(Client, AssessmentId, QueryMap, HeadersMap)

View Source
Link to this function

get_assessment(Client, AssessmentId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_assessment_framework(Client, FrameworkId)

View Source
Returns a framework from Audit Manager.
Link to this function

get_assessment_framework(Client, FrameworkId, QueryMap, HeadersMap)

View Source
Link to this function

get_assessment_framework(Client, FrameworkId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_assessment_report_url(Client, AssessmentId, AssessmentReportId)

View Source
Returns the URL of an assessment report in Audit Manager.
Link to this function

get_assessment_report_url(Client, AssessmentId, AssessmentReportId, QueryMap, HeadersMap)

View Source
Link to this function

get_assessment_report_url(Client, AssessmentId, AssessmentReportId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_change_logs(Client, AssessmentId)

View Source
Returns a list of changelogs from Audit Manager.
Link to this function

get_change_logs(Client, AssessmentId, QueryMap, HeadersMap)

View Source
Link to this function

get_change_logs(Client, AssessmentId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_control(Client, ControlId)

View Source
Returns a control from Audit Manager.
Link to this function

get_control(Client, ControlId, QueryMap, HeadersMap)

View Source
Link to this function

get_control(Client, ControlId, QueryMap, HeadersMap, Options0)

View Source
Returns a list of delegations from an audit owner to a delegate.
Link to this function

get_delegations(Client, QueryMap, HeadersMap)

View Source
Link to this function

get_delegations(Client, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_evidence(Client, AssessmentId, ControlSetId, EvidenceFolderId, EvidenceId)

View Source
Returns evidence from Audit Manager.
Link to this function

get_evidence(Client, AssessmentId, ControlSetId, EvidenceFolderId, EvidenceId, QueryMap, HeadersMap)

View Source
Link to this function

get_evidence(Client, AssessmentId, ControlSetId, EvidenceFolderId, EvidenceId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_evidence_by_evidence_folder(Client, AssessmentId, ControlSetId, EvidenceFolderId)

View Source
Returns all evidence from a specified evidence folder in Audit Manager.
Link to this function

get_evidence_by_evidence_folder(Client, AssessmentId, ControlSetId, EvidenceFolderId, QueryMap, HeadersMap)

View Source
Link to this function

get_evidence_by_evidence_folder(Client, AssessmentId, ControlSetId, EvidenceFolderId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_evidence_folder(Client, AssessmentId, ControlSetId, EvidenceFolderId)

View Source
Returns an evidence folder from the specified assessment in Audit Manager.
Link to this function

get_evidence_folder(Client, AssessmentId, ControlSetId, EvidenceFolderId, QueryMap, HeadersMap)

View Source
Link to this function

get_evidence_folder(Client, AssessmentId, ControlSetId, EvidenceFolderId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_evidence_folders_by_assessment(Client, AssessmentId)

View Source
Returns the evidence folders from a specified assessment in Audit Manager.
Link to this function

get_evidence_folders_by_assessment(Client, AssessmentId, QueryMap, HeadersMap)

View Source
Link to this function

get_evidence_folders_by_assessment(Client, AssessmentId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_evidence_folders_by_assessment_control(Client, AssessmentId, ControlId, ControlSetId)

View Source
Returns a list of evidence folders that are associated with a specified control of an assessment in Audit Manager.
Link to this function

get_evidence_folders_by_assessment_control(Client, AssessmentId, ControlId, ControlSetId, QueryMap, HeadersMap)

View Source
Link to this function

get_evidence_folders_by_assessment_control(Client, AssessmentId, ControlId, ControlSetId, QueryMap, HeadersMap, Options0)

View Source
Gets the latest analytics data for all your current active assessments.
Link to this function

get_insights(Client, QueryMap, HeadersMap)

View Source
Link to this function

get_insights(Client, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_insights_by_assessment(Client, AssessmentId)

View Source
Gets the latest analytics data for a specific active assessment.
Link to this function

get_insights_by_assessment(Client, AssessmentId, QueryMap, HeadersMap)

View Source
Link to this function

get_insights_by_assessment(Client, AssessmentId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_organization_admin_account(Client)

View Source
Returns the name of the delegated Amazon Web Services administrator account for the organization.
Link to this function

get_organization_admin_account(Client, QueryMap, HeadersMap)

View Source
Link to this function

get_organization_admin_account(Client, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_services_in_scope(Client)

View Source
Returns a list of the in-scope Amazon Web Services services for the specified assessment.
Link to this function

get_services_in_scope(Client, QueryMap, HeadersMap)

View Source
Link to this function

get_services_in_scope(Client, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_settings(Client, Attribute)

View Source
Returns the settings for the specified Amazon Web Services account.
Link to this function

get_settings(Client, Attribute, QueryMap, HeadersMap)

View Source
Link to this function

get_settings(Client, Attribute, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_assessment_control_insights_by_control_domain(Client, AssessmentId, ControlDomainId)

View Source

Lists the latest analytics data for controls within a specific control domain and a specific active assessment.

Control insights are listed only if the control belongs to the control domain and assessment that was specified. Moreover, the control must have collected evidence on the lastUpdated date of controlInsightsByAssessment. If neither of these conditions are met, no data is listed for that control.
Link to this function

list_assessment_control_insights_by_control_domain(Client, AssessmentId, ControlDomainId, QueryMap, HeadersMap)

View Source
Link to this function

list_assessment_control_insights_by_control_domain(Client, AssessmentId, ControlDomainId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_assessment_framework_share_requests(Client, RequestType)

View Source
Returns a list of sent or received share requests for custom frameworks in Audit Manager.
Link to this function

list_assessment_framework_share_requests(Client, RequestType, QueryMap, HeadersMap)

View Source
Link to this function

list_assessment_framework_share_requests(Client, RequestType, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_assessment_frameworks(Client, FrameworkType)

View Source
Returns a list of the frameworks that are available in the Audit Manager framework library.
Link to this function

list_assessment_frameworks(Client, FrameworkType, QueryMap, HeadersMap)

View Source
Link to this function

list_assessment_frameworks(Client, FrameworkType, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_assessment_reports(Client)

View Source
Returns a list of assessment reports created in Audit Manager.
Link to this function

list_assessment_reports(Client, QueryMap, HeadersMap)

View Source
Link to this function

list_assessment_reports(Client, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_assessments(Client)

View Source
Returns a list of current and past assessments from Audit Manager.
Link to this function

list_assessments(Client, QueryMap, HeadersMap)

View Source
Link to this function

list_assessments(Client, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_control_domain_insights(Client)

View Source

Lists the latest analytics data for control domains across all of your active assessments.

A control domain is listed only if at least one of the controls within that domain collected evidence on the lastUpdated date of controlDomainInsights. If this condition isn’t met, no data is listed for that control domain.
Link to this function

list_control_domain_insights(Client, QueryMap, HeadersMap)

View Source
Link to this function

list_control_domain_insights(Client, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_control_domain_insights_by_assessment(Client, AssessmentId)

View Source

Lists analytics data for control domains within a specified active assessment.

A control domain is listed only if at least one of the controls within that domain collected evidence on the lastUpdated date of controlDomainInsights. If this condition isn’t met, no data is listed for that domain.
Link to this function

list_control_domain_insights_by_assessment(Client, AssessmentId, QueryMap, HeadersMap)

View Source
Link to this function

list_control_domain_insights_by_assessment(Client, AssessmentId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_control_insights_by_control_domain(Client, ControlDomainId)

View Source

Lists the latest analytics data for controls within a specific control domain across all active assessments.

Control insights are listed only if the control belongs to the control domain that was specified and the control collected evidence on the lastUpdated date of controlInsightsMetadata. If neither of these conditions are met, no data is listed for that control.
Link to this function

list_control_insights_by_control_domain(Client, ControlDomainId, QueryMap, HeadersMap)

View Source
Link to this function

list_control_insights_by_control_domain(Client, ControlDomainId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_controls(Client, ControlType)

View Source
Returns a list of controls from Audit Manager.
Link to this function

list_controls(Client, ControlType, QueryMap, HeadersMap)

View Source
Link to this function

list_controls(Client, ControlType, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_keywords_for_data_source(Client, Source)

View Source
Returns a list of keywords that are pre-mapped to the specified control data source.
Link to this function

list_keywords_for_data_source(Client, Source, QueryMap, HeadersMap)

View Source
Link to this function

list_keywords_for_data_source(Client, Source, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_notifications(Client)

View Source
Returns a list of all Audit Manager notifications.
Link to this function

list_notifications(Client, QueryMap, HeadersMap)

View Source
Link to this function

list_notifications(Client, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_tags_for_resource(Client, ResourceArn)

View Source
Returns a list of tags for the specified resource in Audit Manager.
Link to this function

list_tags_for_resource(Client, ResourceArn, QueryMap, HeadersMap)

View Source
Link to this function

list_tags_for_resource(Client, ResourceArn, QueryMap, HeadersMap, Options0)

View Source
Link to this function

register_account(Client, Input)

View Source
Enables Audit Manager for the specified Amazon Web Services account.
Link to this function

register_account(Client, Input0, Options0)

View Source
Link to this function

register_organization_admin_account(Client, Input)

View Source
Enables an Amazon Web Services account within the organization as the delegated administrator for Audit Manager.
Link to this function

register_organization_admin_account(Client, Input0, Options0)

View Source
Link to this function

start_assessment_framework_share(Client, FrameworkId, Input)

View Source

Creates a share request for a custom framework in Audit Manager.

The share request specifies a recipient and notifies them that a custom framework is available. Recipients have 120 days to accept or decline the request. If no action is taken, the share request expires.

When you invoke the StartAssessmentFrameworkShare API, you are about to share a custom framework with another Amazon Web Services account. You may not share a custom framework that is derived from a standard framework if the standard framework is designated as not eligible for sharing by Amazon Web Services, unless you have obtained permission to do so from the owner of the standard framework. To learn more about which standard frameworks are eligible for sharing, see Framework sharing eligibility in the Audit Manager User Guide.
Link to this function

start_assessment_framework_share(Client, FrameworkId, Input0, Options0)

View Source
Link to this function

tag_resource(Client, ResourceArn, Input)

View Source
Tags the specified resource in Audit Manager.
Link to this function

tag_resource(Client, ResourceArn, Input0, Options0)

View Source
Link to this function

untag_resource(Client, ResourceArn, Input)

View Source
Removes a tag from a resource in Audit Manager.
Link to this function

untag_resource(Client, ResourceArn, Input0, Options0)

View Source
Link to this function

update_assessment(Client, AssessmentId, Input)

View Source
Edits an Audit Manager assessment.
Link to this function

update_assessment(Client, AssessmentId, Input0, Options0)

View Source
Link to this function

update_assessment_control(Client, AssessmentId, ControlId, ControlSetId, Input)

View Source
Updates a control within an assessment in Audit Manager.
Link to this function

update_assessment_control(Client, AssessmentId, ControlId, ControlSetId, Input0, Options0)

View Source
Link to this function

update_assessment_control_set_status(Client, AssessmentId, ControlSetId, Input)

View Source
Updates the status of a control set in an Audit Manager assessment.
Link to this function

update_assessment_control_set_status(Client, AssessmentId, ControlSetId, Input0, Options0)

View Source
Link to this function

update_assessment_framework(Client, FrameworkId, Input)

View Source
Updates a custom framework in Audit Manager.
Link to this function

update_assessment_framework(Client, FrameworkId, Input0, Options0)

View Source
Link to this function

update_assessment_framework_share(Client, RequestId, Input)

View Source
Updates a share request for a custom framework in Audit Manager.
Link to this function

update_assessment_framework_share(Client, RequestId, Input0, Options0)

View Source
Link to this function

update_assessment_status(Client, AssessmentId, Input)

View Source
Updates the status of an assessment in Audit Manager.
Link to this function

update_assessment_status(Client, AssessmentId, Input0, Options0)

View Source
Link to this function

update_control(Client, ControlId, Input)

View Source
Updates a custom control in Audit Manager.
Link to this function

update_control(Client, ControlId, Input0, Options0)

View Source
Link to this function

update_settings(Client, Input)

View Source
Updates Audit Manager settings for the current user account.
Link to this function

update_settings(Client, Input0, Options0)

View Source
Link to this function

validate_assessment_report_integrity(Client, Input)

View Source
Validates the integrity of an assessment report in Audit Manager.
Link to this function

validate_assessment_report_integrity(Client, Input0, Options0)

View Source