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.

Deletes a certificate and its associated private key. If this action succeeds, the certificate no longer appears in the list that can be displayed by calling the ListCertificates action or be retrieved by calling the GetCertificate action. The certificate will not be available for use by Amazon Web Services services integrated with ACM.

You cannot delete an ACM certificate that is being used by another Amazon Web Services service. To delete a certificate that is in use, the certificate association must first be removed.

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 BeginDeleteCertificate and EndDeleteCertificate.

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

Syntax

C#
public abstract Task<DeleteCertificateResponse> DeleteCertificateAsync(
         String certificateArn,
         CancellationToken cancellationToken
)

Parameters

certificateArn
Type: System.String

String that contains the ARN of the ACM certificate to be deleted. This must be of the form: arn:aws:acm:region:123456789012:certificate/12345678-1234-1234-1234-123456789012 For more information about ARNs, see Amazon Resource Names (ARNs).

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 DeleteCertificate service method, as returned by CertificateManager.

Exceptions

ExceptionCondition
AccessDeniedException You do not have access required to perform this action.
ConflictException You are trying to update a resource or configuration that is already being created or updated. Wait for the previous operation to finish and try again.
InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
ResourceInUseException The certificate is in use by another Amazon Web Services service in the caller's account. Remove the association and try again.
ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
ThrottlingException The request was denied because it exceeded a quota.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also