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.

Requests an ACM certificate for use with other Amazon Web Services services. To request an ACM certificate, you must specify a fully qualified domain name (FQDN) in the DomainName parameter. You can also specify additional FQDNs in the SubjectAlternativeNames parameter.

If you are requesting a private certificate, domain validation is not required. If you are requesting a public certificate, each domain name that you specify must be validated to verify that you own or control the domain. You can use DNS validation or email validation. We recommend that you use DNS validation. ACM issues public certificates after receiving approval from the domain owner.

ACM behavior differs from the RFC 6125 specification of the certificate validation process. ACM first checks for a Subject Alternative Name, and, if it finds one, ignores the common name (CN).

After successful completion of the RequestCertificate action, there is a delay of several seconds before you can retrieve information about the new certificate.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to RequestCertificateAsync.

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

Syntax

C#
public virtual RequestCertificateResponse RequestCertificate(
         RequestCertificateRequest request
)

Parameters

request
Type: Amazon.CertificateManager.Model.RequestCertificateRequest

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

Return Value


The response from the RequestCertificate service method, as returned by CertificateManager.

Exceptions

ExceptionCondition
InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
InvalidDomainValidationOptionsException One or more values in the DomainValidationOption structure is incorrect.
InvalidParameterException An input parameter was invalid.
InvalidTagException One or both of the values that make up the key-value pair is not valid. For example, you cannot specify a tag value that begins with aws:.
LimitExceededException An ACM quota has been exceeded.
TagPolicyException A specified tag did not comply with an existing tag policy and was rejected.
TooManyTagsException The request contains too many tags. Try the request again with fewer tags.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

See Also