Interface AcmAsyncClient
- All Superinterfaces:
AutoCloseable,AwsClient,SdkAutoCloseable,SdkClient
builder() method.The
asynchronous client performs non-blocking I/O when configured with any SdkAsyncHttpClient supported in the
SDK. However, full non-blocking is not guaranteed as the async client may perform blocking calls in some cases such
as credentials retrieval and endpoint discovery as part of the async API call.
You can use Certificate Manager (ACM) to manage SSL/TLS certificates for your Amazon Web Services-based websites and applications. For more information about using ACM, see the Certificate Manager User Guide.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringValue for looking up the service's metadata from theServiceMetadataProvider.static final String -
Method Summary
Modifier and TypeMethodDescriptionaddTagsToCertificate(Consumer<AddTagsToCertificateRequest.Builder> addTagsToCertificateRequest) Adds one or more tags to an ACM certificate.addTagsToCertificate(AddTagsToCertificateRequest addTagsToCertificateRequest) Adds one or more tags to an ACM certificate.static AcmAsyncClientBuilderbuilder()Create a builder that can be used to configure and create aAcmAsyncClient.static AcmAsyncClientcreate()Create aAcmAsyncClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider.createAcmeDomainValidation(Consumer<CreateAcmeDomainValidationRequest.Builder> createAcmeDomainValidationRequest) Creates a domain validation for an ACME endpoint.createAcmeDomainValidation(CreateAcmeDomainValidationRequest createAcmeDomainValidationRequest) Creates a domain validation for an ACME endpoint.createAcmeEndpoint(Consumer<CreateAcmeEndpointRequest.Builder> createAcmeEndpointRequest) Creates an ACME endpoint, which is a managed ACME server with a unique endpoint URL.createAcmeEndpoint(CreateAcmeEndpointRequest createAcmeEndpointRequest) Creates an ACME endpoint, which is a managed ACME server with a unique endpoint URL.createAcmeExternalAccountBinding(Consumer<CreateAcmeExternalAccountBindingRequest.Builder> createAcmeExternalAccountBindingRequest) Creates an external account binding (EAB) for an ACME endpoint.createAcmeExternalAccountBinding(CreateAcmeExternalAccountBindingRequest createAcmeExternalAccountBindingRequest) Creates an external account binding (EAB) for an ACME endpoint.deleteAcmeDomainValidation(Consumer<DeleteAcmeDomainValidationRequest.Builder> deleteAcmeDomainValidationRequest) Deletes a domain validation.deleteAcmeDomainValidation(DeleteAcmeDomainValidationRequest deleteAcmeDomainValidationRequest) Deletes a domain validation.deleteAcmeEndpoint(Consumer<DeleteAcmeEndpointRequest.Builder> deleteAcmeEndpointRequest) Deletes an ACME endpoint.deleteAcmeEndpoint(DeleteAcmeEndpointRequest deleteAcmeEndpointRequest) Deletes an ACME endpoint.deleteAcmeExternalAccountBinding(Consumer<DeleteAcmeExternalAccountBindingRequest.Builder> deleteAcmeExternalAccountBindingRequest) Deletes an external account binding.deleteAcmeExternalAccountBinding(DeleteAcmeExternalAccountBindingRequest deleteAcmeExternalAccountBindingRequest) Deletes an external account binding.deleteCertificate(Consumer<DeleteCertificateRequest.Builder> deleteCertificateRequest) Deletes a certificate and its associated private key.deleteCertificate(DeleteCertificateRequest deleteCertificateRequest) Deletes a certificate and its associated private key.describeAcmeAccount(Consumer<DescribeAcmeAccountRequest.Builder> describeAcmeAccountRequest) Returns detailed metadata about the specified ACME account, including its status, public key thumbprint, and associated external account binding.describeAcmeAccount(DescribeAcmeAccountRequest describeAcmeAccountRequest) Returns detailed metadata about the specified ACME account, including its status, public key thumbprint, and associated external account binding.describeAcmeDomainValidation(Consumer<DescribeAcmeDomainValidationRequest.Builder> describeAcmeDomainValidationRequest) Returns detailed metadata about the specified domain validation, including its status, domain scope, and DNS resource records required for validation.describeAcmeDomainValidation(DescribeAcmeDomainValidationRequest describeAcmeDomainValidationRequest) Returns detailed metadata about the specified domain validation, including its status, domain scope, and DNS resource records required for validation.describeAcmeEndpoint(Consumer<DescribeAcmeEndpointRequest.Builder> describeAcmeEndpointRequest) Returns detailed metadata about the specified ACME endpoint, including its status, URL, authorization behavior, and certificate authority configuration.describeAcmeEndpoint(DescribeAcmeEndpointRequest describeAcmeEndpointRequest) Returns detailed metadata about the specified ACME endpoint, including its status, URL, authorization behavior, and certificate authority configuration.describeAcmeExternalAccountBinding(Consumer<DescribeAcmeExternalAccountBindingRequest.Builder> describeAcmeExternalAccountBindingRequest) Returns detailed metadata about the specified external account binding, including the associated IAM role, expiration time, and usage history.describeAcmeExternalAccountBinding(DescribeAcmeExternalAccountBindingRequest describeAcmeExternalAccountBindingRequest) Returns detailed metadata about the specified external account binding, including the associated IAM role, expiration time, and usage history.describeCertificate(Consumer<DescribeCertificateRequest.Builder> describeCertificateRequest) Returns detailed metadata about the specified ACM certificate.describeCertificate(DescribeCertificateRequest describeCertificateRequest) Returns detailed metadata about the specified ACM certificate.exportCertificate(Consumer<ExportCertificateRequest.Builder> exportCertificateRequest) Exports a private certificate issued by a private certificate authority (CA) or a public certificate for use anywhere.exportCertificate(ExportCertificateRequest exportCertificateRequest) Exports a private certificate issued by a private certificate authority (CA) or a public certificate for use anywhere.getAccountConfiguration(Consumer<GetAccountConfigurationRequest.Builder> getAccountConfigurationRequest) Returns the account configuration options associated with an Amazon Web Services account.getAccountConfiguration(GetAccountConfigurationRequest getAccountConfigurationRequest) Returns the account configuration options associated with an Amazon Web Services account.getAcmeExternalAccountBindingCredentials(Consumer<GetAcmeExternalAccountBindingCredentialsRequest.Builder> getAcmeExternalAccountBindingCredentialsRequest) Retrieves the key ID and MAC key credentials for an external account binding.getAcmeExternalAccountBindingCredentials(GetAcmeExternalAccountBindingCredentialsRequest getAcmeExternalAccountBindingCredentialsRequest) Retrieves the key ID and MAC key credentials for an external account binding.default CompletableFuture<GetCertificateResponse> getCertificate(Consumer<GetCertificateRequest.Builder> getCertificateRequest) Retrieves a certificate and its certificate chain.default CompletableFuture<GetCertificateResponse> getCertificate(GetCertificateRequest getCertificateRequest) Retrieves a certificate and its certificate chain.importCertificate(Consumer<ImportCertificateRequest.Builder> importCertificateRequest) Imports a certificate into Certificate Manager (ACM) to use with services that are integrated with ACM.importCertificate(ImportCertificateRequest importCertificateRequest) Imports a certificate into Certificate Manager (ACM) to use with services that are integrated with ACM.listAcmeAccounts(Consumer<ListAcmeAccountsRequest.Builder> listAcmeAccountsRequest) Retrieves a list of ACME accounts registered with the specified ACME endpoint.listAcmeAccounts(ListAcmeAccountsRequest listAcmeAccountsRequest) Retrieves a list of ACME accounts registered with the specified ACME endpoint.default ListAcmeAccountsPublisherlistAcmeAccountsPaginator(Consumer<ListAcmeAccountsRequest.Builder> listAcmeAccountsRequest) This is a variant oflistAcmeAccounts(software.amazon.awssdk.services.acm.model.ListAcmeAccountsRequest)operation.default ListAcmeAccountsPublisherlistAcmeAccountsPaginator(ListAcmeAccountsRequest listAcmeAccountsRequest) This is a variant oflistAcmeAccounts(software.amazon.awssdk.services.acm.model.ListAcmeAccountsRequest)operation.listAcmeDomainValidations(Consumer<ListAcmeDomainValidationsRequest.Builder> listAcmeDomainValidationsRequest) Retrieves a list of domain validations for the specified ACME endpoint.listAcmeDomainValidations(ListAcmeDomainValidationsRequest listAcmeDomainValidationsRequest) Retrieves a list of domain validations for the specified ACME endpoint.listAcmeDomainValidationsPaginator(Consumer<ListAcmeDomainValidationsRequest.Builder> listAcmeDomainValidationsRequest) This is a variant oflistAcmeDomainValidations(software.amazon.awssdk.services.acm.model.ListAcmeDomainValidationsRequest)operation.listAcmeDomainValidationsPaginator(ListAcmeDomainValidationsRequest listAcmeDomainValidationsRequest) This is a variant oflistAcmeDomainValidations(software.amazon.awssdk.services.acm.model.ListAcmeDomainValidationsRequest)operation.listAcmeEndpoints(Consumer<ListAcmeEndpointsRequest.Builder> listAcmeEndpointsRequest) Retrieves a list of ACME endpoints in your account.listAcmeEndpoints(ListAcmeEndpointsRequest listAcmeEndpointsRequest) Retrieves a list of ACME endpoints in your account.default ListAcmeEndpointsPublisherlistAcmeEndpointsPaginator(Consumer<ListAcmeEndpointsRequest.Builder> listAcmeEndpointsRequest) This is a variant oflistAcmeEndpoints(software.amazon.awssdk.services.acm.model.ListAcmeEndpointsRequest)operation.default ListAcmeEndpointsPublisherlistAcmeEndpointsPaginator(ListAcmeEndpointsRequest listAcmeEndpointsRequest) This is a variant oflistAcmeEndpoints(software.amazon.awssdk.services.acm.model.ListAcmeEndpointsRequest)operation.listAcmeExternalAccountBindings(Consumer<ListAcmeExternalAccountBindingsRequest.Builder> listAcmeExternalAccountBindingsRequest) Retrieves a list of external account bindings for the specified ACME endpoint.listAcmeExternalAccountBindings(ListAcmeExternalAccountBindingsRequest listAcmeExternalAccountBindingsRequest) Retrieves a list of external account bindings for the specified ACME endpoint.listAcmeExternalAccountBindingsPaginator(Consumer<ListAcmeExternalAccountBindingsRequest.Builder> listAcmeExternalAccountBindingsRequest) This is a variant oflistAcmeExternalAccountBindings(software.amazon.awssdk.services.acm.model.ListAcmeExternalAccountBindingsRequest)operation.listAcmeExternalAccountBindingsPaginator(ListAcmeExternalAccountBindingsRequest listAcmeExternalAccountBindingsRequest) This is a variant oflistAcmeExternalAccountBindings(software.amazon.awssdk.services.acm.model.ListAcmeExternalAccountBindingsRequest)operation.Retrieves a list of certificate ARNs and domain names.listCertificates(Consumer<ListCertificatesRequest.Builder> listCertificatesRequest) Retrieves a list of certificate ARNs and domain names.listCertificates(ListCertificatesRequest listCertificatesRequest) Retrieves a list of certificate ARNs and domain names.default ListCertificatesPublisherThis is a variant oflistCertificates(software.amazon.awssdk.services.acm.model.ListCertificatesRequest)operation.default ListCertificatesPublisherlistCertificatesPaginator(Consumer<ListCertificatesRequest.Builder> listCertificatesRequest) This is a variant oflistCertificates(software.amazon.awssdk.services.acm.model.ListCertificatesRequest)operation.default ListCertificatesPublisherlistCertificatesPaginator(ListCertificatesRequest listCertificatesRequest) This is a variant oflistCertificates(software.amazon.awssdk.services.acm.model.ListCertificatesRequest)operation.listTagsForCertificate(Consumer<ListTagsForCertificateRequest.Builder> listTagsForCertificateRequest) Lists the tags that have been applied to the ACM certificate.listTagsForCertificate(ListTagsForCertificateRequest listTagsForCertificateRequest) Lists the tags that have been applied to the ACM certificate.listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Lists the tags associated with an ACM resource.listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Lists the tags associated with an ACM resource.putAccountConfiguration(Consumer<PutAccountConfigurationRequest.Builder> putAccountConfigurationRequest) Adds or modifies account-level configurations in ACM.putAccountConfiguration(PutAccountConfigurationRequest putAccountConfigurationRequest) Adds or modifies account-level configurations in ACM.removeTagsFromCertificate(Consumer<RemoveTagsFromCertificateRequest.Builder> removeTagsFromCertificateRequest) Remove one or more tags from an ACM certificate.removeTagsFromCertificate(RemoveTagsFromCertificateRequest removeTagsFromCertificateRequest) Remove one or more tags from an ACM certificate.renewCertificate(Consumer<RenewCertificateRequest.Builder> renewCertificateRequest) Renews an eligible ACM certificate.renewCertificate(RenewCertificateRequest renewCertificateRequest) Renews an eligible ACM certificate.requestCertificate(Consumer<RequestCertificateRequest.Builder> requestCertificateRequest) Requests an ACM certificate for use with other Amazon Web Services services.requestCertificate(RequestCertificateRequest requestCertificateRequest) Requests an ACM certificate for use with other Amazon Web Services services.resendValidationEmail(Consumer<ResendValidationEmailRequest.Builder> resendValidationEmailRequest) Resends the email that requests domain ownership validation.resendValidationEmail(ResendValidationEmailRequest resendValidationEmailRequest) Resends the email that requests domain ownership validation.revokeAcmeAccount(Consumer<RevokeAcmeAccountRequest.Builder> revokeAcmeAccountRequest) Revokes an ACME account, preventing it from requesting or revoking certificates.revokeAcmeAccount(RevokeAcmeAccountRequest revokeAcmeAccountRequest) Revokes an ACME account, preventing it from requesting or revoking certificates.revokeAcmeExternalAccountBinding(Consumer<RevokeAcmeExternalAccountBindingRequest.Builder> revokeAcmeExternalAccountBindingRequest) Revokes an external account binding, preventing new ACME accounts from being registered using this binding.revokeAcmeExternalAccountBinding(RevokeAcmeExternalAccountBindingRequest revokeAcmeExternalAccountBindingRequest) Revokes an external account binding, preventing new ACME accounts from being registered using this binding.revokeCertificate(Consumer<RevokeCertificateRequest.Builder> revokeCertificateRequest) Revokes a public ACM certificate.revokeCertificate(RevokeCertificateRequest revokeCertificateRequest) Revokes a public ACM certificate.searchCertificates(Consumer<SearchCertificatesRequest.Builder> searchCertificatesRequest) Retrieves a list of certificates matching search criteria.searchCertificates(SearchCertificatesRequest searchCertificatesRequest) Retrieves a list of certificates matching search criteria.default SearchCertificatesPublishersearchCertificatesPaginator(Consumer<SearchCertificatesRequest.Builder> searchCertificatesRequest) This is a variant ofsearchCertificates(software.amazon.awssdk.services.acm.model.SearchCertificatesRequest)operation.default SearchCertificatesPublishersearchCertificatesPaginator(SearchCertificatesRequest searchCertificatesRequest) This is a variant ofsearchCertificates(software.amazon.awssdk.services.acm.model.SearchCertificatesRequest)operation.default AcmServiceClientConfigurationThe SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationdefault CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Adds one or more tags to an ACM resource.default CompletableFuture<TagResourceResponse> tagResource(TagResourceRequest tagResourceRequest) Adds one or more tags to an ACM resource.default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Removes one or more tags from an ACM resource.default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest) Removes one or more tags from an ACM resource.updateAcmeDomainValidation(Consumer<UpdateAcmeDomainValidationRequest.Builder> updateAcmeDomainValidationRequest) Updates the prevalidation configuration of an existing domain validation.updateAcmeDomainValidation(UpdateAcmeDomainValidationRequest updateAcmeDomainValidationRequest) Updates the prevalidation configuration of an existing domain validation.updateAcmeEndpoint(Consumer<UpdateAcmeEndpointRequest.Builder> updateAcmeEndpointRequest) Updates the configuration of an existing ACME endpoint.updateAcmeEndpoint(UpdateAcmeEndpointRequest updateAcmeEndpointRequest) Updates the configuration of an existing ACME endpoint.updateCertificateOptions(Consumer<UpdateCertificateOptionsRequest.Builder> updateCertificateOptionsRequest) Updates a certificate.updateCertificateOptions(UpdateCertificateOptionsRequest updateCertificateOptionsRequest) Updates a certificate.default AcmAsyncWaiterwaiter()Create an instance ofAcmAsyncWaiterusing this client.Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
closeMethods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider.- See Also:
-
-
Method Details
-
addTagsToCertificate
default CompletableFuture<AddTagsToCertificateResponse> addTagsToCertificate(AddTagsToCertificateRequest addTagsToCertificateRequest) Adds one or more tags to an ACM certificate. Tags are labels that you can use to identify and organize your Amazon Web Services resources. Each tag consists of a
keyand an optionalvalue. You specify the certificate on input by its Amazon Resource Name (ARN). You specify the tag by using a key-value pair.This action applies only to the
certificateresource type. For all other ACM resource types, use TagResource instead.You can apply a tag to just one certificate if you want to identify a specific characteristic of that certificate, or you can apply the same tag to multiple certificates if you want to filter for a common relationship among those certificates. Similarly, you can apply the same tag to multiple resources if you want to specify a relationship among those resources. For example, you can add the same tag to an ACM certificate and an Elastic Load Balancing load balancer to indicate that they are both used by the same website. For more information, see Tagging ACM certificates.
To remove one or more tags, use the RemoveTagsFromCertificate action. To view all of the tags that have been applied to the certificate, use the ListTagsForCertificate action.
- Parameters:
addTagsToCertificateRequest-- Returns:
- A Java Future containing the result of the AddTagsToCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidParameterException An input parameter was invalid.
- 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.
- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- 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:. - ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
addTagsToCertificate
default CompletableFuture<AddTagsToCertificateResponse> addTagsToCertificate(Consumer<AddTagsToCertificateRequest.Builder> addTagsToCertificateRequest) Adds one or more tags to an ACM certificate. Tags are labels that you can use to identify and organize your Amazon Web Services resources. Each tag consists of a
keyand an optionalvalue. You specify the certificate on input by its Amazon Resource Name (ARN). You specify the tag by using a key-value pair.This action applies only to the
certificateresource type. For all other ACM resource types, use TagResource instead.You can apply a tag to just one certificate if you want to identify a specific characteristic of that certificate, or you can apply the same tag to multiple certificates if you want to filter for a common relationship among those certificates. Similarly, you can apply the same tag to multiple resources if you want to specify a relationship among those resources. For example, you can add the same tag to an ACM certificate and an Elastic Load Balancing load balancer to indicate that they are both used by the same website. For more information, see Tagging ACM certificates.
To remove one or more tags, use the RemoveTagsFromCertificate action. To view all of the tags that have been applied to the certificate, use the ListTagsForCertificate action.
This is a convenience which creates an instance of the
AddTagsToCertificateRequest.Builderavoiding the need to create one manually viaAddTagsToCertificateRequest.builder()- Parameters:
addTagsToCertificateRequest- AConsumerthat will call methods onAddTagsToCertificateRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the AddTagsToCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidParameterException An input parameter was invalid.
- 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.
- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- 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:. - ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createAcmeDomainValidation
default CompletableFuture<CreateAcmeDomainValidationResponse> createAcmeDomainValidation(CreateAcmeDomainValidationRequest createAcmeDomainValidationRequest) Creates a domain validation for an ACME endpoint. Domain validations authorize the endpoint to issue certificates for specified domain names. You configure prevalidation to prove domain ownership.
- Parameters:
createAcmeDomainValidationRequest-- Returns:
- A Java Future containing the result of the CreateAcmeDomainValidation operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- ServiceQuotaExceededException A service quota has been exceeded.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createAcmeDomainValidation
default CompletableFuture<CreateAcmeDomainValidationResponse> createAcmeDomainValidation(Consumer<CreateAcmeDomainValidationRequest.Builder> createAcmeDomainValidationRequest) Creates a domain validation for an ACME endpoint. Domain validations authorize the endpoint to issue certificates for specified domain names. You configure prevalidation to prove domain ownership.
This is a convenience which creates an instance of the
CreateAcmeDomainValidationRequest.Builderavoiding the need to create one manually viaCreateAcmeDomainValidationRequest.builder()- Parameters:
createAcmeDomainValidationRequest- AConsumerthat will call methods onCreateAcmeDomainValidationRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the CreateAcmeDomainValidation operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- ServiceQuotaExceededException A service quota has been exceeded.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createAcmeEndpoint
default CompletableFuture<CreateAcmeEndpointResponse> createAcmeEndpoint(CreateAcmeEndpointRequest createAcmeEndpointRequest) Creates an ACME endpoint, which is a managed ACME server with a unique endpoint URL. After creation, ACME clients can use the endpoint URL to automate certificate issuance using the ACME protocol.
- Parameters:
createAcmeEndpointRequest-- Returns:
- A Java Future containing the result of the CreateAcmeEndpoint operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- ServiceQuotaExceededException A service quota has been exceeded.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createAcmeEndpoint
default CompletableFuture<CreateAcmeEndpointResponse> createAcmeEndpoint(Consumer<CreateAcmeEndpointRequest.Builder> createAcmeEndpointRequest) Creates an ACME endpoint, which is a managed ACME server with a unique endpoint URL. After creation, ACME clients can use the endpoint URL to automate certificate issuance using the ACME protocol.
This is a convenience which creates an instance of the
CreateAcmeEndpointRequest.Builderavoiding the need to create one manually viaCreateAcmeEndpointRequest.builder()- Parameters:
createAcmeEndpointRequest- AConsumerthat will call methods onCreateAcmeEndpointRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the CreateAcmeEndpoint operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- ServiceQuotaExceededException A service quota has been exceeded.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createAcmeExternalAccountBinding
default CompletableFuture<CreateAcmeExternalAccountBindingResponse> createAcmeExternalAccountBinding(CreateAcmeExternalAccountBindingRequest createAcmeExternalAccountBindingRequest) Creates an external account binding (EAB) for an ACME endpoint. An EAB provides credentials that authorize an ACME client to register an account with the endpoint. Each EAB is associated with an IAM role that controls what certificate operations the ACME client can perform.
- Parameters:
createAcmeExternalAccountBindingRequest-- Returns:
- A Java Future containing the result of the CreateAcmeExternalAccountBinding operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- ServiceQuotaExceededException A service quota has been exceeded.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createAcmeExternalAccountBinding
default CompletableFuture<CreateAcmeExternalAccountBindingResponse> createAcmeExternalAccountBinding(Consumer<CreateAcmeExternalAccountBindingRequest.Builder> createAcmeExternalAccountBindingRequest) Creates an external account binding (EAB) for an ACME endpoint. An EAB provides credentials that authorize an ACME client to register an account with the endpoint. Each EAB is associated with an IAM role that controls what certificate operations the ACME client can perform.
This is a convenience which creates an instance of the
CreateAcmeExternalAccountBindingRequest.Builderavoiding the need to create one manually viaCreateAcmeExternalAccountBindingRequest.builder()- Parameters:
createAcmeExternalAccountBindingRequest- AConsumerthat will call methods onCreateAcmeExternalAccountBindingRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the CreateAcmeExternalAccountBinding operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- ServiceQuotaExceededException A service quota has been exceeded.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteAcmeDomainValidation
default CompletableFuture<DeleteAcmeDomainValidationResponse> deleteAcmeDomainValidation(DeleteAcmeDomainValidationRequest deleteAcmeDomainValidationRequest) Deletes a domain validation. After deletion, the ACME endpoint can no longer issue certificates for the associated domain.
- Parameters:
deleteAcmeDomainValidationRequest-- Returns:
- A Java Future containing the result of the DeleteAcmeDomainValidation operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteAcmeDomainValidation
default CompletableFuture<DeleteAcmeDomainValidationResponse> deleteAcmeDomainValidation(Consumer<DeleteAcmeDomainValidationRequest.Builder> deleteAcmeDomainValidationRequest) Deletes a domain validation. After deletion, the ACME endpoint can no longer issue certificates for the associated domain.
This is a convenience which creates an instance of the
DeleteAcmeDomainValidationRequest.Builderavoiding the need to create one manually viaDeleteAcmeDomainValidationRequest.builder()- Parameters:
deleteAcmeDomainValidationRequest- AConsumerthat will call methods onDeleteAcmeDomainValidationRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DeleteAcmeDomainValidation operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteAcmeEndpoint
default CompletableFuture<DeleteAcmeEndpointResponse> deleteAcmeEndpoint(DeleteAcmeEndpointRequest deleteAcmeEndpointRequest) Deletes an ACME endpoint. After deletion, the endpoint URL is no longer accessible and ACME clients cannot issue certificates through it. Any existing external account bindings and domain validations associated with the endpoint are also deleted.
- Parameters:
deleteAcmeEndpointRequest-- Returns:
- A Java Future containing the result of the DeleteAcmeEndpoint operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteAcmeEndpoint
default CompletableFuture<DeleteAcmeEndpointResponse> deleteAcmeEndpoint(Consumer<DeleteAcmeEndpointRequest.Builder> deleteAcmeEndpointRequest) Deletes an ACME endpoint. After deletion, the endpoint URL is no longer accessible and ACME clients cannot issue certificates through it. Any existing external account bindings and domain validations associated with the endpoint are also deleted.
This is a convenience which creates an instance of the
DeleteAcmeEndpointRequest.Builderavoiding the need to create one manually viaDeleteAcmeEndpointRequest.builder()- Parameters:
deleteAcmeEndpointRequest- AConsumerthat will call methods onDeleteAcmeEndpointRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DeleteAcmeEndpoint operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteAcmeExternalAccountBinding
default CompletableFuture<DeleteAcmeExternalAccountBindingResponse> deleteAcmeExternalAccountBinding(DeleteAcmeExternalAccountBindingRequest deleteAcmeExternalAccountBindingRequest) Deletes an external account binding. Previously fetched credentials for this binding will no longer be usable for account registration. A deleted binding cannot be recovered.
- Parameters:
deleteAcmeExternalAccountBindingRequest-- Returns:
- A Java Future containing the result of the DeleteAcmeExternalAccountBinding operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteAcmeExternalAccountBinding
default CompletableFuture<DeleteAcmeExternalAccountBindingResponse> deleteAcmeExternalAccountBinding(Consumer<DeleteAcmeExternalAccountBindingRequest.Builder> deleteAcmeExternalAccountBindingRequest) Deletes an external account binding. Previously fetched credentials for this binding will no longer be usable for account registration. A deleted binding cannot be recovered.
This is a convenience which creates an instance of the
DeleteAcmeExternalAccountBindingRequest.Builderavoiding the need to create one manually viaDeleteAcmeExternalAccountBindingRequest.builder()- Parameters:
deleteAcmeExternalAccountBindingRequest- AConsumerthat will call methods onDeleteAcmeExternalAccountBindingRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DeleteAcmeExternalAccountBinding operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteCertificate
default CompletableFuture<DeleteCertificateResponse> deleteCertificate(DeleteCertificateRequest deleteCertificateRequest) Deletes a certificate and its associated private key. If this action succeeds, the certificate is not available for use by Amazon Web Services services integrated with ACM. Deleting a certificate is eventually consistent. The may be a short delay before 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.
You cannot delete an ACM certificate that is being used by another Amazon Web Services service. To delete a certificate that is in use, you must first remove the certificate association using the console or the CLI for the associated service.
Deleting a certificate issued by a private certificate authority (CA) has no effect on the CA. You will continue to be charged for the CA until it is deleted. For more information, see Deleting Your Private CA in the Private Certificate Authority User Guide.
You cannot delete a certificate with a
CertificateKeyPairOriginofACME. ACM automatically deletes these certificates 1 year after they expire.Deleting a certificate issued by a private certificate authority (CA) has no effect on the CA. You will continue to be charged for the CA until it is deleted. For more information, see Deleting your private CA in the Amazon Web Services Private Certificate Authority User Guide.
- Parameters:
deleteCertificateRequest-- Returns:
- A Java Future containing the result of the DeleteCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceInUseException The certificate is in use by another Amazon Web Services service in the caller's account. Remove the association and try again.
- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteCertificate
default CompletableFuture<DeleteCertificateResponse> deleteCertificate(Consumer<DeleteCertificateRequest.Builder> deleteCertificateRequest) Deletes a certificate and its associated private key. If this action succeeds, the certificate is not available for use by Amazon Web Services services integrated with ACM. Deleting a certificate is eventually consistent. The may be a short delay before 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.
You cannot delete an ACM certificate that is being used by another Amazon Web Services service. To delete a certificate that is in use, you must first remove the certificate association using the console or the CLI for the associated service.
Deleting a certificate issued by a private certificate authority (CA) has no effect on the CA. You will continue to be charged for the CA until it is deleted. For more information, see Deleting Your Private CA in the Private Certificate Authority User Guide.
You cannot delete a certificate with a
CertificateKeyPairOriginofACME. ACM automatically deletes these certificates 1 year after they expire.Deleting a certificate issued by a private certificate authority (CA) has no effect on the CA. You will continue to be charged for the CA until it is deleted. For more information, see Deleting your private CA in the Amazon Web Services Private Certificate Authority User Guide.
This is a convenience which creates an instance of the
DeleteCertificateRequest.Builderavoiding the need to create one manually viaDeleteCertificateRequest.builder()- Parameters:
deleteCertificateRequest- AConsumerthat will call methods onDeleteCertificateRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DeleteCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceInUseException The certificate is in use by another Amazon Web Services service in the caller's account. Remove the association and try again.
- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeAcmeAccount
default CompletableFuture<DescribeAcmeAccountResponse> describeAcmeAccount(DescribeAcmeAccountRequest describeAcmeAccountRequest) Returns detailed metadata about the specified ACME account, including its status, public key thumbprint, and associated external account binding.
- Parameters:
describeAcmeAccountRequest-- Returns:
- A Java Future containing the result of the DescribeAcmeAccount operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeAcmeAccount
default CompletableFuture<DescribeAcmeAccountResponse> describeAcmeAccount(Consumer<DescribeAcmeAccountRequest.Builder> describeAcmeAccountRequest) Returns detailed metadata about the specified ACME account, including its status, public key thumbprint, and associated external account binding.
This is a convenience which creates an instance of the
DescribeAcmeAccountRequest.Builderavoiding the need to create one manually viaDescribeAcmeAccountRequest.builder()- Parameters:
describeAcmeAccountRequest- AConsumerthat will call methods onDescribeAcmeAccountRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DescribeAcmeAccount operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeAcmeDomainValidation
default CompletableFuture<DescribeAcmeDomainValidationResponse> describeAcmeDomainValidation(DescribeAcmeDomainValidationRequest describeAcmeDomainValidationRequest) Returns detailed metadata about the specified domain validation, including its status, domain scope, and DNS resource records required for validation.
- Parameters:
describeAcmeDomainValidationRequest-- Returns:
- A Java Future containing the result of the DescribeAcmeDomainValidation operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeAcmeDomainValidation
default CompletableFuture<DescribeAcmeDomainValidationResponse> describeAcmeDomainValidation(Consumer<DescribeAcmeDomainValidationRequest.Builder> describeAcmeDomainValidationRequest) Returns detailed metadata about the specified domain validation, including its status, domain scope, and DNS resource records required for validation.
This is a convenience which creates an instance of the
DescribeAcmeDomainValidationRequest.Builderavoiding the need to create one manually viaDescribeAcmeDomainValidationRequest.builder()- Parameters:
describeAcmeDomainValidationRequest- AConsumerthat will call methods onDescribeAcmeDomainValidationRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DescribeAcmeDomainValidation operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeAcmeEndpoint
default CompletableFuture<DescribeAcmeEndpointResponse> describeAcmeEndpoint(DescribeAcmeEndpointRequest describeAcmeEndpointRequest) Returns detailed metadata about the specified ACME endpoint, including its status, URL, authorization behavior, and certificate authority configuration.
- Parameters:
describeAcmeEndpointRequest-- Returns:
- A Java Future containing the result of the DescribeAcmeEndpoint operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeAcmeEndpoint
default CompletableFuture<DescribeAcmeEndpointResponse> describeAcmeEndpoint(Consumer<DescribeAcmeEndpointRequest.Builder> describeAcmeEndpointRequest) Returns detailed metadata about the specified ACME endpoint, including its status, URL, authorization behavior, and certificate authority configuration.
This is a convenience which creates an instance of the
DescribeAcmeEndpointRequest.Builderavoiding the need to create one manually viaDescribeAcmeEndpointRequest.builder()- Parameters:
describeAcmeEndpointRequest- AConsumerthat will call methods onDescribeAcmeEndpointRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DescribeAcmeEndpoint operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeAcmeExternalAccountBinding
default CompletableFuture<DescribeAcmeExternalAccountBindingResponse> describeAcmeExternalAccountBinding(DescribeAcmeExternalAccountBindingRequest describeAcmeExternalAccountBindingRequest) Returns detailed metadata about the specified external account binding, including the associated IAM role, expiration time, and usage history.
- Parameters:
describeAcmeExternalAccountBindingRequest-- Returns:
- A Java Future containing the result of the DescribeAcmeExternalAccountBinding operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeAcmeExternalAccountBinding
default CompletableFuture<DescribeAcmeExternalAccountBindingResponse> describeAcmeExternalAccountBinding(Consumer<DescribeAcmeExternalAccountBindingRequest.Builder> describeAcmeExternalAccountBindingRequest) Returns detailed metadata about the specified external account binding, including the associated IAM role, expiration time, and usage history.
This is a convenience which creates an instance of the
DescribeAcmeExternalAccountBindingRequest.Builderavoiding the need to create one manually viaDescribeAcmeExternalAccountBindingRequest.builder()- Parameters:
describeAcmeExternalAccountBindingRequest- AConsumerthat will call methods onDescribeAcmeExternalAccountBindingRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DescribeAcmeExternalAccountBinding operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeCertificate
default CompletableFuture<DescribeCertificateResponse> describeCertificate(DescribeCertificateRequest describeCertificateRequest) Returns detailed metadata about the specified ACM certificate.
If you have just created a certificate using the
RequestCertificateaction, there is a delay of several seconds before you can retrieve information about it.- Parameters:
describeCertificateRequest-- Returns:
- A Java Future containing the result of the DescribeCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
describeCertificate
default CompletableFuture<DescribeCertificateResponse> describeCertificate(Consumer<DescribeCertificateRequest.Builder> describeCertificateRequest) Returns detailed metadata about the specified ACM certificate.
If you have just created a certificate using the
RequestCertificateaction, there is a delay of several seconds before you can retrieve information about it.
This is a convenience which creates an instance of the
DescribeCertificateRequest.Builderavoiding the need to create one manually viaDescribeCertificateRequest.builder()- Parameters:
describeCertificateRequest- AConsumerthat will call methods onDescribeCertificateRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DescribeCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
exportCertificate
default CompletableFuture<ExportCertificateResponse> exportCertificate(ExportCertificateRequest exportCertificateRequest) Exports a private certificate issued by a private certificate authority (CA) or a public certificate for use anywhere. The exported file contains the certificate, the certificate chain, and the encrypted private key associated with the public key that is embedded in the certificate. For security, you must assign a passphrase for the private key when exporting it.
For information about exporting and formatting a certificate using the ACM console or CLI, see Export a private certificate and Export a public certificate.
ACM public certificates created prior to June 17, 2025 cannot be exported.
- Parameters:
exportCertificateRequest-- Returns:
- A Java Future containing the result of the ExportCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- RequestInProgressException The certificate request is in process and the certificate in your account has not yet been issued.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
exportCertificate
default CompletableFuture<ExportCertificateResponse> exportCertificate(Consumer<ExportCertificateRequest.Builder> exportCertificateRequest) Exports a private certificate issued by a private certificate authority (CA) or a public certificate for use anywhere. The exported file contains the certificate, the certificate chain, and the encrypted private key associated with the public key that is embedded in the certificate. For security, you must assign a passphrase for the private key when exporting it.
For information about exporting and formatting a certificate using the ACM console or CLI, see Export a private certificate and Export a public certificate.
ACM public certificates created prior to June 17, 2025 cannot be exported.
This is a convenience which creates an instance of the
ExportCertificateRequest.Builderavoiding the need to create one manually viaExportCertificateRequest.builder()- Parameters:
exportCertificateRequest- AConsumerthat will call methods onExportCertificateRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ExportCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- RequestInProgressException The certificate request is in process and the certificate in your account has not yet been issued.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getAccountConfiguration
default CompletableFuture<GetAccountConfigurationResponse> getAccountConfiguration(GetAccountConfigurationRequest getAccountConfigurationRequest) Returns the account configuration options associated with an Amazon Web Services account.
- Parameters:
getAccountConfigurationRequest-- Returns:
- A Java Future containing the result of the GetAccountConfiguration operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You do not have access required to perform this action.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getAccountConfiguration
default CompletableFuture<GetAccountConfigurationResponse> getAccountConfiguration(Consumer<GetAccountConfigurationRequest.Builder> getAccountConfigurationRequest) Returns the account configuration options associated with an Amazon Web Services account.
This is a convenience which creates an instance of the
GetAccountConfigurationRequest.Builderavoiding the need to create one manually viaGetAccountConfigurationRequest.builder()- Parameters:
getAccountConfigurationRequest- AConsumerthat will call methods onGetAccountConfigurationRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the GetAccountConfiguration operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You do not have access required to perform this action.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getAcmeExternalAccountBindingCredentials
default CompletableFuture<GetAcmeExternalAccountBindingCredentialsResponse> getAcmeExternalAccountBindingCredentials(GetAcmeExternalAccountBindingCredentialsRequest getAcmeExternalAccountBindingCredentialsRequest) Retrieves the key ID and MAC key credentials for an external account binding. These credentials are used by ACME clients during account registration to bind to the endpoint.
- Parameters:
getAcmeExternalAccountBindingCredentialsRequest-- Returns:
- A Java Future containing the result of the GetAcmeExternalAccountBindingCredentials operation returned by
the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getAcmeExternalAccountBindingCredentials
default CompletableFuture<GetAcmeExternalAccountBindingCredentialsResponse> getAcmeExternalAccountBindingCredentials(Consumer<GetAcmeExternalAccountBindingCredentialsRequest.Builder> getAcmeExternalAccountBindingCredentialsRequest) Retrieves the key ID and MAC key credentials for an external account binding. These credentials are used by ACME clients during account registration to bind to the endpoint.
This is a convenience which creates an instance of the
GetAcmeExternalAccountBindingCredentialsRequest.Builderavoiding the need to create one manually viaGetAcmeExternalAccountBindingCredentialsRequest.builder()- Parameters:
getAcmeExternalAccountBindingCredentialsRequest- AConsumerthat will call methods onGetAcmeExternalAccountBindingCredentialsRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the GetAcmeExternalAccountBindingCredentials operation returned by
the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getCertificate
default CompletableFuture<GetCertificateResponse> getCertificate(GetCertificateRequest getCertificateRequest) Retrieves a certificate and its certificate chain. The certificate may be either a public or private certificate issued using the ACM
RequestCertificateaction, or a certificate imported into ACM using theImportCertificateaction. The chain consists of the certificate of the issuing CA and the intermediate certificates of any other subordinate CAs. All of the certificates are base64 encoded. You can use OpenSSL to decode the certificates and inspect individual fields.- Parameters:
getCertificateRequest-- Returns:
- A Java Future containing the result of the GetCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- RequestInProgressException The certificate request is in process and the certificate in your account has not yet been issued.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getCertificate
default CompletableFuture<GetCertificateResponse> getCertificate(Consumer<GetCertificateRequest.Builder> getCertificateRequest) Retrieves a certificate and its certificate chain. The certificate may be either a public or private certificate issued using the ACM
RequestCertificateaction, or a certificate imported into ACM using theImportCertificateaction. The chain consists of the certificate of the issuing CA and the intermediate certificates of any other subordinate CAs. All of the certificates are base64 encoded. You can use OpenSSL to decode the certificates and inspect individual fields.
This is a convenience which creates an instance of the
GetCertificateRequest.Builderavoiding the need to create one manually viaGetCertificateRequest.builder()- Parameters:
getCertificateRequest- AConsumerthat will call methods onGetCertificateRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the GetCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- RequestInProgressException The certificate request is in process and the certificate in your account has not yet been issued.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
importCertificate
default CompletableFuture<ImportCertificateResponse> importCertificate(ImportCertificateRequest importCertificateRequest) Imports a certificate into Certificate Manager (ACM) to use with services that are integrated with ACM. Note that integrated services allow only certificate types and keys they support to be associated with their resources. Further, their support differs depending on whether the certificate is imported into IAM or into ACM. For more information, see the documentation for each service. For more information about importing certificates into ACM, see Importing Certificates in the Certificate Manager User Guide.
ACM does not provide managed renewal for certificates that you import.
Note the following guidelines when importing third party certificates:
-
You must enter the private key that matches the certificate you are importing.
-
The private key must be unencrypted. You cannot import a private key that is protected by a password or a passphrase.
-
The private key must be no larger than 5 KB (5,120 bytes).
-
The certificate, private key, and certificate chain must be PEM-encoded.
-
The current time must be between the
Not BeforeandNot Aftercertificate fields. -
The
Issuerfield must not be empty. -
The OCSP authority URL, if present, must not exceed 1000 characters.
-
To import a new certificate, omit the
CertificateArnargument. Include this argument only when you want to replace a previously imported certificate. -
When you import a certificate by using the CLI, you must specify the certificate, the certificate chain, and the private key by their file names preceded by
fileb://. For example, you can specify a certificate saved in theC:\tempfolder asfileb://C:\temp\certificate_to_import.pem. If you are making an HTTP or HTTPS Query request, include these arguments as BLOBs. -
When you import a certificate by using an SDK, you must specify the certificate, the certificate chain, and the private key files in the manner required by the programming language you're using.
-
The cryptographic algorithm of an imported certificate must match the algorithm of the signing CA. For example, if the signing CA key type is RSA, then the certificate key type must also be RSA.
This operation returns the Amazon Resource Name (ARN) of the imported certificate.
- Parameters:
importCertificateRequest-- Returns:
- A Java Future containing the result of the ImportCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidParameterException An input parameter was invalid.
- 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.
- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- 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:. - 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.
- LimitExceededException An ACM quota has been exceeded.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
-
importCertificate
default CompletableFuture<ImportCertificateResponse> importCertificate(Consumer<ImportCertificateRequest.Builder> importCertificateRequest) Imports a certificate into Certificate Manager (ACM) to use with services that are integrated with ACM. Note that integrated services allow only certificate types and keys they support to be associated with their resources. Further, their support differs depending on whether the certificate is imported into IAM or into ACM. For more information, see the documentation for each service. For more information about importing certificates into ACM, see Importing Certificates in the Certificate Manager User Guide.
ACM does not provide managed renewal for certificates that you import.
Note the following guidelines when importing third party certificates:
-
You must enter the private key that matches the certificate you are importing.
-
The private key must be unencrypted. You cannot import a private key that is protected by a password or a passphrase.
-
The private key must be no larger than 5 KB (5,120 bytes).
-
The certificate, private key, and certificate chain must be PEM-encoded.
-
The current time must be between the
Not BeforeandNot Aftercertificate fields. -
The
Issuerfield must not be empty. -
The OCSP authority URL, if present, must not exceed 1000 characters.
-
To import a new certificate, omit the
CertificateArnargument. Include this argument only when you want to replace a previously imported certificate. -
When you import a certificate by using the CLI, you must specify the certificate, the certificate chain, and the private key by their file names preceded by
fileb://. For example, you can specify a certificate saved in theC:\tempfolder asfileb://C:\temp\certificate_to_import.pem. If you are making an HTTP or HTTPS Query request, include these arguments as BLOBs. -
When you import a certificate by using an SDK, you must specify the certificate, the certificate chain, and the private key files in the manner required by the programming language you're using.
-
The cryptographic algorithm of an imported certificate must match the algorithm of the signing CA. For example, if the signing CA key type is RSA, then the certificate key type must also be RSA.
This operation returns the Amazon Resource Name (ARN) of the imported certificate.
This is a convenience which creates an instance of the
ImportCertificateRequest.Builderavoiding the need to create one manually viaImportCertificateRequest.builder()- Parameters:
importCertificateRequest- AConsumerthat will call methods onImportCertificateRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ImportCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidParameterException An input parameter was invalid.
- 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.
- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- 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:. - 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.
- LimitExceededException An ACM quota has been exceeded.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
-
listAcmeAccounts
default CompletableFuture<ListAcmeAccountsResponse> listAcmeAccounts(ListAcmeAccountsRequest listAcmeAccountsRequest) Retrieves a list of ACME accounts registered with the specified ACME endpoint. ACME accounts are created when clients use external account binding credentials to register.
- Parameters:
listAcmeAccountsRequest-- Returns:
- A Java Future containing the result of the ListAcmeAccounts operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listAcmeAccounts
default CompletableFuture<ListAcmeAccountsResponse> listAcmeAccounts(Consumer<ListAcmeAccountsRequest.Builder> listAcmeAccountsRequest) Retrieves a list of ACME accounts registered with the specified ACME endpoint. ACME accounts are created when clients use external account binding credentials to register.
This is a convenience which creates an instance of the
ListAcmeAccountsRequest.Builderavoiding the need to create one manually viaListAcmeAccountsRequest.builder()- Parameters:
listAcmeAccountsRequest- AConsumerthat will call methods onListAcmeAccountsRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListAcmeAccounts operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listAcmeAccountsPaginator
default ListAcmeAccountsPublisher listAcmeAccountsPaginator(ListAcmeAccountsRequest listAcmeAccountsRequest) This is a variant of
listAcmeAccounts(software.amazon.awssdk.services.acm.model.ListAcmeAccountsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.acm.paginators.ListAcmeAccountsPublisher publisher = client.listAcmeAccountsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.acm.paginators.ListAcmeAccountsPublisher publisher = client.listAcmeAccountsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.acm.model.ListAcmeAccountsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.acm.model.ListAcmeAccountsResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listAcmeAccounts(software.amazon.awssdk.services.acm.model.ListAcmeAccountsRequest)operation.- Parameters:
listAcmeAccountsRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listAcmeAccountsPaginator
default ListAcmeAccountsPublisher listAcmeAccountsPaginator(Consumer<ListAcmeAccountsRequest.Builder> listAcmeAccountsRequest) This is a variant of
listAcmeAccounts(software.amazon.awssdk.services.acm.model.ListAcmeAccountsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.acm.paginators.ListAcmeAccountsPublisher publisher = client.listAcmeAccountsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.acm.paginators.ListAcmeAccountsPublisher publisher = client.listAcmeAccountsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.acm.model.ListAcmeAccountsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.acm.model.ListAcmeAccountsResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listAcmeAccounts(software.amazon.awssdk.services.acm.model.ListAcmeAccountsRequest)operation.
This is a convenience which creates an instance of the
ListAcmeAccountsRequest.Builderavoiding the need to create one manually viaListAcmeAccountsRequest.builder()- Parameters:
listAcmeAccountsRequest- AConsumerthat will call methods onListAcmeAccountsRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listAcmeDomainValidations
default CompletableFuture<ListAcmeDomainValidationsResponse> listAcmeDomainValidations(ListAcmeDomainValidationsRequest listAcmeDomainValidationsRequest) Retrieves a list of domain validations for the specified ACME endpoint.
- Parameters:
listAcmeDomainValidationsRequest-- Returns:
- A Java Future containing the result of the ListAcmeDomainValidations operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listAcmeDomainValidations
default CompletableFuture<ListAcmeDomainValidationsResponse> listAcmeDomainValidations(Consumer<ListAcmeDomainValidationsRequest.Builder> listAcmeDomainValidationsRequest) Retrieves a list of domain validations for the specified ACME endpoint.
This is a convenience which creates an instance of the
ListAcmeDomainValidationsRequest.Builderavoiding the need to create one manually viaListAcmeDomainValidationsRequest.builder()- Parameters:
listAcmeDomainValidationsRequest- AConsumerthat will call methods onListAcmeDomainValidationsRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListAcmeDomainValidations operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listAcmeDomainValidationsPaginator
default ListAcmeDomainValidationsPublisher listAcmeDomainValidationsPaginator(ListAcmeDomainValidationsRequest listAcmeDomainValidationsRequest) This is a variant of
listAcmeDomainValidations(software.amazon.awssdk.services.acm.model.ListAcmeDomainValidationsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.acm.paginators.ListAcmeDomainValidationsPublisher publisher = client.listAcmeDomainValidationsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.acm.paginators.ListAcmeDomainValidationsPublisher publisher = client.listAcmeDomainValidationsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.acm.model.ListAcmeDomainValidationsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.acm.model.ListAcmeDomainValidationsResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listAcmeDomainValidations(software.amazon.awssdk.services.acm.model.ListAcmeDomainValidationsRequest)operation.- Parameters:
listAcmeDomainValidationsRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listAcmeDomainValidationsPaginator
default ListAcmeDomainValidationsPublisher listAcmeDomainValidationsPaginator(Consumer<ListAcmeDomainValidationsRequest.Builder> listAcmeDomainValidationsRequest) This is a variant of
listAcmeDomainValidations(software.amazon.awssdk.services.acm.model.ListAcmeDomainValidationsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.acm.paginators.ListAcmeDomainValidationsPublisher publisher = client.listAcmeDomainValidationsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.acm.paginators.ListAcmeDomainValidationsPublisher publisher = client.listAcmeDomainValidationsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.acm.model.ListAcmeDomainValidationsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.acm.model.ListAcmeDomainValidationsResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listAcmeDomainValidations(software.amazon.awssdk.services.acm.model.ListAcmeDomainValidationsRequest)operation.
This is a convenience which creates an instance of the
ListAcmeDomainValidationsRequest.Builderavoiding the need to create one manually viaListAcmeDomainValidationsRequest.builder()- Parameters:
listAcmeDomainValidationsRequest- AConsumerthat will call methods onListAcmeDomainValidationsRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listAcmeEndpoints
default CompletableFuture<ListAcmeEndpointsResponse> listAcmeEndpoints(ListAcmeEndpointsRequest listAcmeEndpointsRequest) Retrieves a list of ACME endpoints in your account. Use this operation to view all configured ACME endpoints and their current status.
- Parameters:
listAcmeEndpointsRequest-- Returns:
- A Java Future containing the result of the ListAcmeEndpoints operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listAcmeEndpoints
default CompletableFuture<ListAcmeEndpointsResponse> listAcmeEndpoints(Consumer<ListAcmeEndpointsRequest.Builder> listAcmeEndpointsRequest) Retrieves a list of ACME endpoints in your account. Use this operation to view all configured ACME endpoints and their current status.
This is a convenience which creates an instance of the
ListAcmeEndpointsRequest.Builderavoiding the need to create one manually viaListAcmeEndpointsRequest.builder()- Parameters:
listAcmeEndpointsRequest- AConsumerthat will call methods onListAcmeEndpointsRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListAcmeEndpoints operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listAcmeEndpointsPaginator
default ListAcmeEndpointsPublisher listAcmeEndpointsPaginator(ListAcmeEndpointsRequest listAcmeEndpointsRequest) This is a variant of
listAcmeEndpoints(software.amazon.awssdk.services.acm.model.ListAcmeEndpointsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.acm.paginators.ListAcmeEndpointsPublisher publisher = client.listAcmeEndpointsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.acm.paginators.ListAcmeEndpointsPublisher publisher = client.listAcmeEndpointsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.acm.model.ListAcmeEndpointsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.acm.model.ListAcmeEndpointsResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listAcmeEndpoints(software.amazon.awssdk.services.acm.model.ListAcmeEndpointsRequest)operation.- Parameters:
listAcmeEndpointsRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listAcmeEndpointsPaginator
default ListAcmeEndpointsPublisher listAcmeEndpointsPaginator(Consumer<ListAcmeEndpointsRequest.Builder> listAcmeEndpointsRequest) This is a variant of
listAcmeEndpoints(software.amazon.awssdk.services.acm.model.ListAcmeEndpointsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.acm.paginators.ListAcmeEndpointsPublisher publisher = client.listAcmeEndpointsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.acm.paginators.ListAcmeEndpointsPublisher publisher = client.listAcmeEndpointsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.acm.model.ListAcmeEndpointsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.acm.model.ListAcmeEndpointsResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listAcmeEndpoints(software.amazon.awssdk.services.acm.model.ListAcmeEndpointsRequest)operation.
This is a convenience which creates an instance of the
ListAcmeEndpointsRequest.Builderavoiding the need to create one manually viaListAcmeEndpointsRequest.builder()- Parameters:
listAcmeEndpointsRequest- AConsumerthat will call methods onListAcmeEndpointsRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listAcmeExternalAccountBindings
default CompletableFuture<ListAcmeExternalAccountBindingsResponse> listAcmeExternalAccountBindings(ListAcmeExternalAccountBindingsRequest listAcmeExternalAccountBindingsRequest) Retrieves a list of external account bindings for the specified ACME endpoint.
- Parameters:
listAcmeExternalAccountBindingsRequest-- Returns:
- A Java Future containing the result of the ListAcmeExternalAccountBindings operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listAcmeExternalAccountBindings
default CompletableFuture<ListAcmeExternalAccountBindingsResponse> listAcmeExternalAccountBindings(Consumer<ListAcmeExternalAccountBindingsRequest.Builder> listAcmeExternalAccountBindingsRequest) Retrieves a list of external account bindings for the specified ACME endpoint.
This is a convenience which creates an instance of the
ListAcmeExternalAccountBindingsRequest.Builderavoiding the need to create one manually viaListAcmeExternalAccountBindingsRequest.builder()- Parameters:
listAcmeExternalAccountBindingsRequest- AConsumerthat will call methods onListAcmeExternalAccountBindingsRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListAcmeExternalAccountBindings operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listAcmeExternalAccountBindingsPaginator
default ListAcmeExternalAccountBindingsPublisher listAcmeExternalAccountBindingsPaginator(ListAcmeExternalAccountBindingsRequest listAcmeExternalAccountBindingsRequest) This is a variant of
listAcmeExternalAccountBindings(software.amazon.awssdk.services.acm.model.ListAcmeExternalAccountBindingsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.acm.paginators.ListAcmeExternalAccountBindingsPublisher publisher = client.listAcmeExternalAccountBindingsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.acm.paginators.ListAcmeExternalAccountBindingsPublisher publisher = client.listAcmeExternalAccountBindingsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.acm.model.ListAcmeExternalAccountBindingsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.acm.model.ListAcmeExternalAccountBindingsResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listAcmeExternalAccountBindings(software.amazon.awssdk.services.acm.model.ListAcmeExternalAccountBindingsRequest)operation.- Parameters:
listAcmeExternalAccountBindingsRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listAcmeExternalAccountBindingsPaginator
default ListAcmeExternalAccountBindingsPublisher listAcmeExternalAccountBindingsPaginator(Consumer<ListAcmeExternalAccountBindingsRequest.Builder> listAcmeExternalAccountBindingsRequest) This is a variant of
listAcmeExternalAccountBindings(software.amazon.awssdk.services.acm.model.ListAcmeExternalAccountBindingsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.acm.paginators.ListAcmeExternalAccountBindingsPublisher publisher = client.listAcmeExternalAccountBindingsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.acm.paginators.ListAcmeExternalAccountBindingsPublisher publisher = client.listAcmeExternalAccountBindingsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.acm.model.ListAcmeExternalAccountBindingsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.acm.model.ListAcmeExternalAccountBindingsResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listAcmeExternalAccountBindings(software.amazon.awssdk.services.acm.model.ListAcmeExternalAccountBindingsRequest)operation.
This is a convenience which creates an instance of the
ListAcmeExternalAccountBindingsRequest.Builderavoiding the need to create one manually viaListAcmeExternalAccountBindingsRequest.builder()- Parameters:
listAcmeExternalAccountBindingsRequest- AConsumerthat will call methods onListAcmeExternalAccountBindingsRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listCertificates
default CompletableFuture<ListCertificatesResponse> listCertificates(ListCertificatesRequest listCertificatesRequest) Retrieves a list of certificate ARNs and domain names. You can request that only certificates that match a specific status be listed. You can also filter by specific attributes of the certificate. Default filtering returns only
RSA_2048certificates. For more information, see Filters.By default, this action does not return certificates with a
CertificateKeyPairOriginofACME. To include ACME certificates, specifyACMEin theCertificateKeyPairOriginsfilter.- Parameters:
listCertificatesRequest-- Returns:
- A Java Future containing the result of the ListCertificates operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidArgsException One or more of request parameters specified is not valid.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listCertificates
default CompletableFuture<ListCertificatesResponse> listCertificates(Consumer<ListCertificatesRequest.Builder> listCertificatesRequest) Retrieves a list of certificate ARNs and domain names. You can request that only certificates that match a specific status be listed. You can also filter by specific attributes of the certificate. Default filtering returns only
RSA_2048certificates. For more information, see Filters.By default, this action does not return certificates with a
CertificateKeyPairOriginofACME. To include ACME certificates, specifyACMEin theCertificateKeyPairOriginsfilter.
This is a convenience which creates an instance of the
ListCertificatesRequest.Builderavoiding the need to create one manually viaListCertificatesRequest.builder()- Parameters:
listCertificatesRequest- AConsumerthat will call methods onListCertificatesRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListCertificates operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidArgsException One or more of request parameters specified is not valid.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listCertificates
Retrieves a list of certificate ARNs and domain names. You can request that only certificates that match a specific status be listed. You can also filter by specific attributes of the certificate. Default filtering returns only
RSA_2048certificates. For more information, see Filters.By default, this action does not return certificates with a
CertificateKeyPairOriginofACME. To include ACME certificates, specifyACMEin theCertificateKeyPairOriginsfilter.- Returns:
- A Java Future containing the result of the ListCertificates operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidArgsException One or more of request parameters specified is not valid.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listCertificatesPaginator
This is a variant of
listCertificates(software.amazon.awssdk.services.acm.model.ListCertificatesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.acm.paginators.ListCertificatesPublisher publisher = client.listCertificatesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.acm.paginators.ListCertificatesPublisher publisher = client.listCertificatesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.acm.model.ListCertificatesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.acm.model.ListCertificatesResponse response) { //... }; });Please notice that the configuration of MaxItems won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listCertificates(software.amazon.awssdk.services.acm.model.ListCertificatesRequest)operation.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidArgsException One or more of request parameters specified is not valid.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listCertificatesPaginator
default ListCertificatesPublisher listCertificatesPaginator(ListCertificatesRequest listCertificatesRequest) This is a variant of
listCertificates(software.amazon.awssdk.services.acm.model.ListCertificatesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.acm.paginators.ListCertificatesPublisher publisher = client.listCertificatesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.acm.paginators.ListCertificatesPublisher publisher = client.listCertificatesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.acm.model.ListCertificatesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.acm.model.ListCertificatesResponse response) { //... }; });Please notice that the configuration of MaxItems won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listCertificates(software.amazon.awssdk.services.acm.model.ListCertificatesRequest)operation.- Parameters:
listCertificatesRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidArgsException One or more of request parameters specified is not valid.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listCertificatesPaginator
default ListCertificatesPublisher listCertificatesPaginator(Consumer<ListCertificatesRequest.Builder> listCertificatesRequest) This is a variant of
listCertificates(software.amazon.awssdk.services.acm.model.ListCertificatesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.acm.paginators.ListCertificatesPublisher publisher = client.listCertificatesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.acm.paginators.ListCertificatesPublisher publisher = client.listCertificatesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.acm.model.ListCertificatesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.acm.model.ListCertificatesResponse response) { //... }; });Please notice that the configuration of MaxItems won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listCertificates(software.amazon.awssdk.services.acm.model.ListCertificatesRequest)operation.
This is a convenience which creates an instance of the
ListCertificatesRequest.Builderavoiding the need to create one manually viaListCertificatesRequest.builder()- Parameters:
listCertificatesRequest- AConsumerthat will call methods onListCertificatesRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidArgsException One or more of request parameters specified is not valid.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listTagsForCertificate
default CompletableFuture<ListTagsForCertificateResponse> listTagsForCertificate(ListTagsForCertificateRequest listTagsForCertificateRequest) Lists the tags that have been applied to the ACM certificate. Use the certificate's Amazon Resource Name (ARN) to specify the certificate. To add a tag to an ACM certificate, use the AddTagsToCertificate action. To delete a tag, use the RemoveTagsFromCertificate action.
This action applies only to the
certificateresource type. For all other ACM resource types, use ListTagsForResource instead.- Parameters:
listTagsForCertificateRequest-- Returns:
- A Java Future containing the result of the ListTagsForCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listTagsForCertificate
default CompletableFuture<ListTagsForCertificateResponse> listTagsForCertificate(Consumer<ListTagsForCertificateRequest.Builder> listTagsForCertificateRequest) Lists the tags that have been applied to the ACM certificate. Use the certificate's Amazon Resource Name (ARN) to specify the certificate. To add a tag to an ACM certificate, use the AddTagsToCertificate action. To delete a tag, use the RemoveTagsFromCertificate action.
This action applies only to the
certificateresource type. For all other ACM resource types, use ListTagsForResource instead.
This is a convenience which creates an instance of the
ListTagsForCertificateRequest.Builderavoiding the need to create one manually viaListTagsForCertificateRequest.builder()- Parameters:
listTagsForCertificateRequest- AConsumerthat will call methods onListTagsForCertificateRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListTagsForCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listTagsForResource
default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Lists the tags associated with an ACM resource.
Use this action for all ACM resource types except the
certificateresource type. For certificate resources, use ListTagsForCertificate instead.To add one or more tags, use the TagResource action. To remove one or more tags, use the UntagResource action.
- Parameters:
listTagsForResourceRequest-- Returns:
- A Java Future containing the result of the ListTagsForResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listTagsForResource
default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Lists the tags associated with an ACM resource.
Use this action for all ACM resource types except the
certificateresource type. For certificate resources, use ListTagsForCertificate instead.To add one or more tags, use the TagResource action. To remove one or more tags, use the UntagResource action.
This is a convenience which creates an instance of the
ListTagsForResourceRequest.Builderavoiding the need to create one manually viaListTagsForResourceRequest.builder()- Parameters:
listTagsForResourceRequest- AConsumerthat will call methods onListTagsForResourceRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListTagsForResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
putAccountConfiguration
default CompletableFuture<PutAccountConfigurationResponse> putAccountConfiguration(PutAccountConfigurationRequest putAccountConfigurationRequest) Adds or modifies account-level configurations in ACM.
The supported configuration option is
DaysBeforeExpiry. This option specifies the number of days prior to certificate expiration when ACM starts generatingEventBridgeevents. ACM sends one event per day per certificate until the certificate expires. By default, accounts receive events starting 45 days before certificate expiration.- Parameters:
putAccountConfigurationRequest-- Returns:
- A Java Future containing the result of the PutAccountConfiguration operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
putAccountConfiguration
default CompletableFuture<PutAccountConfigurationResponse> putAccountConfiguration(Consumer<PutAccountConfigurationRequest.Builder> putAccountConfigurationRequest) Adds or modifies account-level configurations in ACM.
The supported configuration option is
DaysBeforeExpiry. This option specifies the number of days prior to certificate expiration when ACM starts generatingEventBridgeevents. ACM sends one event per day per certificate until the certificate expires. By default, accounts receive events starting 45 days before certificate expiration.
This is a convenience which creates an instance of the
PutAccountConfigurationRequest.Builderavoiding the need to create one manually viaPutAccountConfigurationRequest.builder()- Parameters:
putAccountConfigurationRequest- AConsumerthat will call methods onPutAccountConfigurationRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the PutAccountConfiguration operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
removeTagsFromCertificate
default CompletableFuture<RemoveTagsFromCertificateResponse> removeTagsFromCertificate(RemoveTagsFromCertificateRequest removeTagsFromCertificateRequest) Remove one or more tags from an ACM certificate. A tag consists of a key-value pair. If you do not specify the value portion of the tag when calling this function, the tag will be removed regardless of value. If you specify a value, the tag is removed only if it is associated with the specified value.
This action applies only to the
certificateresource type. For all other ACM resource types, use UntagResource instead.To add tags to a certificate, use the AddTagsToCertificate action. To view all of the tags that have been applied to a specific ACM certificate, use the ListTagsForCertificate action.
- Parameters:
removeTagsFromCertificateRequest-- Returns:
- A Java Future containing the result of the RemoveTagsFromCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidParameterException An input parameter was invalid.
- TagPolicyException A specified tag did not comply with an existing tag policy and was rejected.
- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- 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:. - ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
removeTagsFromCertificate
default CompletableFuture<RemoveTagsFromCertificateResponse> removeTagsFromCertificate(Consumer<RemoveTagsFromCertificateRequest.Builder> removeTagsFromCertificateRequest) Remove one or more tags from an ACM certificate. A tag consists of a key-value pair. If you do not specify the value portion of the tag when calling this function, the tag will be removed regardless of value. If you specify a value, the tag is removed only if it is associated with the specified value.
This action applies only to the
certificateresource type. For all other ACM resource types, use UntagResource instead.To add tags to a certificate, use the AddTagsToCertificate action. To view all of the tags that have been applied to a specific ACM certificate, use the ListTagsForCertificate action.
This is a convenience which creates an instance of the
RemoveTagsFromCertificateRequest.Builderavoiding the need to create one manually viaRemoveTagsFromCertificateRequest.builder()- Parameters:
removeTagsFromCertificateRequest- AConsumerthat will call methods onRemoveTagsFromCertificateRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the RemoveTagsFromCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidParameterException An input parameter was invalid.
- TagPolicyException A specified tag did not comply with an existing tag policy and was rejected.
- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- 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:. - ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
renewCertificate
default CompletableFuture<RenewCertificateResponse> renewCertificate(RenewCertificateRequest renewCertificateRequest) Renews an eligible ACM certificate. In order to renew your Amazon Web Services Private CA certificates with ACM, you must first grant the ACM service principal permission to do so. For more information, see Testing Managed Renewal in the ACM User Guide.
- Parameters:
renewCertificateRequest-- Returns:
- A Java Future containing the result of the RenewCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- RequestInProgressException The certificate request is in process and the certificate in your account has not yet been issued.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
renewCertificate
default CompletableFuture<RenewCertificateResponse> renewCertificate(Consumer<RenewCertificateRequest.Builder> renewCertificateRequest) Renews an eligible ACM certificate. In order to renew your Amazon Web Services Private CA certificates with ACM, you must first grant the ACM service principal permission to do so. For more information, see Testing Managed Renewal in the ACM User Guide.
This is a convenience which creates an instance of the
RenewCertificateRequest.Builderavoiding the need to create one manually viaRenewCertificateRequest.builder()- Parameters:
renewCertificateRequest- AConsumerthat will call methods onRenewCertificateRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the RenewCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- RequestInProgressException The certificate request is in process and the certificate in your account has not yet been issued.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
requestCertificate
default CompletableFuture<RequestCertificateResponse> requestCertificate(RequestCertificateRequest requestCertificateRequest) 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
DomainNameparameter. You can also specify additional FQDNs in theSubjectAlternativeNamesparameter.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 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
RequestCertificateaction, there is a delay of several seconds before you can retrieve information about the new certificate.- Parameters:
requestCertificateRequest-- Returns:
- A Java Future containing the result of the RequestCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidParameterException An input parameter was invalid.
- 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.
- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- 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:. - InvalidDomainValidationOptionsException One or more values in the DomainValidationOption structure is incorrect.
- LimitExceededException An ACM quota has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
requestCertificate
default CompletableFuture<RequestCertificateResponse> requestCertificate(Consumer<RequestCertificateRequest.Builder> requestCertificateRequest) 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
DomainNameparameter. You can also specify additional FQDNs in theSubjectAlternativeNamesparameter.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 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
RequestCertificateaction, there is a delay of several seconds before you can retrieve information about the new certificate.
This is a convenience which creates an instance of the
RequestCertificateRequest.Builderavoiding the need to create one manually viaRequestCertificateRequest.builder()- Parameters:
requestCertificateRequest- AConsumerthat will call methods onRequestCertificateRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the RequestCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidParameterException An input parameter was invalid.
- 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.
- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- 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:. - InvalidDomainValidationOptionsException One or more values in the DomainValidationOption structure is incorrect.
- LimitExceededException An ACM quota has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
resendValidationEmail
default CompletableFuture<ResendValidationEmailResponse> resendValidationEmail(ResendValidationEmailRequest resendValidationEmailRequest) Resends the email that requests domain ownership validation. The domain owner or an authorized representative must approve the ACM certificate before it can be issued. The certificate can be approved by clicking a link in the mail to navigate to the Amazon certificate approval website and then clicking I Approve. However, the validation email can be blocked by spam filters. Therefore, if you do not receive the original mail, you can request that the mail be resent within 72 hours of requesting the ACM certificate. If more than 72 hours have elapsed since your original request or since your last attempt to resend validation mail, you must request a new certificate. For more information about setting up your contact email addresses, see Configure Email for your Domain.
- Parameters:
resendValidationEmailRequest-- Returns:
- A Java Future containing the result of the ResendValidationEmail operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- 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.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- InvalidStateException Processing has reached an invalid state.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
resendValidationEmail
default CompletableFuture<ResendValidationEmailResponse> resendValidationEmail(Consumer<ResendValidationEmailRequest.Builder> resendValidationEmailRequest) Resends the email that requests domain ownership validation. The domain owner or an authorized representative must approve the ACM certificate before it can be issued. The certificate can be approved by clicking a link in the mail to navigate to the Amazon certificate approval website and then clicking I Approve. However, the validation email can be blocked by spam filters. Therefore, if you do not receive the original mail, you can request that the mail be resent within 72 hours of requesting the ACM certificate. If more than 72 hours have elapsed since your original request or since your last attempt to resend validation mail, you must request a new certificate. For more information about setting up your contact email addresses, see Configure Email for your Domain.
This is a convenience which creates an instance of the
ResendValidationEmailRequest.Builderavoiding the need to create one manually viaResendValidationEmailRequest.builder()- Parameters:
resendValidationEmailRequest- AConsumerthat will call methods onResendValidationEmailRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ResendValidationEmail operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- 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.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- InvalidStateException Processing has reached an invalid state.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
revokeAcmeAccount
default CompletableFuture<RevokeAcmeAccountResponse> revokeAcmeAccount(RevokeAcmeAccountRequest revokeAcmeAccountRequest) Revokes an ACME account, preventing it from requesting or revoking certificates. This operation is irreversible.
- Parameters:
revokeAcmeAccountRequest-- Returns:
- A Java Future containing the result of the RevokeAcmeAccount operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
revokeAcmeAccount
default CompletableFuture<RevokeAcmeAccountResponse> revokeAcmeAccount(Consumer<RevokeAcmeAccountRequest.Builder> revokeAcmeAccountRequest) Revokes an ACME account, preventing it from requesting or revoking certificates. This operation is irreversible.
This is a convenience which creates an instance of the
RevokeAcmeAccountRequest.Builderavoiding the need to create one manually viaRevokeAcmeAccountRequest.builder()- Parameters:
revokeAcmeAccountRequest- AConsumerthat will call methods onRevokeAcmeAccountRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the RevokeAcmeAccount operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
revokeAcmeExternalAccountBinding
default CompletableFuture<RevokeAcmeExternalAccountBindingResponse> revokeAcmeExternalAccountBinding(RevokeAcmeExternalAccountBindingRequest revokeAcmeExternalAccountBindingRequest) Revokes an external account binding, preventing new ACME accounts from being registered using this binding. Existing ACME accounts that were previously registered using the binding are not affected and must be revoked separately.
- Parameters:
revokeAcmeExternalAccountBindingRequest-- Returns:
- A Java Future containing the result of the RevokeAcmeExternalAccountBinding operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
revokeAcmeExternalAccountBinding
default CompletableFuture<RevokeAcmeExternalAccountBindingResponse> revokeAcmeExternalAccountBinding(Consumer<RevokeAcmeExternalAccountBindingRequest.Builder> revokeAcmeExternalAccountBindingRequest) Revokes an external account binding, preventing new ACME accounts from being registered using this binding. Existing ACME accounts that were previously registered using the binding are not affected and must be revoked separately.
This is a convenience which creates an instance of the
RevokeAcmeExternalAccountBindingRequest.Builderavoiding the need to create one manually viaRevokeAcmeExternalAccountBindingRequest.builder()- Parameters:
revokeAcmeExternalAccountBindingRequest- AConsumerthat will call methods onRevokeAcmeExternalAccountBindingRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the RevokeAcmeExternalAccountBinding operation returned by the
service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
revokeCertificate
default CompletableFuture<RevokeCertificateResponse> revokeCertificate(RevokeCertificateRequest revokeCertificateRequest) Revokes a public ACM certificate. You can only revoke certificates that have been previously exported.
Once a certificate is revoked, you cannot reuse the certificate. Revoking a certificate is permanent.
- Parameters:
revokeCertificateRequest-- Returns:
- A Java Future containing the result of the RevokeCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceInUseException The certificate is in use by another Amazon Web Services service in the caller's account. Remove the association and try again.
- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
revokeCertificate
default CompletableFuture<RevokeCertificateResponse> revokeCertificate(Consumer<RevokeCertificateRequest.Builder> revokeCertificateRequest) Revokes a public ACM certificate. You can only revoke certificates that have been previously exported.
Once a certificate is revoked, you cannot reuse the certificate. Revoking a certificate is permanent.
This is a convenience which creates an instance of the
RevokeCertificateRequest.Builderavoiding the need to create one manually viaRevokeCertificateRequest.builder()- Parameters:
revokeCertificateRequest- AConsumerthat will call methods onRevokeCertificateRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the RevokeCertificate operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceInUseException The certificate is in use by another Amazon Web Services service in the caller's account. Remove the association and try again.
- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
searchCertificates
default CompletableFuture<SearchCertificatesResponse> searchCertificates(SearchCertificatesRequest searchCertificatesRequest) Retrieves a list of certificates matching search criteria. You can filter certificates by X.509 attributes and ACM specific properties like certificate status, type and renewal eligibility. This operation provides more flexible filtering than ListCertificates by supporting complex filter statements.
- Parameters:
searchCertificatesRequest-- Returns:
- A Java Future containing the result of the SearchCertificates operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
searchCertificates
default CompletableFuture<SearchCertificatesResponse> searchCertificates(Consumer<SearchCertificatesRequest.Builder> searchCertificatesRequest) Retrieves a list of certificates matching search criteria. You can filter certificates by X.509 attributes and ACM specific properties like certificate status, type and renewal eligibility. This operation provides more flexible filtering than ListCertificates by supporting complex filter statements.
This is a convenience which creates an instance of the
SearchCertificatesRequest.Builderavoiding the need to create one manually viaSearchCertificatesRequest.builder()- Parameters:
searchCertificatesRequest- AConsumerthat will call methods onSearchCertificatesRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the SearchCertificates operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
searchCertificatesPaginator
default SearchCertificatesPublisher searchCertificatesPaginator(SearchCertificatesRequest searchCertificatesRequest) This is a variant of
searchCertificates(software.amazon.awssdk.services.acm.model.SearchCertificatesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.acm.paginators.SearchCertificatesPublisher publisher = client.searchCertificatesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.acm.paginators.SearchCertificatesPublisher publisher = client.searchCertificatesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.acm.model.SearchCertificatesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.acm.model.SearchCertificatesResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
searchCertificates(software.amazon.awssdk.services.acm.model.SearchCertificatesRequest)operation.- Parameters:
searchCertificatesRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
searchCertificatesPaginator
default SearchCertificatesPublisher searchCertificatesPaginator(Consumer<SearchCertificatesRequest.Builder> searchCertificatesRequest) This is a variant of
searchCertificates(software.amazon.awssdk.services.acm.model.SearchCertificatesRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.acm.paginators.SearchCertificatesPublisher publisher = client.searchCertificatesPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.acm.paginators.SearchCertificatesPublisher publisher = client.searchCertificatesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.acm.model.SearchCertificatesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.acm.model.SearchCertificatesResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
searchCertificates(software.amazon.awssdk.services.acm.model.SearchCertificatesRequest)operation.
This is a convenience which creates an instance of the
SearchCertificatesRequest.Builderavoiding the need to create one manually viaSearchCertificatesRequest.builder()- Parameters:
searchCertificatesRequest- AConsumerthat will call methods onSearchCertificatesRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ThrottlingException The request was denied because it exceeded a quota.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
tagResource
Adds one or more tags to an ACM resource. Tags are labels that you can use to identify and organize your Amazon Web Services resources. Each tag consists of a
keyand an optionalvalue.Use this action for all ACM resource types except the
certificateresource type. For certificate resources, use AddTagsToCertificate instead.To remove one or more tags, use the UntagResource action. To view all of the tags that have been applied to a resource, use the ListTagsForResource action.
- Parameters:
tagResourceRequest-- Returns:
- A Java Future containing the result of the TagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ServiceQuotaExceededException A service quota has been exceeded.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
tagResource
default CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Adds one or more tags to an ACM resource. Tags are labels that you can use to identify and organize your Amazon Web Services resources. Each tag consists of a
keyand an optionalvalue.Use this action for all ACM resource types except the
certificateresource type. For certificate resources, use AddTagsToCertificate instead.To remove one or more tags, use the UntagResource action. To view all of the tags that have been applied to a resource, use the ListTagsForResource action.
This is a convenience which creates an instance of the
TagResourceRequest.Builderavoiding the need to create one manually viaTagResourceRequest.builder()- Parameters:
tagResourceRequest- AConsumerthat will call methods onTagResourceRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the TagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ServiceQuotaExceededException A service quota has been exceeded.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
untagResource
default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest) Removes one or more tags from an ACM resource.
Use this action for all ACM resource types except the
certificateresource type. For certificate resources, use RemoveTagsFromCertificate instead.To add one or more tags, use the TagResource action. To view all of the tags that have been applied to a resource, use the ListTagsForResource action.
- Parameters:
untagResourceRequest-- Returns:
- A Java Future containing the result of the UntagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
untagResource
default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Removes one or more tags from an ACM resource.
Use this action for all ACM resource types except the
certificateresource type. For certificate resources, use RemoveTagsFromCertificate instead.To add one or more tags, use the TagResource action. To view all of the tags that have been applied to a resource, use the ListTagsForResource action.
This is a convenience which creates an instance of the
UntagResourceRequest.Builderavoiding the need to create one manually viaUntagResourceRequest.builder()- Parameters:
untagResourceRequest- AConsumerthat will call methods onUntagResourceRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the UntagResource operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateAcmeDomainValidation
default CompletableFuture<UpdateAcmeDomainValidationResponse> updateAcmeDomainValidation(UpdateAcmeDomainValidationRequest updateAcmeDomainValidationRequest) Updates the prevalidation configuration of an existing domain validation.
- Parameters:
updateAcmeDomainValidationRequest-- Returns:
- A Java Future containing the result of the UpdateAcmeDomainValidation operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateAcmeDomainValidation
default CompletableFuture<UpdateAcmeDomainValidationResponse> updateAcmeDomainValidation(Consumer<UpdateAcmeDomainValidationRequest.Builder> updateAcmeDomainValidationRequest) Updates the prevalidation configuration of an existing domain validation.
This is a convenience which creates an instance of the
UpdateAcmeDomainValidationRequest.Builderavoiding the need to create one manually viaUpdateAcmeDomainValidationRequest.builder()- Parameters:
updateAcmeDomainValidationRequest- AConsumerthat will call methods onUpdateAcmeDomainValidationRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the UpdateAcmeDomainValidation operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateAcmeEndpoint
default CompletableFuture<UpdateAcmeEndpointResponse> updateAcmeEndpoint(UpdateAcmeEndpointRequest updateAcmeEndpointRequest) Updates the configuration of an existing ACME endpoint. You can change the authorization behavior, contact requirement, or certificate authority settings.
- Parameters:
updateAcmeEndpointRequest-- Returns:
- A Java Future containing the result of the UpdateAcmeEndpoint operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateAcmeEndpoint
default CompletableFuture<UpdateAcmeEndpointResponse> updateAcmeEndpoint(Consumer<UpdateAcmeEndpointRequest.Builder> updateAcmeEndpointRequest) Updates the configuration of an existing ACME endpoint. You can change the authorization behavior, contact requirement, or certificate authority settings.
This is a convenience which creates an instance of the
UpdateAcmeEndpointRequest.Builderavoiding the need to create one manually viaUpdateAcmeEndpointRequest.builder()- Parameters:
updateAcmeEndpointRequest- AConsumerthat will call methods onUpdateAcmeEndpointRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the UpdateAcmeEndpoint operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InternalServerException The request processing has failed because of an unknown error, exception, or failure.
- 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.
- AccessDeniedException You do not have access required to perform this action.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- 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.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateCertificateOptions
default CompletableFuture<UpdateCertificateOptionsResponse> updateCertificateOptions(UpdateCertificateOptionsRequest updateCertificateOptionsRequest) Updates a certificate. You can use this function to specify whether to export your certificate. Certificate transparency logging opt-out is no longer available. For more information, see Certificate Transparency Logging and Certificate Manager Exportable Managed Certificates.
- Parameters:
updateCertificateOptionsRequest-- Returns:
- A Java Future containing the result of the UpdateCertificateOptions operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- LimitExceededException An ACM quota has been exceeded.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- InvalidStateException Processing has reached an invalid state.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
updateCertificateOptions
default CompletableFuture<UpdateCertificateOptionsResponse> updateCertificateOptions(Consumer<UpdateCertificateOptionsRequest.Builder> updateCertificateOptionsRequest) Updates a certificate. You can use this function to specify whether to export your certificate. Certificate transparency logging opt-out is no longer available. For more information, see Certificate Transparency Logging and Certificate Manager Exportable Managed Certificates.
This is a convenience which creates an instance of the
UpdateCertificateOptionsRequest.Builderavoiding the need to create one manually viaUpdateCertificateOptionsRequest.builder()- Parameters:
updateCertificateOptionsRequest- AConsumerthat will call methods onUpdateCertificateOptionsRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the UpdateCertificateOptions operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- InvalidArnException The requested Amazon Resource Name (ARN) does not refer to an existing resource.
- LimitExceededException An ACM quota has been exceeded.
- ValidationException The supplied input failed to satisfy constraints of an Amazon Web Services service.
- InvalidStateException Processing has reached an invalid state.
- ResourceNotFoundException The specified certificate cannot be found in the caller's account or the caller's account cannot be found.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- AcmException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
waiter
Create an instance ofAcmAsyncWaiterusing this client.Waiters created via this method are managed by the SDK and resources will be released when the service client is closed.
- Returns:
- an instance of
AcmAsyncWaiter
-
serviceClientConfiguration
Description copied from interface:SdkClientThe SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfigurationin interfaceAwsClient- Specified by:
serviceClientConfigurationin interfaceSdkClient- Returns:
- SdkServiceClientConfiguration
-
create
Create aAcmAsyncClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider. -
builder
Create a builder that can be used to configure and create aAcmAsyncClient.
-