Class CertificateAuthority
- java.lang.Object
-
- software.amazon.awssdk.services.acmpca.model.CertificateAuthority
-
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<CertificateAuthority.Builder,CertificateAuthority>
@Generated("software.amazon.awssdk:codegen") public final class CertificateAuthority extends Object implements SdkPojo, Serializable, ToCopyableBuilder<CertificateAuthority.Builder,CertificateAuthority>
Contains information about your private certificate authority (CA). Your private CA can issue and revoke X.509 digital certificates. Digital certificates verify that the entity named in the certificate Subject field owns or controls the public key contained in the Subject Public Key Info field. Call the CreateCertificateAuthority action to create your private CA. You must then call the GetCertificateAuthorityCertificate action to retrieve a private CA certificate signing request (CSR). Sign the CSR with your Amazon Web Services Private CA-hosted or on-premises root or subordinate CA certificate. Call the ImportCertificateAuthorityCertificate action to import the signed certificate into Certificate Manager (ACM).
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceCertificateAuthority.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description Stringarn()Amazon Resource Name (ARN) for your private certificate authority (CA).static CertificateAuthority.Builderbuilder()CertificateAuthorityConfigurationcertificateAuthorityConfiguration()Your private CA configuration.InstantcreatedAt()Date and time at which your private CA was created.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)FailureReasonfailureReason()Reason the request to create your private CA failed.StringfailureReasonAsString()Reason the request to create your private CA failed.<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)inthashCode()KeyStorageSecurityStandardkeyStorageSecurityStandard()Defines a cryptographic key management compliance standard used for handling CA keys.StringkeyStorageSecurityStandardAsString()Defines a cryptographic key management compliance standard used for handling CA keys.InstantlastStateChangeAt()Date and time at which your private CA was last updated.InstantnotAfter()Date and time after which your private CA certificate is not valid.InstantnotBefore()Date and time before which your private CA certificate is not valid.StringownerAccount()The Amazon Web Services account ID that owns the certificate authority.InstantrestorableUntil()The period during which a deleted CA can be restored.RevocationConfigurationrevocationConfiguration()Information about the Online Certificate Status Protocol (OCSP) configuration or certificate revocation list (CRL) created and maintained by your private CA.Map<String,SdkField<?>>sdkFieldNameToField()List<SdkField<?>>sdkFields()Stringserial()Serial number of your private CA.static Class<? extends CertificateAuthority.Builder>serializableBuilderClass()CertificateAuthorityStatusstatus()Status of your private CA.StringstatusAsString()Status of your private CA.CertificateAuthority.BuildertoBuilder()StringtoString()Returns a string representation of this object.CertificateAuthorityTypetype()Type of your private CA.StringtypeAsString()Type of your private CA.CertificateAuthorityUsageModeusageMode()Specifies whether the CA issues general-purpose certificates that typically require a revocation mechanism, or short-lived certificates that may optionally omit revocation because they expire quickly.StringusageModeAsString()Specifies whether the CA issues general-purpose certificates that typically require a revocation mechanism, or short-lived certificates that may optionally omit revocation because they expire quickly.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
arn
public final String arn()
Amazon Resource Name (ARN) for your private certificate authority (CA). The format is
12345678-1234-1234-1234-123456789012.- Returns:
- Amazon Resource Name (ARN) for your private certificate authority (CA). The format is
12345678-1234-1234-1234-123456789012.
-
ownerAccount
public final String ownerAccount()
The Amazon Web Services account ID that owns the certificate authority.
- Returns:
- The Amazon Web Services account ID that owns the certificate authority.
-
createdAt
public final Instant createdAt()
Date and time at which your private CA was created.
- Returns:
- Date and time at which your private CA was created.
-
lastStateChangeAt
public final Instant lastStateChangeAt()
Date and time at which your private CA was last updated.
- Returns:
- Date and time at which your private CA was last updated.
-
type
public final CertificateAuthorityType type()
Type of your private CA.
If the service returns an enum value that is not available in the current SDK version,
typewill returnCertificateAuthorityType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromtypeAsString().- Returns:
- Type of your private CA.
- See Also:
CertificateAuthorityType
-
typeAsString
public final String typeAsString()
Type of your private CA.
If the service returns an enum value that is not available in the current SDK version,
typewill returnCertificateAuthorityType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromtypeAsString().- Returns:
- Type of your private CA.
- See Also:
CertificateAuthorityType
-
serial
public final String serial()
Serial number of your private CA.
- Returns:
- Serial number of your private CA.
-
status
public final CertificateAuthorityStatus status()
Status of your private CA.
If the service returns an enum value that is not available in the current SDK version,
statuswill returnCertificateAuthorityStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstatusAsString().- Returns:
- Status of your private CA.
- See Also:
CertificateAuthorityStatus
-
statusAsString
public final String statusAsString()
Status of your private CA.
If the service returns an enum value that is not available in the current SDK version,
statuswill returnCertificateAuthorityStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstatusAsString().- Returns:
- Status of your private CA.
- See Also:
CertificateAuthorityStatus
-
notBefore
public final Instant notBefore()
Date and time before which your private CA certificate is not valid.
- Returns:
- Date and time before which your private CA certificate is not valid.
-
notAfter
public final Instant notAfter()
Date and time after which your private CA certificate is not valid.
- Returns:
- Date and time after which your private CA certificate is not valid.
-
failureReason
public final FailureReason failureReason()
Reason the request to create your private CA failed.
If the service returns an enum value that is not available in the current SDK version,
failureReasonwill returnFailureReason.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromfailureReasonAsString().- Returns:
- Reason the request to create your private CA failed.
- See Also:
FailureReason
-
failureReasonAsString
public final String failureReasonAsString()
Reason the request to create your private CA failed.
If the service returns an enum value that is not available in the current SDK version,
failureReasonwill returnFailureReason.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromfailureReasonAsString().- Returns:
- Reason the request to create your private CA failed.
- See Also:
FailureReason
-
certificateAuthorityConfiguration
public final CertificateAuthorityConfiguration certificateAuthorityConfiguration()
Your private CA configuration.
- Returns:
- Your private CA configuration.
-
revocationConfiguration
public final RevocationConfiguration revocationConfiguration()
Information about the Online Certificate Status Protocol (OCSP) configuration or certificate revocation list (CRL) created and maintained by your private CA.
- Returns:
- Information about the Online Certificate Status Protocol (OCSP) configuration or certificate revocation list (CRL) created and maintained by your private CA.
-
restorableUntil
public final Instant restorableUntil()
The period during which a deleted CA can be restored. For more information, see the
PermanentDeletionTimeInDaysparameter of the DeleteCertificateAuthorityRequest action.- Returns:
- The period during which a deleted CA can be restored. For more information, see the
PermanentDeletionTimeInDaysparameter of the DeleteCertificateAuthorityRequest action.
-
keyStorageSecurityStandard
public final KeyStorageSecurityStandard keyStorageSecurityStandard()
Defines a cryptographic key management compliance standard used for handling CA keys.
Default: FIPS_140_2_LEVEL_3_OR_HIGHER
Note: Amazon Web Services Region ap-northeast-3 supports only FIPS_140_2_LEVEL_2_OR_HIGHER. You must explicitly specify this parameter and value when creating a CA in that Region. Specifying a different value (or no value) results in an
InvalidArgsExceptionwith the message "A certificate authority cannot be created in this region with the specified security standard."If the service returns an enum value that is not available in the current SDK version,
keyStorageSecurityStandardwill returnKeyStorageSecurityStandard.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromkeyStorageSecurityStandardAsString().- Returns:
- Defines a cryptographic key management compliance standard used for handling CA keys.
Default: FIPS_140_2_LEVEL_3_OR_HIGHER
Note: Amazon Web Services Region ap-northeast-3 supports only FIPS_140_2_LEVEL_2_OR_HIGHER. You must explicitly specify this parameter and value when creating a CA in that Region. Specifying a different value (or no value) results in an
InvalidArgsExceptionwith the message "A certificate authority cannot be created in this region with the specified security standard." - See Also:
KeyStorageSecurityStandard
-
keyStorageSecurityStandardAsString
public final String keyStorageSecurityStandardAsString()
Defines a cryptographic key management compliance standard used for handling CA keys.
Default: FIPS_140_2_LEVEL_3_OR_HIGHER
Note: Amazon Web Services Region ap-northeast-3 supports only FIPS_140_2_LEVEL_2_OR_HIGHER. You must explicitly specify this parameter and value when creating a CA in that Region. Specifying a different value (or no value) results in an
InvalidArgsExceptionwith the message "A certificate authority cannot be created in this region with the specified security standard."If the service returns an enum value that is not available in the current SDK version,
keyStorageSecurityStandardwill returnKeyStorageSecurityStandard.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromkeyStorageSecurityStandardAsString().- Returns:
- Defines a cryptographic key management compliance standard used for handling CA keys.
Default: FIPS_140_2_LEVEL_3_OR_HIGHER
Note: Amazon Web Services Region ap-northeast-3 supports only FIPS_140_2_LEVEL_2_OR_HIGHER. You must explicitly specify this parameter and value when creating a CA in that Region. Specifying a different value (or no value) results in an
InvalidArgsExceptionwith the message "A certificate authority cannot be created in this region with the specified security standard." - See Also:
KeyStorageSecurityStandard
-
usageMode
public final CertificateAuthorityUsageMode usageMode()
Specifies whether the CA issues general-purpose certificates that typically require a revocation mechanism, or short-lived certificates that may optionally omit revocation because they expire quickly. Short-lived certificate validity is limited to seven days.
The default value is GENERAL_PURPOSE.
If the service returns an enum value that is not available in the current SDK version,
usageModewill returnCertificateAuthorityUsageMode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromusageModeAsString().- Returns:
- Specifies whether the CA issues general-purpose certificates that typically require a revocation
mechanism, or short-lived certificates that may optionally omit revocation because they expire quickly.
Short-lived certificate validity is limited to seven days.
The default value is GENERAL_PURPOSE.
- See Also:
CertificateAuthorityUsageMode
-
usageModeAsString
public final String usageModeAsString()
Specifies whether the CA issues general-purpose certificates that typically require a revocation mechanism, or short-lived certificates that may optionally omit revocation because they expire quickly. Short-lived certificate validity is limited to seven days.
The default value is GENERAL_PURPOSE.
If the service returns an enum value that is not available in the current SDK version,
usageModewill returnCertificateAuthorityUsageMode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromusageModeAsString().- Returns:
- Specifies whether the CA issues general-purpose certificates that typically require a revocation
mechanism, or short-lived certificates that may optionally omit revocation because they expire quickly.
Short-lived certificate validity is limited to seven days.
The default value is GENERAL_PURPOSE.
- See Also:
CertificateAuthorityUsageMode
-
toBuilder
public CertificateAuthority.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<CertificateAuthority.Builder,CertificateAuthority>
-
builder
public static CertificateAuthority.Builder builder()
-
serializableBuilderClass
public static Class<? extends CertificateAuthority.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final String toString()
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
-
sdkFieldNameToField
public final Map<String,SdkField<?>> sdkFieldNameToField()
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo
-
-