DeleteCertificateAuthority - AWS Private Certificate Authority

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

DeleteCertificateAuthority

下面的 Java 示例演示了如何使用該DeleteCertificateAuthority操作。

此作業會刪除您使用作業建立的私人憑證授權單位 (CA)。CreateCertificateAuthorityDeleteCertificateAuthority 操作需要您提供要刪除 CA 的 ARN。您可以通過調用ListCertificateAuthorities操作找到 ARN。如果私有 CA 的狀態為 CREATINGPENDING_CERTIFICATE,您可以立即刪除。不過,如果您已經匯入憑證,則無法立即將其刪除。您必須先呼叫UpdateCertificateAuthority作業來停用 CA,並將Status參數設定為DISABLED。您接著可以在 DeleteCertificateAuthority 操作中使用 PermanentDeletionTimeInDays 參數來指定天數 (7 到 30)。在此期間,私有 CA 皆可以還原至 disabled 狀態。依預設,如果您未設定 PermanentDeletionTimeInDays 參數,還原期間為 30 天。過了此期間,私有 CA 會永久刪除,無法還原。如需詳細資訊,請參閱 還原 CA

如需說明如何使用RestoreCertificateAuthority作業的 Java 範例,請參閱RestoreCertificateAuthority

package com.amazonaws.samples; import com.amazonaws.auth.AWSCredentials; import com.amazonaws.auth.profile.ProfileCredentialsProvider; import com.amazonaws.client.builder.AwsClientBuilder; import com.amazonaws.client.builder.AwsClientBuilder.EndpointConfiguration; import com.amazonaws.auth.AWSStaticCredentialsProvider; import com.amazonaws.services.acmpca.AWSACMPCA; import com.amazonaws.services.acmpca.AWSACMPCAClientBuilder; import com.amazonaws.services.acmpca.model.DeleteCertificateAuthorityRequest; import com.amazonaws.AmazonClientException; import com.amazonaws.services.acmpca.model.ResourceNotFoundException; import com.amazonaws.services.acmpca.model.InvalidArnException; import com.amazonaws.services.acmpca.model.InvalidStateException; import com.amazonaws.services.acmpca.model.RequestFailedException; public class DeleteCertificateAuthority { public static void main(String[] args) throws Exception{ // Retrieve your credentials from the C:\Users\name\.aws\credentials file // in Windows or the .aws/credentials file in Linux. AWSCredentials credentials = null; try { credentials = new ProfileCredentialsProvider("default").getCredentials(); } catch (Exception e) { throw new AmazonClientException("Cannot load your credentials from disk", e); } // Define the endpoint for your sample. String endpointRegion = "region"; // Substitute your region here, e.g. "us-west-2" String endpointProtocol = "https://acm-pca." + endpointRegion + ".amazonaws.com/"; EndpointConfiguration endpoint = new AwsClientBuilder.EndpointConfiguration(endpointProtocol, endpointRegion); // Create a client that you can use to make requests. AWSACMPCA client = AWSACMPCAClientBuilder.standard() .withEndpointConfiguration(endpoint) .withCredentials(new AWSStaticCredentialsProvider(credentials)) .build(); // Create a requrest object and set the ARN of the private CA to delete. DeleteCertificateAuthorityRequest req = new DeleteCertificateAuthorityRequest(); // Set the certificate authority ARN. req.withCertificateAuthorityArn("arn:aws:acm-pca:us-east-1:111122223333:certificate-authority/11223344-1234-1122-2233-112233445566"); // Set the recovery period. req.withPermanentDeletionTimeInDays(12); // Delete the CA. try { client.deleteCertificateAuthority(req); } catch (ResourceNotFoundException ex) { throw ex; } catch (InvalidArnException ex) { throw ex; } catch (InvalidStateException ex) { throw ex; } catch (RequestFailedException ex) { throw ex; } } }