AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates an audit report that lists every time that your CA private key is used. The report is saved in the Amazon S3 bucket that you specify on input. The IssueCertificate and RevokeCertificate actions use the private key.

Both Amazon Web Services Private CA and the IAM principal must have permission to write to the S3 bucket that you specify. If the IAM principal making the call does not have permission to write to the bucket, then an exception is thrown. For more information, see Access policies for CRLs in Amazon S3.

Amazon Web Services Private CA assets that are stored in Amazon S3 can be protected with encryption. For more information, see Encrypting Your Audit Reports.

You can generate a maximum of one report every 30 minutes.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginCreateCertificateAuthorityAuditReport and EndCreateCertificateAuthorityAuditReport.

Namespace: Amazon.ACMPCA
Assembly: AWSSDK.ACMPCA.dll
Version: 3.x.y.z

Syntax

C#
public virtual Task<CreateCertificateAuthorityAuditReportResponse> CreateCertificateAuthorityAuditReportAsync(
         CreateCertificateAuthorityAuditReportRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.ACMPCA.Model.CreateCertificateAuthorityAuditReportRequest

Container for the necessary parameters to execute the CreateCertificateAuthorityAuditReport service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the CreateCertificateAuthorityAuditReport service method, as returned by ACMPCA.

Exceptions

ExceptionCondition
InvalidArgsException One or more of the specified arguments was not valid.
InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
InvalidStateException The state of the private CA does not allow this action to occur.
RequestFailedException The request has failed for an unspecified reason.
RequestInProgressException Your request is already in progress.
ResourceNotFoundException A resource such as a private CA, S3 bucket, certificate, audit report, or policy cannot be found.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also