How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Amazon IoT Core Audit API

The Audit API from Amazon IoT Core — 19 operation(s) for audit.

Amazon IoT Core Audit API is one of 70 APIs that Amazon IoT Core publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Audit. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and pricing.

This API exposes 25 operations across 19 paths, and defines 145 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 4 base URLs: http://iot.{region}.amazonaws.com, https://iot.{region}.amazonaws.com, http://iot.{region}.amazonaws.com.cn, https://iot.{region}.amazonaws.com.cn.

25 operations 19 paths 145 schemas 2 DELETE10 GET3 PATCH8 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://iot.amazonaws.com
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

Amazon IoT Core Audit API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (hmac). By default, every request must be authenticated.

  • hmac — Amazon Signature authorization v4

Paths & Operations 25

Across 19 paths, the API surfaces 25 operations — 2 DELETE, 10 GET, 3 PATCH, 8 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Audit 25
PUT
/audit/mitigationactions/tasks/{taskId}/cancel
Amazon IoT Core Cancel Audit Mitigation Actions Task
CancelAuditMitigationActionsTask 8 params → 200480481482483
PUT
/audit/tasks/{taskId}/cancel
Amazon IoT Core Cancel Audit Task
CancelAuditTask 8 params → 200480481482483
POST
/audit/suppressions/create
Amazon IoT Core Create Audit Suppression
CreateAuditSuppression 7 params body → 200480481482483484
POST
/audit/scheduledaudits/{scheduledAuditName}
Amazon IoT Core Create Scheduled Audit
CreateScheduledAudit 8 params body → 200480481482483484
DELETE
/audit/scheduledaudits/{scheduledAuditName}
Amazon IoT Core Delete Scheduled Audit
DeleteScheduledAudit 8 params → 200480481482483
GET
/audit/scheduledaudits/{scheduledAuditName}
Amazon IoT Core Describe Scheduled Audit
DescribeScheduledAudit 8 params → 200480481482483
PATCH
/audit/scheduledaudits/{scheduledAuditName}
Amazon IoT Core Update Scheduled Audit
UpdateScheduledAudit 8 params body → 200480481482483
DELETE
/audit/configuration
Amazon IoT Core Delete Account Audit Configuration
DeleteAccountAuditConfiguration 8 params → 200480481482483
GET
/audit/configuration
Amazon IoT Core Describe Account Audit Configuration
DescribeAccountAuditConfiguration 7 params → 200480481
PATCH
/audit/configuration
Amazon IoT Core Update Account Audit Configuration
UpdateAccountAuditConfiguration 7 params body → 200480481482
POST
/audit/suppressions/delete
Amazon IoT Core Delete Audit Suppression
DeleteAuditSuppression 7 params body → 200480481482
GET
/audit/findings/{findingId}
Amazon IoT Core Describe Audit Finding
DescribeAuditFinding 8 params → 200480481482483
GET
/audit/mitigationactions/tasks/{taskId}
Amazon IoT Core Describe Audit Mitigation Actions Task
DescribeAuditMitigationActionsTask 8 params → 200480481482483
POST
/audit/mitigationactions/tasks/{taskId}
Amazon IoT Core Start Audit Mitigation Actions Task
StartAuditMitigationActionsTask 8 params body → 200480481482483484
POST
/audit/suppressions/describe
Amazon IoT Core Describe Audit Suppression
DescribeAuditSuppression 7 params body → 200480481482483
GET
/audit/tasks/{taskId}
Amazon IoT Core Describe Audit Task
DescribeAuditTask 8 params → 200480481482483
POST
/audit/findings
Amazon IoT Core List Audit Findings
ListAuditFindings 9 params body → 200480481482
GET
/audit/mitigationactions/executions#taskId&findingId
Amazon IoT Core List Audit Mitigation Actions Executions
ListAuditMitigationActionsExecutions 12 params → 200480481482
GET
/audit/mitigationactions/tasks#startTime&endTime
Amazon IoT Core List Audit Mitigation Actions Tasks
ListAuditMitigationActionsTasks 14 params → 200480481482
POST
/audit/suppressions/list
Amazon IoT Core List Audit Suppressions
ListAuditSuppressions 9 params body → 200480481482
GET
/audit/tasks#startTime&endTime
Amazon IoT Core List Audit Tasks
ListAuditTasks 13 params → 200480481482
GET
/audit/relatedResources#findingId
Amazon IoT Core List Related Resources for Audit Finding
ListRelatedResourcesForAuditFinding 10 params → 200480481482483
GET
/audit/scheduledaudits
Amazon IoT Core List Scheduled Audits
ListScheduledAudits 9 params → 200480481482
POST
/audit/tasks
Amazon IoT Core Start on Demand Audit Task
StartOnDemandAuditTask 7 params body → 200480481482483
PATCH
/audit/suppressions/update
Amazon IoT Core Update Audit Suppression
UpdateAuditSuppression 7 params body → 200480481482483

Schemas 145

The contract defines 145 schemas that model the data the API accepts and returns. The most detailed are AuditFinding (11 properties), ResourceIdentifier (10 properties), AuditMitigationActionExecutionMetadata (9 properties), AuditCheckDetails (7 properties). Each schema is shown below with its type and property counts.

ScheduledAuditMetadataList
array
DeleteScheduledAuditResponse
object
WaitingForDataCollectionChecksCount
integer
DayOfWeek
string
FailedFindingsCount
integer
CancelAuditMitigationActionsTaskResponse
object
AuditTaskType
string
AuditTaskMetadata
object
The audits that were performed.
3 properties
ResourceNotFoundException
TaskStatisticsForAuditCheck
object
Provides summary counts of how many tasks for findings are in a particular state. This information is included in the response from DescribeAuditMitigationActi…
5 properties
AuditMitigationActionsTaskMetadata
object
Information about an audit mitigation actions task that is returned by ListAuditMitigationActionsTasks .
3 properties
AuditMitigationActionsTaskMetadataList
array
ReasonForNonComplianceCodes
array
AuditMitigationActionsTaskTarget
object
Used in MitigationActionParams, this information identifies the target findings to which the mitigation actions are applied. Only one entry appears.
3 properties
String
string
PolicyName
string
IssuerCertificateSubject
string
CertificateArn
string
InternalFailureException
NonCompliantResourcesCount
integer
AuditCheckConfigurations
object
DescribeAuditSuppressionResponse
object
5 properties
FindingIds
array
SuppressedNonCompliantResourcesCount
integer
ReplaceDefaultPolicyVersionParams
object
Parameters to define a mitigation action that adds a blank policy to restrict permissions.
1 property 1 required
ThingGroupNames
array
AuditCheckRunStatus
string
AuditSuppressionList
array
AuditCheckToActionsMapping
object
AuditSuppression
object
Filters out specific findings of a Device Defender audit.
5 properties 2 required
CACertificateUpdateAction
string
TagValue
string
TotalFindingsCount
integer
LimitExceededException
RoleAliasArn
string
AuditFinding
object
The findings (results) of the audit.
11 properties
AwsAccountId
string
DeleteAuditSuppressionResponse
object
CancelAuditTaskResponse
object
TotalChecksCount
integer
UpdateCACertificateParams
object
Parameters to define a mitigation action that changes the state of the CA certificate to inactive.
1 property 1 required
ThingGroupName
string
FindingId
string
ResourceIdentifier
object
Information that identifies the noncompliant resource.
10 properties
TotalResourcesCount
integer
ListAuditSuppressionsResponse
object
2 properties
TagKey
string
InvalidRequestException
ReasonForNonComplianceCode
string
ListAuditFindingsResponse
object
2 properties
AuditCheckDetails
object
Information about the audit check.
7 properties
ListAuditMitigationActionsTasksResponse
object
2 properties
ErrorMessage
string
AuditCheckName
string
An audit check name. Checks must be enabled for your account. (Use DescribeAccountAuditConfiguration to see the list of all checks, including those that are en…
RoleArn
string
IssuerId
string
ScheduledAuditArn
string
UpdateDeviceCertificateParams
object
Parameters to define a mitigation action that changes the state of the device certificate to inactive.
1 property 1 required
ListAuditTasksResponse
object
2 properties
ResourceAlreadyExistsException
StringMap
object
CognitoIdentityPoolId
string
DescribeScheduledAuditResponse
object
6 properties
SnsTopicArn
string
AuditDescription
string
ListRelatedResourcesForAuditFindingResponse
object
2 properties
DescribeAuditMitigationActionsTaskResponse
object
7 properties
PublishFindingToSnsParams
object
Parameters to define a mitigation action that publishes findings to Amazon SNS. You can implement your own custom actions in response to the Amazon SNS message…
1 property 1 required
ClientId
string
ResourceType
string
CertificateId
string
AuditTaskId
string
CompliantChecksCount
integer
AuditCheckToReasonCodeFilter
object
DayOfMonth
string
Tag
object
A set of key/value pairs that are used to manage the resource.
2 properties 1 required
AuditFindings
array
MitigationActionNameList
array
MitigationActionList
array
ReasonForNonCompliance
string
AuditTaskMetadataList
array
NextToken
string
InProgressChecksCount
integer
DeleteAccountAuditConfigurationResponse
object
IssuerCertificateIdentifier
object
The certificate issuer indentifier.
3 properties
AuditMitigationActionsTaskStatus
string
CreateScheduledAuditResponse
object
1 property
AuditMitigationActionsTaskStatistics
object
AuditNotificationTarget
object
Information about the targets to which audit notifications are sent.
3 properties
ListScheduledAuditsResponse
object
2 properties
NonCompliantChecksCount
integer
SuppressIndefinitely
boolean
NonCompliantResource
object
Information about the resource that was noncompliant with the audit check.
3 properties
DescribeAuditFindingResponse
object
1 property
UpdateScheduledAuditResponse
object
1 property
AuditMitigationActionExecutionMetadataList
array
FailedChecksCount
integer
UpdateAuditSuppressionResponse
object
AuditMitigationActionExecutionMetadata
object
Returned by ListAuditMitigationActionsTask, this object contains information that describes a mitigation action that has been started.
9 properties
ScheduledAuditMetadata
object
Information about the scheduled audit.
5 properties
AuditFrequency
string
RelatedResources
array
UpdateAccountAuditConfigurationResponse
object
AuditTaskStatus
string
ListAuditMitigationActionsExecutionsResponse
object
2 properties
EnableIoTLoggingParams
object
Parameters used when defining a mitigation action that enable Amazon Web Services IoT Core logging.
2 properties 2 required
AddThingsToThingGroupParams
object
Parameters used when defining a mitigation action that move a set of things to a thing group.
2 properties 1 required
TaskAlreadyExistsException
LogLevel
string
AuditMitigationActionsExecutionStatus
string
CanceledFindingsCount
integer
AuditNotificationTargetConfigurations
object
MitigationActionName
string
PolicyVersionId
string
ThrottlingException
DeviceCertificateUpdateAction
string
ScheduledAuditName
string
TargetArn
string
TaskStatistics
object
Statistics for the checks performed during the audit.
7 properties
CreateAuditSuppressionResponse
object
MitigationActionsTaskId
string
CheckCompliant
boolean
StartAuditMitigationActionsTaskResponse
object
1 property
AuditCheckConfiguration
object
Which audit checks are enabled and disabled for this account.
1 property
PolicyVersionIdentifier
object
Information about the version of the policy associated with the resource.
2 properties
IssuerCertificateSerialNumber
string
RelatedResource
object
Information about a related resource.
3 properties
SkippedFindingsCount
integer
MitigationActionId
string
StartOnDemandAuditTaskResponse
object
1 property
AuditDetails
object
DescribeAuditTaskResponse
object
6 properties
AuditFindingSeverity
string
IsSuppressed
boolean
CanceledChecksCount
integer
SucceededFindingsCount
integer
Timestamp
string
NullableBoolean
boolean
DescribeAccountAuditConfigurationResponse
object
3 properties
Enabled
boolean
TargetAuditCheckNames
array
MitigationAction
object
Describes which changes should be applied as part of a mitigation action.
4 properties
PolicyTemplateName
string
ErrorCode
string
MitigationActionParams
object
The set of parameters for this mitigation action. You can specify only one type of parameter (in other words, you can apply only one action for each defined mi…
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

amazon-iot-core-audit-api-openapi.yml Raw ↑

Other APIs Amazon IoT Core publishes across the network.

Amazon IoT Core Accept Certificate Transfer API
Amazon IoT Core Active Violations API
Amazon IoT Core Attached Policies API
Amazon IoT Core Authorizer API
Amazon IoT Core Authorizers API
Amazon IoT Core Behavior Model Training API
Amazon IoT Core Billing Groups API
Amazon IoT Core Cacertificate API
Amazon IoT Core Cacertificates API
Amazon IoT Core Cancel Certificate Transfer API
Amazon IoT Core Certificate API
Amazon IoT Core Certificates API
Where this information came from

This is an independent, third-party profile of Amazon IoT Core Audit API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.