Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de AWS Command Line Interface with ACM.
Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.
Rubriques
Actions
L'exemple de code suivant montre comment utiliseradd-tags-to-certificate.
- AWS CLI
-
Pour ajouter des balises à un certificat ACM existant
La
add-tags-to-certificatecommande suivante ajoute deux balises au certificat spécifié. Utilisez un espace pour séparer plusieurs balises :aws acm add-tags-to-certificate --certificate-arnarn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012--tagsKey=Admin,Value=AliceKey=Purpose,Value=Website-
Pour plus de détails sur l'API, reportez-vous AddTagsToCertificate
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-certificate.
- AWS CLI
-
Pour supprimer un certificat ACM de votre compte
La
delete-certificatecommande suivante supprime le certificat avec l'ARN spécifié :aws acm delete-certificate --certificate-arnarn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012-
Pour plus de détails sur l'API, reportez-vous DeleteCertificate
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdescribe-certificate.
- AWS CLI
-
Pour récupérer les champs contenus dans un certificat ACM
La
describe-certificatecommande suivante extrait tous les champs du certificat avec l'ARN spécifié :aws acm describe-certificate --certificate-arnarn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012Un résultat similaire à ce qui suit s'affiche :
{ "Certificate": { "CertificateArn": "arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012", "CreatedAt": 1446835267.0, "DomainName": "www.example.com", "DomainValidationOptions": [ { "DomainName": "www.example.com", "ValidationDomain": "www.example.com", "ValidationEmails": [ "hostmaster@example.com", "admin@example.com", "owner@example.com.whoisprivacyservice.org", "tech@example.com.whoisprivacyservice.org", "admin@example.com.whoisprivacyservice.org", "postmaster@example.com", "webmaster@example.com", "administrator@example.com" ] }, { "DomainName": "www.example.net", "ValidationDomain": "www.example.net", "ValidationEmails": [ "postmaster@example.net", "admin@example.net", "owner@example.net.whoisprivacyservice.org", "tech@example.net.whoisprivacyservice.org", "admin@example.net.whoisprivacyservice.org", "hostmaster@example.net", "administrator@example.net", "webmaster@example.net" ] } ], "InUseBy": [], "IssuedAt": 1446835815.0, "Issuer": "Amazon", "KeyAlgorithm": "RSA-2048", "NotAfter": 1478433600.0, "NotBefore": 1446768000.0, "Serial": "0f:ac:b0:a3:8d:ea:65:52:2d:7d:01:3a:39:36:db:d6", "SignatureAlgorithm": "SHA256WITHRSA", "Status": "ISSUED", "Subject": "CN=www.example.com", "SubjectAlternativeNames": [ "www.example.com", "www.example.net" ] } }-
Pour plus de détails sur l'API, reportez-vous DescribeCertificate
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserexport-certificate.
- AWS CLI
-
Pour exporter un certificat privé émis par une autorité de certification privée.
La
export-certificatecommande suivante exporte un certificat privé, une chaîne de certificats et une clé privée vers votre écran :aws acm export-certificate --certificate-arnarn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012--passphrasefile://path-to-passphrase-filePour exporter le certificat, la chaîne et la clé privée vers un fichier local, utilisez la commande suivante :
aws acm export-certificate --certificate-arnarn:aws:acm:region:sccount:certificate/12345678-1234-1234-1234-123456789012--passphrasefile://path-to-passphrase-file>c:\temp\export.txt-
Pour plus de détails sur l'API, reportez-vous ExportCertificate
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-certificate.
- AWS CLI
-
Pour récupérer un certificat ACM
La
get-certificatecommande suivante permet de récupérer le certificat pour l'ARN spécifié et la chaîne de certificats :aws acm get-certificate --certificate-arnarn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012Un résultat similaire à ce qui suit s'affiche :
{ "Certificate": "-----BEGIN CERTIFICATE----- MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE= -----END CERTIFICATE-----", "CertificateChain": "-----BEGIN CERTIFICATE----- MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE= -----END CERTIFICATE-----", "-----BEGIN CERTIFICATE----- MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE= -----END CERTIFICATE-----", "-----BEGIN CERTIFICATE----- MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE= -----END CERTIFICATE-----" }-
Pour plus de détails sur l'API, reportez-vous GetCertificate
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserimport-certificate.
- AWS CLI
-
Pour importer un certificat dans ACM.
La
import-certificatecommande suivante importe un certificat dans ACM. Remplacez les noms de fichiers par les vôtres :aws acm import-certificate --certificatefile://Certificate.pem--certificate-chainfile://CertificateChain.pem--private-keyfile://PrivateKey.pem-
Pour plus de détails sur l'API, reportez-vous ImportCertificate
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-certificates.
- AWS CLI
-
Pour répertorier les certificats ACM d'un AWS compte
La
list-certificatescommande suivante répertorie les certificats ARNs de votre compte :aws acm list-certificatesLa commande précédente génère une sortie similaire à la sortie suivante :
{ "CertificateSummaryList": [ { "CertificateArn": "arn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012", "DomainName": "www.example.com" }, { "CertificateArn": "arn:aws:acm:region:account:certificate/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "DomainName": "www.example.net" } ] }Vous pouvez décider du nombre de certificats que vous souhaitez afficher à chaque appel
list-certificates. Par exemple, si vous avez quatre certificats et que vous ne souhaitez pas en afficher plus de deux à la fois, définissez l'max-itemsargument sur 2 comme dans l'exemple suivant :aws acm list-certificates --max-items2Deux certificats ARNs et une
NextTokenvaleur seront affichés :"CertificateSummaryList": [ { "CertificateArn": "arn:aws:acm:region:account: \ certificate/12345678-1234-1234-1234-123456789012", "DomainName": "www.example.com" }, { "CertificateArn": "arn:aws:acm:region:account: \ certificate/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "DomainName": "www.example.net" } ], "NextToken": "9f4d9f69-275a-41fe-b58e-2b837bd9ba48"Pour afficher les deux certificats suivants dans votre compte, définissez cette
NextTokenvaleur lors de votre prochain appel :aws acm list-certificates --max-items2--next-token9f4d9f69-275a-41fe-b58e-2b837bd9ba48Vous pouvez filtrer votre sortie à l'aide de l'
certificate-statusesargument. La commande suivante affiche les certificats dotés du statut PENDING_VALIDATION :aws acm list-certificates --certificate-statusesPENDING_VALIDATIONVous pouvez également filtrer votre sortie à l'aide de l'
includesargument. La commande suivante affiche les certificats filtrés selon les propriétés suivantes. Les certificats à afficher :- Specify that the RSA algorithm and a 2048 bit key are used to generate key pairs. - Contain a Key Usage extension that specifies that the certificates can be used to create digital signatures. - Contain an Extended Key Usage extension that specifies that the certificates can be used for code signing. aws acm list-certificates --max-items 10 --includes extendedKeyUsage=CODE_SIGNING,keyUsage=DIGITAL_SIGNATURE,keyTypes=RSA_2048-
Pour plus de détails sur l'API, reportez-vous ListCertificates
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-tags-for-certificate.
- AWS CLI
-
Pour répertorier les balises appliquées à un certificat ACM
La
list-tags-for-certificatecommande suivante répertorie les balises appliquées à un certificat dans votre compte :aws acm list-tags-for-certificate --certificate-arnarn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012La commande précédente génère une sortie similaire à la sortie suivante :
{ "Tags": [ { "Value": "Website", "Key": "Purpose" }, { "Value": "Alice", "Key": "Admin" } ] }-
Pour plus de détails sur l'API, reportez-vous ListTagsForCertificate
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserremove-tags-from-certificate.
- AWS CLI
-
Pour supprimer une étiquette d'un certificat ACM
La
remove-tags-from-certificatecommande suivante supprime deux balises du certificat spécifié. Utilisez un espace pour séparer plusieurs balises :aws acm remove-tags-from-certificate --certificate-arnarn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012--tagsKey=Admin,Value=AliceKey=Purpose,Value=Website-
Pour plus de détails sur l'API, reportez-vous RemoveTagsFromCertificate
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserrequest-certificate.
- AWS CLI
-
Pour demander un nouveau certificat ACM
La
request-certificatecommande suivante demande un nouveau certificat pour le domaine www.example.com à l'aide de la validation DNS :aws acm request-certificate --domain-namewww.example.com--validation-methodDNSVous pouvez saisir un jeton d'idempuissance pour faire la distinction entre les appels à :
request-certificateaws acm request-certificate --domain-namewww.example.com--validation-methodDNS--idempotency-token91adc45qVous pouvez saisir un ou plusieurs noms de sujet alternatifs pour demander un certificat qui protégera plusieurs domaines apex :
aws acm request-certificate --domain-nameexample.com--validation-methodDNS--idempotency-token91adc45q--subject-alternative-nameswww.example.netVous pouvez saisir un autre nom qui peut également être utilisé pour accéder à votre site Web :
aws acm request-certificate --domain-nameexample.com--validation-methodDNS--idempotency-token91adc45q--subject-alternative-nameswww.example.comVous pouvez utiliser un astérisque (*) comme caractère générique pour créer un certificat pour plusieurs sous-domaines du même domaine :
aws acm request-certificate --domain-nameexample.com--validation-methodDNS--idempotency-token91adc45q--subject-alternative-names*.example.comVous pouvez également saisir plusieurs noms alternatifs :
aws acm request-certificate --domain-nameexample.com--validation-methodDNS--subject-alternative-namesb.example.comc.example.comd.example.comSi vous utilisez le courrier électronique pour la validation, vous pouvez saisir des options de validation de domaine pour spécifier le domaine auquel l'e-mail de validation sera envoyé :
aws acm request-certificate --domain-nameexample.com--validation-methodEMAIL--subject-alternative-nameswww.example.com--domain-validation-optionsDomainName=example.com,ValidationDomain=example.comLa commande suivante permet de désactiver la journalisation transparente des certificats lorsque vous demandez un nouveau certificat :
aws acm request-certificate --domain-namewww.example.com--validation-methodDNS--optionsCertificateTransparencyLoggingPreference=DISABLED--idempotency-token184627-
Pour plus de détails sur l'API, reportez-vous RequestCertificate
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserresend-validation-email.
- AWS CLI
-
Pour renvoyer un e-mail de validation pour votre demande de certificat ACM
La
resend-validation-emailcommande suivante indique à l'autorité de certification Amazon d'envoyer un e-mail de validation aux adresses appropriées :aws acm resend-validation-email --certificate-arnarn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012--domainwww.example.com--validation-domainexample.com-
Pour plus de détails sur l'API, reportez-vous ResendValidationEmail
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserupdate-certificate-options.
- AWS CLI
-
Pour mettre à jour les options de certificat
La
update-certificate-optionscommande suivante permet de désactiver la journalisation de la transparence des certificats :aws acm update-certificate-options --certificate-arnarn:aws:acm:region:account:certificate/12345678-1234-1234-1234-123456789012--optionsCertificateTransparencyLoggingPreference=DISABLED-
Pour plus de détails sur l'API, reportez-vous UpdateCertificateOptions
à la section Référence des AWS CLI commandes.
-
